---
title: Prepare a new Tool File to manage DeviceHub Device(s) on multiple Litmus Edge
slug: solutions/prepare-a-new-tool-file-to-manage-devicehub-devices-on-multiple-litmus-edge
docTags: 
createdAt: 2025-08-12T10:46:36.826Z
---

To manage DeviceHub Devices on multiple Litmus Edge with the Litmus Excel Add-ins with a new Tool file, you must prepare the Tool file first.

# Before You Begin

- You know the IPv4 addresses of your Litmus Edge devices. 
- You [have an API Key defined](docId\:qZV_OaP7FN9tGhq9UTn_N) on every Litmus Edge Device you want to use.

# Step 1: Navigate to Home Actions

Open a new Excel file with *Litmus Excel Add-ins *enabled. See [Step 4: Verify Litmus Excel Add-in Activation in Excel](docId\:GZDhBJ1xZZNDDThYOCuuu) to learn more.

Expand **Home Actions**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/nz31SoF7h4a472dNJh5eA_image.png" size="80" width="1004" height="363" position="center" showCaption="false"}

Click on **New Configuration**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HxyUP9sPbRB16HK563y-L_image.png" size="80" width="525" height="251" position="center" showCaption="false"}

Click on **Device Management Template**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gki14UyJ31U3XkugvGIX0_image.png" size="80" width="640" height="431" position="center" showCaption="false"}

A new file will be created, based on the Device Management Template, with a default name of "Litmus\_Configuration\_DeviceManagement\_\<User Name>\_\<Date>\_\<Time>.xlsm".
Example:*&#x20; Litmus\_Configuration\_DeviceManagement\_Jane Doe\_08122025\_132020.xlsm*
It is stored by default in your Documents Folder.

# Step 2: Add IP and API Key for one  Litmus Edge

The Device Management Tool will inform the user if no Litmus Edge Device is defined.
Acknowledge the message through a click on the *OK* button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/GfYHfm0ZqSL8-kckL7Eqj_image.png" size="80" width="1028" height="645" position="center" showCaption="false"}

Select for **Connect To** the Multiple LE option. Which will show the **Target Litmus Edge IP** column.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/e2q3QAnXr-BiG6k1k9M2M_image.png" size="80" width="548" height="379" position="center" showCaption="false"}

Provide the IPv4 of **one** of the Litmus Edge you want to work on in the first row (Row 5). And press the **Yes** button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Fp-1Y37NESAn-OE04Wmiw_image.png" size="80" width="604" height="393" position="center" showCaption="false"}

Provide the [API Key](docId\:yEbaCETwTk6biyhTq0SL9) from Litmus Edge. Press the ENTER key. And Click on the green **Save** button

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ozgETgypSA6W917ypoww2_image-2025-08-12-133928982.png" size="80" width="628" height="410" position="center" showCaption="false"}

The tool will now verify if it can connect to the defined Litmus Edge.

:::hint{type="info"}
**Notes**:

It is **not** necessary to add all the IPv4 addresses for every Litmus Edge you want to work on.

Their IPv4 addresses will be added as needed.
:::

# Troubleshooting

The system will attempt to establish a connection with the Litmus Edge. If successful, you will see the red banner disappear and the cell change to green.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Nxx14VSTTc74jTvU1A4po_image.png" size="80" width="603" height="421" position="center" showCaption="false"}

If the connection fails:
Example: DeviceHub Service not responding.

::Image[You want to:]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/1wNtlHQ_29oQ8kzXzJMoH_image.png" size="80" width="741" height="448" position="center" showCaption="false"}

- Select a cell in colum&#x6E;**&#x20;Target Litmus Edge IP** with the IPv4 address to verify
- Verify the IPv4 address
- Confirm the API Key

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/XxSGNUxxCbf_nc5V0-EPp_image.png?format=webp" size="80" width="804" height="549" position="center" showCaption="false"}

- Confirm if all Services are in a running (green) state.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/YpUcm3-Iwbry-0dJSY6VY_image.png?format=webp" size="80" width="635" height="485" position="center" showCaption="false"}

- Confirm if the Stats Service is not running correctly.

![](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/wjAixztaQ8M_hv6Yu3S2k_image.png?format=webp)