Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Undeploying JAM Packages from Devices

Junos Space Network Management Platform allows you to undeploy Junos Continuity software packages (JAM packages) that you have earlier deployed to devices. When you undeploy the Junos Continuity software package using the Undeploy JAM Package from Device action, the package is uninstalled from the selected device or devices.

Note:

You must ensure that the Modular Port Concentrators (MPCs) supported by the Junos Continuity software package are offline before you undeploy the Junos Continuity software package from the devices by using Junos Space Platform.

To undeploy the Junos Continuity software package from devices:

  1. On the Junos Space Platform UI, select Images and Scripts > Images.

    The Images page appears.

  2. Select the check box beside the entry for the Junos Continuity software package that you want to undeploy.
  3. Select Undeploy JAM Package from Device from the Actions menu.

    The Undeploy JAM Package from Device dialog box appears. The Select Devices table in the Undeploy JAM Package from Device dialog box displays the devices that are supported by the selected Junos Continuity software package. For a description of the fields in this table, see Table 1

    Table 1: Select Devices Table Fields

    Field

    Description

    JAM Package Name

    Name of the Junos Continuity software package (This field is above the devices table.)

    MD5 Value

    32-character hexadecimal number that is computed on the selected Junos Continuity software package file, which is stored on the Junos Space server

    Device Name

    Identifier used for network communication between Junos Space Platform and the device running Junos OS

    Device Alias

    Value of the Device Alias custom label for the device. This field is empty if the Device Alias custom label is not added or no value is assigned to the Device Alias custom label for the device.

    IP Address

    IP address of the device

    Platform

    Model number of the device

    Software Version

    Operating system firmware version running on the device

    Staged Status

    Indicates whether the selected Junos Continuity software package is staged on the device. This column displays either Staged (if the Junos Continuity software package is staged) or Not Staged (if the Junos Continuity software package is not staged).

    Deployed Status

    Indicates whether the Junos Continuity software package is deployed on the device. The column displays either Deployed (if the Junos Continuity software package is deployed) or Undeployed (if the Junos Continuity software package is not deployed).

    Checksum Status

    Indicates whether the Junos Continuity software package on the Junos Space server and the device are the same:

    • Valid means that the checksum values of the Junos Continuity software package on the Junos Space server and the device match.

    • Invalid means that the checksum values of the Junos Continuity software package on the Junos Space server and the device do not match.

    • NA means that the selected Junos Continuity software package is not staged on the device yet.

    Last Checksum Time

    Time when the checksum was last verified. For a device in which the selected Junos Continuity software package is not staged yet, this column displays NA.

    Domain

    Domain to which the device belongs
  4. Select the devices from which you want to undeploy the Junos Continuity software package by using one of the following selection modes—manually, based on tags, or by using a comma-separated values (CSV) file. These options are mutually exclusive. If you select one, the others are disabled.
    Note:

    By default, the Select Device Manually option is selected and the list of devices on which the Junos Continuity software package is deployed is displayed.

    To select devices manually:

    1. Click the Select Device Manually option button, if it is not selected previously.
    2. Select the devices from which you want to undeploy the Junos Continuity software package.

      The Select Devices status bar shows the total number of devices that you selected. The status bar is dynamically updated as you select devices.

    3. To select all devices, select the check box in the column header next to Device Name.

    To select devices on the basis of tags:

    1. Click the Select by Tags option button.

      The Select by tags list is activated.

    2. Click the arrow on the Select by Tags list.

      A list of tags defined for devices in the Junos Space system appears, categorized into two—Public and Private.

      Note:

      If no tags are displayed, then it means that none of the devices is associated with any tag. You must first tag the devices on the Device Management page before you can use the Select by Tags option.

    3. To select tags, perform one of the following actions :

      • Select the check boxes next to the tag names to select the desired tags and click OK.

      • To search for a specific tag, enter the first few letters of the tag name in the Select by Tags field to the left of the OK button.If a match is found, a suggestion is made. Select the suggested match and click OK.

      As you select the tags, the total number of devices associated with the selected tags, on which the selected Junos Continuity software package is deployed, appears just above the device display table. For example, if there are six devices associated with the selected tags, and two of them have the selected Junos Continuity software package deployed, then 2 items selected is displayed.

      The selected tags appear next to the Tags Selected label. An [X] icon appears after each tag name. You can click the [X] icon to clear any tag from the list. The device count decrements accordingly.

    To select devices by using a CSV file:

    1. Select the Select by CSV option button.
    2. Click Browse and upload the file in CSV format containing the list of devices from which you want to undeploy the Junos Continuity software package.
      Tip:

      For a sample CSV file, click the Sample CSV link. You are prompted to save the file. Save the file to your local system and open it by using an application, such as Microsoft Excel.

      From Release 16.1R2 onward, when you upload a CSV file to select devices from, Junos Space Platform verifies the devices in the CSV file. If the CSV file contains devices to which the changes do not apply, a warning message appears which says "Few devices are not selected due to precondition failure. Please click "View inapplicable devices" for more details.” You can click the View inapplicable devices link to review the list of devices that are excluded from the update.

  5. (Optional) To specify advanced options, expand the Advanced Options and select one or more check boxes.

    Using the options in this section, you can specify the script bundles to be executed before and after undeploying the Junos Continuity software package. See Table 2 for a description of the advanced options.

    Note:

    If you are assigned a user role that does not have the permissions required for executing script bundles on devices, then all the options in the Advanced Options section are unavailable.
    Table 2: Advanced Options Description

    Advanced Options

    Description

    Execute script bundle before JAM Package undeployment (pre scripts)

    Execute the script bundle that you have selected from the list, before undeploying the Junos Continuity software package. This ensures that the scripts in the selected script bundle are executed before the Junos Continuity software package is uninstalled from the device.

    After selecting a script bundle, you can configure the script parameters of the scripts within the script bundle. For instructions, see the following procedure starting with Step 5.a.

    Select same pre script bundle for post script bundle

    Execute the same script bundle on the device before and after the Junos Continuity software package is undeployed.

    This check box is unavailable if you have not selected a script bundle on the Execute script bundle before JAM Package undeployment (pre scripts) list.

    Execute script bundle after JAM Package undeployment (post scripts)

    Execute the script bundle that you have selected from the list, after undeploying the Junos Continuity software package. This ensures that the scripts in the selected script bundle are executed after the Junos Continuity software package is uninstalled from the device.

    After selecting a script bundle, you can configure the script parameters of the scripts within the script bundle. For instructions, see the following procedure starting with Step5.a.

    If you select the Select same pre script bundle for post script bundle check box, then the Execute script bundle after JAM Package undeployment (post scripts) check box is unavailable because the postscript bundle is the same as the prescript bundle.

    Deploy and Enable script bundle before execution

    Deploy the selected script bundle and enable the scripts included in the script bundle before the script bundle is executed on the device.

    If you are assigned a user role that does not have permissions for staging or enabling script bundles on devices, this check box is unavailable for selection.

    This check box is also unavailable if you have not selected a script bundle on the Execute script bundle before JAM Package undeployment (pre scripts) list or the Execute script bundle after JAM Package undeployment (post scripts) list.

    Disable scripts after execution

    Disable the scripts in the script bundle after they are executed on the device.

    If you are assigned a user role that does not have permissions for disabling script bundles on devices, this check box is unavailable for selection.

    You can enable the scripts at a later point of time (for instructions see Enabling Scripts on Devices).

    To configure the script parameters of scripts included in the script bundle:

    1. Select the prescript or postscript bundle that you want to configure, from the respective lists.

      If there are no script bundles listed, you can create script bundles using the Scripts workspace (see Creating a Script Bundle) and then select the script bundle during Junos Continuity software package undeployment.

    2. Click the Configure Scripts Parameters link.

      The Configure Script Bundle Parameters page appears. You can mouse over the script parameters to view short descriptions about them.

    3. Edit the values of script parameters by clicking the Edit icon.

      The changes made to script parameters are saved only on the devices on which the script bundle is executed. The script parameters in the script bundle in Junos Space Platform continue to reflect the original values.

    4. Click Configure.

      Your changes are saved and the Undeploy JAM Package from Device dialog box appears.

  6. (Optional) To schedule a time for deployment, select the Schedule at a later time check box and use the calendar icon and drop-down list to specify the date and time respectively.
  7. Click Undeploy.

    The Job Information dialog box appears with a message indicating that the undeploy job is successfully scheduled. You can click the job ID link that is displayed in the dialog box if you want to view the job details. You can also navigate to the Job Management page and view the details of the particular job.

  8. Click OK.

    You are returned to the Images page.

When you undeploy a JAM package from a device, an audit log entry is automatically generated. You can view the audit logs from the Audit Logs workspace.

Related Documentation