ZIRO Provisioning for Cisco (ZPM) Upgrade Guide

Follow this guide to upgrade your ZPM instance to the latest version. This guide support ZPM version 6.0 and later.

WHAT YOU WILL NEED

Tools

• FTP Client (WinSCP, FileZilla, etc)
  This will be used to move the upgrade file(s) onto the ZPM machine.

• SSH Client (Putty, SecureCRT, etc)
  This will be used to connect to the ZPM machine via the stack8-console and perform the upgrade.

Credentials to your s8admin account

This is the account you will use to connect to the stack8-console via SSH. The default password for the s8admin account is $tacK8, unless your team changed it during the initial deployment of the ZPM OVA.

Upgrade files _{(links to the latest version are available from the ZIRO Customer Portal, get in touch with Stack8 Support or your CSM for more infos)}

• Latest version of stack8-console

• Latest version of ZPM

DOWNLOAD UPGRADE FILES PROVIDED BY EMAIL

In order to upgrade ZPM, you will use the stack8-console built into the ZPM machine. The stack8-console also receives periodic updates and needs to be kept up to date.

The stack8-console version is visible immediately after logging into the machine.

Get in touch with our Support team to receive the links to the latest versions of both ZPM and the stack8-console upgrade files. Please download them to your local machine before proceeding to step 3.

CONNECT VIA SFTP TO UPLOAD FILES TO THE ZPM MACHINE (VIDEO)

 1. Open your chosen SFTP client and connect to ZPM using your s8admin credentials:

• Username: s8admin

• Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM machine) 

2. Navigate to the ~/deb-repo folder 

3. Upload the files to the folder

CONNECT VIA SSH TO UPGRADE THE STACK8-CONSOLE (VIDEO)

1. Open your chosen SSH client and connect to ZPM using your s8admin credentials:

• Username: s8admin

• Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM machine) 

2. Select the Install/Upgrade Applications menu item

3. Select the stack8-console file and version which matches the file you uploaded in Step “Connect via SFTP to Upload Files to the ZPM Machine”.

CONNECT VIA SSH TO UPGRADE ZPM (VIDEO)

1. Open your chosen SSH client and connect to ZPM using your s8admin credentials:

• Username: s8admin

• Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM machine)  

2. Select the Install/Upgrade Applications menu item

3. Select the smacs file and version which matches the file you uploaded in Step 3.

4. You will receive the following prompt:  “Which instance of SMACS do you want to upgrade?”

• Select the inactive side which is not yet receiving your production traffic.

The upgrade will take a few minutes.  Wait to receive confirmation that the upgrade is complete.

FLIP YOUR PRODUCTION TRAFFIC (VIDEO)

Connect to the inactive and upgraded side of your ZPM machine by using the relevant port (8443 or 8444) visible from the Routing & Traffic Flip section of the stack8-console.(i.e. ZPM.mydomain.com:8443)

In the above example, sideA is still running on the old version and receiving production traffic (indicated by the green checkmark), while sideB is upgraded to the newer version but not yet receiving production traffic.  In this example, entering 172.20.34.21:8444 into your browser will bring you to the inactive side of the machine.

1. Open your chosen SSH client and connect to ZPM using your s8admin credentials:

   1. Username: s8admin

   2. Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM machine)  

2. Select the Routing & Traffic Flip menu item and select smacs.

3. You will be presented the routing table and receive the following prompt: 

   1. “Would you like to flip your production traffic?” 
      Type “y” and hit ENTER key.

4. You will receive a 2^nd prompt: 

   1. “Would you like to import the LIVE side application settings to other side (i.e. configurations, audits, etc...) before performing the traffic flip?”
      Type “y” and hit ENTER key

 Now wait for the import of the configurations and traffic flip to complete.