Upgrading and downgrading OS images on Cisco IOS XR Router devices


This topic describes how to run a predefined job to upgrade or downgrade the OS images on the Cisco IOS XR Router devices.

Running the predefined job

  1. Navigate to Network > Actions > Predefined Jobs.
    The Predefined Jobs list page appears.
  2. For the Cisco IOS XR Version Upgrade/Downgrade predefined job, in the Actions column, click Prepare Job Icon_PrepareJob.png.
  3. Enter the following details in the Edit Job page:

    Fields

    Description

    Change ID

    Enter the Change ID for this job.

    Task ID

    Enter the Task ID for this job.

    Run At

    Select one of the following options:

    • Select a date and time to run the predefined job
    • Now or When Approved

    Send Notification

    Select one of the following options:

    • Never
    • On Selected State Changes

    Optional

    • On Error, Skip Remaining Actions
    • Include Debug Trace in Communication Transcripts

    User Assigned Dynamic Fields

    • Change Type
    • Comments
    • Date Filter
    • Impact
    • IntegerFilter
    • Risk Level
    • SingleSelectMenu
  4. Click Save And Submit.
  5. The job you have prepared is displayed on the Jobs list page.
  6. Click View Icon_View.pngin the Actions column to view the Job Details page. 
    The following figure shows the Job Details page for a sample job. The page shows two actions, Add and activate packages on IOS XR (Action #1) and Commit the active software set on IOS XR (Action #2).

    Important

    The Add and activate packages on IOS XR action only supports .tar files. The .tar files can contain only PIE files. For more information, see Cisco's System Management Command Reference.

    Job details.png

    In the sample job, Action 1# was run on all Cisco IOS XR Router devices in the Default realm. If this action fails on any of the devices, then the final job status is shown as Failed. You can click the Status link to check on the device models that were captured and on which the custom action failed. 
    Action #2 shows the results of the external script action. Clicking the link for a device in the Status column displays the transcript where you can see the detailed results for the device, as shown in the following figure:
    Action details.png

  7. Upon successful execution of the job, the OS Image column on the Devices page is populated with a new image name for the Cisco ISO XR Router devices. The following figure shows the Devices page for the sample job.
    Devices.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*