ShareFile StorageZones Controller: Preparing for Upgrade

If you are upgrading your StorageZones Controller from a previous version, full documentation of this procedure can be found here: https://docs.citrix.com/en-us/storagezones-controller/5-0/upgrade.html

It is highly recommended that you refer to and read the entire guide before proceeding.

After reading the guide and before starting the update, please ensure the following has taken place:

  • Take a snapshot of the Storage Zone Controller before performing the upgrade
  • Perform necessary backup as per recommendations.

The PowerShell script used in this procedure is unsigned, so you may need to change your PowerShell execution policy. In order to determine if your PowerShell execution policy allows you to run local, unsigned scripts: PS C:>Get-ExecutionPolicy

For example, a policy of RemoteSigned, Unrestricted, or Bypass allows you to run unsigned scripts.

To change your PowerShell execution policy: PS C:>Set-ExecutionPolicy RemoteSigned

Set the user context for this PowerShell session

In a command window, run one of the following commands.

  1. If using the default Network Service account: PsExec.exe -i -u “NT AUTHORITYNetworkService” C:WindowsSysWOW64WindowsPowerShellv1.0powershell
  2. If using a named user for the StorageZones Controller application pool: PsExec.exe -i -u “domainusername” C:WindowsSysWOW64WindowsPowerShellv1.0powershell A PowerShell window opens.
  3. From the PowerShell prompt, import the module ConfigBR.dll: Import-Module “C:inetpubwwwrootCitrixStorageCenterToolsSfConfigBRConfigBR.dll”
  4. You must import the module each time you open a new PowerShell window.
  5. From the PowerShell prompt, run the Get-SfConfig command: Get-SfConfig -PrimaryZoneController “server” -Passphrase “passphrase” -FilePath “fullpath”
    • For example: Get-SfConfig -PrimaryZoneController “https://myserver.domain.com/ConfigService/” -Passphrase “mypassphrase” -FilePath “c:szc-backup.bak”

On the server where you want to upgrade the primary StorageZones Controller

  1. Run StorageCenter.msi to start the ShareFile StorageZones Controller Setup wizard.
  2. Respond to the prompts.
  3. When the installation completes, the wizard displays the message “Completed Citrix ShareFile StorageZones Controller Setup Wizard.”
  4. Click Finish. The StorageZones Controller console opens.
    • Important: If you plan to clone the StorageZones Controller, do not proceed with the configuration. Capture the disk image and then configure each StorageZones Controller.
    • To return to the StorageZones Controller console at any time, open http://localhost/configservice/login.aspx or start the configuration tool from the Start menu.
  5. After you click Finish or return to the StorageZones Controller console, the Logon page opens.
  6. To change any of the displayed information, click Modify, make your changes, and then click Save.
  7. Verify the registry settings on the primary StorageZones Controller: Not all upgrade paths add the registry settings needed to increase the number of files per zone. To enable that feature, verify that the settings are included in the registry. For details, see Increase the number of files per zone in https://docs.citrix.com/en-us/storagezones-controller/5-0/upgrade.html

On each secondary StorageZones Controller

  1. Run StorageCenter.msi to start the ShareFile StorageZones Controller Setup wizard.
  2. Respond to the prompts and then click Finish.
  3. The StorageZones Controller console Logon page opens.
  4. Log on.
  5. To change any of the displayed information, click Modify, make your changes, and then click Save.
  6. Restart the IIS server of all zone members.

Related:

  • No Related Posts

Leave a Reply