BroadWorks servers R25 upgrade-procedure
Inleiding
Dit document beschrijft de generieke upgrade Methode van Procedure (MOP) voor het upgraden van BroadWorks servers zoals voldaan door het BroadWorks Upgrade Team van andere officiële documentatie bronnen.
Deze referentiedocumenten vindt u op de pagina Cisco BroadWorks Documentatiegids release 25. Raadpleeg de volgende hoofddocumenten:
- Software Management Guide
- Handleiding voor systeemconfiguratie
- Onderhoudshandleiding
- Releaseopmerkingen 25.0
- Releaseopmerkingen van ASrelease 24.0
Voor extra upgradeondersteuning kunt u contact opnemen met het upgrade-team op bwupgrade@cisco.com.
Release-opmerkingen
Voorafgaand aan de upgrade moet u de releaseopmerkingen voor de doelrelease in Cisco BroadWorks Documentatiegids release 25 bekijken. Meet het potentiële effect met de genoteerde veranderingen.
Als u een upgrade uitvoert naar een release die meer dan één belangrijk getal hoger is dan de huidige release, (bijvoorbeeld een upgrade van R23 naar R25), kunt u de opmerkingen bij de release van de release(s) daartussen bekijken (R24 in dit voorbeeld).
Deze vindt u op de pagina Cisco-documentatie of via de opgegeven koppelingen.
Standaardprocedures
Dit is de volgorde waarin servers moeten worden bijgewerkt. De netwerkservers (NS's) en mediaservers (MS's) hoeven niet in een specifieke volgorde ten opzichte van elkaar te worden bijgewerkt.
De Application Delivery Platforms (ADP's) worden in de reeks tweemaal genoemd, aangezien de eerste reeks ADP's bestaat uit degenen die DBSObserver, DBMmanagement en andere profielservices uitvoeren. De tweede set ADP's bestaat uit de Xtended Services Interface (XSI), Open Client Interface - Provisioning (OCI-P), Device Management System (DMS) en Notification Push Server (NPS) services.
Volg deze standaard stappen op hoog niveau bij het upgraden van een BroadWorks-server:
- Maak een back-up van de server.
- Installeer het laatste installatiepakket voor Release Independent (RI). De swmanager is opgenomen in het RI-pakket.
- Installeer de doelrelease-licentie.
- Draai het gereedschap upgradecontrole vanaf de CLI om er zeker van te zijn dat er geen waarschuwingen zijn:
ADP_CLI/Maintenance/Tools> upgradeCheck ADP_Rel_2021.02_1.50
Installeer altijd de doelrelease op alle peers van hetzelfde cluster voordat u een van de leden van het cluster upgradt.
Het kan handig zijn om voltooide taken voor elke server uit te checken. Voorbeeld:
| machine |
SERVER1 |
SERVER2 |
SERVER3 |
|---|---|---|---|
| Back-up |
Gereed |
Gereed |
|
| Technische ondersteuning |
Gereed |
...etc... |
|
| Doelrelease installatie |
Gereed |
||
| Licentie importeren |
Gereed |
||
| Healthmon Check |
Gereed |
||
| Upgradecontrole |
Gereed |
Procesverwachtingen
In dit document wordt ervan uitgegaan dat:
- Er is voldoende schijfruimte om back-ups te maken, de nieuwe binaire bestanden te installeren en te upgraden.
- Elke server heeft de mogelijkheid om pakketten te installeren.
- Het besturingssysteem is compatibel met de doelrelease.
- De pre-InstallCheck is op elke server uitgevoerd en eventuele waarschuwingen of fouten zijn gecorrigeerd.
- Het systeem verkeert in een gezondheidstoestand.
- Er zijn de juiste licenties verkregen.
- Er is een testplan na de upgrade gemaakt, dat voorafgaand aan de upgrade wordt uitgevoerd en de resultaten zijn vastgelegd.
Opmerkingen over servers
- De Network Function Manager (NFM) is onafhankelijk van de andere BroadWorks-servers, dus is interoperabiliteit geen probleem. Het wordt altijd aanbevolen om de laatste versie van de NFM uit te voeren.
- De upgrade naar de Databaseserver (DBS) verbetert de software, maar de schemawijzigingen in de database vinden pas plaats nadat de ADP (met de EnhancedCallLogsDBMManagement-toepassing) is bijgewerkt.
- Het wordt aanbevolen om een back-up te maken van de DBS of Network Database Server (NDS) voordat u een upgrade uitvoert van de ADP waarop EnhancedCallLogsDBMmanagementNDS of CCReportingDBMmanagement wordt uitgevoerd.
- Upgrade de MS/NS voordat de Application Server (AS) wordt gestart. Het is gebruikelijk om de MS/NS op de laatste release een dag of twee actief te laten tot het AS is bijgewerkt.
Raadpleeg de compatibiliteitsmatrix voor meer informatie.
Testplannen vóór en na de upgrade
Aanbevolen wordt om een volledig testplan te hebben en om de resultaten van dit testplan voor een upgrade uit te voeren en op te nemen. Dit helpt problemen te identificeren voorafgaand aan een upgrade en biedt bovendien een vergelijking met de testresultaten van na de upgrade.
Omkeren en terugdraaien
In de context van een BroadWorks upgrade zijn het terugdraaien en terugdraaien van een server niet hetzelfde. Een server herstellen de laatste database (DB) back-up die is genomen om de DB terug te zetten naar de status voor de upgrade. Met een terugkeer van alle gegevens die aan de DB zijn toegevoegd na het verlies van de eerste upgrade. Een terugdraai maakt een terugdraai van alle wijzigingen die in de DB zijn aangebracht tijdens het proces van de upgrade, waardoor alle gegevens die aan de DB zijn toegevoegd na de eerste upgrade intact blijven.
Onafhankelijke servers vrijgeven
Alle servers zijn RI. Alle nieuwe functies, bugs en security fixes worden geleverd in een nieuwe versie van de software. Patches worden niet beschikbaar gesteld. De servers moeten van de ene versie naar de andere worden geüpgraded om een oplossing te verkrijgen. Verwacht wordt dat er per maand een nieuwe versie van elke server zal worden uitgebracht (in plaats van maandelijkse patchbundels).
RI versies volgen een ander formaat dan het standaard Rel_25.0_1.944 formaat. Dit RI formaat is als volgt, Server_Rel_yyy.mm_1.xxx:
- Server is bijvoorbeeld MS
- yyyy het jaar met vier cijfers is
- mm de maand met twee cijfers is
- xxx is de stapsgewijze release voor die maand
MS_Rel_2022.11_1.273.Linux-x86_64.bin is bijvoorbeeld een versie van de MS die in november 2022 werd uitgebracht.
ADP
In release 25 is het functionele aanbod van Xtended Services Platform (XSP) en Profile Server (PS) overgestapt op de ADP. De applicaties die op de XSP en PS draaien zijn in twee categorieën, kernapplicaties (die diensten verlenen aan de kerninfrastructuur) of grensapplicaties (die externe API-toegang bieden). De toepassingen die worden geïnstalleerd bepalen waar ADP in het netwerk ligt.
De applicaties die op de ADP worden geleverd, worden geleverd op RI-wijze of als Release Anchored (RA). RA betekent dat de applicatie een schemaafhankelijkheid heeft van de AS versie, zodat er een release component is van de applicatie filename en er een andere "branch" wordt geleverd die is gekoppeld aan de AS release.
Zie BroadWorks Application Delivery Platform Software Download voor een lijst met beschikbare applicaties voor de ADP en de nieuwste versies die beschikbaar zijn.
Installatieprocedure
BroadWorks-installatieprogramma's kunnen worden gedownload van Cisco BroadWorks - Downloads.
Installeer de doelrelease-binaire applicatie
Deze kunnen zonder onderbreking van de service worden geïnstalleerd. De installatieprocedure is hetzelfde voor alle servers met één klein verschil voor servertypen. RI-servers hebben geen installatiepatch.
In deze voorbeeldstappen gebruiken we een AS, maar de procedure is hetzelfde voor alle 25.x BroadWorks binaire getallen. Dit moet als wortelgebruiker worden uitgevoerd (sudo is niet aanvaardbaar.). De umask is 0022 voor root en 0002 voor bwadmin.
$ chmod +x AS-25_Rel_2023.03_1.411.Linux-x86_64.bin $ ./AS-25_Rel_2023.03_1.411.Linux-x86_64.bin
Nadat de installatie is voltooid, controleert u de uitvoer op extra acties of waarschuwingen. Het toont berichten dat een nieuwe vergunning wordt vereist en dat de doelversie manueel moet worden geactiveerd.
============================================================== The installation is now completed. ============================================================== +++ Warnings summary +++ +++WARNING --- 1001 <You may have to install new license files> +++WARNING --- 1002 <You will need to manually activate the new software version> Please refer to the information reported in file: /var/broadworks/logs/installation/installation.230418.20h03m19s.warning for details as some warnings may require manual intervention. done Moving logs, steps and warnings to /var/broadworks/logs/installation
Voer na installatie de volgende stappen in: qversions commando vanuit de bwcli om ervoor te zorgen dat het aanwezig is. Merk op dat de status Installed (niet Active).
AS_CLI> qversions
Identity Version Install Date Status
==================================================
AS 2023.03_1.411 Apr 18, 2023 Installed
AS 24.0_1.944 Feb 11, 2022 Active
Een geïnstalleerd binair getal verwijderen
Als het binaire getal niet goed wordt geïnstalleerd of moet worden verwijderd, voert u de uninstall-bwserver.pl script.
$ cd /bw/broadworks/
/uninstall/
$ ./uninstall-bwserver.pl -r
De "-r" parameter geeft de instructie om de resterende mappenstructuur in /bw/Broadworks/<server> te verwijderen.
Releaselicentie voor installatie
Deze sectie heeft alleen betrekking op Universal Unique Identifier (UUID)-licenties. Voor op NFM gebaseerde licenties wordt verwezen naar de sectie Licentiebeheer van de Network Functie Manager Node en Licentiebeheergids.
Voor UID-gebaseerde licenties kunnen de licentiebestanden zich bevinden binnen meerdere zip-bestanden, de server verwacht dat het zip-bestand met de .txt en .sig-bestanden. Open de bestanden niet op een lokale machine om eenvoudig de .txt en .sig bestanden te kopiëren, omdat dit de handtekening ongeldig maakt.
Invoercertificaat van de CLI
U hoeft de licenties niet uit te pakken en het volledige pad te gebruiken.
AS_CLI/System/Licensing/LicenseManager/LicenseStore> import /path/to/licensefiles.zip
Licentie installeren vanaf het besturingssysteem
U hoeft de licenties niet uit te pakken en het volledige pad te gebruiken, als bwadmin of root run.
$ cd /usr/local/broadworks/bw_base/bin/ $ ./install-license.pl /path/to/licensefiles.zip
De upgrade-controletool uitvoeren
Draai de upgradeCheck en bevestig dat er geen waarschuwingen zijn.
Hier wordt een voorbeeld van het AS getoond:
AS_CLI/Maintenance/Tools> upgradeCheck AS_Rel_2023.03_1.411
This is a dry-run upgrade.
BroadWorks SW Manager checking AS server version 2023.03_1.411...
Checking license file information
Checking configuration file presences
Checking installation.conf file
Checking version presences
Checking Broadworks version dependencies
Checking target Broadworks version present
Checking for available disk space
Space required = 32768 Mb
[done]
Checking System configuration
BW Daemon configuration validation
testing /etc/xinetd.d... [done]
Validating MoDaemon
Checking upgrade compatibility
Checking for dangling softlink
...Monitoring directory tree starting at: /var/broadworks
Running /usr/local/broadworks/AS_Rel_2023.03_1.411 /bin/preUpgradeCheck
Executing transform... [ok]
####### CCRS Support Check START #######
No need to check for CCRS devices, upgrading from release 19 or later
####### CCRS Support Check END #######
####### Conference Access Check START #######
No need to check for duplicate conference Id's and Moderator Pins , upgrading from release 19 or later
####### Conference Access Check END #######
####### trunk group check START #######
####### Startup Parameters IP Addresses Check START #######
####### Startup Parameters IP Addresses Check END #######
####### Reporting File Queues Check START #######
####### Reporting File Queues Check END #######
####### Domains table sanity check START #######
####### Domains table sanity check END #######
####### DNIS UID sanity check START #######
####### DNIS UID sanity check END #######
####### File System Protocol Check START #######
No need to check for use of WebDav interface for custom media files.
Upgrading from release 20 or later
####### File System Protocol Check END #######
####### Disk space check for Announcement repository START #######
No need to check for available diskspace for announcement repository.
Upgrading from release 20 or later
####### Disk space check for Announcement repository END #######
####### DeviceProfileAuthMode Check START #######
####### DeviceProfileAuthMode Check END #######
####### Activatable Feature Validation START #######
Validation Successful
####### Activatable Feature Validation END #######
####### Database Manual Connections START #######
No manual database connections detected..
####### Database Manual Connections END #######
Waiting for maintenance tasks to complete if any
Checking sshd configuration
Checking for critical patches
Checking for feature patches conformity between source and target version
Checking TimesTen permanent memory size
Checking version of active TimesTen
####### Database Impacts Check START #######
Database impacts detected: datastore will be unloaded, replication will be restarted, database will be imported on non-primary nodes.
####### Database Impacts Check END #######
setactiveserver command successfully executed.
Dry-run upgrade completed.Netwerkfunctiebeheer (NFM)
NFM implementeert de functies voor netwerk- en licentiemanagement.
Zorg ervoor dat gezondheid geen problemen vertoont:
-------------------------------- System Health Report Page BroadWorks Server Name: nfm1 Date and time : Thu Nov 8 05:19:16 EST 2022 Report severity : NOTIFICATION Server type : NetworkFunctionManager Server state : Unlock -------------------------------- No abnormal condition detected. --------------------------------
Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een back-up te maken en een technische ondersteuning te loggen van vóór de upgrade:
$ bwBackup.pl -full -file=/var/broadworks/backup/bwBackup.bak $ tech-support >> tsup_hostname_sourceRelease.txt
Pre-upgrade
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
NFM_CLI/Maintenance/Tools> upgradeCheck NFM_Rel_2022.11_1.274
Controleer of Network Monitoring aanwezig is op de NFM die wordt bijgewerkt
NFM_CLI/Applications/NetworkMonitoring/Replication> status
Admin state = standby
Effective state = standby
Name Admin State Effective State
================================================
PostgreSQL Online Online
OpenNMS Offline Offline
File replication Online Offline
Monitoring Online Offline
4 entries found.
NFM_CLI/Applications/NetworkMonitoring/Replication> exit
Please confirm (Yes, Y, No, N): y
This session is now ending...
bwadmin@nfm02-cormac.local$ pgctl status
Database Status: Running
Accepting Connections: TRUE
Configured Mode: standby
Effective Mode: standby
Replication stats:
WAL files: 66
NFM-upgrade-Switch
In een cluster is de volgorde waarin NFM-servers worden geüpgraded niet relevant. Echter, upgrade ze een voor een.
Start de upgrade door deze opdracht in te voeren:
NFM_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NFM 2022.11_1.274
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NFM to 2022.11_1.274. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yLicentiebeheer op de NFM
Raadpleeg de NFM-handleiding voor knooppunt en licentiemanagement.
NFM-controles na upgrade
Controleer na het upgraden de NFM-status na het opstarten:
healthmon -lshowrunbwshowvermdbctl status- Als Network Monitoring actief is:
pgctl status - Beoordeel /var/Broadworks/logs/Maken/Onderhoud/ setactiveserver.NFM.Rel_2022.11_1.274.<date-time>.log bestand voor mogelijke activeringsfouten.
- Als de NFM Network Monitoring uitvoert, zorg er dan voor dat de applicatie is teruggekomen in de doelrelease.
Aanbevolen NFM-tests na de upgrade
Controleer dat applicaties die aangesloten zijn op de NFM servers databasetransacties kunnen uitvoeren.
Deze tests zijn generiek, voer alle aanvullende tests uit in het testplan na de upgrade.
NFM-server omkeren
De NFM revert procedure is hetzelfde als andere servers.
NFM keert terug naar R21.SP1 wordt niet ondersteund aangezien de gegevensbestandencryptie niet in die versie wordt ondersteund. We moeten daar de terugkeeroptie gebruiken. Het omkeren van een NFM-cluster creëert downtime voor toepassingen, aangezien de database op alle clusterleden moet worden gestopt om de back-up van de database te herstellen.
De gedetailleerde terugkeerstappen vindt u in de NFM Configuration Guide.
terugkeren
In het geval dat de NFM de post upgrade controles niet doorgeeft, ga terug naar de vorige release.
NFM_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NFM 2022.10_1.318 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NFM to 2022.10_1.318 NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het keert terug naar 2022.10_1.318 maar dit kan voor om het even welke vorige versie worden gesubstitueerd.
Databaseserver (DBS)
Aangezien de DBS een andere database engine (Oracle 11g) gebruikt dan andere BroadWorks producten, zijn de upgrade voorwaarden en upgrade stappen en back-up commando's heel anders dan de rest van de BroadWorks suite. Lees deze sectie aandachtig door en aarzel niet om informatiekaarten naar het Technical Assistance Center (TAC) te sturen om eventuele verduidelijkingen te krijgen.
Een verschil dat opvalt, voor de DBS, en de DBS alleen, start het upgraden van de Standby-server eerst. Dit gebeurt omdat de DBS-upgrade het DB-schema niet daadwerkelijk wijzigt. Dit gebeurt wanneer het CCReportingDBMmanagement wordt bijgewerkt. Met een DBS-upgrade worden de software en de database bijgewerkt, maar het schema verandert niet.
Andere bijzonderheden zijn onder meer de noodzaak om de servers te herstarten voordat een upgrade kan worden uitgevoerd, en het handmatig verwijderen van geplande taken (om de upgrade niet te storen).
Alles wat nodig is, wordt in de volgende paragrafen uitvoerig beschreven. Het diagram van de verbeteringsopeenvolging wordt gevolgd door de gedetailleerde stappen en de bevelen voor elke stap.
Back-up van beide DBS
Noteer de grootte van de GEGEVENS met de dbsctl diskinfo uit.
bwadmin@dbs1$ dbsctl diskinfo
Disk Group Usage Summary
DATA 12.32 % used (8075/65530 MB)
FRA 11.12 % used (7286/65530 MB)
FRA LIM 11.50 % used (7156/62253 MB)
FRA 11.12 % used (7286/65530 MB) , w/o Reclaimable data
Disk Usage Summary
DATA 12.32 % used (8075/65530 MB)
FRA 11.12 % used (7286/65530 MB)
Rebalancing in progress: no
De benodigde ruimte voor de back-up is ongeveer 1/7e van dat.
Geef deze opdrachten op voor het maken van een back-up:
bwadmin@dbs1$ export TAG=`echo -n $(showver | grep Rel | sed -e ‘s|.*Rel_||’);echo -n “-“; date +%Y.%m.%d`
bwadmin@dbs1$ bwBackup.pl -type=Full -tag=$TAG -path= /var/broadworks/backup/$TAG -compressed
BroadWorks Database Server Backup Tool version 1.10
Checking for sufficient disk space…[DONE]
Backing up database...[DONE]
bwadmin@dbs1$Merk op dat de back-up wordt uitgevoerd als de Oracle-gebruiker, zodat deze moet worden geschreven naar een locatie waar Oracle schrijfrechten heeft. Zorg ervoor dat er voldoende schijfruimte is om dit op de partitie aan te kunnen.
Volledige back-ups kunnen worden uitgevoerd met: deze opdracht:
bwadmin@dbs1$ bwBackup.pl -f -type=full -tag=$TAG -device=/var/broadworks/backup/$TAGDBSO-server stoppen
Stop voor redundante configuraties de DBSO-servertoepassing op de ADP terwijl u een upgrade uitvoert:
bwadmin@<ps1>$ stopbw DBSObserver
De DBSO-server wordt op een van de ADP's geïmplementeerd. Om te bepalen of een bepaalde ADP de DBSObserver in werking stelt, bekijk de output van showrun opdracht op het ADP.
Saniteitscontroles voorafgaand aan de upgrade
Zorg ervoor dat de replicatie actief en gezond is en dat de OB's correct zijn geïnstalleerd met de dbsctl status opdracht op beide DBS'en.
bwadmin@dbs1$ dbsctl status Database Name : bwCentralizedDb0 Database Instance : DBSI0 Database Service : bwCentralizedDb Database Status (Mode) : running (Read Write) Database Service Status : running Database Role (Expected Role) : Primary (Primary)
bwadmin@dbs2$ dbsctl status Database Name : bwCentralizedDb1 Database Instance : DBSI0 Database Service : bwCentralizedDb Database Status (Mode) : running (Read Only w/Apply) Database Service Status : running Database Role (Expected Role) : Secondary (Secondary) Check repctl status to ensure that logs are shipping and both DBS are in sync. bwadmin@dbs1$ repctl status Gathering site information, please be patient...[DONE] Redundancy/Replication Status----------------------------- Database Name = bwCentralizedDb1 Database Service Name = bwCentralizedDb Dataguard Replication pid = 26502 Primary Database = bwCentralizedDb0 [DBS1] Standby Database = bwCentralizedDb1 [DBS2] Primary Database Reachable = yes Standby Database Reachable = yes Replication gap summary = OK Replication gap details Primary SCN: 842675099 Standby SCN: 842675095 Redo Apply Lag = +00 00:00:00 Estimated Redo Rate = 0.01 MB/s Primary Estimated Redo Log Space = 791991 MB Primary Estimated Log Space Exhaustion = +916 15:45:00 Primary Redo free space condition = NORMAL Primary Lag vs Redo state = N/A Standby Estimated Redo Log Space = 788521 MB Standby Estimated Log Space Exhaustion = +912 15:21:40 Standby Redo free space condition = NORMAL Standby Lag vs Redo state = N/A Archive gap summary = N/A Archive gap details N/A
Verplichte stappen vóór de upgrade
Verwijder de geplande taken uit de Scheduler
Geplande taken zijn geïdentificeerd als oorzaak van upgradefouten en automatische terugkeer naar bronrelease. Neem eerst nota van de aanvankelijke configuratie:
DBS_CLI/Maintenance/Scheduler> get
Id Name Date Day Hour Minute
=================================================================
1 tech-support - - 4 33
2 cpuMon - - - 5
3 healthmon - - - 30(offset: 1)
4 autoCleanup - saturday 2 33
5 backup - saturday 4 03Verwijder vervolgens de geplande taken. Let op bij het verwijderen van een taak, de ID nummers verschuiven. Begin door eerst de hoogste ID te verwijderen.
DBS_CLI/Maintenance/Scheduler> del 5 DBS_CLI/Maintenance/Scheduler> del 4 DBS_CLI/Maintenance/Scheduler> del 3 DBS_CLI/Maintenance/Scheduler> del 2 DBS_CLI/Maintenance/Scheduler> del 1
Controleer of de items zijn verwijderd met de get uit.
Start de server opnieuw op (init 6) voordat u een upgrade uitvoert
Zorg ervoor dat u elke server opnieuw opstart voordat u een upgrade uitvoert. Nogmaals, dit helpt upgrademislukking te voorkomen. Omdat we de upgrade altijd doen op een standby DBS-server, heeft dit geen invloed op iets en veroorzaakt niet meer rollen omschakelen dan normaal.
Verwijs naar het diagram van de verbeteringsopeenvolging voor de orde. De init 6 wordt uitgevoerd na de back-up en vóór de activering van elke server.
Start de upgrade
De DBS verschilt van alle andere BroadWorks servers in die zin dat de stand-by/secundaire DBS eerst wordt geüpgraded. Als u begint met de momenteel actieve server; het vereist een extra reboot / rol verandering.
Op de standby-/secundaire modus:
DBS_CLI/Maintenance/ManagedObjects> lock
Switch naar de doelrelease:
DBS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server 2023.03_1.411
Ontgrendel de server zodra deze is voltooid:
DBS_CLI/Maintenance/ManagedObjects> unlock
Controleer of de DBS correct is opgestart.
Schakel de nieuwe upgrade van STANDBY/secundaire DBS om actief/primair te zijn
Opmerking: voer deze opdracht uit op de zojuist opgewaardeerde server (niet op de DBS nog bij de vorige release).
bwadmin@dbs1$ peerctl ls
PEER Role Status State
===========================================================
dbs1 PRIMARY ACTIVE Unlocked
dbs2 SECONDARY STANDBY Unlocked
bwadmin@dbs1$ peerctl setPrimary dbs2
Setting 'dbs2' as new primary.
Switch over may take a few moments to complete, do you still want to proceed? (y/n) [y]?y
Switching over to 'bwCentralizedDb1', this may take a few moments to complete.[DONE]
Switch over completed.
bwadmin@dbs1$ peerctl ls
PEER Role Status State
===========================================================
dbs1 SECONDARY STANDBY Unlocked
dbs2 PRIMARY ACTIVE Unlocked
In dit stadium is de geüpgradede DBS (dbs2) nu primair.
Controles van de databaseserver na de upgrade
- Plaats een oproep naar een Call Center en haal rapporten op die deze activiteit weergeven.
- Historische rapporten ophalen.
- Bekijk de XSLogs op het AS om te bevestigen dat de gegevens worden verzonden naar DBS2 (en niet in de bestandswachtrij).
Upgradeer de voormalige primaire switch (nu standby)
Op de voormalige primaire <dbs1> (nu standby), vergrendeld:
DBS_CLI/Maintenance/ManagedObjects> lockSwitch het aan de bestemmingsversie:
DBS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server DBS 2023.03_1.411Ontgrendel de primaire dbs1:
DBS_CLI/Maintenance/ManagedObjects> unlockVoer de switchover uit als de Original Setup of the Standby to be Primary
Stel DBS1 terug in op primair met de peerctl setPrimary dbs1 uit.
bwadmin@dbs1$ peerctl ls
PEER Role Status State
===========================================================
dbs1 SECONDARY STANDBY Unlocked
dbs2 PRIMARY ACTIVE Unlocked
bwadmin@dbs1$ peerctl setPrimary dbs1
Setting 'dbs1' as new primary.
Switch over may take a few moments to complete, do you still want to proceed? (y/n) [y]?y
Switching over to 'bwCentralizedDb0', this may take a few moments to complete.[DONE]
Switch over completed.
bwadmin@dbs1$ peerctl ls
PEER Role Status State
===========================================================
dbs1 PRIMARY ACTIVE Unlocked
dbs2 SECONDARY STANDBY Unlocked
De planner terugzetten zoals deze was
Aangezien we de geplande taken uit de planner hebben verwijderd, moeten we deze weer toevoegen. Voor het geval dat, hier zijn alle standaard tijden:
DBS_CLI/Maintenance/Scheduler> add tech-support daily 4 33
DBS_CLI/Maintenance/Scheduler> add cpuMon minute 5
DBS_CLI/Maintenance/Scheduler> add healthmon minute 30 1
DBS_CLI/Maintenance/Scheduler> add autoCleanup day saturday 2 33
DBS_CLI/Maintenance/Scheduler> add backup day saturday 4 3Controles van de primaire databaseserver na de upgrade
- Plaats een oproep naar een Call Center en haal rapporten op die deze activiteit weergeven.
- Historische rapporten ophalen.
- Bekijk de XSLogs op het AS om te bevestigen dat de gegevens worden verzonden naar DBS1 (en niet in de bestandswachtrij).
Controleer de genethmon, replicatie en redo log verzending:
bwadmin@dbs1$ repctl status
bwadmin@dbs1$ dbsctl status
bwadmin@dbs1$ dbsctl diskinfo
bwadmin@dbs1$ dbsctl redolog infoVoer dit op beide DBSs uit om te bevestigen dat ze in goede gezondheid post upgrade.
Gezondheid via automatische gegevensverwerking valideren
Voer vanuit het ADP running CCReportingDBMmanagement deze opdrachten in:
bwadmin@ps1$ bwcli
ADP_CLI/Applications/CCReportingDBManagement/Database/Databases/Sites> validate
Host Name Database Status
===========================================================
dbs01 bwCentralizedDb Primary
dbs02 bwCentralizedDb Standby
ADP_CLI/Applications/CCReportingDBManagement/Database/Schemas> validate
Name Status
===========================================================bweccr Read/Write
DBSO-server starten
Nadat beide DBSs zijn bijgewerkt, start u de DBSObserver-toepassing om failover te besturen:
bwadmin@ADP1$ startbw DBSObserver
Starting DBSObserver...Databaseserver-omkeerprocedure
De algemene procedure voor het terugzetten van de database server lijkt sterk op de algemene procedure voor het terugdraaien van BroadWorks die wordt beschreven in de BroadWorks Software Management Guide.
De belangrijkste verschillen zijn:
- Terugdraaien wordt niet ondersteund. Alleen terugzetten wordt ondersteund.
- Voor redundante configuraties wordt de software eerst op de stand-by site teruggezet.
- Een post-omkeercontrole (zie Database Server > Database Server Revert Procedure > Gedetailleerde procedurele stappen > Post Revertcheck) moet na softwareactivering worden uitgevoerd om te verifiëren of de terugdraaiing van de database op de juiste manier is uitgevoerd en of er corrigerende maatregelen nodig zijn.
Terugdraai geweigerd
Elke poging om de actieve softwareversie op de Databaseserver terug te draaien wordt ontkend, zoals in dit voorbeeld:
DBS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server DBS 2022.12_1.371
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of DBS to 2022.12_1.371. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): y
SW Manager initialized!
[Error] This server type does not support rollback. The revert flag is mandatory.Gedetailleerde procedurele stappen
De stappen die vereist zijn om Cisco BroadWorks op een standalone server en op een redundante serverconfiguratie om te zetten, zijn identiek en moeten in een specifieke volgorde worden uitgevoerd. Deze stappen hebben betrekking op beide configuraties.
- Activeer de oude Cisco BroadWorks versie. Voor redundante configuraties moet de standby server eerst worden teruggezet. Wanneer u de stand-by terugzet, geeft u geen back-uplocatie op.
- Ga voor redundante configuraties verder met de omkering van de primaire server.
- Voer de controle achteraf uit.
Om duidelijkheid te geven aan de stappen die overeenkomen met het sequentiediagram, wanneer we teruggaan naar standby SiteB geven we het back-upbestand niet op. Maar we kunnen het back-upbestand specificeren wanneer we SiteA terugzetten. U kunt ook het back-upbestand in de volgende stap herstellen. De synchrone stand-by stap synchroniseert vervolgens de gegevens tussen SiteA en SiteB.
Handeling omkeren
De terugkerende bewerking wordt gestart vanaf het BroadWorks CLI ManagedObject-niveau. Net als bij de andere servertypen kan de back-uplocatie direct binnen de CLI worden opgegeven, zoals in dit voorbeeld:
DBS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server DBS 2022.12_1.371 revert /var/broadworks/backup/2022.12_1.371-2022.12.28-12.15.43
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of DBS to 2022.12_1.371. NOTE that this action will cause downtime.
Continue?Als de terugkerende bewerking op de stand-by site wordt uitgevoerd, geef dan niet de back-uplocatie op. De stand-by-site wordt opnieuw gecreëerd vanaf de primaire importdb.pl na de terugkeeroperatie of automatisch opnieuw gesynchroniseerd door het terugkeerscript zelf. Nadat de omkering is voltooid, raadpleegt u de testresultaten van de omkeercontrole voor de aanbevolen corrigerende maatregelen.
Bovendien, als de revert wordt uitgevoerd alvorens de primaire te verbeteren, is de database die op de primaire wordt uitgevoerd nog onaangetast door de upgrade, en de stand-by kan veilig worden teruggezet naar de vorige release zonder dat een herstel- of resynchronisatiehandeling vereist is.
Dit logbestand met opdrachtoutput laat de terugkerende volgorde zien wanneer het is gestart zonder een back-upmap op te geven:
DBS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server DBS 2022.12_1.371 revertControle achteraf
Het script post revertcheck is ontworpen om te bepalen of de terugdraaiing van de database correct is uitgevoerd en of er corrigerende maatregelen nodig zijn. Het moet worden uitgevoerd vanuit de nieuwste BroadWorks release bin directory, met behulp van het volledige pad of de dot-slash (./) prefix:
bwadmin@dbs01.example.com$ cd /usr/local/broadworks/DBS_Rel_2022.12_1.371/bin/
bwadmin@dbs01.example.com$ ./dbsctl validate revertcheck
The last activation completed 0d 18h 23m 39s ago.
Running database post revert checks...
Oracle version already active.
Grid version already active.
... reverting init check [success]
... reverting check permissions [skipped]
... reverting check hardware [skipped]
... reverting check peer time [skipped]
... reverting check kernel [skipped]
... reverting check inventory [skipped]
... reverting check archivelog [skipped]
... reverting check backup [skipped]
... reverting check standby count [skipped]
... reverting check remote versions [skipped]
... reverting check patch level [skipped]
... reverting check peer idle [skipped]
... reverting check node id [skipped]
... reverting check replication [success]
... reverting check peer status [success]
... reverting check peer name lookup [skipped]
... reverting check traced event [skipped]
... reverting check invalid objects [skipped]
... reverting check active tasks [skipped]
... reverting check supported data types [skipped]
... reverting check dbcontrol [skipped]
... reverting check database status [skipped]
Post check... [DONE]
No corrective action necessaryBack-up herstellen
Als een back-upmap is opgegeven met de opdracht ActiveSoftwareVersie, wordt de back-up automatisch teruggezet door het terugkeerproces.
Anders moet de back-up worden hersteld met deze opdracht:
bwadmin@dbs01$ bwRestore.pl -recover -path=/var/broadworks/backup/<backup_name>Stand-by synchroniseren
Als de stand-by opnieuw moet worden gesynchroniseerd met de database, wordt de importdb.pl wordt gebruikt.
Deze opdracht wordt gebruikt om de database op site B te synchroniseren indien de primaire op site A niet is bijgewerkt:
bwadmin@dbs02$ importdb.pl --peer=dbs01Als Site A is bijgewerkt en teruggedraaid, moet de stand-by database opnieuw worden gemaakt vanaf de primaire site en moet redundantie opnieuw worden geconfigureerd. Om dit te doen, wordt deze opdracht in plaats daarvan gebruikt:
bwadmin@dbs02$ importdb.pl --peer=dbs01 --cleanupDe omgekeerde procedure voor de DBS wordt verder beschreven in de DBS Configuration Guide.
Terug naar de status van de switch Primair/Standby (PoE)
Wanneer de teruggave is voltooid, gebruikt u de peerctl opdracht om de servers terug te zetten naar de status Primary/Standby (Primair/Standby) vóór de upgrade. Voorbeeld:
bwadmin@dbs1$ peerctl setPrimary dbs1Als de DBSO-server niet actief is op de ADP, start deze.
Network Database Server (NDS)
Zorg ervoor dat gezondheid geen problemen vertoont:
--------------------------------
System Health Report Page
BroadWorks Server Name: nds1
Date and time : Thu Nov 7 05:19:16 EST 2022
Report severity : NOTIFICATION
Server type : NDS
Server state : Unlock
--------------------------------
No abnormal condition detected.
--------------------------------Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een volledige back-up te maken en een technische ondersteuning te loggen van vóór de upgrade:
$ bwBackup.pl -full -file=/var/broadworks/backup/bwBackup.bak
$ tech-support >> tsup_hostname_sourceRelease.txtUpgradecontrole
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
NDS_CLI/Maintenance/Tools> upgradeCheck NDS_Rel_2022.11_1.273NDS-upgrade-Switch
In een cluster is de volgorde waarin NDS’en worden geüpgraded niet relevant. U hoeft echter maar één voor één te upgraden. Start de upgrade door deze opdracht in te voeren:
NDS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NDS 2022.11_1.273
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NDS to 2022.11_1.273. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yNDS-controles na upgrade
Controleer na het upgraden de NDS-status na het opstarten:
healthmon -lshowrunbwshowvermdbctl status- Review /var/Broadworks/logs/Maken van logbestanden/onderhoud/ setactiveserver.NDS.Rel_2022.11_1.273.<date-time>.log bestand voor mogelijke activeringsfouten.
Aanbevolen NDS-tests na upgrade
Controleer dat applicaties verbonden met de NDS databasetransacties kunnen uitvoeren.
Deze tests zijn generiek, voer alle aanvullende tests uit in het testplan na de upgrade.
NDS-serveromkering
Als een NDS-cluster wordt teruggedraaid, ontstaat downtime voor toepassingen, aangezien de database op alle clusterleden moet worden gestopt om de back-up van de database te herstellen.
De NDS-terugkeerprocedure is hetzelfde als andere servers.
terugkeren
In het geval dat de NDS de post upgrade controles niet doorgeeft, ga terug naar de vorige release:
NDS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NDS 2022.08_1.352 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NDS to 2022.08_1.352 NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het keert terug naar 2022.08_1.352 maar dit kan voor om het even welke vorige versie worden gesubstitueerd.
Netwerkserver (NS)
De NS is nu RI.
Zorg ervoor dat gezondheid geen problemen vertoont
--------------------------------
System Health Report Page
BroadWorks Server Name: ns1
Date and time : Thu Oct 3 15:50:21 BST 2022
Report severity : NOTIFICATION
Server type : NetworkServer
Server state : Unlock
--------------------------------
No abnormal condition detected.
--------------------------------
Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een back-up te maken en een bestand met technische ondersteuning te loggen:
$ bwBackup.pl networkserver NS_hostname_sourceRelease.tar
$ tech-support >> tsup_hostname_sourceRelease.txtPre-upgrade
Maak een testgesprek dat de NS inroept en controleer of een succesvol 302-bericht zich in het NSXSLog-logbestand bevindt in /var/Broadworks/logs/Routingserver/.
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
NS_CLI/Maintenance/Tools> upgradeCheck NS_Rel_2022.11_1.27Controleer het huidige aantal oproepen en dergelijke die u gebruikt met de qcurrent opdracht:
NS_CLI/Monitoring/Report> qcurrentDatabasesynchrone controleren (synchcheck_basic.pl -a) op alle niet-primaire peer-NS's:
$ synchcheck_basic.pl -aPrimaire ONS upgrade-Switch
Start de upgrade door deze opdracht in te voeren:
NS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NS 2022.11_1.27
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NS to 2022.11_1.27. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yWerk de databasestatistieken bij door de bwPeriodMaint.sh script.
$ bwPeriodMaint.shONS-controles na upgrade
Controleer na het upgraden de NS-status na het opstarten.
healthmon -l- Het toont de peer uit synchronisatie is maar dit wordt verwacht tot de secundaire wordt opgewaardeerd.
- Als healthmon aangeeft dat bepaalde databasepaginaformaten zijn overtroffen, voert u
check_dbpages.pl networkserver modify.
showrunbwshowver- Bekijk het bestand /var/Broadworks/logs/intenance/ setactiveserver.NS.Rel_2022.11_1.27.<date-time>.log voor mogelijke activeringsfouten.
- Voer NS-tests uit om te controleren of deze NS correct oproepen verwerkt.
Aanbevolen NS-tests na upgrade
- Validate Public Switched Telephone Network (PSTN) inkomende 3020-omleiding.
- Valideren AS uitgaand 302 omleiden.
- Valideren van AS naar MS-verzoek/antwoord.
- Valideren CLI-toegang (inloggen en naar NS_CLI/System/Device/HostingNE gaan; voer de opdracht get in).
- Bevestig webtoegang tot de NS (indien ingeschakeld).
- Bevestig gebruikersraadpleging van een ADP met behulp van communicatie in NS-modus door eenvoudig in te loggen op een ADP.
NS-activiteiten na upgrade
Controleer dat de NS niet is ingesteld om ADP's te ontkennen van het inloggen op een AS in een andere versie. Stel ADP versie in Gelijk aan fout voor elke hostingNE onder NS_CLI/System/Device/HostingNE>.
NS omkeren
In het geval dat de NS niet de post upgrade controles doorgeeft, ga terug naar de vorige release:
NS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NS 2022.09_1.340 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NS to 2022.09_1.340. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het keert terug naar 2022.09_1.340 maar dit kan voor om het even welke vorige versie worden gesubstitueerd.
Aangezien de secundaire NS een huidige versie van de database uit de bronrelease heeft, kan de DB van daaruit worden geïmporteerd.
Op de secundaire NS:
$ repctl startOp de primaire NS,
$ stopbw
$ repctl stop
$ importdb.pl networkserver <peer_ns2>
$ repctl start
$ startbwOntgrendel de secundaire (en alle andere) NS-databases:
$ peerctl unlockControleer of replicatie op de omgekeerde primaire NS wordt uitgevoerd:
$ repctl statusControleer of er replicatie op alle secundaire NS’s wordt uitgevoerd en dat de database wordt ontgrendeld:
$ repctl statuscontroleren healthmon -l op alle NS's. Zorg ervoor dat de gemelde ernst een MELDING is voor alle servers.
Controleer of de secundaire NS- en primaire NS-databases gesynchroniseerd zijn (op secundair):
$ synchcheck_basic.pl -aSwitch voor secundaire NS-upgrade
Start de upgrade door deze opdracht in te voeren:
NS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server NS 2022.11_1.27
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of NS to 2022.11_1.27. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yHet is niet nodig om het updatestatistieken script uit te voeren, omdat het werd uitgevoerd voorafgaand aan de import die automatisch werd gedaan tijdens de upgrade van de secundaire NS.
ONS-controles na upgrade
Controleer na het upgraden de NS-status na het opstarten
healthmon -l- Als healthmon aangeeft dat bepaalde databasepaginaformaten zijn overtroffen, voert u
check_dbpages.pl networkserver modify.
- Als healthmon aangeeft dat bepaalde databasepaginaformaten zijn overtroffen, voert u
showrunbwshowver- Bekijk het bestand /var/Broadworks/logs/intenance/ setactiveserver.NS.Rel_2022.11_1.27.<date-time>.log voor mogelijke activeringsfouten.
- Voer NS-tests uit om te controleren of deze NS correct oproepen verwerkt.
Aanbevolen NS-tests na upgrade
Door de primaire NS te vergrendelen, leidt dit alle verkeer door de secundaire weg:
- Validate PSTN inbound 302 redirect.
- Valideren AS uitgaand 302 omleiden.
- Valideren van AS naar MS-verzoek/antwoord.
- Valideren CLI-toegang (inloggen en naar NS_CLI/System/Device/HostingNE gaan; voer de opdracht get in).
- Bevestig webtoegang tot de NS (indien ingeschakeld).
- Bevestig gebruikersraadpleging van een XSP met behulp van NS-mode communicatie door eenvoudig in te loggen op een XSP.
- Post-Cluster testen.
- Zorgen voor meldingen van de ernst van alle servers.
- Controleer databasesynchrone werking.
$ healthmon -l
$ synchcheck_basic.pl –aMediaserver (MS)
Zorg ervoor dat gezondheid geen problemen vertoont:
--------------------------------
System Health Report Page
BroadWorks Server Name: ms1
Date and time : Thu Mar 3 11:10:53 BST 2022
Report severity : NOTIFICATION
Server type : MediaServer
Server state : Unlock
--------------------------------
No abnormal condition detected.
--------------------------------Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een back-up te maken en een technische ondersteuning te loggen van vóór de upgrade. Voor de lidstaten zou dit neerkomen op:
$ bwAutoBackup.sh
$ tech-support >> tsup_hostname_sourceRelease.txtPre-upgrade
Maak een testoproep die Interactive Voice Response (IVR) inroept of haal een voicemail op en zorg ervoor dat deze werkt zoals verwacht en dat de oproep in de logbestanden te zien is.
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
MS_CLI/Maintenance/Tools> upgradeCheck MS_Rel_2022.11_1.273Controleer het huidige aantal poorten dat wordt gebruikt met de qcurrent uit.
MS_CLI/Monitoring/Report> qcurrentMS upgrade-Switch
Start de upgrade met deze opdracht:
MS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server MS 2022.11_1.273
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of MS to 2022.11_1.273. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yMS-post-upgrade controles
Controleer na het upgraden de MS-status na het opstarten en controleer of u een voicemail- en voicemailrevial achterlaat.
healthmon -lshowrunbwshowver
Aanbevolen MS-tests na upgrade
- Bevestig succesvolle audio-messageriedeponering en het ophalen.
- Valideer succesvolle IVR-interactie.
- Valideren van succesvolle drieweg-oproep.
Deze tests zijn generiek, voer alle aanvullende tests uit in het testplan na de upgrade.
MS omkeren
Als de lidstaten de controles na de upgrade niet doorstaan, gaat u terug naar de vorige release.
MS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server MS 2022.08_1.350 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of MS to 2022.08_1.350. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het vorige voorbeeld keert het terug naar 2022.08_1.350, maar dit kan worden vervangen voor een eerdere release.
Toepassingsserver (AS)
Zorg ervoor dat gezondheid geen problemen vertoont
--------------------------------
System Health Report Page
BroadWorks Server Name: as1
Date and time : Thu Oct 3 15:50:21 BST 2022
Report severity : NOTIFICATION
Server type : AppServer
Server state : Unlock
--------------------------------
No abnormal condition detected.
-------------------------------- Controleer de logbestanden om er zeker van te zijn dat beide AS's gesprekken verwerken (het afdwingen van nieuwe oproepen naar de secundaire kan worden gedaan door AS1 te vergrendelen).
- Bevestig webtoegang via webservers en elk AS.
Reserve- en technische ondersteuning
Het is aan te raden om een back-up te maken en een technische ondersteuning te registreren van voor de upgrade.
$ bwBackup.pl AppServer AS_hostname_sourceRelease.tar
$ tech-support >> tsup_hostname_sourceRelease.txtPre-upgrade
Draai het upgradeCheck gereedschap om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd.
AS_CLI/Maintenance/Tools> upgradeCheck AS_Rel_2023.03_1.411
Opmerking: Als de upgradeCheck mislukt vanwege bestanden in de directory /var/Broadworks/eccr of /var/Broadworks/ecl, wacht dan tot er een ‘lock force’ wordt uitgevoerd vanuit de bwcli. Hiermee worden de bestanden binnen een paar minuten naar de DBS gezuiverd.
Controleer databasesynchrone (synchcheck_basic.pl -a) op het secundaire AS:
$ synchcheck_basic.pl -aStel de extensieTimeInSeconds in op 10800 (drie uur), zodat deze overeenkomt met de hoeveelheid tijd die is gereserveerd voor het upgraden van de server:
AS_CLI/System/Registration> set extensionTimeInSeconds 10800De standaardinstelling hiervan is wanneer u 2400 niet upgradt volgens de Systeemconfiguratiegids.
De replicatie duwt deze verandering in de resterende servers in het cluster.
Verwijdert de back-upbewerking uit de planner:
AS_CLI/Maintenance/Scheduler> get
Id Name Date Day Hour Minute
=================================================================
5 backup - saturday 4 03Als de back-up tijdens de upgrade wordt geactiveerd, kan dit problemen veroorzaken tijdens de activering:
AS_CLI/Maintenance/Scheduler> del 5Vergrendel het primaire AS
Vergrendel de primaire AS, nieuwe oproepen zijn door de secundaire waardoor het aantal actieve oproepen op de primaire kan dalen voordat de switch wordt uitgevoerd (schakelen of vergrendelkracht veroorzaakt de actieve oproepen om te laten vallen):
AS_CLI/Maintenance/ManagedObjects> lock
+++ WARNING +++ WARNING +++ WARNING +++
This command will lock the server. Note that this action could cause downtime.
The server state is persisted across server restarts and upgrade.
A server in "Locked" state will need to be manually unlocked after a server
restart or upgrade. Continue?
Please confirm (Yes, Y, No, N): y
...DoneControleer na afloop het aantal oproepen op het AS met de qcurrent opdracht:
AS_CLI/Monitoring/Report> qcurrentPrimaire AS-upgrade-Switch
Nadat de oproepen tot een acceptabel niveau zijn gedaald, start u de upgrade met:
AS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server AS 2023.03_1.411
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of AS to 2023.03_1.411 . NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yOntgrendel de server zodra deze is voltooid:
AS_CLI/Maintenance/ManagedObjects> unlockWerk de DB-statistieken bij met bwPeriodMaint.sh:
$ bwPeriodMaint.shDeze opdracht geeft geen uitvoer terug.
Aangezien we de back-upbewerking uit de planner hebben verwijderd, moeten we deze na de upgrade toevoegen. Dit is de voorgestelde waarde. We moeten het weer toevoegen aan de waarde die vóór de upgrade was ingesteld:
AS_CLI/Maintenance/Scheduler> add backup day saturday 4 3Primaire AS-acties na upgrade
AS-controles na upgrade
Controleer de AS-status na het opstarten en controleer registraties en gesprekken.
healthmon -l- Het toont de peer uit synchronisatie is maar dit wordt verwacht tot de secundaire wordt opgewaardeerd.
showrunbwshowver- Beoordeel /var/Broadworks/logs/intenance/ setactiveserver.AS.Rel_2023.03_1.411 .<date-time>.log bestand voor mogelijke activeringsfouten.
- Voer AS-tests uit om er zeker van te zijn dat dit AS oproepen goed verwerkt.
Aanbevolen AS400 post-upgrade-tests
- Valideer SIP uitgaande aanroep.
- Validate Media Gateway Control Protocol (MGCP) uitgaande oproepen.
- Bevestig PSTN aan SIP gebruiker inkomende aanroep.
- Bevestig PSTN aan MGCP gebruiker inkomende het roepen.
- Valideren van voicemail die vertrekt/ophalen (spraakportal).
- Valideren CommPilot-initiaties/terminaties.
- Valideer CLI-toegang (ga naar AS_CLI/System/Alias en gebruik de opdracht get).
- Valideren van directe webtoegang tot het AS.
Gelokaliseerde spraakvragen
Als u een upgrade uitvoert naar R25, worden de aangepaste audiopresentaties automatisch gekopieerd uit de bronrelease. Raadpleeg paragraaf 4.5 in de functiebeschrijving.
Als omkeren
Als het AS de post upgrade controles niet doorgeeft, ga dan terug naar de vorige release.
AS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server AS 2022.08_1.354 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of AS to 2022.08_1.354. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het is terug te keren naar 2022.08_1.354, maar dit kan voor om het even welke vorige versie worden gesubstitueerd.
Aangezien secundaire AS een huidige versie van de database heeft, importeer de DB vanaf daar.
Op het secundaire AS:
$ repctl startOp het primaire AS:
$ stopbw
$ repctl stop
$ importdb.pl appserver
appserver
$ repctl start
$ startbwOntgrendel de secundaire AS-database:
$ peerctl unlockControleer of er replicatie wordt uitgevoerd op de omgekeerde primaire AS:
$ repctl statusControleer of er replicatie op de secundaire AS wordt uitgevoerd en dat de database wordt ontgrendeld:
$ repctl status
$ peerctl unlockcontroleren healthmon -l op alle AS's. Zorg ervoor dat de gemelde ernst een MELDING is voor alle servers.
Controleer of de secundaire AS- en primaire AS-databases gesynchroniseerd zijn (op secundair):
$ synchcheck_basic.pl -aSecundaire AS-upgrade-Switch
Start de upgrade door deze opdracht in te voeren:
AS_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server AS 2023.03_1.411
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of AS to 2023.03_1.411. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yWerk de databasestatistieken bij door de bwPeriodMaint.sh script:
$ bwPeriodMaint.shSecundaire AS-post-upgrade-acties
AS-controles na upgrade
Controleer de AS-status na het opstarten en controleer registraties en gesprekken.
healthmon -lshowrunbwshowver- Controleer /var/Broadworks/logs/Maxwell/Maxwell/setactiveserver.AS.Rel_2023.03_1.411.<date-time>.log bestand voor mogelijke activeringsfouten.
- Voer AS-tests uit om er zeker van te zijn dat dit AS de oproepen goed verwerkt.
Aanbevolen AS400 post-upgrade-tests
- Sluit de primaire AS om nieuwe oproepen naar de secundaire te forceren.
- Valideer SIP uitgaande aanroep.
- Valideer MGCP uitgaande oproep.
- Bevestig PSTN aan SIP gebruiker inkomende aanroep.
- Bevestig PSTN aan MGCP gebruiker inkomende het roepen.
- Valideren van voicemail die vertrekt/ophalen (spraakportal).
- Valideren CommPilot-initiaties/terminaties.
- Valideer CLI-toegang (ga naar AS_CLI/System/Alias en gebruik de opdracht get).
- Valideren van directe webtoegang tot het AS.
Post-Cluster test
- Zorgen voor meldingen van de ernst van alle servers.
- Controleer databasesynchrone:
$ healthmon -l
$ synchcheck_basic.pl –aServicebeheerfunctie (SCF)
Zorg ervoor dat gezondheid geen problemen vertoont:
--------------------------------
System Health Report Page
BroadWorks Server Name: scf1
Date and time : Fri Nov 8 11:30:38 GMT 2022
Report severity : NOTIFICATION
Server type : ServiceControlFunction
Server state : Unlock
--------------------------------
No abnormal condition detected.
--------------------------------- Controleer de logbestanden om er zeker van te zijn dat het SCF oproepen verwerkt.
Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een back-up te maken en een technische ondersteuning te loggen van vóór de upgrade. Dit gebeurt met:
$ bwAutoBackup.sh
$ tech-support >> tsup_hostname_sourceRelease.txtPre-upgrade
Test oproepen vanuit het mobiele netwerk om er zeker van te zijn dat de huidige functie werkt zoals normaal.
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
SCF_CLI/Maintenance/Tools> upgradeCheck SCF_Rel_2023.03_1.411Als een redundante installatie, vergrendelt u de server om oproepen naar de andere SCF te forceren:
SCF_CLI/Maintenance/ManagedObjects> lockSCF upgrade-Switch
Nadat de oproepen tot een acceptabel niveau zijn gedaald, start u de upgrade met:
SCF_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server SCF 2023.03_1.411
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of SCF to 2023.03_1.411. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yOntgrendel de server en test gesprekken als deze zijn voltooid:
SCF_CLI/Maintenance/ManagedObjects> unlockSCF-controles na upgrade
Na upgrade, controleer de SS7 logs voor een goede start-up:
healthmon -lshowrunbwshowver- Review /var/Broadworks/logs/Maken van logbestanden/onderhoud/ setactiveserver.SCF.Rel_2023.03_1.411.<date-time>.log bestand voor mogelijke activeringsfouten.
- Voer tests uit om er zeker van te zijn dat dit SCF correct oproepen verwerkt.
- Bevestig de oproepen van het mobiele netwerk naar de BroadWorks-kern werken zoals voor de upgrade.
SCF-serveromkering
In het geval dat het SCF de post upgrade controles niet doorgeeft, ga terug naar de vorige release:
SCF_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server SCF 2022.10_1.313 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of SCF to 2022.10_1.313. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het keert terug naar 2022.10_1.313 maar dit kan voor om het even welke vorige versie worden vervangen.
Application Delivery Platform (ADP)
Zorg ervoor dat gezondheid geen problemen vertoont:
--------------------------------
System Health Report Page
BroadWorks Server Name: adp1
Date and time : Fri Nov 8 11:30:38 GMT 2022
Report severity : NOTIFICATION
Server type : ApplicationDeliveryPlatform
Server state : Unlock
--------------------------------
No abnormal condition detected.
--------------------------------Reserve- en technische ondersteuning
Vóór elke serverupgrade wordt aanbevolen om een back-up te maken en een technische ondersteuning te loggen van vóór de upgrade. Dit zou gebeuren met:
$ bwAutoBackup.sh
$ tech-support >> tsup_hostname_sourceRelease.txtPre-upgrade
Draai het upgradeCheck gereedschap om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
ADP_CLI/Maintenance/Tools> upgradeCheck ADP_Rel_2022.10_1.313Vergrendel de server voordat de nieuwe softwareversie wordt geactiveerd:
ADP_CLI/Maintenance/ManagedObjects> lockECLQ-toepassing verwijderen en deactiveren bij verplaatsen van ADP/PS op R23 naar RI
Voordat we de ADP naar de nieuwste RI upgraden, moeten we de ECLQ-query-toepassing naar de NDS migreren als de bron ADP/PS op R23 ECLQ-query-toepassing actief heeft. Raadpleeg de functiebeschrijving Enhanced Call Log Migration van Database Server naar Network Database Server.
ADP_CLI/Maintenance/ManagedObjects> undeploy application /ECLQuery
ADP_CLI/Maintenance/ManagedObjects> deactivate application /ECLQueryAls dit niet wordt gedaan, zien wij een "bwCentralisedDatabaseListenerFailure"alarm op ADP na activering van de nieuwe versie.
Upload de ADP RI/RA-toepassingen die overeenkomen met de geïmplementeerde toepassingen op de bronrelease
De ADP BroadWorks-server vereist dat de RI/RA-versies van de toepassingen die momenteel op de bronrelease worden geïmplementeerd, worden gedownload van Cisco.com. Voltooi deze acties om de lijst van vereiste toepassingen te krijgen.
Voer in het ADP:
$ bwshowver
ADP version Rel_2022.11_1.273
Applications Info:
- OpenClientServer version 2022.11_1.273
- WebContainer version 2022.11_1.273
- OCIOverSoap version 2022.11_1.273 context path /webservice
- CommPilot version 2022.11_1.273 context path /
- Xsi-Actions version 2022.11_1.273 context path /com.broadsoft.xsi-actions
- Xsi-Events version 2022.11_1.273 context path /com.broadsoft.xsi-events
- Xsi-VTR version 2022.11_1.273 context path /vtr
- OCIFiles version 2022.11_1.273 context path /ocifiles
- BroadworksDms version 2022.11_1.273 context path /dms
- AuthenticationService version 2022.11_1.273 context path /authserviceAlle toepassingen die na "Toepassingsinfo" worden vermeld zijn toepassingen die op ADP worden ingezet en die de ADP-compatibele versies van Cisco.com moeten downloaden. Download de nieuwste versies beschikbaar. Voorbeelden van toepassingen die zijn gebaseerd op het vorige voorbeeld zijn:
OCS_2023.01_1.193.bwar
OCIOversoap_2023.01_1.193.bwar
XSI-Actions-24_2023.01_1.010.bwar
XSI-Events-24_2023.01_1.010.bwar
CommPilot-24_2023.01_1.010.bwar
XSI-VTR-24_2023.01_1.010.bwar
OCIFiles_2023.01_1.010.bwar
dms_2023.01_1.193.bwar
Kopieer de gedownloade bwar / war bestanden naar de ADP en geplaatst in de /usr/local/broadcast/apps directory:
$ cd <bwar / war directory location>
$ cp OCS_2023.01_1.193.war /usr/local/broadworks/apps/
$
De rest van de upgrade is een normale BroadWorks upgrade.
Pre-upgrade
Voer het upgradeCheck-gereedschap uit om er zeker van te zijn dat er geen waarschuwingen worden gegenereerd:
ADP_CLI/Maintenance/Tools> upgradeCheck ADP_Rel_2023.03_1.411ADP upgrade-Switch
Start de upgrade door deze opdracht in te voeren:
ADP_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server ADP 2023.03_1.411
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of ADP to 2023.03_1.411. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yADP-acties na upgrade
Upgradetoepassingen
De WebContainer-toepassing wordt automatisch bijgewerkt. De andere toepassingen vallen in twee soorten, Cisco BroadWorks-toepassingen en webtoepassingen. De upgradeprocedure is afhankelijk van of de toepassing een Cisco BroadWorks-toepassing of een webtoepassing is.
- Cisco BroadWorks-toepassingen worden verpakt als een BroadWorks-archiefbestand (.bwar).
- Web applicaties, verpakt als Web Archief (.war) bestand.
Voer het qbw bevel om te zien welke versie momenteel voor elke toepassing en zijn opgestelde contextweg actief is.
Webtoepassingen voor upgrades
Web applicaties worden geüpgraded door de huidige versie uit te schakelen en te verwijderen en vervolgens de nieuwe versie te activeren en te implementeren:
ADP_CLI/Maintenance/ManagedObjects> undeploy application /callcenter
ADP_CLI/Maintenance/ManagedObjects> deactivate application /callcenter
ADP_CLI/Maintenance/ManagedObjects> activate application BWCallCenter 2023.04_1.150 /callcenter
ADP_CLI/Maintenance/ManagedObjects> deploy application /callcenterUpgrade Cisco BroadWorks-toepassingen
Cisco BroadWorks-toepassingen worden vanaf de bwcli geüpgraded met de set activeSoftwareVersion application uit.
Meer informatie vindt u in de Application Releaseopmerkingen en de Application Implementation Platform Config Guide.
ADP_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion application LoadBalancer 2023.02_1.090
+++ WARNING +++ WARNING +++ WARNING +++ Upgrading an application will cause downtime for the targeted component. Continue?
Please confirm (Yes, Y, No, N): y
--> Stopping application LoadBalancer <--
Stopping [done]
BroadWorks SW Manager upgrading LoadBalancer to version 2023.02_1.090 ...DoneADP-toepassingen voor terugdraaien
Als, om de een of andere reden, de toepassing moet worden teruggerold naar een vorige versie, is het proces vergelijkbaar met een upgrade. Een belangrijk punt om op te merken is dat sommige veranderingen verloren kunnen gaan nadat de terugdraai-operatie wordt uitgevoerd (bijvoorbeeld, configuratie wijzigingen) omdat de resulterende actieve toepassing in de staat is het was vóór de upgrade.
Roll Back-webtoepassingen
Web applicaties worden teruggedraaid door de huidige versie uit te schakelen en niet te implementeren en vervolgens de nieuwe versie te activeren en te implementeren:
ADP_CLI/Maintenance/ManagedObjects> undeploy application /callcenter
ADP_CLI/Maintenance/ManagedObjects> deactivate application /callcenter
ADP_CLI/Maintenance/ManagedObjects> activate application BWCallCenter 2023.04_1.150 /callcenter
ADP_CLI/Maintenance/ManagedObjects> deploy application /callcenter
Rollback Cisco BroadWorks-toepassingen
Cisco BroadWorks-toepassingen worden via de set activeSoftwareVersion application opdracht:
ADP_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion application LoadBalancer 2020.09_1.090
+++ WARNING +++ WARNING +++ WARNING +++ Upgrading an application will cause downtime for the targeted component. Continue?
Please confirm (Yes, Y, No, N): y
--> Stopping application LoadBalancer <--
Stopping [done]
BroadWorks SW Manager upgrading LoadBalancer to version 2020.09_1.090 ...DoneADP-controles na upgrade
Na de upgrade, controleer de logbestanden op een goede start-up en log in bij GUI zoals voorheen.
healthmon -lshowrunbwshowver- Beoordeel /var/Broadworks/logs/Maken/Onderhoud/ setactiveserver.ADP.Rel_2023.03.0_1.1411.<date-time>.log bestand voor mogelijke activeringsfouten.
Aanbevolen ADP-tests na upgrade
- Controleer de aanmelding op beheerdersniveau.
- Controleer de aanmelding op gebruikersniveau.
- De functie CommPilot Call Manager valideren.
- Valideren van Call Control Client (bijvoorbeeld BroadWorks Assistant-Enterprise) en Operations Support System (OSS)/Open Client Interface (OCI)-functionaliteit.
- Controleer of een Open Client Server (OCS) proxy provisioning voor het AS of NS goed werkt.
Deze tests zijn generiek, voer alle aanvullende tests uit in het testplan na de upgrade.
ADP-serveromkering
Als de ADP de post upgrade check niet doorgeeft, ga dan terug naar de vorige release:
ADP_CLI/Maintenance/ManagedObjects> set activeSoftwareVersion server ADP 2022.10_1.313 revert
+++ WARNING +++ WARNING +++ WARNING +++
This command will change the active software version of ADP to 2022.10_1.313. NOTE that this action will cause downtime.
Continue?
Please confirm (Yes, Y, No, N): yIn het voorbeeld, het keert terug naar 2022.10_1.313 maar dit kan voor om het even welke vorige versie worden vervangen.
Revisiegeschiedenis
| Revisie | Publicatiedatum | Opmerkingen |
|---|---|---|
1.0 |
21-Jul-2023 |
Eerste vrijgave |
Feedback