Add Upload Job

Click the plus icon on the Upload Job page to create a new Upload Job. The 'Add Upload' page includes three additional tabs:

Job Details | Add Upload Jobs

Label

Action

Description/ Example

Job Name

Enter the appropriate name for the job.

This name will be used to identify the upload job within the system. Example: "Network Backup Job."

Job Description

Provide a brief description of the upload job.

This description helps users understand the purpose and details of the job.

Example: "Backup configuration for all routers."

Change Request ID

Auto-filled field

This field gets populated automatically when a job is triggered through the Request button. It links the Upload Job to its associated Change Request in the Change Management module. Not editable manually.

Type

Select the type of upload job from the drop-down list.

Options include Regular Job and OS Upgrade Job.

Job Execution Window (Mins/Hrs)

Choose the time frame for executing the upload job.

Select the time window in minutes or hours to specify when the job should run.

Example: "Execution window: 24 hours."

Notify to

Select users to be notified about the upload job.

Choose the relevant users who should receive notifications about the job's completion or completion from the drop-down list.

Agent

Choose the respective agent from the drop-down list.

The agent refers to the entity responsible for executing the upload job.

Job Status

Toggle the button to enable or disable the job status.

Enable the job status to allow the job to run. If disabled, the job will not execute.

Download Configuration before and after Upload

Turn on this functionality if needed.

This action is used to take a backup of the configuration before the upload job begins, and once the upload is complete, another backup is taken to ensure the updated configuration is saved.

Request

Click to initiate a change request before executing the job

This button allows the user to raise a change request for the upload job instead of directly running it. The job is routed through the Change Management module for approval. Once approved, the job executes automatically.

Note: The Upload Job Pre-Approval setting in Roles and Privileges controls the visibility of this button.

Change Request Workflow in NCCM

The Request button provides an extra control layer by routing configuration upload jobs through a formal approval process. This ensures network changes are reviewed and authorized before being applied to critical infrastructure.

It supports organizations following ITIL or internal compliance processes, where technicians or junior admins cannot execute changes directly.

Role-Based Visibility

The visibility of the Request button (and its counterpart, Submit) depends on the Upload Job Pre-Approval toggle:

Setting

What Happens

OFF

Only the Request button is shown. The user must initiate a change request.

ON

Both Request and Submit buttons are visible. Privileged users can bypass the approval process and directly submit jobs.

This setting is configured under the Roles & Privileges module.

Request Workflow Process

1. Job Creation The user fills out the Upload Job details, selects the configuration template and runtime values, then clicks Request.

2. Change Request Generation The system automatically generates a Change Request (CR) with a unique ID and routes it through the Change Management module.

3. CAB Review and Approval The Change Request is assigned to a CAB team. It is either approved or rejected based on the defined approval rules (e.g., threshold percentage, approvers).

4. Job Execution

  • If approved, the Upload Job is automatically triggered and executed on the targeted device(s).

  • If rejected, the job is marked accordingly and is not executed.

5. Audit and Notification All actions are logged for audit purposes. Notifications (if configured) are sent to relevant stakeholders.

Once the details have been added, click on Next to continue.

Task Details | Add Upload Jobs

Each Job has one or more tasks to be executed in a specific order, as defined. Task is the smallest unit where command execution on Devices is defined. Every task will have its Configuration Template, and the Devices will RUN with Runtime object input.

Each Task supports multiple command executions with multiple parameter substitutions simultaneously for individual location devices. Every task gets Device Credentials from the User when it is created.

Each task requires the following inputs from the User

  • Task Name.

  • Task Description.

  • Vendor

  • Configuration Template (Based on the Vendor).

    • View template - used to view the selected template.

    • Task Command(s) - used to view and edit task-related commands.

    • Select Template - used to select the template from the Template(s) collection.

Note: View and Edit template functionalities can be availed only when editing the job.

Note: Configuration template options are enabled based on the applied license. The buttons (View Template & Select Template) will not be visible if the configuration template license is inactive.

  • Device group and IP Address and IP Address from CSV - Using the dropdown or IP Address(s) in textbox or IP address from the CSV by using Load IP Address from CSV

    • Configuration profile (Mandatory for null vendor)

    • Configuration protocol (Mandatory for null vendor)

    • Connection Port (Mandatory for null vendor)

    • Device Username

    • Device Password

    • Confirm Password

    • Enable Password

    • Confirm Enable Password

    • Select if Shell must be installed remotely or locally.

    • Update Device credentials using the dropdown menu. (This option is for performing password rotation)

    • Task Enabled/Disabled

    • Task retry count

    • Task retry interval window (mins/hrs)

    • Continue next IP Address on Error

    • Continue the next Command on Error

    • Run after (Previous Task(s) Name)

    • Run only (Previous Task(s)) Status)

    • Wait After Previous Task(s) Completion in seconds

Click Add to Add the Task to the Upload Job Execution Queue.

  • To Edit the Added Task, select the Task and click Edit

  • Select the Task and click Delete to remove the Task from the upload job.

  • Clicking ^ on will move the task up.

  • Clicking ^ on will move the task down.

Other Details | Add Upload Jobs

Schedule Details | Add Upload Jobs

Click the Schedule Details Tab. Update the information below

  • Select the execution schedule option.

    • Once

    • Every

    • Daily

    • Weekly

    • Monthly

  • Select the Hours and Minutes from the Execute

Access Control | Add Upload Jobs

Click the Access Control tab.

  • Choose the visibility using the Radio button

If visibility is “Private,” User and User group dropdown will be enabled.

    • Select User(s) using dropdown.

    • Select Team(s) using dropdown.

If the Upload job is private, only selected users and User groups can view the job.

Note: Fields marked with * are mandatory to add.

Review Job

Click Review to Review the Upload job.

  • The review process displays all Tasks, their definitions, and completed details, including commands to execute before saving the job.

  • Review results could be exported into PDF.

Click Save to configure the Upload job. Click Cancel to abort the job.

Note:

  • If the Upload job has been added by a White-listed user, it will be executed based on the execution time.

  • If a Non-White-Listed user has added an Upload job, it will be executed only after the approval process.

  • The task waiting Period will suspend the execution of the next Task until the end of the period, at which point the Task execution resumes.

  • If the device(s) vendor is not identified (due to SNMP not being reachable), then the upload Job must be selected with Profile, Protocol, and Port to override download Job null entries.

  • If any particular task has failed, the task will execute again based on the Retry count and interval before the dependent task execution.

  • If the first task fails, the second task will be executed after completing the whole retry interval of the previous task.

  • If a task has multiple IP(s) configured and at the time of execution, if any IP(s) fail, the next retry will happen only for the failed IPs.

Configuring Task Chain or Task Dependency

The upload job supports Task dependencies by associating ‘Previous Task’s Name’ from the previous task name list and the previous execution result status as a condition for the current task to execute.

Three tasks have been configured:

  • Task1 - Enabling the BGP

  • Task2 - BGP Additional-Paths Select

  • Task3 - Start the Interface

  • Task1 is the Parent or Previous Task for the Task2 and Task3.

  • Upon successful execution of Task 1, Task 2 will be executed (not Task 3).

  • If Task1 fails, Task3 will be executed (Task2 will not be executed).

Task 1 Details:

Task 1 has been configured with the below parameters,

Label

Value

Execution Window

2 Hours

Run After

Start

Run if Previous Task

Success

Retry Count

1

Retry Interval

2 Hours

  • Task 1 should be executed within 2 hours of initiating it.

  • If Task 1 fails during execution, it will retry the same task one more time in 2-hour intervals.

  • If the input for the “Run After” field is given as ‘Start’, there is no dependency on the previous task.

  • Task 2 Details:

  • Task 2 has been configured with the below parameters.

Label

Value

Execution Window

15 minutes

Run After

Task1

Run if Previous Task

Success

Retry Count

3

Retry Interval

15 Minutes

  • Task 2 should be executed within 15 minutes of starting the execution.

  • Run After is “Task1” and Run if Previous Task is “Success,” which means “Task2” is dependent on “Task1” and will only be executed if “Task1” has been successfully executed.

  • If Task 2 fails during execution, it will retry the same task three times within 15-minute intervals.

  • Task 3 Details:

  • Task 3 has been configured with the below parameters.

Label

Value

Execution Window

2 Hours

Run After

Task1

Run if the Previous Task

Fail

Retry Count

2

Retry Interval

30 Minutes

  • Task 3 should be executed within 2 hours of starting the execution.

  • Run After is “Task1” and Run if Previous Task is “Fail,” which means “Task3” is dependent on “Task1”; if “Task1” fails, only then will “Task3” get executed.

  • If Task 3 fails during execution, it will retry the same task three times within 30-minute intervals.

Note: Users will only receive notifications upon the completion of the upload job.

Edit Upload Job

To edit an upload job, select an existing job, click on Edit, and Follow the same procedure as ‘Add job’ to edit.

Note:

  • Job re-run cannot be in the In-progress state.

  • Once the job execution has been completed, we can Re-run the same job.

  • Re-run options are only available if the job is enabled or completed.

Job Re-Run

This will trigger the job to re-execute the same job. However, users cannot re-run a job if any associated tasks are currently in progress or if the job is disabled.

Last updated

Was this helpful?