SD-WAN-controllers upgraden met vManage GUI of CLI
Inhoud
Inleiding
In dit document wordt beschreven hoe de SD-WAN-controllers (Software-Defined Wide Area Network) worden bijgewerkt.
Voorwaarden
Vereisten
Cisco raadt kennis van de volgende onderwerpen aan:
- Cisco Software-defined Wide Area Network (SD-WAN)
- Cisco Software Central
- Download de Controllers software van software.cisco.com
- Voer het AURA-script uit vóór de upgrade CiscoDevNet/sure: SD-WAN Upgrade Readiness Experience
Er kunnen meerdere redenen zijn om een Controllers-upgrade te plannen, zoals:
- Nieuwe releases met nieuwe features.
- Fix van bekende caveats / bugs.
- Uitgestelde releases.
Wanneer het tijd is om uw controllers te upgraden, overweeg dan de volgende nuttige informatie:
- Controleer de Release Notes van de SD-WAN-controllers.
- Controleer de Cisco vManage-upgradepaden.
- Controleer of de Cisco SD-WAN-controllers voldoen aan de aanbevolen computerbronnen.
- Verifieer de eindlevenscyclus en eindverkoopberichten van de SD-WAN-producten.
Gebruikte componenten
Dit document is gebaseerd op de volgende softwareversies:
- Cisco vManage 20.12.6 en 20.15.4.1
- Cisco vBond en vSmart 20.12.16 en 20.15.4.1
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.
Vooraf uit te voeren controles voorafgaand aan een Controller-upgrade
Back-up maken van uw vManage
- Als de cloud wordt gehost, bevestigt u dat de laatste back-up is gemaakt of start u een back-up van db config zoals vermeld in de volgende stap.
- U kunt de huidige back-ups bekijken en een momentopname op aanvraag activeren vanuit het SSP-portaal. Vind hier meer begeleiding.
- Indien in gebruik:
- Maak een config-db back-up
- VM-momentopname van alle controllers.
vManage# request nms configuration-db backup path /home/admin/db_backup
successfully saved the database to /home/admin/db_backup.tar.gz
- Als u on-prem bent, verzamelt u de show running-config en slaat u deze lokaal op.
- Indien on-prem, zorg ervoor dat u uw configuratie-db (neo4j) gebruikersnaam en wachtwoord kent en noteer uw exacte huidige versie.
Als u hulp nodig hebt om uw configuratie-db-referenties op te halen, kunt u contact opnemen met Cisco TAC.
Systeemberekening op de vManage
Opmerking: deze controle is ook van toepassing op vBonds en vSmarts.
Voer op de CLI van elk vManage-knooppunt de opdracht systeemstatus weergeven uit. Zorg ervoor dat de vereiste computers zijn toegewezen aan de vManage-knooppunten. U kunt de Compute Guide raadplegen.
Voer een AURA-controle uit
- Download en volg de stappen om AURA uit te voeren vanaf CiscoDevNet/sure: SD-WAN Upgrade Readiness Experience
- Raadpleeg deze handleiding voor meer informatie: Aura-implementatie configureren vóór upgrade.
- Sta open voor een TAC SR om eventuele vragen in verband met de mislukte controles in het AURA-rapport te beantwoorden.
- Vanaf 20.11.x voert vManage automatisch AURA uit wanneer het image is geactiveerd met vManage UI.
Gebruik van schijfruimte vManage
Controleer voordat u de upgrade start of het schijfgebruik op alle drie de kritieke partities -/boot, /rootfs.rw en /opt/data- 60% of lager is.
Voor het opschonen zoekt en verwijdert u onnodige door de gebruiker gekopieerde bestanden of niet-gecomprimeerde logbestanden.
Verwijder alle admin-tech bestanden, heap dumps, Neo4j back-ups, thread dumps, of tijdelijke bestanden die schijfruimte verbruiken.
Als u niet zeker weet welke bestanden veilig kunnen worden verwijderd, opent u een Cisco TAC-hoesje voor hulp.
Zorg ervoor dat Verzenden naar Controllers/Verzenden naar vBond is voltooid
Op de vManage UI navigeert u naar Configuration --> Certificates --> Controllers en selecteert u verzenden naar vBond
Controleer het verzamelingsinterval voor vManage-statistieken
Cisco raadt het interval voor het verzamelen van statistieken aan in Beheer > Instellingen is ingesteld op de standaardtimer van 30 minuten.
Opmerking: Cisco raadt u aan uw vSmarts en vBonds vóór een upgrade aan de vManage-sjabloon te koppelen.
NMS Diagnostics verifiëren op alle vManage-knooppunten
Voer de opdracht "vraag alle diagnostiek voor nms" uit en zorg ervoor dat de NPing voor alle NMS-services succesvol is. In het geval van vManage-clusters moeten deze controles op alle vManage-knooppunten worden uitgevoerd:
Opmerking: in een vManage-cluster met zes knooppunten wordt configuratie-db alleen op drie knooppunten uitgevoerd.
Bekijk de diagnostiek voor configuratie-db:
Zorg ervoor dat we configuratie-db-attributen kunnen krijgen zoals hieronder:
Zorg ervoor dat alle vManage-knooppunten worden vermeld in Neo4j-clusterstatus voor zowel "neo4j" als "systeem"
Zorg ervoor dat de validatie van het schema succesvol is en dat geen van de Neo4j-knooppunten in quarantaine is geplaatst.
Ga door de hele output en als er fouten of storingen worden opgemerkt, neem dan contact op met TAC voordat u doorgaat met de upgrade.
Controleer het gebruik van schijfruimte op vManage-knooppunten
Zorg ervoor dat, behalve /rootfs.ro, geen van de andere schijfpartities meer dan 60% als gebruik heeft. Controleer dit op alle vManage-knooppunten.
Schijfruimte controleren op vSmart en vBond
Gebruik de opdracht df -kh | grep boot van vShell om de grootte van de schijf te bepalen.
controller:~$ df -kh | grep boot
/dev/sda1 2.5G 232M 2.3G 10% /boot
controller:~$ Als de grootte groter is dan 200 MB, gaat u verder met de upgrade van de controllers.
Als de grootte kleiner is dan 200 MB, voert u de volgende stappen uit:
1. Controleer of de huidige versie de enige is die wordt vermeld onder opdracht Software weergeven. Deze controle is van toepassing op alle drie de controllers, vManage, vBond en vSmart.
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
------------------------------------------------------------------------------
20.12.6 true true false auto 2023-05-02T16:48:45-00:00
20.9.1 false false true user 2023-05-02T19:16:09-00:00
2. Controleer of de huidige versie standaard is ingesteld onder opdracht softwareversie tonen. Deze controle is van toepassing op alle drie de controllers, vManage, vBond en vSmart.
controller# request software set-default 20.12.6
status mkdefault 20.11.1: successful
controller#
3. Als er meer versies worden vermeld, verwijdert u alle versies die niet actief zijn met de opdrachtaanvraagsoftware <versie>. Dit vergroot de beschikbare ruimte om door te gaan met de upgrade. Deze controle is van toepassing op alle drie de controllers, vManage, vBond en vSmart.
controller# request software remove 20.9.1
status remove 20.9.1: successful
vedge-1# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
------------------------------------------------------------------------------
20.12.6 true true false auto 2023-05-02T16:48:45-00:00
controller#
4. Controleer de schijfruimte om er zeker van te zijn dat deze groter is dan 200 MB. Als dit niet het geval is, gaat u verder met het openen van een TAC SR.
Voor en na commando's
Voor en na de upgrade voert u deze opdrachten uit om te controleren of de controllers naar behoren zijn geconvergeerd:
-
Controleverbindingen weergeven
Zorg ervoor dat elke controller actieve besturingsverbindingen heeft met alle andere controllers (volledig gaas). -
omp peers tonen (alleen vSmart)
Controleer het aantal OMP-peers op elke vSmart-controller. -
omp-overzicht weergeven (alleen vSmart)
Controleer de algemene OMP-status en peer-informatie.-
uitvoeringsbeleid weergeven (alleen vSmart)
Bevestig dat alle beoogde beleidsregels actief en zichtbaar zijn op de controller.Controleer de uitvoer van deze opdrachten zowel voor als na de upgrade om netwerkstabiliteit en goede convergentie te garanderen.
Werkstroom voor upgradecontrollers
vManage-clusterupgrade
In het geval van een clusterupgrade moeten de stappen die worden genoemd in de Cisco SD-WAN Getting Started Guide - Clusterbeheer [Cisco SD-WAN] - Cisco-gids worden gevolgd.
SD-WAN-controllers upgraden via vManage Graphic User Interface (GUI)
Stap 1. Upload de software-images naar de vManage-repository
Navigeer naar Software Download en download de vereiste installatiekopie van de softwareversie voor vManage.
Navigeer naar Software Download en download de afbeelding van de softwareversie voor vBond en vSmart.
Als u de nieuwe images wilt uploaden, gaat u naar Onderhoud > Softwarerepository > Softwareimages.
Klik op Nieuwe software toevoegen en selecteer vManage in het vervolgkeuzemenu.
Selecteer de afbeeldingen en klik op Uploaden.
Zodra de afbeeldingen zijn geüpload, controleert u of ze worden vermeld in Software Repository > Software Images.
Stap 2. Installatie, activering en nieuwe versie instellen als standaard
In deze stap wordt uitgelegd hoe u de upgrade in drie stappen kunt uitvoeren, installatie, activering en de nieuwe versie als standaard kunt instellen.
vManage
Stap A. Installatie
Ga in het hoofdmenu naar Onderhoud > Software-upgrade > vManage en klik op Upgrade.
Ga in het pop-upvenster Software-upgrade als volgt te werk:
- Kies het tabblad vManage.
- Selecteer de versie van het image waarnaar u wilt upgraden in de vervolgkeuzelijst Versie.
- Klik op Upgrade.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Stap B. Activering
In deze stap activeert vManage de nieuwe geïnstalleerde softwareversie en start het zichzelf opnieuw op om met de nieuwe software op te starten.
Ga naar Onderhoud > Software-upgrade > vManage en klik op Activeren.
Selecteer de nieuwe versie en klik op Activeren.
Log in en navigeer naar Maintenance > Software Upgrade > Manager om te controleren of de nieuwe versie is geactiveerd.
Stap C. Standaardsoftwareversie instellen
U kunt een softwareafbeelding instellen als de standaardimage op een Cisco SD-WAN-apparaat. Het wordt aanbevolen om het nieuwe image als standaard in te stellen nadat u hebt gecontroleerd of de software naar wens werkt op het apparaat en in het netwerk.
Als een fabrieksreset op het apparaat wordt uitgevoerd, wordt het apparaat opgestart met het image dat als standaard is ingesteld.
Ga als volgt te werk om een softwareafbeelding in te stellen als standaardimage:
- Navigeer naar Onderhoud > Software-upgrade > Manager > Software Image Actions.
- Klik op Standaardversie instellen, selecteer de nieuwe versie in de vervolgkeuzelijst en klik op Standaardversie instellen.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Ga naar Onderhoud > Software Upgrade > Manager om de standaardversie te controleren.
vBond
Stap A. Installatie
In deze stap stuurt vManage de nieuwe software naar vBond en installeert het nieuwe image.
Navigeer naar Onderhoud > Software-upgrade > Bedieningscomponenten en klik op Upgrade.
Ga in het pop-upvenster Software-upgrade als volgt te werk:
- Kies het tabblad Beheren.
- Selecteer de versie van het image waarnaar u wilt upgraden in de vervolgkeuzelijst Versie.
- Klik op Upgrade.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Stap B. Activering
In deze stap activeert vBond de nieuwe geïnstalleerde softwareversie en start zichzelf opnieuw op om op te starten met de nieuwe software.
Navigeer naar Onderhoud > Software-upgrade > Bedieningscomponenten en klik op Activeren.
Selecteer de nieuwe versie en klik op Activeren.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Nadat het proces is voltooid, navigeert u naar Onderhoud > Software-upgrade > Bedieningscomponenten om te controleren of de nieuwe versie is geactiveerd.
Optionele stap. De nieuwe softwareafbeelding activeren en opnieuw opstarten
Stap C. Standaardsoftwareversie instellen
U kunt een softwareafbeelding instellen als de standaardimage op een Cisco SD-WAN-apparaat. Het wordt aanbevolen om het nieuwe image als standaard in te stellen nadat u hebt gecontroleerd of de software naar wens werkt op het apparaat en in het netwerk.
Als een fabrieksreset op het apparaat wordt uitgevoerd, wordt het apparaat opgestart met het image dat als standaard is ingesteld.
Ga als volgt te werk om een softwareafbeelding in te stellen als standaardimage:
- Navigeer naar Onderhoud > Software-upgrade > Bedieningscomponenten > Software Image Actions.
- Klik op Standaardversie instellen, selecteer de nieuwe versie in de vervolgkeuzelijst en klik op Standaardversie instellen.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Als u de standaardversie wilt controleren, gaat u naar Onderhoud > Software-upgrade > Beheercomponenten.
vSmart
Richtlijnen voor het bijwerken van vSmart (Controller)
- Cisco raadt aan eerst 50% van de vSmart-controllers te upgraden. Controleer het systeem na de eerste upgrade gedurende ten minste 24 uur op stabiliteit. Als er geen problemen worden waargenomen, gaat u verder met het upgraden van de resterende vSmart-controllers.
- Voor het upgraden van vSmart (Controller) raadt Cisco aan de vManage GUI te gebruiken in plaats van de CLI.
Voordat u een upgrade uitvoert naar vSmart-controllers, moet u ervoor zorgen dat aan de voorwaarden is voldaan om een naadloze werking van het gegevensvliegtuig na de upgrade te behouden.
voorwaarden
Stap 1. Verzamel referentie screenshots van het dashboard
- Navigeer voor vSmart-controllers naar Monitor > Overzicht > Controller > Systeemstatus om CPU- en geheugengebruik vast te leggen.
- Verzamel de opdracht Real-Time om een samenvatting van alle vSmarts op de vManage te tonen.
Stap 2. Controleren op OMP Peer State-meldingen
- Controleer het gebeurtenissen- of alarmdashboard voor meldingen die de OMP peer state down-status aangeven.
- Navigeer hiervoor naar Monitor > Logs > Alarmen/gebeurtenissen en zoek naar relevante waarschuwingen voordat u doorgaat met de upgrade.
Stap 3. Back-ups maken van vSmart-configuraties
- Verzamel de actieve configuratie van alle vSmart-controllers, inclusief het huidige vSmart-beleid.
- Sla deze configuraties op als een back-up om ervoor te zorgen dat u de instellingen kunt herstellen als dat nodig is na de upgrade.
Stap 4. Schijfruimte controleren
Controleer het schijfgebruik op uw vSmart om er zeker van te zijn dat er voldoende vrije ruimte is voordat u de upgrade start. Besteed speciale aandacht aan partities die op of in de buurt van volledige capaciteit zijn, zoals
/var/volatile/log/tmplogin de uitvoer hieronder, die momenteel 100% is. Opslagproblemen zo nodig oplossen om upgradestoringen of operationele storingen te voorkomen.vSmart# df -h
Filesystem Size Used Avail Use% Mounted on
none 7.6G 4.0K 7.6G 1% /dev
/dev/nvme0n1p1 7.9G 1.8G 6.0G 23% /boot
/dev/loop0 139M 139M 0 100% /rootfs.ro
/dev/nvme1n1 20G 7.6G 12G 41% /rootfs.rw
aufs 20G 7.6G 12G 41% /
tmpfs 7.6G 728K 7.6G 1% /run
shm 7.6G 16K 7.6G 1% /dev/shm
tmp 1.0G 16K 1.0G 1% /tmp
tmplog 120M 120M 0 100% /var/volatile/log/tmplog
svtmp 2.0M 1.2M 876K 58% /etc/sv
vSmart#Stap 5. Bewaken van het gebruik van vSmart-bronnen
- Controleer het CPU- en geheugengebruik op vSmart-controllers.
- Voer in vshell de bovenste en vrije -m-opdrachten uit om de huidige bronstatistieken te verzamelen
vSmart# vshell
vSmart~$top
vSmart~$ free -mStap 6. Omp- en controlestatus op alle vSmarts verifiëren
- Voer OMP- en controleverificatie uit op alle vSmarts om een basislijn vast te stellen voordat u wijzigingen aanbrengt.
- Voer show omp summary uit en noteer de uitvoer als referentie van de oorspronkelijke status voor vergelijking na de upgrade.
- Gebruik controleoverzicht weergeven en controleverbindingen weergeven om te bevestigen dat het aantal controleverbindingen met randen, andere vSmarts, vBonds en vManage correct is.
- Voer show control local-properties uit voor meer details over het controlevlak.
- Voer de systeemstatus uit om er zeker van te zijn dat elke vSmart de status "vManaged" heeft als true en dat de "Configuratiesjabloon" niet is ingesteld op None.
Stap 7. Voorbeeldrandapparaten valideren
Selecteer een steekproef van 10 tot 15 apparaten uit verschillende sitelijsten en voer de controles uit:
- Voer show sdwan omp peers uit om ervoor te zorgen dat elk apparaat actieve OMP-peers heeft met alle verwachte vSmarts.
- Uitvoeren tonen sdwan omp samenvatting om de algemene OMP-status te bekijken.
- Gebruik show sdwan bfd sessies om het aantal actieve BFD sessies en hun uptime vast te leggen.
Aanbevolen configuratie-instellingen van Cisco
Hoewel dit niet verplicht is voor de upgrade, raadt Cisco deze best practices voor de configuratie ten zeerste aan om een optimale werking te garanderen.
OMP Hold Timer
- Voor softwareversies 20.12.1 en hoger, configureert u de OMP-wachttimer op 300 seconden.
- Voor versies vóór 20.12.1, stelt u de OMP-wachttimer in op 60 seconden.
OMP Graceful Restart Timer
- De standaardtimer van 12 uur (43.200 seconden) is over het algemeen voldoende om tunnels voor gegevensvliegtuigen te onderhouden tijdens tijdelijke vSmart-uitval.
IPsec Rekey Timer
- Als u wilt voorkomen dat IPsec opnieuw wordt getoetst terwijl OMP is uitgeschakeld, configureert u de IPsec rekey-timer op tweemaal de waarde van de OMP graceful restart-timer.
Deze instellingen helpen de netwerkstabiliteit te verbeteren en verstoringen tijdens geplande of ongeplande uitval te minimaliseren.
Ga alleen door naar de volgende stap als alle verificaties succesvol zijn.
Stap A. Installatie
In deze stap stuurt vManage de nieuwe software naar vSmart en installeert het nieuwe image.
Navigeer naar Onderhoud > Software-upgrade > Controller en klik op Upgrade.
Ga in het pop-upvenster Software-upgrade als volgt te werk:
- Kies het tabblad vManage.
- Selecteer de versie van het image waarnaar u wilt upgraden in de vervolgkeuzelijst Versie.
- Klik op Upgrade.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Stap B. Activering
Bij deze stap activeert vSmart de nieuwe geïnstalleerde softwareversie en start zichzelf opnieuw op om op te starten met de nieuwe software.
Ga naar Onderhoud > Software-upgrade > Controller en klik op Activeren.
Selecteer de nieuwe versie en klik op Activeren.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Nadat het proces is voltooid, navigeert u naar Onderhoud > Software-upgrade > Controller om te controleren of de nieuwe versie is geactiveerd.
Optionele stap. De nieuwe softwareafbeelding activeren en opnieuw opstarten
Stap C. Standaardsoftwareversie instellen
U kunt een softwareafbeelding instellen als de standaardimage op een Cisco SD-WAN-apparaat. Het wordt aanbevolen om het nieuwe image als standaard in te stellen nadat u hebt gecontroleerd of de software naar wens werkt op het apparaat en in het netwerk.
Als een fabrieksreset op het apparaat wordt uitgevoerd, wordt het apparaat opgestart met het image dat als standaard is ingesteld.
Ga als volgt te werk om een softwareafbeelding in te stellen als standaardimage:
- Navigeer naar Onderhoud > Software-upgrade > Controller.
- Klik op Standaardversie instellen, selecteer de nieuwe versie in de vervolgkeuzelijst en klik op Standaardversie instellen.
Controleer de status van de taak totdat deze wordt weergegeven als Succes.
Ga naar Onderhoud > Software-upgrade > Controller om de standaardversie te controleren.
SD-WAN-controllers upgraden via CLI
Stap 1. Installatie
Er zijn twee opties om het image te installeren:
Optie 1: Van CLI met het gebruik van HTTP, FTP of TFTP.
U installeert de software-image als volgt vanuit de CLI:
-
Configureer de tijdslimiet om te bevestigen dat een software-upgrade succesvol is. De tijd kan variëren van 1 tot 60 minuten.
Viptela# system upgrade-confirm minutes - Installeer de software:
Viptela#request software install url/vmanage-20.15.4.1-x86_64.tar.gz [reboot]Geef de locatie van het image op een van de volgende manieren op:
- Het afbeeldingsbestand bevindt zich op de lokale server:
/directory-path/
U kunt de functie voor automatisch aanvullen op de CLI gebruiken om het pad en de bestandsnaam te voltooien.
- Het beeldbestand bevindt zich op een FTP-server.
ftp://hostname/
- Het beeldbestand bevindt zich op een HTTP-server.
http://hostname/
- Het beeldbestand bevindt zich op een TFTP-server.
tftp://hostname/
Geef optioneel de VPN-id op waarin de server zich bevindt.
Met de optie Opnieuw opstarten wordt het nieuwe softwareimage geactiveerd en wordt het apparaat opnieuw opgestart nadat de installatie is voltooid.
3. Als u de optie opnieuw opstarten niet hebt opgenomen in stap 2, activeert u het nieuwe software-image en voert u automatisch een reboot van de instantie uit om de nieuwe versie op te starten.
Viptela#request software activate4. Bevestig binnen de geconfigureerde bevestigingstermijn voor upgrades (standaard 12 minuten) dat de software-installatie is voltooid:
Viptela#request software upgrade-confirmAls u deze opdracht niet binnen deze tijdslimiet uitvoert, wordt het apparaat automatisch teruggezet naar het vorige softwareimage.
Optie 2: Van vManage GUI
Met deze stap kunt u de afbeeldingen uploaden naar de vManage-repository.
Navigeer naar Software Download en download de installatiekopie van de softwareversie voor vManage.
Navigeer naar Software Download en download de afbeelding van de softwareversie voor vBond en vSmart.
Als u de nieuwe images wilt uploaden, gaat u in het hoofdmenu naar Onderhoud > Softwarerepository > Softwareimages, klikt u op Nieuwe software toevoegen en selecteert u vManage op de optie slepen en neerzetten.
Selecteer de afbeeldingen en klik op Uploaden.
Ga naar Software Repository > Software Images om te controleren of de images beschikbaar zijn.
vManage:
Klik op Upgrade.
vBond:
Klik op Upgrade.
vSmart:
Klik op Upgrade.
Ga in het pop-upvenster Software-upgrade als volgt te werk:
- Kies het tabblad vManage.
- Selecteer de versie van het image waarnaar u wilt upgraden in de vervolgkeuzelijst Versie.
- Klik op Upgrade.
Voor vManage:
Voor vBond en vSmart:
Stap 2. activering
Zodra de installatie is voltooid, controleert u de software-images die in de controllers zijn geïnstalleerd.
vmanage# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
---------------------------------------------------------------------------
20.12.6 true true - - 2023-02-01T22:25:24-00:00
20.15.4.1 false false false - -vbond# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 true true - - 2022-10-01T00:30:40-00:00
20.15.4.1 false false false - -vsmart# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 true true - - 2022-10-01T00:31:34-00:00
20.15.4.1 false false false - -vmanage# request software activate ?
Description: Display software versions
Possible completions:
20.12.6
20.15.4.1
clean Clean activation
now Activate software version
vmanage# request software activate 20.15.4.1
This will reboot the node with the activated version.
Are you sure you want to proceed? [yes,NO] yes
Broadcast message from root@vmanage (console) (Tue Feb 28 01:01:04 2023):
Tue Feb 28 01:01:04 UTC 2023: The system is going down for reboot NOW!vbond# request software activate ?
Description: Display software versions
Possible completions:
20.12.6
20.15.4.1
clean Clean activation
now Activate software version
vbond# request software activate 20.15.4.1
This will reboot the node with the activated version.
Are you sure you want to proceed? [yes,NO] yes
Broadcast message from root@vbond (console) (Tue Feb 28 01:05:59 2023):
Tue Feb 28 01:05:59 UTC 2023: The system is going down for reboot NOWvsmart# request software activate ?
Description: Display software versions
Possible completions:
20.12.6
20.15.4.1
clean Clean activation
now Activate software version
vsmart# request software activate 20.15.4.1
This will reboot the node with the activated version.
Are you sure you want to proceed? [yes,NO] yes
Broadcast message from root@vsmart (console) (Tue Feb 28 01:13:44 2023):
Tue Feb 28 01:13:44 UTC 2023: The system is going down for reboot NOW!Voer de volgende opdracht uit om te controleren of de nieuwe softwareversie is geactiveerd:
vmanage# show version
20.15.4.1
vmanage# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
---------------------------------------------------------------------------
20.12.6 false true true - 2023-02-01T22:25:24-00:00
20.15.4.1 true false false auto 2023-02-28T01:05:14-00:00vbond# show version
20.15.4.1
vbond# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 false true true - 2022-10-01T00:30:40-00:00
20.15.4.1 true false false - 2023-02-28T01:09:05-00:00vsmart# show version
20.15.4.1
vsmart# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 false true true - 2022-10-01T00:31:34-00:00
20.15.4.1 true false false - 2023-02-28T01:16:36-00:00Stap 3. Standaardsoftwareversie instellen
U kunt een softwareafbeelding instellen als de standaardimage op een Cisco SD-WAN-apparaat. Het wordt aanbevolen om het nieuwe image als standaard in te stellen nadat u hebt gecontroleerd of de software naar wens werkt op het apparaat en in het netwerk.
Als een fabrieksreset op het apparaat wordt uitgevoerd, wordt het apparaat opgestart met het image dat als standaard is ingesteld.
Als u een softwareversie als standaard wilt instellen, voert u de volgende opdracht uit in de controllers:
vmanage# request software set-default ?
Possible completions:
20.12.6
20.15.4.1
cancel Cancel this operation
start-at Schedule start.
| Output modifiers
<cr>
vmanage# request software set-default 20.15.4.1
status mkdefault 20.15.4.1: successfulvbond# request software set-default ?
Possible completions:
20.12.6
20.15.4.1
cancel Cancel this operation
start-at Schedule start.
| Output modifiers
<cr>
vbond# request software set-default 20.15.4.1
status mkdefault 20.15.4.1: successfulvsmart# request software set-default ?
Possible completions:
20.12.6
20.15.4.1
cancel Cancel this operation
start-at Schedule start.
| Output modifiers
<cr>
vsmart# request software set-default 20.15.4.1
status mkdefault 20.15.4.1: successfulVoer de volgende opdracht uit om te controleren of de nieuwe standaardversie is ingesteld op controllers:
vmanage# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
---------------------------------------------------------------------------
20.12.6 false false true - 2023-02-01T22:25:24-00:00
20.15.4.1 true true false auto 2023-02-28T01:05:14-00:00vbond# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 false false true - 2022-10-01T00:30:40-00:00
20.15.4.1 true true false - 2023-02-28T01:09:05-00:00vsmart# show software
VERSION ACTIVE DEFAULT PREVIOUS CONFIRMED TIMESTAMP
--------------------------------------------------------------------------
20.12.6 false false true - 2022-10-01T00:31:34-00:00
20.15.4.1 true true false - 2023-02-28T01:16:36-00:00Upgrade vManage/vManage-cluster met Disaster Recovery ingeschakeld
-
Voor het vManage- of vManage-cluster waarin Disaster Recovery is ingeschakeld,
Bevestig dat er geen replicatie voor Disaster Recovery wordt uitgevoerd. Navigeer naar Beheer --> Disaster Recovery en zorg ervoor dat de status Succes is en niet in een voorbijgaande toestand verkeert, zoals Import Pending, Export Pending of Download Pending. Het is belangrijk om Disaster Recovery op het huidige actieve vManage te onderbreken.
Als de status niet succesvol is, wacht dan tot de status wordt weergegeven als "succes". Als het langer vastzit op een andere status (meer dan 1 uur, afhankelijk van het ingestelde replicatieinterval), neem dan contact op met Cisco TAC en zorg ervoor dat de replicatie succesvol is voordat u doorgaat met het pauzeren van het noodherstel.
Pauzeer eerst het noodherstel en zorg ervoor dat de taak succesvol is. Ga vervolgens verder met het upgraden van Active vManage volgens de stappen die hierboven zijn beschreven.
Opmerking: Voor zelfstandige Active vManage kunnen we de nieuwe software installeren en activeren met vManage UI. Voor het Active vManage-cluster wordt aanbevolen de software te installeren met vManage UI en de software te activeren met vManage CLI met behulp van de aanvraagsoftware < > te activeren, zoals hieronder beschreven in het gedeelte SD-WAN-controllers via CLI upgraden.
Voor het standby vManage/vManage-cluster moeten we de software installeren en activeren met behulp van CLI van vManage-knooppunten.
-
Validatiecontroles na upgrade
-
Softwareversies verifiëren: controleer of alle controllers de beoogde softwareversie uitvoeren.
-
Controleer SD-WAN Manager Services: zorg ervoor dat alle services op de SD-WAN Manager-instanties operationeel zijn.
-
Controleverbindingen tussen controllers valideren: controleer of de controleverbindingen tussen alle controllers zijn ingesteld en stabiel zijn.
-
Beleidsactivering bevestigen: Controleer of het beleid is geactiveerd op SD-WAN Manager.
-
Controle van de verbindingsdistributie controleren: Zorg ervoor dat de besturingsverbindingen correct worden verdeeld over alle SD-WAN Manager-knooppunten. Navigeer naar Monitor > Netwerk en bekijk de kolom Besturing.
-
Post-upgradetests op siteniveau: Voer de volgende controles uit op alle sites waar pre-upgradecontroles zijn uitgevoerd:
-
Controleverbindingen en BFD-sessies:
show sd-wan control connections
show sd-wan bfd sessions -
Routeringsverificatie:
show ip route
show ip route vrf <vrf_id>
show sd-wan omp routes vpn <vpn_id> -
Bereikbaarheid van datacenters: controleer de connectiviteit met datacenterservices.
-
Sjabloonsynchronisatie: Bevestig dat apparaatsjablonen na de upgrade op apparaten zijn aangesloten en gesynchroniseerd.
-
Beleidsverificatie van controllers:
-
show sd-wan policy from-controller
-
Gebruikersacceptatietests: Voer gebruikerstests uit op de gemigreerde sites om de functionaliteit van de toepassing te valideren
-
terugdraaiplan
vBond en vSmart Rollback Plan
Als er na de upgrade onverwachte problemen worden waargenomen met de Validator (vBond) of Controller (vSmart), gaat u terug naar de vorige softwareversie door de oudere afbeelding op de betreffende apparaten te activeren.
vSmart# request software activate <older image version>
vBond# request software activate <older image version>vManage Rollback Plan
Als zich na de upgrade onverwachte problemen voordoen met SD-WAN Manager (vManage), kunt u het systeem terugzetten met behulp van de momentopname die voorafgaand aan de upgrade is gemaakt.
Problemen oplossen
1. Als de GUI na activering lange tijd uitvalt en nooit meer bereikbaar wordt, kunnen deze uitgangen nuttig zijn om de oorzaak te achterhalen:
vmanage# request nms application-server status
NMS application server
Enabled: true <<<<<<<<<<< "false"
Status: running PID:26470 for 22279s <<<<<<<<<< "not running"Als de status van de app-server Ingeschakeld als false weergeeft en de status niet actief is, kunt u de volgende opdracht geven om de GUI te herstellen:
vmanage# request nms application-server restart
2. Als u de status van alle NMS-services wilt controleren, kunt u de volgende opdracht uitvoeren:
vmanage# request nms all status
NMS service proxy
Enabled: true
Status: running PID:30888 for 819s
NMS service proxy rate limit
Enabled: true
Status: running PID:32029 for 812s
NMS application server
Enabled: true
Status: running PID:30834 for 819s
NMS configuration database
Enabled: true
Status: running PID:28321 for 825s
Native metrics status: ENABLED
Server-load metrics status: ENABLED
NMS coordination server
Enabled: true
Status: running PID:16814 for 535s
NMS messaging server
Enabled: true
Status: running PID:32561 for 799s
NMS statistics database
Enabled: false
Status: not running
NMS data collection agent
Enabled: true
Status: running PID:31051 for 824s
NMS CloudAgent v2
Enabled: true
Status: running PID:31902 for 817s
NMS cloud agent
Enabled: true
Status: running PID:18517 for 1183s
NMS SDAVC server
Enabled: false
Status: not running
NMS SDAVC gateway
Enabled: false
Status: not running
vManage Device Data Collector
Enabled: true
Status: running PID:3709 for 767s
NMS OLAP database
Enabled: true
Status: running PID:18167 for 521s
vManage Reporting
Enabled: true
Status: running PID:30015 for 827s3. Voer de volgende opdracht uit om te controleren of de TCP-handshake is voltooid:
vmanage# request nms all diagnostics NMS service server Pinging vManage node on localhost ... Starting Nping 0.7.80 ( https://nmap.org/nping ) at 2026-02-24 06:17 UTC SENT (0.0014s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (0.0014s) Handshake with localhost:8443 (127.0.0.1:8443) completed SENT (1.0025s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (1.0025s) Handshake with localhost:8443 (127.0.0.1:8443) completed SENT (2.0036s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (2.0036s) Handshake with localhost:8443 (127.0.0.1:8443) completed Max rtt: 0.012ms | Min rtt: 0.010ms | Avg rtt: 0.010ms TCP connection attempts: 3 | Successful connections: 3 | Failed: 0 (0.00%) Nping done: 1 IP address pinged in 2.00 seconds Server network connections -------------------------- tcp6 0 0 127.0.0.1:8443 127.0.0.1:43682 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43892 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 169.254.1.1:8443 169.254.1.8:52962 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43738 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43738 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43828 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43836 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43866 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:52020 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43828 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43896 ESTABLISHED 31081/envoy tcp6 0 0 169.254.1.1:8443 169.254.1.8:51382 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43726 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43810 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43756 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43748 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 169.254.0.254:8443 151.186.182.23:35154 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43898 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43860 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:56308 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:52028 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43756 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43712 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43834 ESTABLISHED 31081/envoy tcp6 0 0 169.254.0.254:8443 151.186.182.23:52168 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43810 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43836 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43852 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 169.254.0.254:8443 151.186.182.23:53030 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43898 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43892 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:52028 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:44096 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43896 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43866 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43730 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43860 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43878 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43772 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:52020 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:56308 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43874 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43772 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43826 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:52038 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43754 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43726 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43782 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43862 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:43834 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 169.254.1.1:8443 169.254.1.8:52964 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:44096 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43754 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43874 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43712 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43794 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43696 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43696 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 169.254.1.1:8443 169.254.1.8:52978 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43748 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43730 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43852 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43878 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43826 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:43682 127.0.0.1:8443 ESTABLISHED 30944/java tcp6 0 0 127.0.0.1:8443 127.0.0.1:43794 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43862 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:52038 ESTABLISHED 31081/envoy tcp6 0 0 127.0.0.1:8443 127.0.0.1:43782 ESTABLISHED 31081/envoy NMS application server Sending ICMP Echo to vManage on localhost ... PING localhost.localdomain (127.0.0.1) 56(84) bytes of data. 64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=1 ttl=64 time=0.022 ms 64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=2 ttl=64 time=0.030 ms 64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=3 ttl=64 time=0.027 ms --- localhost.localdomain ping statistics --- 3 packets transmitted, 3 received, 0% packet loss, time 2034ms rtt min/avg/max/mdev = 0.022/0.026/0.030/0.003 ms Pinging vManage node on localhost ... Starting Nping 0.7.80 ( https://nmap.org/nping ) at 2026-02-24 06:17 UTC SENT (0.0015s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (0.0015s) Handshake with localhost:8443 (127.0.0.1:8443) completed SENT (1.0026s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (1.0026s) Handshake with localhost:8443 (127.0.0.1:8443) completed SENT (2.0037s) Starting TCP Handshake > localhost:8443 (127.0.0.1:8443) RCVD (2.0037s) Handshake with localhost:8443 (127.0.0.1:8443) completed Max rtt: 0.012ms | Min rtt: 0.009ms | Avg rtt: 0.010ms TCP connection attempts: 3 | Successful connections: 3 | Failed: 0 (0.00%) Nping done: 1 IP address pinged in 2.00 seconds Disk I/O statistics for vManage storage --------------------------------------- avg-cpu: %user %nice %system %iowait %steal %idle 1.63 0.00 0.37 0.06 0.00 97.93 Device tps kB_read/s kB_wrtn/s kB_dscd/s kB_read kB_wrtn kB_dscd nvme1n1 24.49 74.59 913.44 0.00 2717198 33273456 0 NMS configuration database Checking cluster connectivity for ports 7687,7474 ... Pinging vManage node 0 on 169.254.1.5:7687,7474... Starting Nping 0.7.80 ( https://nmap.org/nping ) at 2026-02-24 06:17 UTC SENT (0.0013s) Starting TCP Handshake > 169.254.1.5:7474 RCVD (0.0013s) Handshake with 169.254.1.5:7474 completed SENT (1.0024s) Starting TCP Handshake > 169.254.1.5:7687 RCVD (1.0024s) Handshake with 169.254.1.5:7687 completed SENT (2.0035s) Starting TCP Handshake > 169.254.1.5:7474 RCVD (2.0035s) Handshake with 169.254.1.5:7474 completed SENT (3.0046s) Starting TCP Handshake > 169.254.1.5:7687 RCVD (3.0046s) Handshake with 169.254.1.5:7687 completed SENT (4.0057s) Starting TCP Handshake > 169.254.1.5:7474 RCVD (4.0058s) Handshake with 169.254.1.5:7474 completed SENT (5.0069s) Starting TCP Handshake > 169.254.1.5:7687 RCVD (5.0069s) Handshake with 169.254.1.5:7687 completed Max rtt: 0.021ms | Min rtt: 0.010ms | Avg rtt: 0.013ms TCP connection attempts: 6 | Successful connections: 6 | Failed: 0 (0.00%) Nping done: 1 IP address pinged in 5.01 seconds Server network connections -------------------------- tcp 0 0 169.254.1.5:7687 169.254.1.1:59650 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:49998 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.13:55794 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:35374 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:40100 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:52748 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:35380 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:40618 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.1:59658 ESTABLISHED 30148/java tcp 0 0 169.254.1.5:7687 169.254.1.13:55782 ESTABLISHED 30148/java Connecting to localhost... +------------------------------------------------------------------------------------+ | type | row | attributes[row]["value"] | +------------------------------------------------------------------------------------+ | "StoreSizes" | "TotalStoreSize" | 156365978 | | "PageCache" | "Flush" | 68694 | | "PageCache" | "EvictionExceptions" | 0 | | "PageCache" | "UsageRatio" | 0.1795189950980392 | | "PageCache" | "Eviction" | 3186 | | "PageCache" | "HitRatio" | 1.0 | | "ID Allocations" | "NumberOfRelationshipIdsInUse" | 8791 | | "ID Allocations" | "NumberOfPropertyIdsInUse" | 47067 | | "ID Allocations" | "NumberOfNodeIdsInUse" | 4450 | | "ID Allocations" | "NumberOfRelationshipTypeIdsInUse" | 77 | | "Transactions" | "LastCommittedTxId" | 26470 | | "Transactions" | "NumberOfOpenTransactions" | 1 | | "Transactions" | "NumberOfOpenedTransactions" | 109412 | | "Transactions" | "PeakNumberOfConcurrentTransactions" | 10 | | "Transactions" | "NumberOfCommittedTransactions" | 106913 | +------------------------------------------------------------------------------------+ 15 rows ready to start consuming query after 126 ms, results consumed after another 2 ms Completed Connecting to localhost... Displaying the Neo4j Cluster Status +---------------------------------------------------------------------------------------------------------------------------------+ | name | aliases | access | address | role | requestedStatus | currentStatus | error | default | home | +---------------------------------------------------------------------------------------------------------------------------------+ | "neo4j" | [] | "read-write" | "localhost:7687" | "standalone" | "online" | "online" | "" | TRUE | TRUE | | "system" | [] | "read-write" | "localhost:7687" | "standalone" | "online" | "online" | "" | FALSE | FALSE | +---------------------------------------------------------------------------------------------------------------------------------+ 2 rows ready to start consuming query after 3 ms, results consumed after another 1 ms Completed Total disk space used by configuration-db: 63M . Detailed disk space usage of configuration-db: 0 database_lock 8.0K neostore 48K neostore.counts.db 1.8M neostore.indexstats.db 48K neostore.labelscanstore.db 8.0K neostore.labeltokenstore.db 40K neostore.labeltokenstore.db.id 32K neostore.labeltokenstore.db.names 40K neostore.labeltokenstore.db.names.id 72K neostore.nodestore.db 48K neostore.nodestore.db.id 8.0K neostore.nodestore.db.labels 40K neostore.nodestore.db.labels.id 1.9M neostore.propertystore.db 312K neostore.propertystore.db.arrays 48K neostore.propertystore.db.arrays.id 72K neostore.propertystore.db.id 8.0K neostore.propertystore.db.index 48K neostore.propertystore.db.index.id 32K neostore.propertystore.db.index.keys 40K neostore.propertystore.db.index.keys.id 4.2M neostore.propertystore.db.strings 104K neostore.propertystore.db.strings.id 16K neostore.relationshipgroupstore.db 48K neostore.relationshipgroupstore.db.id 48K neostore.relationshipgroupstore.degrees.db 296K neostore.relationshipstore.db 48K neostore.relationshipstore.db.id 48K neostore.relationshiptypescanstore.db 8.0K neostore.relationshiptypestore.db 40K neostore.relationshiptypestore.db.id 8.0K neostore.relationshiptypestore.db.names 40K neostore.relationshiptypestore.db.names.id 16K neostore.schemastore.db 48K neostore.schemastore.db.id 11M profiles 44M schema ############################################## Running schema violation pre-check script WARNING: sun.reflect.Reflection.getCallerClass is not supported. This will impact performance. Validating Schema from the configuration-db Successfully validated configuration-db schema written to file /opt/data/containers/mounts/upgrade-coordinator/schema.json Contents of /opt/data/containers/mounts/upgrade-coordinator/schema.json: { "check_name": "Validating configuration-db admin names", "check_result": "SUCCESSFUL", "check_analysis": "Successfully validated configuration-db schema", "check_action": "" } ############################################## ############################################## Running quarantine check WARNING: sun.reflect.Reflection.getCallerClass is not supported. This will impact performance. Check if Neo4j Nodes are Quarantined None of the neo4j nodes is quarantined ############################################## ############################################## Checking High Direct Memory Usage in Neo4j High Direct Memory Usage in Neo4j not found NMS data collection agent Checking data-collection-agent status ------------------------ data-collection-agent container exists Checking Data collection agent processes status ------------------------ Data collection agent parent processs ID 12 Data collection agent process ID 104 Data collection bulk process ID 97 Data collection rest process ID 98 Data collection monitor process ID 99 Checking vmanage access ------------------------ Successfully logged into vmanage. Checking DCS Push Status ------------------------ vAnalytics not enabled. NMS coordination server Checking cluster connectivity for ports 2181 ... Pinging vManage node 0 on 169.254.1.4:2181... Starting Nping 0.7.80 ( https://nmap.org/nping ) at 2026-02-24 06:18 UTC SENT (0.0014s) Starting TCP Handshake > 169.254.1.4:2181 RCVD (0.0014s) Handshake with 169.254.1.4:2181 completed SENT (1.0025s) Starting TCP Handshake > 169.254.1.4:2181 RCVD (1.0025s) Handshake with 169.254.1.4:2181 completed SENT (2.0036s) Starting TCP Handshake > 169.254.1.4:2181 RCVD (2.0036s) Handshake with 169.254.1.4:2181 completed Max rtt: 0.012ms | Min rtt: 0.010ms | Avg rtt: 0.010ms TCP connection attempts: 3 | Successful connections: 3 | Failed: 0 (0.00%) Nping done: 1 IP address pinged in 2.00 seconds Server network connections -------------------------- tcp 0 0 169.254.1.4:2181 169.254.1.1:56716 ESTABLISHED 16814/java NMS container manager Checking container-manager status Listing all images ------------------------ REPOSITORY TAG IMAGE ID CREATED SIZE sdwan/host-agent 1.0.1 ca71fd3fe4a2 5 months ago 131MB sdwan/cluster-oracle 1.0.1 8ef918482315 5 months ago 294MB sdwan/data-collection-agent 1.0.1 4bf055257027 5 months ago 157MB sdwan/application-server 19.1.0 6a9624dc3125 5 months ago 508MB sdwan/configuration-db 4.4.38 700fe6e56199 5 months ago 472MB sdwan/coordination-server 3.7.1 a04198d518b3 5 months ago 606MB sdwan/olap-db 23.3.13.6 a17712731d5f 5 months ago 494MB sdwan/device-data-collector 1.0.0 515f2793ee43 5 months ago 116MB sdwan/service-proxy 1.27.2 5174f58b97b1 5 months ago 105MB sdwan/messaging-server 0.20.0 9560cd4b7c42 5 months ago 105MB sdwan/statistics-db 7.17.6 b9f8ab30d647 5 months ago 589MB cloudagent-v2 3358cee09e99 66063bed474e 5 months ago 458MB sdwan/upgrade-coordinator 2.0.0 969cd2f1626a 5 months ago 93.3MB sdwan/vault 1.0.1 0883c094affc 6 months ago 511MB sdwan/support-tools latest 022aebae12e6 13 months ago 143MB sdavc 4.6.0 730e83b39087 17 months ago 602MB sdavc-gw 4.6.0 84083ed484ba 18 months ago 369MB sdwan/reporting latest 509ec99584fd 19 months ago 772MB sdwan/ratelimit latest 719f624e9268 2 years ago 45.7MB Listing all containers ------------------------ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES c676b358b12d sdwan/olap-db:23.3.13.6 "/usr/bin/docker-ini…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:8123->8123/tcp olap-db 627c1dcf16fa sdwan/coordination-server:3.7.1 "/docker-entrypoint.…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:2181->2181/tcp, 127.0.0.1:2888->2888/tcp, 127.0.0.1:3888->3888/tcp coordination-server 9299443ff7a1 sdwan/messaging-server:0.20.0 "/entrypoint.sh" 10 hours ago Up 10 hours (healthy) 127.0.0.1:4222->4222/tcp, 127.0.0.1:6222->6222/tcp, 127.0.0.1:8222->8222/tcp messaging-server 0c5236ee911b sdwan/ratelimit:latest "/usr/local/bin/rate…" 10 hours ago Up 10 hours (healthy) 6379/tcp, 127.0.0.1:8460-8462->8460-8462/tcp ratelimit 094166df1cd9 cloudagent-v2:3358cee09e99 "./entrypoint.sh" 10 hours ago Up 10 hours 127.0.0.1:9051-9052->9051-9052/tcp cloudagent-v2 8f1287c11840 sdwan/reporting:latest "/sbin/tini -g -- py…" 10 hours ago Up 10 hours 80/tcp, 127.0.0.1:9080->9080/tcp reporting 66a46485cfab sdwan/vault:1.0.1 "docker-entrypoint.s…" 10 hours ago Up 10 hours (healthy) 8200/tcp, 127.0.0.1:8201->8201/tcp vault ccf5336112b6 sdwan/data-collection-agent:1.0.1 "/usr/bin/docker-ini…" 10 hours ago Up 10 hours (healthy) data-collection-agent 079ecfe36482 sdwan/service-proxy:1.27.2 "/entrypoint.sh" 10 hours ago Up 10 hours (healthy) service-proxy ec1b50457302 sdwan/configuration-db:4.4.38 "/usr/bin/docker-ini…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:5000->5000/tcp, 127.0.0.1:6000->6000/tcp, 127.0.0.1:6362->6362/tcp, 127.0.0.1:6372->6372/tcp, 127.0.0.1:7000->7000/tcp, 127.0.0.1:7473-7474->7473-7474/tcp, 127.0.0.1:7687-7688->7687-7688/tcp configuration-db f54ccdcf7a14 sdwan/device-data-collector:1.0.0 "/bin/sh -c /vMDDC/v…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:8129->8129/tcp device-data-collector 605f986dc9f1 sdwan/application-server:19.1.0 "/sbin/tini -g -- /e…" 10 hours ago Up 10 hours (healthy) application-server 50377e02b120 sdwan/host-agent:1.0.1 "/entrypoint.sh pyth…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:9099->9099/tcp host-agent ca36faf52f36 sdwan/cluster-oracle:1.0.1 "/entrypoint.sh java…" 10 hours ago Up 10 hours (healthy) 127.0.0.1:9090->9090/tcp cluster-oracle Docker info ------------------------ Client: Context: default Debug Mode: false Server: Containers: 14 Running: 14 Paused: 0 Stopped: 0 Images: 19 Server Version: 20.10.25-ce Storage Driver: overlay2 Backing Filesystem: extfs Supports d_type: true Native Overlay Diff: true userxattr: false Logging Driver: local Cgroup Driver: cgroupfs Cgroup Version: 1 Plugins: Volume: local Network: bridge host ipvlan macvlan null overlay Log: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog Swarm: inactive Runtimes: io.containerd.runc.v2 io.containerd.runtime.v1.linux runc Default Runtime: runc Init Binary: docker-init containerd version: 1e1ea6e986c6c86565bc33d52e34b81b3e2bc71f.m runc version: v1.1.4-8-g974efd2d-dirty init version: b9f42a0-dirty Security Options: seccomp Profile: default Kernel Version: 5.15.146-yocto-standard Operating System: Linux OSType: linux Architecture: x86_64 CPUs: 16 Total Memory: 30.58GiB Name: vmanage_1 ID: GHLX:JUWP:Z7JP:J3UX:MOF7:ZY7G:MSLS:E7BI:3LKT:2WRU:K2HZ:YWL7 Docker Root Dir: /var/lib/nms/docker Debug Mode: false Registry: https://index.docker.io/v1/ Labels: Experimental: false Insecure Registries: 127.0.0.0/8 Live Restore Enabled: false WARNING: No cpu cfs quota support WARNING: No cpu cfs period support WARNING: No blkio throttle.read_bps_device support WARNING: No blkio throttle.write_bps_device support WARNING: No blkio throttle.read_iops_device support WARNING: No blkio throttle.write_iops_device support NMS SDAVC server is disabled on this vmanage node NMS Device Data Collector Checking Device Data Collector Port.... Port 8129 is reachable Current Health Status:- true Getting docker stats of Device Data Collector container .... CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS f54ccdcf7a14 device-data-collector 0.00% 9.773MiB / 30.58GiB 0.03% 1.85MB / 876kB 0B / 0B 21 NMS OLAP database Checking cluster connectivity for ports 9000,8123,9009 ... Pinging vManage node 0 on 169.254.1.10:9000,8123,9009... Starting Nping 0.7.80 ( https://nmap.org/nping ) at 2026-02-24 06:18 UTC SENT (0.0013s) Starting TCP Handshake > 169.254.1.10:8123 RCVD (0.0013s) Handshake with 169.254.1.10:8123 completed SENT (1.0024s) Starting TCP Handshake > 169.254.1.10:9000 RCVD (1.0024s) Handshake with 169.254.1.10:9000 completed SENT (2.0036s) Starting TCP Handshake > 169.254.1.10:9009 RCVD (2.0036s) Handshake with 169.254.1.10:9009 completed SENT (3.0047s) Starting TCP Handshake > 169.254.1.10:8123 RCVD (3.0047s) Handshake with 169.254.1.10:8123 completed SENT (4.0058s) Starting TCP Handshake > 169.254.1.10:9000 RCVD (4.0058s) Handshake with 169.254.1.10:9000 completed SENT (5.0069s) Starting TCP Handshake > 169.254.1.10:9009 RCVD (5.0070s) Handshake with 169.254.1.10:9009 completed SENT (6.0081s) Starting TCP Handshake > 169.254.1.10:8123 RCVD (6.0081s) Handshake with 169.254.1.10:8123 completed SENT (7.0092s) Starting TCP Handshake > 169.254.1.10:9000 RCVD (7.0092s) Handshake with 169.254.1.10:9000 completed SENT (8.0103s) Starting TCP Handshake > 169.254.1.10:9009 RCVD (8.0103s) Handshake with 169.254.1.10:9009 completed Max rtt: 0.014ms | Min rtt: 0.008ms | Avg rtt: 0.009ms TCP connection attempts: 9 | Successful connections: 9 | Failed: 0 (0.00%) Nping done: 1 IP address pinged in 8.01 seconds Server network connections -------------------------- tcp 0 0 169.254.1.10:8123 169.254.1.1:38848 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38736 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38864 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38826 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:32996 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38792 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38720 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38704 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38790 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38740 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38786 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38576 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38766 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38754 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38828 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38676 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38770 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38620 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:32768 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38820 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38574 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38878 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38804 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38692 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38808 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38844 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:32984 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:60970 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:60974 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:51222 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38712 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38662 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:60986 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38598 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38640 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38652 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:32982 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38572 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38630 ESTABLISHED 18258/clickhouse-se tcp 0 0 169.254.1.10:8123 169.254.1.1:38606 ESTABLISHED 18258/clickhouse-se Mode: SingleTenant ---------------------------- Node health state ---------------------------- Server status: [OK] Replica status: [OK] Database summary ---------------------------- database count: 5 table count in db(INFORMATION_SCHEMA) : 4 table count in db(backup) : 0 table count in db(default) : 61 table count in db(information_schema) : 4 table count in db(system) : 82 Tables in database default ---------------------------- - aggregated_apps_dpi_app_60min_summary_view_default - aggregated_apps_dpi_app_summary_default - aggregated_apps_dpi_site_5min_summary_view_default - aggregated_apps_dpi_site_summary_default - aggregated_apps_dpi_stats_default - aggregated_apps_dpi_summary_default - alarm_default - api_telemetry - api_telemetry_metadata - app_hosting_interface_stats_default - app_hosting_stats_default - approute_stats_default - approute_stats_routing_summary_default - approute_stats_transport_summary_default - art_stats_default - audit_log_default - bridge_interface_stats_default - bridge_mac_stats_default - cloudx_stats_default - device_configuration_default - device_events_default - device_health_stats_default - device_stats_files_default - device_system_status_stats_default - dpi_stats_default - eio_lte_stats_default - flow_log_stats_default - fwall_stats_default - interface_stats_default - ips_alert_stats_default - nwa_default - nwapending_default - nwpi_agg_metrics_default - nwpi_app_default - nwpi_domain_agg_trend_default - nwpi_domain_default - nwpi_flow_default - nwpi_flow_event_default - nwpi_flow_metric_default - nwpi_hops_of_flow_default - nwpi_routing_default - nwpi_te_default - nwpi_time_series_default - nwpi_trace_and_task_default - pagination_request_info_default - perf_mon_statistics_default - perf_mon_summary_default - perfmon_app_15min_summary_view_default - perfmon_app_summary_default - qos_stats_default - sdra_stats_default - site_health_stats_default - sleofflinereport_default - speed_test_default - sul_stats_default - tracker_stats_default - umbrella_stats_default - umtsrestevent_default - urlf_stats_default - vnf_stats_default - wlan_client_info_stats_default ---------------------------- ┌─parts.table──────────────────────────────┬──rows─┬─latest_modification─┬─disk_size──┬─primary_keys_size─┬─engine─────────────┬─bytes_size─┬─min_date───┬─max_date───┬─compressed_size─┬─uncompressed_size─┬─ratio─┐ │ device_system_status_stats_default │ 7238 │ 2026-02-24 06:13:12 │ 430.24 KiB │ 100.00 B │ MergeTree │ 440561 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ api_telemetry │ 34476 │ 2026-02-24 06:06:32 │ 306.22 KiB │ 264.00 B │ MergeTree │ 313574 │ tuple() │ tuple() │ 0.00 B │ 0.00 B │ nan │ │ audit_log_default │ 744 │ 2026-02-24 06:15:48 │ 200.16 KiB │ 48.00 B │ MergeTree │ 204967 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ device_events_default │ 4819 │ 2026-02-24 06:17:06 │ 189.26 KiB │ 245.00 B │ MergeTree │ 193802 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ interface_stats_default │ 7036 │ 2026-02-24 06:10:50 │ 117.07 KiB │ 104.00 B │ MergeTree │ 119879 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ alarm_default │ 408 │ 2026-02-23 21:48:41 │ 69.99 KiB │ 212.00 B │ ReplacingMergeTree │ 71671 │ 2026-02-23 │ 2026-02-23 │ 0.00 B │ 0.00 B │ nan │ │ api_telemetry_metadata │ 5342 │ 2026-02-24 06:01:04 │ 57.52 KiB │ 32.00 B │ MergeTree │ 58899 │ tuple() │ tuple() │ 0.00 B │ 0.00 B │ nan │ │ approute_stats_default │ 2540 │ 2026-02-24 06:10:20 │ 37.25 KiB │ 259.00 B │ MergeTree │ 38139 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ device_configuration_default │ 18 │ 2026-02-23 20:55:39 │ 33.97 KiB │ 51.00 B │ MergeTree │ 34787 │ 2026-02-23 │ 2026-02-23 │ 0.00 B │ 0.00 B │ nan │ │ device_health_stats_default │ 1463 │ 2026-02-24 06:15:00 │ 23.07 KiB │ 303.00 B │ ReplacingMergeTree │ 23626 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ site_health_stats_default │ 1413 │ 2026-02-24 06:15:01 │ 9.95 KiB │ 230.00 B │ ReplacingMergeTree │ 10185 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ approute_stats_routing_summary_default │ 70 │ 2026-02-23 20:30:17 │ 1.79 KiB │ 83.00 B │ MergeTree │ 1837 │ tuple() │ tuple() │ 0.00 B │ 0.00 B │ nan │ │ nwa_default │ 120 │ 2026-02-24 06:11:08 │ 1.69 KiB │ 32.00 B │ MergeTree │ 1734 │ 2026-02-23 │ 2026-02-24 │ 0.00 B │ 0.00 B │ nan │ │ approute_stats_transport_summary_default │ 18 │ 2026-02-23 20:30:17 │ 997.00 B │ 83.00 B │ MergeTree │ 997 │ tuple() │ tuple() │ 0.00 B │ 0.00 B │ nan │ └──────────────────────────────────────────┴───────┴─────────────────────┴────────────┴───────────────────┴────────────────────┴────────────┴────────────┴────────────┴─────────────────┴───────────────────┴───────┘ Application server stats --------------------------------- STATISTICS --------------------------------- Success: 20418 Fail: 0 CONN DOWN: 0 OOM: 0 ILL ARG: 0 --------------------------------- This action is not supported vmanage_1# -
-
Gerelateerde informatie
Cisco SD-WAN Overlay Network Bring-Up Process
Revisiegeschiedenis
| Revisie | Publicatiedatum | Opmerkingen |
|---|---|---|
4.0 |
13-Oct-2023
|
Sectie clusterupgrade beheren |
3.0 |
11-Jul-2023
|
Vooraf uit te voeren controles voorafgaand aan een Controller-upgrade |
2.0 |
27-Apr-2023
|
Eerste vrijgave |
1.0 |
26-Apr-2023
|
Eerste vrijgave |
FeedbackContact Cisco
- Een ondersteuningscase openen
- (Vereist een Cisco-servicecontract)