# Upload Jobs

Upload jobs involve changing or updating configuration files or firmware from the Infraon NCCM server to network devices. They're commonly used for deploying new devices, updating existing ones, and upgrading device firmware. For instance, users can simultaneously upload entire configuration files or specific snippets to individual or multiple devices.

While backup involves taking a copy of the device configuration and retaining it in the NCCM, upload refers to the opposite. "Upload" transfers the configuration from the NCCM to the device. Entire configuration files or select lines/snippets within a file can be uploaded using the Network Configuration Manager.

*This is a privilege-based feature:* The user can access, view, add, edit, delete, execute, and export only if the administrator has given them privileges. This will be defined under roles and privileges.

Upload jobs are controlled ways of changing the Device Configuration and Device OS Image within a defined period.

## What you see on the screen

The **Upload Job** page displays the list of active and scheduled jobs in the network configuration inventory. The following table outlines the available action icons and their descriptions.

**Upload Jobs Details** | Basic Details

<table data-header-hidden><thead><tr><th width="162.60003662109375"></th><th width="241.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td><strong>Search</strong></td><td>Search for the required Upload job.</td><td>Upload Job name.</td></tr><tr><td><strong>Filter</strong></td><td>A filter can be added based on the field, and the conditions can be selected from the drop-down box below. </td><td><p>Field: Agent Name, Job Name, Job Status, Status.</p><p>Conditions: in, not in, equal to, not equal to.</p></td></tr><tr><td><strong>Download Jobs</strong></td><td>Click to navigate to the Download Jobs module</td><td>Redirects users to the Download Jobs module, where they can view, manage, or track jobs related to downloading configurations or firmware.</td></tr><tr><td><strong>Configuration Templates</strong></td><td>Click to navigate to the Configuration Template module</td><td>Opens the Configuration Template module, allowing users to create, edit, or manage predefined templates for configuration uploads.</td></tr><tr><td><strong>Job Task</strong></td><td>Click to navigate to the Upload Job Task to view more details.</td><td>Filter by: Upload Task IP Results, Completed, In-Progress</td></tr><tr><td><strong>Export</strong></td><td>Click to export the uploaded job file.</td><td>Upload Job data can be exported in an XLS file.</td></tr><tr><td><strong>Add</strong></td><td>Click to add an Upload job in the NCCM tool.</td><td>Users can create a new upload job by specifying the configuration, device details, and schedule parameters.</td></tr><tr><td><strong>Column Details</strong></td><td></td><td></td></tr><tr><td><strong>Job Name</strong></td><td>No actions can be taken.</td><td>Displays a unique Name to identify the Job.</td></tr><tr><td><strong>Status</strong></td><td>Click to change the upload job from an active to an Inactive state or vice-versa.</td><td>Active, In-Active.</td></tr><tr><td><strong>Agent</strong></td><td>Displays the agent name associated with the upload job.</td><td>Indicates the name, logo, IP address, and indicator to check the status.</td></tr><tr><td><strong>Kafka Status</strong></td><td>View-only field, no actions can be taken</td><td>Displays the real-time status of Kafka messages associated with the upload job, such as Success, Failed, or NA.</td></tr><tr><td><strong>Job Status</strong></td><td>No actions can be taken. This displays the status.</td><td><p>Job Status:</p><ul><li>Waiting For Schedule</li><li>Send to Queue in Progress</li><li>Added in Send Queue</li><li>Agent Received</li><li>Agent Execution In Progress</li><li>Completed</li><li>Requesting OS Image</li><li>OS Image Copied to Node Server</li><li>OS Image Agent Download In Progress</li><li>Waiting For Execution</li><li>Waiting For Rerun</li><li>Job Closed</li></ul></td></tr><tr><td><strong>Frequency</strong></td><td>No actions can be taken. This displays the frequency of the job.</td><td><p>Frequency</p><ul><li>Execute Now</li><li>Execute at</li><li>At Every</li><li>Weekly</li><li>Daily</li><li>Monthly</li></ul></td></tr><tr><td><strong>Visibility</strong></td><td>View-only field: no actions can be taken</td><td>This shows whether the upload job is designated as <strong>Private</strong> (restricted access) or <strong>Public</strong> (accessible to authorized users).</td></tr><tr><td><strong>Last Action Time</strong></td><td>No actions can be taken.</td><td>This displays the last action time of the job.</td></tr><tr><td><strong>Next Action Time</strong></td><td>No actions can be taken.</td><td>This displays the next action time of the job.</td></tr></tbody></table>

**Action Icons** | Upload Jobs

<table data-header-hidden><thead><tr><th width="208.20001220703125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td><strong>Edit</strong></td><td>Click to make changes to the upload job.</td><td>Job Details, Task Details, and Other details can be made.</td></tr><tr><td><strong>Delete</strong></td><td>Click to make changes to the upload job.</td><td>This action will allow users to delete the executed upload job.</td></tr><tr><td><strong>View Result</strong></td><td>Click to view the executed upload job result.</td><td>Refer to the below sections for in-depth details</td></tr><tr><td><strong>View Audit</strong></td><td>Click to view the executed upload job audit.</td><td>Refer to the below sections for in-depth details</td></tr><tr><td><strong>Close Job</strong></td><td>Click to close the job</td><td>Terminates the upload job, marking it as completed or manually stopped by the user.</td></tr><tr><td><strong>Reset to Next Schedule</strong></td><td>Click to initiate the action</td><td>Resets the upload job for execution at the next scheduled time per the defined upload schedule.</td></tr></tbody></table>

**View Result** | Action Icons

After clicking the 'View Result' option, a pop-up window will appear displaying details such as Timestamp, Job Name, Task Name, Vendor, Template Name, Task Owner, Device Account, Created By, Task Status, Task End Time, Next Retry Action, Retry Count, and Retry Status.

Please refer to the table below for additional details:

<table data-header-hidden><thead><tr><th width="161.800048828125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td><strong>Search</strong></td><td>Search for the required Upload job results based on timestamp, Job name, etc.</td><td>Job Name and Task name.</td></tr><tr><td><strong>Filter</strong></td><td>A filter can be added based on the field, and the conditions can be selected from the drop-down box below. </td><td>Field: Task Name, Vendor, Template Name, Task Owner, Device Account, Task Status, and respective conditions can be made.</td></tr><tr><td><strong>Sort By</strong></td><td>Sort the result window based on respected criteria from the drop-down box.</td><td>Current hour, Last 60 minutes, Last hour, 3 Hours, etc.</td></tr><tr><td><strong>Stop Auto Reload</strong></td><td>Click to stop the reloading of the page</td><td>Disable the automatic page refresh, which occurs by default after every selected time interval.</td></tr><tr><td><strong>Export</strong></td><td>Click to export the uploaded job result file.</td><td>Upload Job Result data can be exported in an XLS file.</td></tr><tr><td><strong>View IP Details</strong></td><td>Click to view the IP details tab.</td><td>Refer to the section below for more details.</td></tr><tr><td><strong>Re-Run all Devices</strong></td><td>Click to perform the necessary action.</td><td>This will Re-execute the selected Task. Task Re-run will be executed for all the devices.</td></tr><tr><td><strong>Re-Run Failed Devices</strong></td><td>Click to perform the necessary action.</td><td>This will Re-Run the tasks only for failed devices.</td></tr></tbody></table>

**View IP Details** | View Result

After clicking the 'View IP Details' option, a pop-up window will appear displaying details such as Timestamp, IP Address, Vendor, Model, Serial Number, Task Owner, Device Account, Execution Identifier, Task Status, Task Started, Task Ended, and Error Message.

<table data-header-hidden><thead><tr><th width="158.5999755859375"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td><strong>Search</strong></td><td>Search for the required IP details based on timestamp, Job name, etc.</td><td><strong>Examples:</strong> IP Address</td></tr><tr><td><strong>Filter</strong></td><td>A filter can be added based on the field, and the conditions can be selected from the drop-down box below. </td><td>Field: Vendor, Execution Identifier, IP Address, Task Owner, Device Account, Task Status, and respective conditions can be made.</td></tr><tr><td><strong>Sort By</strong></td><td>Sort the result window based on respected criteria from the drop-down box.</td><td>Current hour, Last 60 minutes, Last hour, 3 Hours, etc.</td></tr><tr><td><strong>Stop Auto Reload</strong></td><td>Click to stop the reloading of the page</td><td>Disable the automatic page refresh, which occurs by default after every selected time interval.</td></tr><tr><td><strong>Export</strong></td><td>Click to export the uploaded job result file.</td><td>Upload Job Result data can be exported in an XLSX file.</td></tr></tbody></table>

Please refer to the below sections for additional details about the Task IP Audits:

**Job Execution Trail** | View IP Details

View Trails lets you track the history of actions for a job, showing details like changes made, who made them, and when. It's useful for auditing and reviewing the steps taken during job execution.

Upon clicking the corresponding icon, the following details will be available: Upload Job, Configuration Template, IP Address, Vendor, Created By, Executed By, and Result.

The Result tab will display all command information related to the job execution.

**Job Execution Result** | View IP Details

View results show the outcome of a job after it's completed. It provides details such as the job status (success or failure) and any relevant execution information or errors.

Upon clicking the corresponding icon, the following details will be available: Upload Job, Configuration Template, IP Address, Vendor, Created By, Executed By, and Result.

**View Audit** | Action Icons

After clicking the 'View Audit' option, a pop-up window displaying details such as Timestamp, Task Name, IP Address, and the respective message will appear.

Please refer to the table below for additional details:

<table data-header-hidden><thead><tr><th width="120.20001220703125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td><strong>Search</strong></td><td>Search for the required audits based on timestamp, Job name, etc.</td><td>Task Name, IP Address, and Message.</td></tr><tr><td><strong>Filter</strong></td><td>A filter can be added based on the field, and the conditions can be selected from the drop-down box below. </td><td>Field: Task Name, Device IP Address, Audit Message, and respective conditions can be made.</td></tr><tr><td><strong>Auto Refresh</strong></td><td>Click to enable the auto-refresh feature.</td><td>This automatically refreshes the Upload Job audits page, providing real-time data updates.</td></tr><tr><td><strong>Export</strong></td><td>Click to export the uploaded job result file.</td><td>Upload Job Result data can be exported in an XLSX file.</td></tr></tbody></table>

### **Bulk Actions**

Bulk action icons enable users to manage multiple upload jobs at once efficiently. Users can perform bulk actions through the pop-up menu by selecting jobs with checkboxes.

Refer to the table below for detailed actions and their functionalities:

**Bulk Actions |** Action Icons

<table data-header-hidden><thead><tr><th width="117.800048828125"></th><th width="211.800048828125"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Enable</strong></td><td>Click on the checkbox to enable the multi-selection panel.</td><td><p>This action will initiate the upload job and activate the execution process.</p><p>Disabled jobs will be activated and executed based on the scheduled time.</p></td></tr><tr><td><strong>Disable</strong></td><td>Click on the checkbox to enable the multi-selection panel.</td><td><p>This action will terminate the upload job, deactivate the process, and prevent further execution.</p><p>Once the upload is disabled, the job will go to a disabled state, which means it won’t RUN until enabled.</p></td></tr></tbody></table>