Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Table of Contents
maxLevel7
minLevel1

WHAT YOU WILL NEED

Tools

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

  • SSH Client (Putty, SecureCRT, etc)
    This will be used to connect to the ZPM ZPC 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 ZPC OVA.

Upgrade files (links to the latest version are available from the ZIRO Customer Portal)

  • Latest version of stack8-console

  • Latest version of ZPMZPC

DOWNLOAD UPGRADE FILES PROVIDED BY EMAIL

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

...

Get in touch with our Support team to receive the links to the latest versions of both ZPMZPC 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

...

ZPC MACHINE (VIDEO)

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

  • Username: s8admin

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

2. Navigate to the ~/deb-repo folder 

...

Warning

The upgrade will not be possible unless the files are uploaded to the correct folder!

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

 

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

  • Username: s8admin

  • Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM ZPC 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 ZPC Machine”.

Note

You will be logged out of the machine once the upgrade completes.

Tip

You have successfully upgraded the stack8-console!

CONNECT VIA SSH TO UPGRADE

...

ZPC (VIDEO)

Note

 IMPORTANT NOTE: As of version 6.5.0 of ZPMZPC, upgrading ZPM ZPC will not be permitted if the stack8-console is not running the latest available version. (See video for details)

Upgrade the stack8-console before upgrading ZPM ZPC to avoir any issues. 

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

  • Username: s8admin

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

2. Select the Install/Upgrade Applications menu item

...

Tip

You have successfully upgraded ZPM ZPC on the inactive side of the machine.

FLIP YOUR PRODUCTION TRAFFIC (VIDEO)

Note

Important Note:

Before pointing your production traffic to the newest version of ZPMZPC, we suggest performing some smoke tests on the new version to make sure it is working well in your environment.

Connect to the inactive and upgraded side of your ZPM ZPC machine by using the relevant port (8443 or 8444) visible from the Routing & Traffic Flip section of the stack8-console.(i.e. ZPM zpc.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.

...

Warning

The traffic flip will log out anybody currently working in ZPMZPC, but there is no other downtime required.

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

    1. Username: s8admin

    2. Default password: $tacK8 (this password should have been changed during the initial deployment of your ZPM ZPC 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 2nd 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

...

Tip

You have successfully imported your configuration and flipped your production traffic. You are now running the latest version of ZPM ZPC in production! 🎈🎉

Note

Updating from SMACS/ZPM ZPC 6.x to 7.x or 8.x? Do not forget to also go through the Virtual Machine Ressources Upgrade Guide!