Managing Update Jobs in iRM

Prev Next

Update jobs are the primary method for distributing data to routers via icom Router Management Cloud (iRM Cloud).
They enable centralized management of firmware, configurations, and applications across entire fleets, supporting compliance with operational and security policies.

Update jobs rely on Update Packages, which are structured archives containing firmware, configurations, containers, and more.
If you are not yet familiar with update packages, refer to the article Using Update Packages.

Note

Update Jobs are only available in iRM Cloud and require a valid “Basic” plan license.


What Are Update Jobs

An update job in iRM Cloud defines:

  • Which routers should receive an update

  • Which update package should be deployed

  • When the update should be executed

Update jobs provide:

  • Full visibility into the rollout process

  • Structured management of updates over time

  • Traceability and control critical for cybersecurity and regulatory compliance (e.g., CRA, IEC 62443)


Overview of the Update Jobs Page

Navigate to Update → Update Jobs to access the overview.
The page displays a table listing all created update jobs, including:

Field

Description

Number of target routers

How many routers are assigned to the job

Creation time

When the job was created

Execution time

When the job was executed (if applicable)

Execution status

Current status: such as Successfully Executed, Active, Failed, or Ready (waiting to be started)




Creating a New Update Job

To create a new update job:

  1. Navigate to Update → Update Jobs.

  2. Click the "+" button, or if no item is selected, open the "Select Action" dropdown and choose "Run Update Wizard".

The Update Wizard will guide you through three steps:

Step 1: Select Routers

Choose which routers should be updated:

  • Individual Selection: Select specific routers manually.

  • Group Selection: Select entire router groups.

  • All: Select all available routers.

Click Continue to continue.

Step 2: Select Update Package

Select the update package to deploy:

  • My own Update Packages: Upload a new package or select an existing custom package.

  • Update Packages from INSYS icom: Select official icom OS firmware provided by INSYS icom.

  • ASCII Templates: Select an ASCII configuration template for mass configuration updates.

When using ASCII Templates:

  • Custom fields and parameters assigned to each router are displayed automatically.

  • For editable string parameters, router-specific values can be entered directly into the fields.

  • These values are inserted individually into the ASCII configuration before it is transmitted to each router.

Click Continue to proceed.


Step 3: Define Execution and Job Details

In the final step, define:

  • Whether the job should start immediately or manually later.

  • A meaningful job name for easier management and identification.

Click Finish Update to finalize the setup.


After Completing the Wizard

After completing the wizard:

  • Choose Create new update to immediately set up another update job.

  • Or return To Update Job view.

Jobs that were not started immediately will appear with the status Ready.


Managing Existing Update Jobs

Click on the name of a job in the overview table to open its details view.

In the details view you can:

Action

Description

Run Job

Start a job manually by clicking the Run button.

Delete Job

Delete a job by clicking the Trash Bin icon.

Edit Name and Description

Directly edit the name and description fields.

View Timestamps

See creation time and modification time (if available).

Change Update Package

Click the Pencil icon to modify the assigned update package. Choose from existing packages, uploaded ones, or INSYS icom packages. Save to apply changes.

The details page also contains a router table listing all target routers for the job.

Router Table Feature

Description

Add Routers

Click the "+" button to open the router selection again.

Individual Update Package

In the Individual Update column, assign a different update package to a specific router if needed.