---
title: Add New Software Job
slug: bhdm/add-new-software-job
createdAt: 2022-10-04T20:50:52.000Z
---

Software jobs are used to upgrade your edge device software.

:::hint{type="info"}
**Note**: Software packages are added from th&#x65;**&#xA0;Images&#xA0;**&#x6D;odule in the Belden Horizon Data Manager Admin Console. See [Edge Software Update](https://public-docs.litmus.io/bhdm/edge-software-update).&#x20;
:::

# Before You Begin

- Ensure the edge device that will be upgraded are online.
- Ensure an edge device is currently not already undergoing an existing software job (update). You cannot create a new software job for an edge device that is already undergoing an existing software job.

# Step 1: Add New Job

You can add a software update job from the *Software* pane by clicking **a new** or the **Add new Job** icon.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/DXa_kmJVwBXzZ8MMrAbFp_image.png" size="80" width="1920" height="866" caption="Software Update Job UI : Step 1 Add New Job" position="center" showCaption="true"}

# Step 2: Select Software

You can select some software that will be applied to recipient Edge Devices. The user interface below is for Belden Horizon Data Manager version 2.10.0 and later.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/eBPbnAHJdY0veXDMqyR6f_image.png" size="80" width="1568" height="417" caption="Software Update Job UI : Step 2 Select Software" position="center" showCaption="true"}

**To select software**:

1. From the **Software&#xA0;**&#x74;ab, select at least one software package to add.
2. Click **Next**.

# Step 3: Select Target Device(s)

After selecting software that will be applied to Edge Devices, select the devices that will receive the software. There is no limit on the number of edge devices that can be updated.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BMIhqDzKcnPIF-uQ1XdJq_image.png" size="80" width="1380" height="445" caption="Software Update Job UI : Step 3 Select Target Device(s)" position="center" showCaption="true"}

**To target devices to apply**:

1. From the **Targets** tab, select one or more edge devices from the edge device list.
2. Click **Next**.

# Step 4: Run Deploy

Before deploying software to a list of Edge Devices, you can review job details before it gets executed.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/uMHaPrdH3O5TiQVcpdvVG_image.png" size="80" width="1369" height="380" caption="Software Update Job UI : Step 4 Run Deploy" position="center" showCaption="true"}

**To deploy jobs to edge devices**:

1. From the *Targets&#xA0;*&#x74;ab, you have the option to select the **Start job immediately** check box.&#x20;
2. Click **Save**.&#x20;

:::hint{type="info"}
**Note**: If you do not check the **Start job immediately** check box, the *Job Status* column displays `PENDING`. Otherwise, it will display as `RUNNING`.
:::

The software job appears in th&#x65;*&#x20;Software Update Jobs* pane **Current (#)** tab.&#x20;

# Running Job Properties

- Up to 10 running jobs can run in parallel. Additional ones will be queued until a running job completes.
- The progress bar will automatically fill up from 0 to 100% without a need to refresh the page. It will automatically by itself refresh every 5 seconds.&#x20;
- A *Software Update Job* will usually take a few minutes to complete.
- A *Software Update Job&#x20;*&#x77;ill automatically timeout after 1 hour.&#x20;
- A *Software Update Job&#x20;*&#x74;hat disconnects before it finishes could still upgrade and reboot a Belden Horizon Data Operations instance. This will happen if the Belden Horizon Data Operations successfully receives the `.upd` file before the disconnect.
- Once the job completes, it will be transferred from the *Current (#)* tab to th&#x65;*&#xA0;History (#)&#xA0;*&#x74;ab. If the job was successful, the update status will be set to `COMPLETED`. If instead the job failed, the update status will be set to `ERROR`.

