Build Golden ISO
The customized ISO is built using Cisco Golden ISO (GISO) build script gisobuild.py
available on the github location https://github.com/ios-xr/gisobuild.
-
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 in mini-x.iso.
-
Displays an error and exits build process if there are multiple base RPMs of same release but different versions.
-
Performs compatibility check and dependency check for all the RPMs. For example, the child RPM is dependent on the parent RPM . If only the child RPM is included, the Golden ISO build fails.
-
Base mini-x.iso (mandatory)
-
XR configuration file (optional)
-
one or more Cisco-specific SMUs for host, XR and System admin (mandatory)
-
one or more third-party SMUs for host, XR and System admin (mandatory)
-
Label for golden ISO (optional)
![]() Note |
Golden ISO can be built only from mini ISO. The full or fullk9 bundle ISO is not supported. |
GISO Build |
Format |
Example |
---|---|---|
GISO without k9sec RPM |
|
<platform-name>-golden-x64.iso-<version>.v1 <platform-name>-golden-x64-<version>.iso.v1 |
GISO with k9sec RPM |
|
<platform-name>-goldenk9-x64.iso-<version>.v1 <platform-name>-goldenk9-x64-<version>.iso.v1 |
![]() Note |
To successfully add k9sec RPM to GISO, change the permission of the file to 644 using the
chmod
command.
|
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 GISO support.
-
The system where GISO is built must meet the following requirements: -
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 the system. These utilities will be used by the script. Ensure privileges are available to execute all of these Linux commands. -
Kernel version of the system must be later than 3.16 or later than the version of kernel of Cisco ISO.
-
Verify that a
libyaml rpm
supported by the Linux kernel is available to successfullyimport yaml
in the tool. -
User should have proper permission for security rpm(k9sec-rpm) in rpm repository, else security rpm would be ignored for Golden ISO creation.
-
-
The system from where the gisobuild script is executed must have root credentials.
Procedure
Step 1 |
Copy the script |
||
Step 2 |
Run the script
The following example shows the script output:
GISO is built with the RPMs placed in respective folders in the specified directory and also includes the log files |
![]() Note |
The GISO script does not support verification of XR configuration. |
What to do next
Install the golden ISO on the router.