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

1. 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

2. 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

3. 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.

4. 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

5. 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

6. 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.

7. 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

8. Upgrade Standby server (use procedures from steps 4, 5, 6)

9. Redo step 2 to verify all services are up and operational with new version

10. Redo step 1 to verify zCenter is up and operational with new version

Notes

1. 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:

     1. Download the package to a local drive and transport it to a place that allows https or scp from where zCenter is located.

     2. 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: ********