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

Software Update jobs are used to upgrade your edge device software.

:::hint{type="info"}
**Note**: Software packages are added from the** Images **module in the Belden Horizon Data Manager Admin Console. See [Edge Software Update](docId\:VNNHtRzlZ0zstljkmPDA3). 
:::

# 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.

# 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. 
- A *Software Update Job* will usually take a few minutes to complete.
- A *Software Update Job *will automatically timeout after 1 hour. 
- A *Software Update Job *that 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 the* History (#) *tab. 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`.

# Add New Job

You can add a software update job from the *Software Update * 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" position="center" caption="Software Update Job UI : Step 1 Add New Job" showCaption="true"}

# Step 1: 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.

![](https://api.archbee.com/api/optimize/vAqK-046vdh4I0e1y9cfX/wgSbc33I-5Fpp23_kT6F6_image.png "Software Update Job UI : Step 2 Select Software")

**To select software**:

1. From the **Software Update  **tab, select at least one software package to add.
2. Click **Next**.

# Step 2: 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.

**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 3a: Schedule Software Job

You have several options to schedule the software job. 

To schedule the software job, select one of the following options and click **Next**. 

- **Run now**: Download and install the update immediately. 
- **Download only**: Download the upgrade file to devices.
- **Run on a schedule**: Download immediately. 

# Step 3b: Configure Software Job Schedule

If you select **Run on schedule**, select the date and time to run the software job. 

You have the option to select the checkbox for **Allow delayed upgrade if the download takes long**. 

- If you don't select this option and the downloading of the file is not completed by the scheduled upgrade time, the upgrade will not occur. 
- If you select this option and the the downloading of the file is not completed by the scheduled upgrade time, the upgrade will still occur on a delayed schedule. 

# Step 4: Review Software Job Details

Review and confirm the details of the software job. Then, click Finish to create the job. 

The software job appears in the list of *Software Update Tasks*. Click the **Task ID** to view more information on the job. 

To delete the job, click the **Action menu** for the job and select **Cancel task**.