Einrichten eines Repositorys für die Installation von Vorgängen in IOS XR7 und für den Upgrade-Prozess

Einleitung

In diesem Dokument werden Upgrades der Cisco IOS^® XR 7-Softwareversionen und die Installation mithilfe eines Repositorys beschrieben.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco IOS XR-Software
• Cisco IOS XR Software-Installations- und Upgrade-Verfahren

Verwendete Komponenten

Dieses Dokument ist nicht auf bestimmte Hardwareversionen beschränkt. Es gilt für alle Router mit IOS XR7.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Verwandte Produkte

IOS XR7, auch Lindt genannt, ist eine Weiterentwicklung der XR-Software, die auf einer Linux 9-Distribution aufbaut.

Eine wichtige Änderung ist die vollständige Entfernung der Administrationsebene. Darüber hinaus werden die IOS XR-Prozesse auf Kontrollebene jetzt nativ auf dem Host ausgeführt.

Dieses Dokument gilt derzeit für die folgenden Hardware-Geräte:

• Cisco Router der Serie 540
• Router der Serie 8000
• Cisco NCS 57B1 Router

IOS XR7-Installationserweiterung.

Um Pakete (RPM), Code-Upgrades und Updates in XR7 zu installieren, benötigen Sie ein RPM-Repository, aus dem der Router die RPMs für die Installation herunterladen kann. Das Repository kann sich lokal am Router befinden oder per Remote-Zugriff über FTP, HTTP oder HTTPS aufgerufen werden.

Wir haben eine Reihe von Befehlen, die uns in verschiedenen Szenarien und bei allen Installationsaktivitäten in XR7 helfen können.

Installationsaustausch	Upgrade auf eine neue Version
Installationsquelle	Fehlerbehebungs-RPMs zwischen Versionen und optionalen Paketen installieren
installieren/übernehmen	Änderungen bestätigen, um das erneute Laden aufrechtzuerhalten
show install active	Aktive Pakete anzeigen
show install Committed	Bestätigte Pakete anzeigen
Installationsanfrage anzeigen	Anzeigen des Installationsstatus
show version	Status der aktuellen Installationsversion anzeigen

Die derzeit aktive Software kann auf Ihrem System durch die Software eines bestimmten ISO-Image oder Golden ISO (GISO)-Image ersetzt werden. Für das Upgrade auf die neue Software sind nur minimale Änderungen erforderlich. Pakete werden nicht entfernt und neu installiert, wenn sie den gleichen Namen und die gleiche Version haben.

• Erstellen Sie ein Repository für den Zugriff auf Dateien:

RP/0/RP0/CPU0:R0(config)# install repository local-repo | remote-repo

• Aktualisieren Sie die Version:

RP/0/RP0/CPU0:R0(config)# install package replace

• Effektive Konfiguration:

RP/0/RP0/CPU0:R0# install apply {reload | restart} [noprompt]

• Bestätigen (Installation dauerhaft machen):

RP/0/RP0/CPU0:R0# install commit

Konfigurieren

In diesem Abschnitt wird beschrieben und erläutert, wie ein Repository auf dem Router konfiguriert wird. Es wird empfohlen, dass der HTTP/FTP-Server bereits erstellt wurde und funktionsfähig ist.

Remote-Repository

Wenn auf das Repository remote zugegriffen wird, müssen Sie eine Repository-URL angeben, von der die Installationsdateien abgerufen werden. Die URL enthält:

• IP-Adresse des Servers

• Portnummer des Servers

• (Optional) VRF-Name (Virtual Routing and Forwarding)

Das Repository kann so konfiguriert werden, dass es mithilfe einer nicht standardmäßigen VRF-Tabelle erreichbar ist. Wenn das Repository über eine Adresse in einer VRF-Instanz erreichbar ist, geben Sie den Namen der VRF-Instanz an.

Das Format der Repository-URL ist wie folgt:

• FTP: ftp://<Server>[;<VRF>]/<Pfad zum Repository>
• HTTP: http://<server>[;<vrf>]/<Pfad zum Repository>
• HTTPS: https://<Server>[;<VRF>]/<Pfad zum Repository>
• Lokal: file:///<Pfad zum Repository>. Der Pfad zum Projektarchiv muss sich unter /harddisk:/ befinden.

Konfigurieren Sie das Remote-Repository auf dem Router.

RP/0/RP0/CPU0:R0# configure
RP/0/RP0/CPU0:R0(config)# install repository remote_repo url http://192.168.122.1/
RP/0/RP0/CPU0:R0(config)# commit
RP/0/RP0/CPU0:R0(config)# end
RP/0/RP0/CPU0:R0#

Wie bereits erwähnt, ist es zwingend erforderlich, eine Repository-URL bereitzustellen, von der die Installationsdateien abgerufen werden.

• Überprüfen Sie die Korrekturen, die in unserem Remote-Repository oder einem zuvor konfigurierten Repository verfügbar sind.

RP/0/RP0/CPU0:R0#sh install fixes available 
Wed Jan 31 22:32:39.477 UTC
Trying to access repositories...

Available Fixes (count: 1):
Bug Id      Packages                                                    Repository                               Cached
----------- ----------------------------------------------------------- ---------------------------------------- ------
CSCvz57398        xr-ospf-7.3.2v1.0.1-1                                       remote_repo     

Installationsvorgang

RP/0/RP0/CPU0:R0#install package upgrade xr-ospf-7.3.2v1.0.1-1 synchronous
Wed Jan 31 22:34:16.220 UTC
Starting:
install package upgrade xr-ospf-7.3.2v1.0.1-1
Packaging operation 1.1.1
Press Ctrl-C to return to the exec prompt. This will not cancel the install operation

Current activity: Initializing ...
Current activity: Veto check ..
Current activity: Package add or other package operation ..

Packaging operation 1.1.1: 'install package upgrade xr-ospf-7.3.2v1.0.1-1' completed without error

Das Remote-Repository kann einige Protokolle des Routers anzeigen, der einige Dateien anfordert. In diesem Fall zeigt der HTTP-Server einige erfolgreiche HTTP-Anforderungen an.

HTTP-Serverprotokolle von Erfolgsanforderungen

Effektive Konfiguration

RP/0/RP0/CPU0:R0#sh install fixes active
Wed Jan 31 22:39:54.987 UTC
There are currently no fixes active.

RP/0/RP0/CPU0:R0#install apply
Wed Jan 31 22:40:16.628 UTC
Once the packaging dependencies have been determined, the install operation may have to reload the system.
If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'.
Continue? [yes/no]:[yes] yes
Install apply operation 1.1 has started
Install operation will continue in the background

Mitshow install requestBefehl kann der Fortschritt der Installation überwacht werden. Bei der zweiten Ausführung des Befehls ist die Installationsanforderung bereits abgeschlossen.

RP/0/RP0/CPU0:R0#sh install request
Wed Jan 31 22:41:07.649 UTC

User request: install apply restart
Operation ID: 1.1
State: In progress since 2024-01-31 22:40:19 UTC

Current activity: Apply by restarting processes
Next activity: Await user input
Time started: 2024-01-31 22:40:19

No per-location information.


RP/0/RP0/CPU0:R0#sh install request
Wed Jan 31 22:43:51.577 UTC

User request: install apply restart
Operation ID: 1.1
State: Success since 2024-01-31 22:41:10 UTC <<<<

Current activity: Await user input
Time started: 2024-01-31 22:41:10

 An diesem Punkt ist fix aktiv, aber nicht persistent.

RP/0/RP0/CPU0:R0#sh install fixes active 
Wed Jan 31 22:46:33.940 UTC

Active Fixes (count: 1):
Bug Id      Packages                                                   
----------- -----------------------------------------------------------
CSCvz57398        xr-ospf-7.3.2v1.0.1-1   

Installieren/Übernehmen

An diesem Punkt, nach dem Commit der Installation und erhalten 0 Fehler, Installation abgeschlossen ist.

RP/0/RP0/CPU0:R0#install commit synchronous
Wed Jan 31 22:47:38.676 UTC
Starting:
install commit
Transaction 1
Press Ctrl-C to return to the exec prompt. This will not cancel the install operation

Current activity: Initializing
Current activity: Commit transaction .

Transaction 1: 'install commit' completed without error
RP/0/RP0/CPU0:R0#

Lokales Repository

Der Router kann als Repository zum Hosten der RPMs dienen. Sie müssen ein Root-lr-Benutzer mit Zugriff auf die Router-Shell sein. Ein Remote-Repository ist die empfohlene Methode für den Zugriff auf die RPMs. Wenn jedoch das Remote-Repository nicht die bevorzugte Option ist, können Sie den Router als Repository für das Hosten der RPMs verwenden.

Die Methode des lokalen Repositorys ist fast identisch mit der des Remote-Repositorys, weist jedoch anfänglich geringfügige Unterschiede auf.

Voraussetzungen

Pakete müssen sich auf der Festplatte befinden, um sie unserem Repository hinzuzufügen.

Beispiel für die nächste TAR-Datei:

RP/0/RP0/CPU0:R0#dir harddisk: 
Wed Jan 31 23:07:15.476 UTC

Directory of harddisk:
     12 -rw-rw-rw-. 1 8388681 Jan 31 22:55 nvgen_bkup.log
2097153 drwxrwxrwx. 2    4096 Jan 31 22:19 .sppdc
 524289 drwxrwxrwx. 3    4096 Oct 18  2021 mirror
2228225 drwxrwxrwx. 2    4096 Oct 18  2021 .sppdc_new
3932161 drwxrwxrwx. 3    4096 Oct 18  2021 ztp
3276801 drwxr-xr-x. 3    4096 Jun 16  2022 pam
     13 -rw-rw-rw-. 1     600 Jan 31 22:18 debug_shell_client.log
3407873 drwxrwxrwx. 2    4096 Oct 18  2021 shutdown
1835009 drwxrwxrwx. 2    4096 Oct 18  2021 nvram
     14 -rw-r--r--. 1  911360 Jan 31 23:06 8000-optional-rpms.7.3.2.tar  <<<<<<<
 262145 drwxr-xr-x. 2    4096 Jun 16  2022 showtech
     11 drwx------. 2   16384 Oct 18  2021 lost+found
 655361 drwx------. 3    4096 Jan 31 22:20 ima
     15 -rw-rw-rw-. 1       2 Jan 31 22:25 feature_list
 786433 drwxrwxrwx. 2    4096 Jun 16  2022 dumper
1048577 drwxrwxrwx. 5    4096 Jan 31 22:24 cisco_support
3145729 drwxrwxrwx. 2    4096 Jan 31 22:18 npu_sdk_logs

65908476 kbytes total (62474792 kbytes free)
RP/0/RP0/CPU0:R0#

Es wird empfohlen, die Starterfunktion für die Datei in der Shell des Routers aufzuheben.

RP/0/RP0/CPU0:R0#run
Wed Jan 31 23:08:20.380 UTC
[node0_RP0_CPU0:/]$cd harddisk\:
[node0_RP0_CPU0:/harddisk:]$tar -xvf 8000-optional-rpms.7.3.2.tar

Lokales Repository konfigurieren

RP/0/RP0/CPU0:R0# configure 
RP/0/RP0/CPU0:R0(config)# install repository local-repo url file:///harddisk:/optional-rpms
RP/0/RP0/CPU0:R0(config)# commit
RP/0/RP0/CPU0:R0(config)# end
RP/0/RP0/CPU0:R0#

Validiert die Pakete, die dem lokalen Repository hinzugefügt wurden

RP/0/RP0/CPU0:R0#sh install available  
Wed Jan 31 23:14:52.788 UTC
Trying to access repositories...

Package                                              Architecture                         Version Repository                          Cached
---------------------------------------------------- ---------------- --------------------------- ----------------------------------- ------
xr-cdp                                               x86_64                         7.3.2v1.0.0-1 local-repo                                
xr-healthcheck                                       x86_64                         7.3.2v1.0.0-1 local-repo                                
xr-telnet                                            x86_64                         7.3.2v1.0.0-1 local-repo                                
RP/0/RP0/CPU0:R0#

Installationsvorgang

Um zu überprüfen, ob es sich um den gleichen Prozess wie bei der Remote-Repository-Option handelt, können wir versuchen, eines dieser Pakete zu installieren, z. B. Telnet One.

RP/0/RP0/CPU0:R0#install source local-repo xr-telnet
Wed Jan 31 23:20:28.252 UTC
Once the packaging dependencies have been determined, the install operation may have to reload the system.
If you want to control the timing of system reload, you must not continue, but use the 'install package add' command instead, followed by 'install apply'.
Continue? [yes/no]:[yes] yes
Install source operation 3.1 has started
Install operation will continue in the background
RP/0/RP0/CPU0:R0#sh install request 
Wed Jan 31 23:24:45.907 UTC

User request: install source local-repo xr-telnet
Operation ID: 3.1
State:        Success since 2024-01-31 23:22:58 UTC

Konfiguration aktivieren und Installation bestätigen

Wie bei der Remote-Methode müssen wir den ausführen, um dieinstall applyKonfiguration wirksam zu machen undinstall commitum die Installation dauerhaft zu machen. Verwenden Sie den nächsten Befehl, um die korrekte Installation von Paketen zu überprüfen.

RP/0/RP0/CPU0:R0#sh install committed summary 
Wed Jan 31 23:28:15.923 UTC
Committed Packages: XR: 181    All: 1283
Label:              7.3.2
Software Hash:      bfe1bf8477ebb422e0eaf5c23358fcb1

Optional Packages                                                        Version
---------------------------------------------------- ---------------------------
xr-8000-mcast                                                      7.3.2v1.0.0-1
xr-8000-netflow                                                    7.3.2v1.0.0-1
xr-bgp                                                             7.3.2v1.0.0-1
xr-ipsla                                                           7.3.2v1.0.0-1
xr-is-is                                                           7.3.2v1.0.0-1
xr-lldp                                                            7.3.2v1.0.0-1
xr-mcast                                                           7.3.2v1.0.0-1
xr-mpls-oam                                                        7.3.2v1.0.0-1
xr-netflow                                                         7.3.2v1.0.0-1
xr-ospf                                                            7.3.2v1.0.0-1
xr-perfmgmt                                                        7.3.2v1.0.0-1
xr-telnet                                                          7.3.2v1.0.0-1  <<<<<<
xr-track                                                           7.3.2v1.0.0-1
RP/0/RP0/CPU0:R0#