Upgrading to CloudFS 8.0

Filers that are already running a 7.x release can upgrade directly to 8.0.

For filers running older releases (6.x), the boot partitions will need to be expanded prior to upgrade. Filers running releases older than 6.3.1.5 must first be upgraded to 6.3.1.5. See the table below.

Client SMB connections must be remounted when upgrading from 6.2 or 6.3 to 8.x. Remount is required only for Windows 8, Windows 10, and Windows 2012 clients (clients that support SMBv3).

If you are deploying a new filer, see the installation guide for your platform (hardware, ESXi VM, AWS AMI, or Azure instance).

Hardware Compatibility

FD- 6000 series supports CloudFS 7.1.6 and above.

FD - 5000 series supports CloudFS 6.3.1.5 and above.

Upgrade Steps

The following table shows the upgrade path for each CloudFS version.

Starting Version Upgrade Path

7.x

Any CloudFS release from 7.1.0.0 to the latest 7.1.x.x patch release.

  1. Install the New Image.
  2. Upload the Key File.
6.3.1.5
  1. Install the New Image.
  2. (Earlier than 6.3.1.5 only) Expand VM Boot Partition .
  3. (Earlier than 6.3.1.5 only) Run Partitioning Script.
  4. Upload the Key File.

Note: For help upgrading boot partitions on the AMI platform, contact Panzura Support.

Earlier than 6.3.1.5

You first must upgrade to 6.3.1.5, then use the upgrade steps listed above for 6.3.1.5.

Note: Contact Panzura Support for help upgrading to 6.3.1.5.

 

Install the New Image

To install the new image

On filers running 6.3.1.5 or later, use these steps to install the new image and reboot.

  1. In the WebUI, navigate to Maintenance > System Operations > Upgrade.
  2. Select Image.
  3. Select Local or Panzura, depending on where the filer will look for the image file.
  4. Click Select Image.
  5. Click Upgrade.

(Earlier than 6.3.1.5 only) Expand VM Boot Partition

If running a VM filer on ESXi, on a CloudFS release earlier than 6.3.1.5, use these steps to expand the boot partition.

Note: In the following steps, the screen shots of ESXi may vary from your display, based on the version of vSphere.

  1. Power off the Panzura VM.
  2. Right-click the Panzura VM instance in the left menu and select Power Off.

  3. Expand the boot partition. Right-click the Panzura instance and select Edit Settings.
  4. If the size of the boot disk or first hard disk is less than 50GB, change it to 50GB. Click OK.

  5. Power on the VM.

(Earlier than 6.3.1.5 only) Run Partitioning Script

If running a CloudFS release earlier than 6.3.1.5, use these steps to expand the boot partition, before upgrading to 8.0.0.0.

  1. Log in to the WebUI and select Maintenance > Diagnostics.
  2. Select staging-8.0-upgrade from the Command Type menu and click Run.
    (Example: staging-8.0-upgrade)

Note: The partitioning script takes a few minutes to run for VM filers and up to 20 minutes for a physical filer. While the script runs, messages are displayed in the output area.

• For ESXi, the process includes an automatic shutdown of the VM. After the VM shuts down, restart the VM to complete the partitioning process. Contact Panzura Support for assistance with the upgrade to 8.0.0.0.

• For a physical filer, the processing does not include an automatic shutdown. When you see the success message, reboot the filer to complete the process. Contact Panzura Support for assistance with the upgrade to 8.0.0.0.

Upload the Key File

After you have completed any upgrade, update the encryption settings. On the Key Master:

  1. Navigate to Configuration > Encryption Settings > Authentication Keys.
  2. Click Export to export the pairing.key file to your local system.
  3. Navigate to Configuration > Encryption Settings > Authentication Keys on each of the Subordinate Filers in the CloudFS and upload the pairing.key file.

Downgrade Process

Filers that are already running on an 8.0.0.0 release need to be downgraded to 7.1.9.1 (the landing release) before downgrading to any other 7.x release.

On filers running release versions (7.1.9 or earlier), you can directly downgrade to any 7.x or 6.x release version without any stopover in between.

Note: Since any PZOS earlier than 8.0.0.0 does not support Cloud Mirroring, please deactivate Cloud Mirroring or CMP License before a downgrade to 7.1.9 or earlier.

To Downgrade to any release version, click Configuration > Upgrade and follow the downgrade steps below.

Downgrade Steps

The following table displays the downgrade path for each CloudFS version.

Target Version  
To 7.x Later than 7.1.9.1

1. Install the New Image for 7.1.9.1

2. Upload the Key File.

7.x earlier then 7.1.9.1

1. Downgrade to 7.1.9.1

2. Install the New Image to your desired 7.x version

3. Upload the Key File.

6.x

1. Downgrade to 7.1.9.1

2. Install the New Image to your desired 6.x version

3. Upload the Key File.

Access Denied Error receipt while Downgrading:

If your password to begin the downgrade process is not "enabled", please perform these additional steps:

  • Switch from the original image to any other image
  • Login to CLI, change the enable password to default: enable.
  • On the CLI enter: "enable-password enable"
  • Switch to the image version you wish to downgrade to
  • Perform the following steps to change the password.

If your password to begin the downgrade process is "enabled", please perform these additional steps:

  • Login to cc with support user.
  • Modify "enable-password" field to 2a355074033ce0ab3fc1d9a2ed344c6601efa8de
  • Run command on the CLI:
    echo enablepass=2a355074033ce0ab3fc1d9a2ed344c6601efa8de >>/proc/cfg/7
  • Then you can use default "enable" password.

Note: Please change the enable password if you set it to default "enable"

Note: