Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Deploying a Template to the Devices

 

You deploy a template to the devices to update the configuration on the devices. Before deploying a template to a device, ensure that you have not already assigned the template to the same device. If you assign a template to a device and use the Deploy workflow to deploy that template on the same device, even if the template is deployed to the device, Junos Space Network Management Platform does not reflect this managed status. The managed status of the device is shown as "Space Changed" on the Device Management page.

You can also use this workflow to assign and publish the template to the devices. You assign and publish a template to the devices to set up this template for deployment. When you assign and publish a template to the devices, the template is placed in queue. You can review the accumulated configuration changes that will be deployed to the devices.

To deploy or assign a template to the devices:

  1. On the Junos Space Network Management Platform user interface, select Device Templates > Templates.

    The Templates page is displayed.

  2. Select the device template that you want to deploy and select Assign/Deploy Template from the Actions menu.

    The Assign/Deploy Template page is displayed. This page displays the devices on which the template can be deployed.

  3. From the Selected Template Version drop-down list, select the version of the device template that you want to deploy or assign to the devices.
  4. You can deploy the device template by selecting the devices manually, filtering by device properties, using tags, or providing a CSV file with filter criteria:
    • To select the devices manually, enter the search criteria in the Search field and click the Search icon.

      The list of devices are filtered by the search criteria.

    • To filter devices by device properties, select the check box next to the appropriate device column on the Column Filter drop-down list.

    • To select a device by using tags, select an appropriate tag from the Tag Filter drop-down list.

    • From Junos Space Platform Release 17.2R1 onward, when you select devices by CSV, you can choose to select all managed devices. Select the Include All Managed Devices check box to list all managed devices for selection.

      To provide filter criteria using a CSV file, click the CSV Filter icon and upload the CSV file with the filter criteria through the Upload a CSV pop-up window.

  5. Select the devices on which you want to deploy the template and click Next.

    This page displays the devices you chose on the left and the configuration to be deployed on the device on the right. You can also view details such as device name, managed status, validation status.

    If you specified device-specific values when creating the template definition, the Variable column is displayed. This column displays the validity of the value of the device-specific variable: PASS or FAIL.

  6. (Optional) To validate the configuration on the device before deploying, select the device and click the Validate on Device link.

    By validating the configuration, you ensure that the device template is semantically correct. If the validation fails, change the template parameters appropriately.

    Note

    If you select modeled devices that are in the Modeled state, the Validate on Device link is disabled.

    A job is triggered. You can view the details of the job from the Job Management page. When the job is completed, the job ID is displayed next to the Validate on Device link.

    Note

    If validation fails on all devices you selected, you cannot deploy the template on devices. If validation fails on some devices you selected, you can deploy the template to only those devices that succeeded the validation.

  7. (Optional) To view the XML format of the configuration, select the device and click the XML tab.
  8. (Optional) To view the CLI format of the configuration, select the device and click the CLI tab.
  9. Click Next.
  10. Select whether to deploy the device template now or later or whether to only assign and publish it.
    • To assign and publish the device template, select the Assign and Publish to pending configuration changes option button.

    • To deploy the device template now, select the Deploy Now option button.

    • To deploy the device template later:

      1. Select the Deploy Later option button.

      2. Enter the date in the Date field in the DD/MM/YYYY format.

      3. Enter the time in the Time field in the hh:mm format.

    Note

    If you select modeled devices that are in the Modeled state, the Deploy Now and Deploy Later buttons are disabled.

    Note

    If you publish the template, the configuration in the template is deployed to the device along with the candidate configuration for the device, with the Junos OS confirmed-commit functionality.

  11. Click Finish.

    The Deploy Template Job Information page is displayed. You are redirected to the Templates page.

Click OK to close the page.

The device template is deployed to the devices.

Note

You can check whether a template is deployed on all devices from the Job Management page. Double-click the row corresponding to the ID of the device template deployment job on the Job Management page. The Job Details page is displayed. The Description column on this page specifies whether the template is deployed on all devices. If the device template is not deployed on all devices, this column lists the reason why the template was not deployed. If there is an error, the View Job Details page displays an error message. For more information about the error messages, see Common Error Messages in Device-Related Operations.

Note

If you deploy the template when in SSOR mode, Junos Space Network Management Platform automatically assigns the template to the device. To subsequently modify the template, use one of the following workflows:

  • Unassign the template from the device, modify the template, and deploy the template by using the Deploy workflow.

  • Modify, approve, and deploy the template on the device by using the Review/Deploy Configuration workflow in the Devices workspace.

Release History Table
Release
Description
From Junos Space Platform Release 17.2R1 onward, when you select devices by CSV, you can choose to select all managed devices. Select the Include All Managed Devices check box to list all managed devices for selection.