+ All Categories
Home > Documents > Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for...

Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for...

Date post: 09-Feb-2018
Category:
Upload: hoanghanh
View: 308 times
Download: 6 times
Share this document with a friend
28
Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883
Transcript
Page 1: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 SeriesRoutersFirst Published: 2015-12-23

Last Modified: 2017-09-15

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800 553-NETS (6387)Fax: 408 527-0883

Page 2: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITEDWARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITHTHE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain versionof the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDINGANYOTHERWARRANTYHEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS"WITH ALL FAULTS.CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OFMERCHANTABILITY, FITNESS FORA PARTICULAR PURPOSEANDNONINFRINGEMENTORARISING FROMACOURSEOFDEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUTLIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERSHAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, networktopology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentionaland coincidental.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnershiprelationship between Cisco and any other company. (1110R)

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, seeWhat's New in CiscoProduct Documentation.

To receive new and revised Cisco technical content directly to your desktop, you can subscribe to theWhat's New in Cisco Product Documentation RSS feed. RSSfeeds are a free service.

© 2015-2017 Cisco Systems, Inc. All rights reserved.

Page 3: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

C O N T E N T S

Changes to This Document 5

C H A P T E R 1 New and Changed Feature Information 1

New and Changed Feature Information 1

C H A P T E R 2 Introduction to Flexible Packaging 3

Workflow for Flexible Packaging 4

Packaging Filename Format 5

C H A P T E R 3 Manage Automatic Dependency 7

Update RPMs and SMUs 8

Upgrade Base Software Version 9

C H A P T E R 4 Customize Installation using Golden ISO 11

Limitations 12

Golden ISO Workflow 13

Build Golden ISO 13

Install Golden ISO 17

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers iii

Page 4: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routersiv

Contents

Page 5: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Changes to This Document

This table lists the technical changes made to this document since it was first released.

Table 1: Changes to This Document

SummaryDate

Republished for Cisco IOS XR Release 6.3.1September 2017

Republished for Cisco IOS XR Release 6.2.2July 2017

Republished for Cisco IOS XR Release 6.1.2.November 2016

First release for Cisco IOS XR Release 6.0.0.December 2015

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 5

Page 6: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers6

Changes to This Document

Page 7: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

C H A P T E R 1New and Changed Feature Information

This section lists all the new and changed features for the Flexible Packaging Configuration Guide.

• New and Changed Feature Information, page 1

New and Changed Feature InformationTable 2: New and Changed Features in Cisco IOS XR Software

Where DocumentedChanged in ReleaseDescriptionFeature

NARelease 6.3.1NANo new features wereintroduced.

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 1

Page 8: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers2

New and Changed Feature InformationNew and Changed Feature Information

Page 9: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

C H A P T E R 2Introduction to Flexible Packaging

Flexible packaging is a method of breaking down the Cisco IOS XR operating system into modules andproviding them as RPMs (packages). Delivering packages as RPMs enables easier and faster system updates.

The lean base software contains only the required packages, while the optional packages are providedseparately as installable RPMs. You can select and install the services you want by selecting the requiredRPMs.

Flexible packaging feature also supports automatic dependency management, whereby, while the user isupdating an RPM, the system automatically identifies all relevant dependent packages and updates them.The system uses standard LINUX tools to manage dependency during upgrades.

The base software is the minimum mandatory package (with utilities), required for the basic functioning ofthe router. This is also called the mini.iso file. This base package contains:

• Operating system (OS)—Kernel, file system, memory management, and other OS utilities

• Base components—Interfacemanager, system database, checkpoint services, configurationmanagementutilities

• Infrastructure components—rack management, fabric management

• Routing protocols—mandatory routing protocols (such as BGP)

• Forwarding components—FIB, ARP, QoS, ACL

• Line card drivers

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 3

Page 10: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Mandatory RPMs (such as, BGP) which are a part of the base software, cannot be removed and can only beupgraded. Optional RPMs such as, EIGRP can be added, upgraded and removed as required.

Figure 1: Granular routing modules

This section also describes the following:

• Workflow for Flexible Packaging, page 4

• Packaging Filename Format, page 5

Workflow for Flexible PackagingThis image shows the overall workflow for Flexible Packaging.

Figure 2: Flexible Packaging Workflow

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers4

Introduction to Flexible PackagingWorkflow for Flexible Packaging

Page 11: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Packaging Filename FormatThe format of an RPM is: name-version-release.architecture.rpm where,

• name - of the platform the software supports

• version - the version of the software

• release - the number of times this version of the software has been delivered

• architecture - the node's processor architecture

Consider the following example:

ncs5500-mpls-1.2.0.0-r611.x86_64.rpm

Platform-Package Name : ncs5500-mplsVersion : 1.2.0.0Release : r611Architecture : x86_64

Software Maintenance Upgrades (SMUs) are delivered as RPMs. RPMs have a four-digit version number.The first three digits represent major, minor, and build numbers respectively. The fourth digit is incrementedwith each SMU release.

This table lists the reasons when each digit of the version gets incremented.Incremented WhenIndicatesVersion (Digit from left)

non-backward compatible API(s)change(s)

MajorFirst

a backward compatible changeoccurs to a public API

MinorSecond

an RPM is built without any APIchange

BuildThird

a new SMU is releasedSMU ReleaseFourth

Defect ID

SMUs are identified with a defect-ID. In this example, note that, for the first SMU release of the package, thefourth digit starts at 1 and for the second SMU release of the package, the fourth digit is incremented to 2.

First SMU of the mpls package: ncs5500-mpls-1.2.0.1-r611.CSCus12345.x86_64.rpmSecond SMU of the mpls package: ncs5500-mpls-1.2.0.2-r611.CSCus12322.x86_64.rpm

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 5

Introduction to Flexible PackagingPackaging Filename Format

Page 12: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers6

Introduction to Flexible PackagingPackaging Filename Format

Page 13: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

C H A P T E R 3Manage Automatic Dependency

Flexible packaging supports automatic dependency management. While the user is updating an RPM, thesystem automatically identifies all relevant dependent packages and updates them.

Figure 3: Flow for Installation (base software, RPMs and SMUs)

Until this release, users downloaded the software image and required RPMs from CCO on a network server(the repository). They used the install add and the install activate commands to add and activate thedownloaded files on the . Then, users needed to manually identify relevant dependent RPMs, to add andactivate them.

With automatic dependency management, users need not identify dependent RPMs to individually add andactivate them. They can execute new install commands to identify and install dependent RPMs automatically.

The new commands are install update and install upgrade. The install update command identifies andupdates dependent packages. The command does not update the base package. The install upgrade commandupgrades the base package.

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 7

Page 14: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Note 1 Cisco IOS XR Version 6.0.2 and later does not provide 3rd-party and host package SMUs as part ofautomatic dependency management (install update and install upgrade commands). The 3rd partyand host package SMUsmust be installed separately, and in isolation from other installation procedures(installation of SMUs and RPMs in IOS XR or admin containers).

2 Cisco IOS XR Version 6.0.2 and later does not support asynchronous package upgrades.

3 From Cisco IOS XR Version 6.1.1 onwards, it is possible to update the mini.iso file by using theinstall update command.

The rest of this chapter contains these sections:

• Update RPMs and SMUs, page 8

• Upgrade Base Software Version, page 9

Update RPMs and SMUsAn RPM may contain a fix for a specific defect, and you may need to update the system with that fix. Toupdate RPMs and SMUs to a newer version, use the install update command. When the install updatecommand is issued for a particular RPM, the router communicates with the repository, and downloads andactivates that RPM. If the repository contains a dependent RPM, the router identifies that dependent RPMand installs that too.

The syntax of the install update command is:

install update source repository [rpm]

Four scenarios in which you can use the install update command are:

•When a package name is not specified

When no package is specified, the command updates the latest SMUs of all installed packages.install update source [repository]

From Cisco IOS XR Version 6.1.1 onwards, if the mini.iso file is not specified, thenit is not added as part of the update. Even if the repository contains the mini.iso file,it is not installed.install update source scp://<username>@<server>/my/path/of/packagesnoprompt

Note

•When a package name is specified

If the package name is specified, the command installs that package, updates the latest SMUs of thatpackage, along with its dependencies. If the package is already installed, only the SMUs of that packageare installed. (SMUs that are already installed are skipped.)install update source [repository] ncs5500-mpls.rpm

•When a package name and version number are specified

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers8

Manage Automatic DependencyUpdate RPMs and SMUs

Page 15: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

If a particular version of package needs to be installed, the complete package name must be specified;that package is installed along with the latest SMUs of that package present in the repository.install update source [repository] ncs5500-mpls-1.0.2.0-r611.x86_64.rpm

•When an SMU is specified

If an SMU is specified, that SMU is downloaded and installed, along with its dependent SMUs.install update source [repository] ncs5500-mpls-1.2.0.1-r611.CSCus12345.x86_64.rpm

•When a list of packages (containing the mini.iso file) is specified

From Cisco IOS XR Version 6.1.1 onwards, if a list of packages (containing the mini.iso file) isspecified, all the packages in the list and the mini.iso file are automatically added as part of the update.install update source scp://<username>@<server>/my/path/of/packages [List of packages]noprompt

•When the mini.iso file is specified

From Cisco IOS XR Version 6.1.1 onwards, if the mini.iso file is specified during the update, then thefile is installed with all RPMs and SMUs from the repository.install update source scp://<username>@<server>/my/path/of/packages [mini.iso] noprompt

Upgrade Base Software VersionYou may choose to upgrade to a newer version of the base software when it becomes available. To upgradeto the latest base software version, use the install upgrade command. With the upgrade of the base version,RPMs that are currently available on the router are also upgraded.

SMUs are not upgraded as part of this process.Note

The syntax of the install upgrade command is:

install upgrade source repository version version [rpm]

You can use the install upgrade command when:

• The version number is specified

The base software (.mini) is upgraded to the specified version; all installed RPMs are upgraded to thesame release version.install upgrade source [repository] version 6.2.2

• The version number for an RPM is specified

When performing a system upgrade, the user can choose to have an optional RPM to be of a differentrelease (from that of the base software version); that RPM can be specified.install upgrade source [repository] version 6.2.2 ncs5500-mpls-1.0.2.0-r623.x86_64.rpm

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 9

Manage Automatic DependencyUpgrade Base Software Version

Page 16: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers10

Manage Automatic DependencyUpgrade Base Software Version

Page 17: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

C H A P T E R 4Customize Installation using Golden ISO

Golden ISO (GISO) is a customized ISO that a user can build to suit the installation requirement. The usercan customize the installable image to include the standard base image with the basic functional components,and add additional RPMs, SMUs and configuration files based on requirement.

The ease of installation and the time taken to seamlessly install or upgrade a system plays a vital role in acloud-scale network. An installation process that is time-consuming and complex affects the resiliency andscale of the network. The GISO simplifies the installation process, automates the installation workflow, andmanages the dependencies in RPMs and SMUs automatically.

GISO is built using a build script gisobuild.py available on the box in /pkg/bin location in XR domain.For more information about the build script and the steps to build GISO, see Build Golden ISO, on page13.

When a system boots with GISO, additional SMUs and RPMs in GISO are installed automatically, and therouter is pre-configured with the XR configuration in GISO. For more information about downloading andinstalling GISO, see Install Golden ISO, on page 17.

The capabilities of GISO can be used in the following scenarios:

• Migration from IOS XR 32-bit to IOS XR 64-bit

• Initial deployment of the router

• Software disaster recovery

• System upgrade from one base version to another

• System upgrade from same base version but with additional SMUs

• Install update to identify and update dependant packages

• Limitations, page 12

• Golden ISO Workflow, page 13

• Build Golden ISO, page 13

• Install Golden ISO, page 17

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 11

Page 18: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

LimitationsThe following are the known problems and limitations with the customized ISO:

• Building and booting GISO for asynchronous package (a package of different release than the ISO) isnot supported.

• GISO build script gisobuild.py does not support verifying the XR configuration.

• Renaming a GISO build and then installing from the renamed GISO build is not supported.

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers12

Customize Installation using Golden ISOLimitations

Page 19: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Golden ISO WorkflowThe following image shows the workflow for building and installing golden ISO.

Figure 4: Golden ISO Workflow

Build Golden ISOThe customized ISO is built using Cisco Golden ISO (GISO) build script gisobuild.py available on the boxin /pkg/bin location in XR domain.

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 13

Customize Installation using Golden ISOGolden ISO Workflow

Page 20: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

The GISO build script supports automatic dependency management, and provides these functionalities:

• Builds RPM database of all the packages present in package repository.

• Skips and removes Cisco RPMs that do not match the mini-x.iso version.

• Skips and removes third-party RPMs that are not SMUs of already existing third-party base package inmini-x.iso.

• Displays an error and exits build process if there are multiple base RPMs of same release but differentversions.

• Performs compatibility check for all the RPMs.

To build GISO, provide the following input parameters to the script:

• Base mini-x.iso (mandatory)

• XR configuration file (optional)

• one or more Cisco-specific SMUs for host, XR and System admin

• one or more third-party SMUs for host, XR and System admin

• Label for golden ISO

Golden ISO can be built only from mini ISO. The full or fullk9 bundle ISO is not supported.Note

Use the following naming convention when building GISO:ExampleFormatGISO Build

<platform-name>-golden-x64.iso-<version>.v1

<platform-name>-golden-x64-<version>.iso.v1

<platform-name>-golden-x.iso-<version>.<label>

<platform-name>-golden-x-<version>.iso.<label>

GISO withoutk9sec RPM

<platform-name>-goldenk9-x64.iso-<version>.v1

<platform-name>-goldenk9-x64-<version>.iso.v1

<platform-name>-goldenk9-x.iso-<version>.<label>

<platform-name>-goldenk9-x-<version>.iso.<label>GISO with k9secRPM

To successfully add k9sec RPM to GISO, change the permission of the file to 644 using the chmodcommand.chmod 644 [k9 sec rpm]

Note

To build GISO, perform the following steps:

Before You Begin

• To upgrade from non-GISO to GISO version, it is mandatory to first upgrade to mini ISO with GISOsupport. For NCS 5500 series routers, upgrade to release 6.2.2 or later.

• The system where GISO is built must meet the following requirements:

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers14

Customize Installation using Golden ISOBuild Golden ISO

Page 21: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

System must have Python version 2.7 and later.•

• System must have free disk space of minimum 3 to 4 GB.

• Verify that the Linux utilities mount, rm, cp, umount, zcat, chroot, mkisofs are present in thesystem. These utilities will be used by the script. Ensure privileges are available to execute all ofthese Linux commands.

• Kernel version of the system must be later than 3.16 or later than the version of kernel of CiscoISO.

• Verify that a libyaml rpm supported by the Linux kernel is available to successfully import yaml

in the tool.

• User should have proper permission for security rpm(k9sec-rpm) in rpm repository, else securityrpm would be ignored for Golden ISO creation.

Step 1 From the XR prompt, find the directory path of the build script gisobuild.py.Router# run ls -l /pkg/bin

Step 2 Copy the script gisobuild.py from the router to an offline system or external server where the GISO will be built.Ensure that this system meets the pre-requisites described above in the Before You Begin section.a) Go to shell prompt of IOS XR and copy the script gisobuild.py to harddisk:

Router#runMon Jul 10 13:14:43.606 UTC[Router]$cp /pkg/bin/gisobuild.py /harddisk\:/[Router]$exitlogout

b) Go to EXEC mode of IOS XR and check the script gisobuild.py in harddisk:

Router#dir harddisk:/ | inc gisobuild.pyMon Jul 10 13:15:20.542 UTC

13 -rwxr-xr-x 1 77203 Jul 10 13:14 gisobuild.py

c) Copy the script gisobuild.py from harddisk:/ to any desired location (outside the router where ISO will be built)that is supported. Use any of the supported protocol.Router#copy harddisk:/ ?WORD Copy to fileapphost: Copy to apphost: file systemconfig: Copy to config: file systemdisk0: Copy to disk0: file systemftp: Copy to ftp: file systemharddisk: Copy to harddisk: file systemhttp: Copy to http: file systemhttps: Copy to https: file systemlocation location to copy fromrootfs: Copy to rootfs: file systemrunning-config Update (merge with) current system configurationtftp: Copy to tftp: file system

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 15

Customize Installation using Golden ISOBuild Golden ISO

Page 22: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

The following example shows the script copied from one harddisk to another with a new name gisobuild_new.py:

Router#copy harddisk:/gisobuild.py harddisk:/gisobuild_new.pyMon Jul 10 13:19:28.912 UTCDestination filename [/harddisk:/gisobuild_new.py]?CCCCC77203 bytes copied in 0 secRouter#dir harddisk:/ | inc gisobuild_new.pyMon Jul 10 13:19:48.557 UTC

14 -rwxr-xr-x 1 77203 Jul 10 13:19 gisobuild_new.py

Step 3 Use the script gisobuild.py and provide parameters to build the golden ISO off the router:The -i option is mandatory, and either or both -r or -c options must be provided.Note

NCS5500 routers has two types of cards - x86_64 and arm. System Admin runs on both types of cards, whereasXR runs only on x86_64 card.

Note

[directory-path]$ gisobuild.py [-h] [-i <mini-x.iso>] [-r <rpm repository>][-c <config-file>] [-l <giso label>] [-m] [-v]

System requirements check [PASS]

Platform: ncs5500 Version: 6.2.2

Scanning repository [repository-path]...

Building RPM Database...Total 3 RPM(s) present in the repository path provided in CLI

Following XR x86_64 rpm(s) will be used for building Golden ISO:

(+) ncs5500-mgbl-3.0.0.0-r622.x86_64.rpm

...RPM compatibility check [PASS]

Following SYSADMIN x86_64 rpm(s) will be used for building Golden ISO:

(+) ncs5500-sysadmin-system-6.2.2-r622.CSCcv44444.x86_64.rpm

Following SYSADMIN arm rpm(s) will be used for building Golden ISO:

(+) ncs5500-sysadmin-system-6.2.2-r622.CSCcv44444.arm.rpm

...RPM compatibility check [PASS]

Building Golden ISO...Summary .....

XR rpms:ncs5500-mgbl-3.0.0.0-r622.x86_64.rpm

SYSADMIN rpms:ncs5500-sysadmin-system-6.2.2-r622.CSCcv44444.x86_64.rpmncs5500-sysadmin-system-6.2.2-r622.CSCcv44444.arm.rpm

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers16

Customize Installation using Golden ISOBuild Golden ISO

Page 23: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

...Golden ISO creation SUCCESS.

Golden ISO Image Location: <directory-path>/ncs5500-golden-x.iso-6.2.2

Detail logs: <directory-path>/Giso_build.log-2017-07-10:18:17:43.395586

where:

• -i is the path to mini-x.iso

• -r is the path to RPM repository

• -c is the path to XR config file

• -l is the golden ISO label

• -h shows the help message

• -v is the version of the build tool gisobuild.py

• -m is to build the migration tar to migrate from IOS XR to IOS XR 64 bit

GISO is built with the RPMs placed in respective folders in the specified directory and also includes the log filesgiso_summary.txt and gisobuild.log-<timestamp>. The XR configuration file is placed as router.cfg in the directory.

The GISO script does not support verification of XR configuration.Note

What to Do Next

Install the golden ISO on the router.

Install Golden ISOGolden ISO (GISO) automatically performs the following actions:

• Installs host and system admin RPMs.

• Partitions repository and TFTP boot on RP.

• Creates software profile in system admin and XR modes.

• Installs XR RPMs. Use show instal active command to see the list of RPMs.

• Applies XR configuration. Use show running-config command in XR mode to verify.

Step 1 Download GISO image to the router using one of the following options:

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 17

Customize Installation using Golden ISOInstall Golden ISO

Page 24: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

• PXE boot: when the router is booted, the boot mode is identified. After detecting PXE as boot mode, all availableethernet interfaces are brought up, and DHClient is run on each interface. DHClient script parses HTTP or TFTPprotocol, and GISO is downloaded to the box.

• System Upgrade when the system is upgraded, GISO can be installed using install add, install activate, or usinginstall update commands.

• system upgrade from a non-GISO (image that does not support GISO) to GISO image: If a system isrunning a version1 with an image that does not support GISO, the system cannot be upgraded directly toversion2 of an image that supports GISO. Instead, the version1 must be upgraded to version2 mini ISO, andthen to version2 GISO.

• system upgrade in a release from version1 GISO to version2 GISO: If both the GISO images have thesame base version but different labels, install add and install activate commands does not support sameversion of two images. Instead, using install update command installs only the delta RPMs. System reloadis based on restart type of the delta RPMs.

Router#install update source <path-to-image> <platform-name-goldenk9-x64.iso-6.2.2>

Sat Dec 3 15:51:43.384 UTC

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

ISO <platform-name-goldenk9-x64.iso-6.2.2> in input package list. Going to upgrade thesystem to version 6.2.2.

Updating contents of golden ISO

Scheme : localdisk

Hostname : localhost

Username : None

SourceDir : Dir

Collecting software state..

Fetching .... <ncs5500-name-goldenk9-x64.iso-6.2.2.v2>

LC/0/0/CPU0:Dec 3 15:53:41.580 : %PLATFORM-STATS_INFRA-3-ERR_STR_1 : ErrStr:Unable to mapstats infra shared mem

Skipping openssh-scp-6.6p1.p1-r0.0.CSCtp12345.host.x86_64.rpm from GISO as it's active

Skipping <platform-name>-sysadmin-system-6.2.2-r622.CSCcv11111.x86_64.rpm from GISO as it'sactive

Skipping openssh-scp-6.6p1.p1-r0.0.CSCtp12345.admin.x86_64.rpm from GISO as it's active

Skipping openssh-scp-6.6p1-r0.0.host.x86_64.rpm from GISO (skipped SMUs base pkg)

Adding packages

<platform-name>-sysadmin-shared-6.2.2-r622.CSCcv33333.x86_64.rpm

<platform-name>-mpls-te-rsvp-x64-1.2.0.0-r622.x86_64.rpm

Router:Dec 3 15:54:12.308 : sdr_instmgr[1145]: %INSTALL-INSTMGR-2-OPERATION_SUCCESS :Install operation 1 finished successfully

Dec 03 15:54:03 Install operation 1 started by root:

install add source /misc/disk1/install_tmp_staging_area/6.2.2ncs5500-sysadmin-shared-6.2.2-r622.CSCcv33333.x86_64.rpmncs5500-mpls-te-rsvp-x64-1.2.0.0-r622.x86_64.rpm

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers18

Customize Installation using Golden ISOInstall Golden ISO

Page 25: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Dec 03 15:54:05 Install operation will continue in the background

Dec 03 15:54:13 Install operation 1 finished successfully

------Truncated

• system upgrade across releases from version1 GISO to version2 GISO: Both the GISO images havedifferent base versions. Use install add and install activate commands, or install update command to performthe system upgrade. The router reloads after the upgrade with the version2 GISO image.install update source <path-to-image> <platform-name-goldenk9-x64.iso-6.2.2.opt

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ISO <platform-name-goldenk9-x64.iso-6.2.2.opt> in input package list. Going to upgrade thesystem to version 6.2.2.Scheme : localdiskHostname : localhostUsername : NoneSourceDir : DirCollecting software state..Getting platformGetting supported architectureGetting active packages from XRGetting inactive packages from XRGetting list of RPMs in local repoGetting list of provides of all active packagesGetting provides of each rpm in repoGetting requires of each rpm in repoLC/0/0/CPU0: fab_si[193]: %PLATFORM-STATS_INFRA-3-ERR_STR_1 : ErrStr:Unable to map statsinfra shared memFetching .... <platform-name-goldenk9-x64.iso-6.2.2.opt>Adding packages

<platform-name>-goldenk9-x64.iso-6.2.2.opt.......July 4 08:17:07 Install operation 2 started by root:install add source <path>/6.2.2 <platform-name>-goldenk9-x64.iso-6.2.2.optJuly 4 08:17:08 Install operation will continue in the backgroundJuly 4 08:26:43 Install operation 2 finished successfully

Install add operation successfulActivating <platform-name>-goldenk9-x64-6.2.2July 4 08:26:49 Install operation 3 started by root:install activate pkg <platform-name>-goldenk9-x64-6.2.2

July 4 08:26:49 Package list:July 4 08:26:49 <platform-name>-goldenk9-x64-6.2.2This install operation will reload the sdr, continue?[yes/no]:[yes] Install operation will continue in the background------Truncated

Step 2 Run the show install repository all command in System Admin mode to view the RPMs and base ISO for host, systemadmin and XR.sysadmin-vm:0_RP0# show install repository allAdmin repository---------------------ncs5500-sysadmin-6.2.2ncs5500-sysadmin-hostos-6.2.2-r622.CSCcv10001.admin.x86_64ncs5500-sysadmin-hostos-6.2.2-r622.CSCcv10001.admin.armncs5500-sysadmin-system-6.2.2-r622.CSCcv10005.x86_64ncs5500-sysadmin-system-6.2.2-r622.CSCcv10005.arm....XR repository------------------ncs5500-iosxr-mgbl-3.0.0.0-r622.x86_64ncs5500-xr-6.2.2

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 19

Customize Installation using Golden ISOInstall Golden ISO

Page 26: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

....Host repository---------------------host-6.2.2

Step 3 Run the show install package <golden-iso> command to display the list of RPMs, and packages built in GISO.

Router#show install package ncs5500-goldenk9-x64-6.2.2

This may take a while ...ISO Name: ncs5500-goldenk9-x64-6.2.2ISO Type: bundleISO Bundled: ncs5500-mini-x64-6.2.2Golden ISO Label: tempISO Contents:

ISO Name: ncs5500-xr-6.2.2ISO Type: xrrpms in xr ISO:

iosxr-os-ncs5500-64-5.0.0.0-r622iosxr-ce-ncs5500-64-3.0.0.0-r622iosxr-infra-ncs5500-64-4.0.0.0-r622iosxr-fwding-ncs5500-64-4.0.0.0-r622iosxr-routing-ncs5500-64-3.1.0.0-r6122

ISO Name: ncs5500-sysadmin-6.2.2ISO Type: sysadminrpms in sysadmin ISO:

ncs5500-sysadmin-topo-6.2.2-r622ncs5500-sysadmin-shared-6.2.2-r622ncs5500-sysadmin-system-6.2.2-r622ncs5500-sysadmin-hostos-6.2.2-r622.admin

...

ISO Name: host-6.2.2ISO Type: hostrpms in host ISO:

ncs5500-sysadmin-hostos-6.2.2-r622.host

Golden ISO Rpms:xr rpms in golden ISO:

ncs5500-k9sec-x64-2.2.0.1-r622.CSCxr33333.x86_64.rpmopenssh-scp-6.6p1.p1-r0.0.CSCtp12345.xr.x86_64.rpmopenssh-scp-6.6p1-r0.0.xr.x86_64.rpmncs5500-mpls-x64-2.1.0.0-r622.x86_64.rpmncs5500-k9sec-x64-2.2.0.0-r622.x86_64.rpm

sysadmin rpms in golden ISO:ncs5500-sysadmin-system-6.2.2-r622.CSCcv11111.x86_64.rpmncs5500-sysadmin-system-6.2.2-r622.CSCcv11111.arm.rpmopenssh-scp-6.6p1-r0.0.admin.x86_64.rpmopenssh-scp-6.6p1-r0.0.admin.arm.rpmopenssh-scp-6.6p1.p1-r0.0.CSCtp12345.admin.x86_64.rpmopenssh-scp-6.6p1.p1-r0.0.CSCtp12345.admin.arm.rpmncs5500-sysadmin-hostos-6.2.2-r622.CSCcv10001.admin.x86_64.rpm

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers20

Customize Installation using Golden ISOInstall Golden ISO

Page 27: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

ncs5500-sysadmin-hostos-6.2.2-r622.CSCcv10001.admin.arm.rpm

host rpms in golden ISO:openssh-scp-6.6p1-r0.0.host.x86_64.rpmopenssh-scp-6.6p1-r0.0.host.arm.rpmopenssh-scp-6.6p1.p1-r0.0.CSCtp12345.host.x86_64.rpmopenssh-scp-6.6p1.p1-r0.0.CSCtp12345.host.arm.rpm

The ISO, SMUs and packages in GISO are installed on the router.

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers 21

Customize Installation using Golden ISOInstall Golden ISO

Page 28: Flexible Packaging Configuration Guide for Cisco NCS …Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers First Published: 2015-12-23 Last Modified: 2017-09-15

Flexible Packaging Configuration Guide for Cisco NCS 5500 Series Routers22

Customize Installation using Golden ISOInstall Golden ISO


Recommended