Installation Guide

This help article applies to CloudShell 9.3. To see the latest, click here.

You are here: Maintenance of the HA Plugin > Upgrading the CloudShell HA Plugin

Upgrading the CloudShell HA Plugin

This section describes the required steps to upgrade the Quali server clustering environment to a new version of CloudShell.

Repeat the following procedure for each Quali Server node in the Quali server clustering environment.

Note: Do not perform this procedure in parallel. Upgrade each node separately.

To upgrade CloudShell:

  1. Open Windows Failover Cluster Manager.
  1. Right-click the Quali Server role and select Stop Role.

    When the role stops, a Java process starts.

  1. In Task Manager, close the java.exe process (do this in all of the nodes in the cluster).

    If more than one Java process is running, the java.exe process that is running from the Quali server folder must be closed.

  2. Navigate to the following folder:

    ~Qualisystems\CloudShell\Server\Quicksearch\config

  3. Make a backup copy of the elasticsearch.yml file and move the backup copy to another folder as this file is overwritten during the upgrade process.
  4. Download the latest official HA Plugin from the Quali's Download Center.
  5. Copy the Quali server files to the same folder where the files from the earlier version are saved. Replace old files if needed. When upgrading, use the Quali.vbs file from the new version plus the Functions.ps1 file provided in the new HA Plugin.
  6. Perform the following steps for each node (do not perform this procedure in parallel, upgrade each node separately):
    1. Install the new version of CloudShell.
    2. Run the server Quali Server Configuration wizard.
  7. Stop the Quali Server service and then perform the following steps:
    1. Change the Quali Server service to Manual.
    2. Copy the backup elasticsearch.yml file to the correct location:

      ~Qualisystems\CloudShell\Server\Quicksearch\config

  8. Start the Quali Server service, ensuring that the service starts successfully.
  9. Open Windows Failover Cluster Manager.
  10. Right-click the Quali Server node and in the context menu click Start Role to start the Cluster Quali Server Role.
  11. Move the role between all nodes – see Moving a WSFC Role between Nodes.