This procedure is for upgrading zCenter via zCLI where High Availablity (HA) has been configured for the service. When the HA is involved, extra care must be taken to avoid failover being triggered and to minimize service downtime.
Requirements
Access to zCenter admin portal as Service Admin
Access to zCLI on zCenter Active server and on Standby server
Downloadable upgrade packages (https/sftp/scp) accessible by both zCenter servers
Procedure
Login to zCenter portal
Verify Service domain name and version (verify version is lower than upgrade version
Advanced Management --> click on Zentera logo (may be private branded)
Verify HA status
Advanced Management --> Service Management --> HA Status
HA Status = Active
Counterpart IP = {standby server ip address}
Master DB Log File Position = Slave DB Log File Position
Seconds Behind Master = 0
Verify and/or notify nobody is logged into zCenter and Launcher
Advanced Management --> Project Management --> Current CoIP User Login Sessions
Login to zCLI on both zCenter Active and Standby servers
SSH to the server using ztu as the username (requires password)
zCLI@{server name}> enable (requires zcli enable password)
zCLI@{server name}# service
zCLI@{server name}(service)# controller
zCLI@{server name}(service-zgw)# show swversion (verify is older version than upgrade version)
Network Switch Version: {ZNS switch version} Web Portal Version: {ZGW current version} zCLI Version: {zCLI current version}
zCLI@{server name}(service-zgw)# service status
Active server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... Running Checking zns ... Running
Standby server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... ZGW service not running Checking zns ... Service is not running
zCLI@{server name}(service-zgw)# ha show
Active server response
This system configured as ACTIVE server is in ACTIVE state now Service IP: {active server IP address} Peer IP: {standby server IP address} Router ID: 241 Interface: em1
Standby server response
This system configured as STANDBY server is in STANDBY state now Service IP: {standby server IP address} Peer IP: {active server IP address} Router ID: 241 Interface: em1
Pause HA on Standby server
zCLI@{server name}(service-zgw)# ha pause (type "yes" when asked)
zCLI@{server name}(service-zgw)# service status
keepalived is inactive and dead... Checking MySQL... Running Checking ZGW service... ZGW service not running Checking zns ... Service is not running
zCLI@{server name}(service-zgw)# ha show
This system configured as STANDBY server is in PAUSE state now.
Upgrade Active server
zCLI@{server name}(service-zgw)# upgrade download <ZGW upgrade download location> (see notes.1 below if zCenter cannot directly access Zentera provided public URL.)
zCLI@{server name}(service-zgw)# upgrade download <zCLI upgrade download location> (if upgrading)
zCLI@{server name}(service-zgw)# upgrade list (verify upgrade version and copy file name)
zCLI@{server name}(service-zgw)# upgrade deploy cli <zCLI upgrade file name> (if upgrading)
Check response for errors And follow instructions on the screen to re-enter the enable mode
zCLI@{server name}(service-zgw)# upgrade deploy gw <ZGW upgrade file name>
Check response for errors
zCLI@{server name}(service-zgw)# show swversion (verify upgrade version as expected)
Switch Version: {switch version} Web Portal Version: {ZGW upgrade version} zCLI Version: {zCLI upgrade version}
zCLI@{server name}(service-zgw)# service status
HA active server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... Running Checking zns ... Running
HA standby server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... ZGW service not running Checking zns ... Service is not running
Verify service status of upgraded server
zCLI@{server name}(service-zgw)# service status
Active server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... Running Checking zns ... Running
Standby server response
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... ZGW service not running Checking zns ... Service is not running
Verify HA status of upgraded server
zCLI@{server name}(service-zgw)# ha show
Active server response
This system configured as ACTIVE server is in ACTIVE state now Service IP: {active server IP address} Peer IP: {standby server IP address} Router ID: 241 Interface: em1
Standby server response
This system configured as STANDBY server is in PAUSE state now.
Resume HA on Standby server
zCLI@{server name}(service-zgw)# ha resume
zCLI@{server name}(service-zgw)# service status
keepalived (pid {pid of service}) is active and running... Checking MySQL... Running Checking ZGW service... ZGW service not running Checking zns ... Service is not running
zCLI@{server name}(service-zgw)# ha show
This system configured as STANDBY server is in STANDBY state now Service IP: {standby server IP address} Peer IP: {active server IP address} Router ID: 241 Interface: em1
Upgrade Standby server (use procedures from steps 4, 5, 6)
Redo step 2 to verify all services are up and operational with new version
Redo step 1 to verify zCenter is up and operational with new version
Notes
Options for retrieving the downloadable upgrade package
This step may be customized to 2 sub-steps if zCenter cannot directly reach Zentera provided public URL where zCenter is hosted in a LAN that does not allow traffic to go to Internet:
Download the package to a local drive and transport it to a place that allows https or scp from where zCenter is located.
If the place is a web server with https capability, place the package to the server with an accessible URL likehttps://<web-ip>/path/packageby zCenter, then issue the command below:
zCLI@{server name}(service-zgw)# upgrade download https://<web-ip>/path/package
If the place is a storage server with scp capability, place the package to the server where a user can access after login like /homepath/package, then issue the command below:
zCLI@{server name}(service-zgw)# upgrade download user@<server-ip>:/homepath/package Password: ********
Comments
0 comments
Please sign in to leave a comment.