Print Download PDF Send Feedback

Previous

Next

Optimal Service Upgrade of a VSX Cluster

Important - Before you upgrade a cluster:

Step

Description

1

Back up your current configuration.

Important - Back up both the Management Server and the VSX Cluster Members. Follow sk100395: How to backup and restore VSX gateway.

2

See the Upgrade Options and Prerequisites.

3

See the Planning a Cluster Upgrade.

4

Upgrade the Management Server and Log Servers to R80.20 version.

5

Schedule a full maintenance window to make sure you can make all the desired custom configurations again after the upgrade.

The procedure below describes an example VSX Cluster with three Cluster Members M1, M2 and M3. However, you can use it for clusters that consist of two or more Cluster Members.

Cluster States

General Upgrade Action Plan

The VSX Cluster Member M1 is the Active.

The VSX Cluster Members M2 and M3 are Standby.

  1. On the Management Server - upgrade the configuration of the VSX Cluster object to R80.20.
  2. Upgrade, or Clean Install the Standby VSX Cluster Members M2 and M3.

    The upgraded VSX Cluster Members M2 and M3 change their cluster state to Ready.

    The old VSX Cluster Member M1 changes its cluster state to Active Attention.

  3. From the Management Server, reconfigure the Standby VSX Cluster Members M2 and M3.
  4. Disconnect the upgraded VSX Cluster Members M2 and M3 from their networks.
  5. On one of the upgraded VSX Cluster Members (M2), connect the Sync cable.
  6. Start the Optimal Service Upgrade - on the Active old VSX Cluster Member M1 and on the connected upgraded VSX Cluster Member M2.
  7. Stop the Optimal Service Upgrade - on the Active old VSX Cluster Member M1 and on the connected upgraded VSX Cluster Member M2.
  8. Disconnect the Active old VSX Cluster Member M1 from its networks.
  9. Reconnect the upgraded VSX Cluster Members M2 and M3 (one by one) to their networks.
  10. Upgrade, or Clean Install the old VSX Cluster Member M1.
  11. From the Management Server, reconfigure the VSX Cluster Member M1.
  12. Cluster states of the VSX Cluster Members are: one is Active, others are Standby.
  13. On each VSX Cluster Member, change the CCP mode to Auto.
  14. Install the Threat Prevention Policy on the VSX Cluster object.

Workflow:

  1. On the Management Server - Upgrade the configuration of the VSX Cluster object to R80.20
  2. On the VSX Cluster Member M2 - Upgrade to R80.20 with CPUSE, or perform a Clean Install of R80.20
  3. On the VSX Cluster Member M3 - Upgrade to R80.20 with CPUSE, or perform a Clean Install of R80.20
  4. In SmartConsole - Install the Access Control Policy
  5. On each VSX Cluster Member - Examine the cluster state
  6. Disconnect the upgraded VSX Cluster Members M2 and M3 from their networks
  7. On one of the upgraded VSX Cluster Members M2 connect all the cables
  8. On the old VSX Cluster Member M1 - Start the Optimal Service Upgrade
  9. On the connected upgraded VSX Cluster Member M2 - Start the Optimal Service Upgrade
  10. On the old VSX Cluster Member M1 - Stop the Optimal Service Upgrade
  11. On the connected upgraded VSX Cluster Member M2 - Stop the Optimal Service Upgrade
  12. Disconnect the old VSX Cluster Member M1 from its networks
  13. Reconnect the upgraded VSX Cluster Member M2 to its networks
  14. Reconnect the upgraded VSX Cluster Member M3 to its networks
  15. On the old VSX Cluster Member M1 - Upgrade with CPUSE, or perform a Clean Install
  16. In SmartConsole - Install the Access Control Policy
  17. On each VSX Cluster Member - Examine the VSX state
  18. On each VSX Cluster Member - Examine the cluster state
  19. On each VSX Cluster Member - Change the CCP mode to Auto
  20. In SmartConsole - Install the Threat Prevention Policy
  21. Test the functionality

Step 1 of 21: On the Management Server - Upgrade the configuration of the VSX Cluster object to R80.20

Step

Description

1

Connect to the command line on the Security Management Server or Multi-Domain Server that manages this VSX Cluster.

2

Log in to the Expert mode.

3

On a Multi-Domain Server, go to the context of the Main Domain Management Server that manages this VSX Cluster object:

mdsenv <IP Address or Name of Main Domain Management Server>

4

Upgrade the configuration of the VSX Cluster object to R80.20:

4A

Run:

vsx_util upgrade

This command is interactive.

4B

Enter these details to log in to the management database:

  • IP address of the Security Management Server or Main Domain Management Server that manages this VSX Cluster
  • Management Server administrator's username
  • Management Server administrator's password

4C

Select your VSX Cluster.

4D

Select R80.20.

4E

For auditing purposes, save the vsx_util log file:

  • On a Security Management Server:

    /opt/CPsuite-R80.20/fw1/log/vsx_util_YYYYMMDD_HH_MM.log

  • On a Multi-Domain Server:

    /opt/CPmds-R80.20/customers/<Name_of_Domain>/CPsuite-R80.20/fw1/log/vsx_util_YYYYMMDD_HH_MM.log

5

Connect with SmartConsole to the R80.20 Security Management Server or Main Domain Management Server that manages this VSX Cluster.

6

From the left navigation panel, click Gateways & Servers.

7

Open the VSX Cluster object.

8

From the left navigation tree, click the General Properties page.

9

Make sure in the Platform section, the Version field shows R80.20.

10

Click Cancel (do not click OK).

Note - If you click OK, the Management Server pushes the VSX configuration to the VSX Cluster Members. Because the VSX Cluster Members are not upgraded yet, this operation would fail.

Step 2 of 21: On the VSX Cluster Member M2 - Upgrade to R80.20 with CPUSE, or perform a Clean Install of R80.20

Installation Method

Instructions

Upgrade to R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Upgrade.

Clean Install of R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Clean Install.

Clean Install of R80.20 from scratch

See Installing a VSX Cluster.

  1. In the Gaia First Time Configuration Wizard, for the Management Connection IP address, you must use the same IP address as was used by the previous VSX Cluster Member (prior to the upgrade).
  2. After you complete the Gaia First Time Configuration Wizard and reboot, run the vsx_util reconfigure command on the Management Server to push the VSX configuration to the VSX Cluster Member. You must enter the same Activation Key you entered during the First Time Configuration Wizard of the VSX Cluster Member.

Note - You must reboot the VSX Cluster Member after the upgrade or clean install.

Step 3 of 21: On the VSX Cluster Member M3 - Upgrade to R80.20 with CPUSE, or perform a Clean Install of R80.20

Installation Method

Instructions

Upgrade to R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Upgrade.

Clean Install of R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Clean Install.

Clean Install of R80.20 from scratch

See Installing a VSX Cluster.

  1. In the Gaia First Time Configuration Wizard, for the Management Connection IP address, you must use the same IP address as was used by the previous VSX Cluster Member (prior to the upgrade).
  2. After you complete the Gaia First Time Configuration Wizard and reboot, run the vsx_util reconfigure command on the Management Server to push the VSX configuration to the VSX Cluster Member. You must enter the same Activation Key you entered during the First Time Configuration Wizard of the VSX Cluster Member.

Note - You must reboot the VSX Cluster Member after the upgrade or clean install.

Step 4 of 21: In SmartConsole - Install the Access Control Policy

Step

Description

1

Connect with SmartConsole to the R80.20 Security Management Server or Main Domain Management Server that manages this VSX Cluster.

2

From the left navigation panel, click Gateways & Servers.

3

Click Install Policy.

4

In the Install Policy window:

  1. In the Policy field, select the applicable Access Control Policy that is called:

    <Name_of_VSX_Cluster_object>_VSX

  2. In the Install Mode section, configure these two options:
    • Select Install on each selected gateway independently.
    • Clear For gateway clusters, if installation on a cluster member fails, do not install on that cluster.
  3. Click Install.

5

The Access Control Policy successfully installs on the upgraded VSX Cluster Members M2 and M3.

The Access Control Policy installation fails on the old VSX Cluster Member M1 with a warning. Ignore this warning.

Step 5 of 21: On each VSX Cluster Member - Examine the cluster state

Step

Description

1

Connect to the command line on each VSX Cluster Member.

2

Examine the cluster state:

  • In Gaia Clish (R80.20 and above), run:

    set virtual-system 0

    show cluster state

  • In Expert mode, run:

    vsenv 0

    cphaprob state

Notes:

  • The cluster states of the upgraded VSX Cluster Members M2 and M3 are Ready.
  • The cluster state of the old VSX Cluster Member M1 is Active Attention.

Step 6 of 21: Disconnect the upgraded VSX Cluster Members M2 and M3 from their networks

Step

Description

1

Select one VSX Cluster Member M1 to process the current connections.

2

Completely disconnect all other VSX Cluster Members M2 and M3 from their networks (this includes the Management Server).

Step 7 of 21: On one of the upgraded VSX Cluster Members M2 connect the Sync cable

Step

Description

1

Connect all the cables to one of the upgraded VSX Cluster Members M2.

2

Make sure traffic (for example, pings) can pass on the Sync interface to the old VSX Cluster Member M1.

Step 8 of 21: On the old VSX Cluster Member M1 - Start the Optimal Service Upgrade

Step

Description

1

Connect to the command line on the old VSX Cluster Member M1.

2

Log in to the Expert mode.

3

Start the Optimal Service Upgrade:

[Expert@MemberOld:0]# cphaosu start

Step 9 of 21: On the connected upgraded VSX Cluster Member M2 - Start the Optimal Service Upgrade

Step

Description

1

Connect to the command line on the connected upgraded VSX Cluster Member M2.

2

Log in to the Expert mode.

3

Start the Optimal Service Upgrade:

[Expert@MemberNew:0]# cphaosu start

Step 10 of 21: On the old VSX Cluster Member M1 - Stop the Optimal Service Upgrade

Step

Description

1

Connect to the command line on the old VSX Cluster Member M1.

2

Log in to the Expert mode.

3

Monitor the amount of traffic for some time:

[Expert@MemberOld:0]# cphaosu stat

4

When the old VSX Cluster Member does not have many connections (in your opinion), stop the Optimal Service Upgrade:

[Expert@MemberOld:0]# cphaosu finish

Step 11 of 21: On the connected upgraded VSX Cluster Member M2 - Stop the Optimal Service Upgrade

Step

Description

1

Connect to the command line on the connected upgraded VSX Cluster Member M2.

2

Log in to the Expert mode.

4

Stop the Optimal Service Upgrade:

[Expert@MemberNew:0]# cphaosu finish

Step 12 of 21: Disconnect the old VSX Cluster Member M1 from its networks

Completely disconnect the old VSX Cluster Member M1 from its networks (this includes the Management Server).

Step 13 of 21: Reconnect the upgraded VSX Cluster Member M2 to its networks

Step

Description

1

Connect to the command line on the upgraded VSX Cluster Member M2.

2

Log in to the Expert mode.

3

Stop the cluster:

[Expert@MemberNew:0]# cphastop

4

Connect the upgraded VSX Cluster Member M2 to all its network (this includes the Management Server)

5

Start the cluster:

[Expert@MemberNew:0]# cphastart

Step 14 of 21: Reconnect the upgraded VSX Cluster Member M3 to its networks

Step

Description

1

Connect to the command line on the upgraded VSX Cluster Member M3.

2

Log in to the Expert mode.

3

Stop the cluster:

[Expert@MemberNew:0]# cphastop

4

Connect the upgraded VSX Cluster Member M3 to all its network (this includes the Management Server)

5

Start the cluster:

[Expert@MemberNew:0]# cphastart

Step 15 of 21: On the old VSX Cluster Member M1 - Upgrade with CPUSE, or perform a Clean Install

Upgrade or perform Clean Install for all the VSX Cluster Members (in our example, M2 and M3),
except for the VSX Cluster Member with the lowest Cluster Member ID (in our example, M1).

Installation Method

Instructions

Upgrade to R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Upgrade.

Clean Install of R80.20 with CPUSE

See Installing Software Packages on Gaia.

Follow the applicable action plan for the local or central installation.

Select the R80.20 package and perform Clean Install.

Clean Install of R80.20 from scratch

See Installing a VSX Cluster.

  1. In the Gaia First Time Configuration Wizard, for the Management Connection IP address, you must use the same IP address as was used by the previous VSX Cluster Member (prior to the upgrade).
  2. After you complete the Gaia First Time Configuration Wizard and reboot, run the vsx_util reconfigure command on the Management Server to push the VSX configuration to the VSX Cluster Member. You must enter the same Activation Key you entered during the First Time Configuration Wizard of the VSX Cluster Member.

Note - You must reboot the VSX Cluster Member after the upgrade or clean install.

Step 16 of 21: In SmartConsole - Install the Access Control Policy

Step

Description

1

Connect with SmartConsole to the R80.20 Security Management Server or Domain Management Server that manages this VSX Cluster.

2

From the left navigation panel, click Gateways & Servers.

3

Click Install Policy.

4

In the Install Policy window:

  1. In the Policy field, select the applicable Access Control Policy that is called:

    <Name_of_VSX_Cluster_object>_VSX

  2. In the Install Mode section, select these two options:
    • Install on each selected gateway independently
    • For gateway clusters, if installation on a cluster member fails, do not install on that cluster
  3. Click Install.

5

The Access Control Policy successfully installs on all the VSX Cluster Members.

Step 17 of 21: On each VSX Cluster Member - Examine the VSX state

Step

Description

1

Connect to the command line on each VSX Cluster Member.

2

Log in to the Expert mode.

3

Examine the VSX state:

vsenv 0

vsx stat -v

Notes:

  • Make sure all the configured Virtual Devices are loaded.
  • Make sure all Virtual Systems and Virtual Routers have policy and SIC.

Step 18 of 21: On each VSX Cluster Member - Examine the cluster state

Step

Description

1

Connect to the command line on each VSX Cluster Member.

2

Examine the cluster state:

  • In Gaia Clish (R80.20 and above), run:

    set virtual-system 0

    show cluster state

  • In Expert mode, run:

    vsenv 0

    cphaprob state

Note - The cluster states of the VSX Cluster Members are: one is Active, others are Standby.

Step 19 of 21: On each VSX Cluster Member - Change the CCP mode to Auto

Step

Description

1

Connect to the command line on each VSX Cluster Member.

2

Change the CCP mode:

  • In Gaia Clish, run:

    set virtual-system 0

    set cluster member ccp auto

    save config

  • In Expert mode, run:

    vsenv 0

    cphaconf set_ccp auto

Notes:

  • This change does not require a reboot.
  • This change applies immediately and survives reboot.

3

Make sure the CCP mode is set to Auto:

  • In Gaia Clish, run:

    set virtual-system 0

    show cluster members interfaces all

  • In Expert mode, run:

    vsenv 0

    cphaprob -a if

Step 20 of 21: In SmartConsole - Install the Threat Prevention Policy

Step

Description

1

Connect with SmartConsole to the R80.20 Security Management Server or Domain Management Server that manages this VSX Cluster.

2

From the left navigation panel, click Gateways & Servers.

3

Click Install Policy.

4

In the Policy field, select the applicable Threat Prevention Policy.

5

Click Install.

Step 21 of 21: Test the functionality

Step

Description

1

Connect with SmartConsole to the R80.20 Security Management Server or Main Domain Management Server that manages the Virtual Systems on this VSX Cluster.

2

From the left navigation panel, click Logs & Monitor > Logs.

3

Examine the logs from Virtual Systems on this VSX Cluster to make sure they inspect the traffic as expected.

For more information, see the: