Upgrading

The following topics explain how to upgrade to BrickStor SP Release 23.2 for single-node configurations.

Please contact RackTop support for specific upgrade instructions if you are upgrading from release 21.x or prior.
Please contact RackTop support to arrange for assistance when upgrading a BrickStor SP HA cluster configuration.
If your BrickStor is in an air-gapped network or otherwise unable to download the latest version from the public internet, you can request a download link at https://support.racktopsystems.com or by contacting RackTop support to arrange alternative means.

Pre-upgrade Considerations

There are some important items to note when upgrading from Release 22 to Release 23.2. The email and report system has been greatly improved in Release 23.2, but this means any existing email and report configurations will not be carried forward and will need to be configured after the upgrade is complete. Please review these settings and note them where necessary prior to commencing with the upgrade.

Upgrading a Single Node BrickStor using the latest BrickStor SP Manager

The following steps demonstrate the upgrade process for a single, standalone BrickStor SP configuration.

1. Beginning the upgrade

up step1

  • Connect the BrickStor SP Manager to your appliance.

  • Choose Upgrade OS / Manage Versions to perform the upgrade.

2. Download the new OS version

up get step2 up get step3

  • Choose the version to download by clicking the Download link.

3. Activating OS Version

up get step 4 public

  • Once downloaded, click the "play" icon to activate at next boot.

4. Commit the OS Upgrade Change

up get step5

  • Commit the change in the Changes pane.

5. Reboot the System

up get step6

The BrickStor SP appliance will now reboot into the new version of the OS. After it does so, navigate to its IP address or hostname in a web browser and log in. You will be asked to review and accept the Terms & Conditions before proceeding. Once you have done that, you will be able to download the new version of the BrickStor SP Manager.

Post-Upgrade Tasks

Once you are connected to your BrickStor SP system using the new version of the BrickStor SP Manager, be sure to do the following:

  • Reconfigure any SMTP email settings.

  • Review and configure any desired report settings.

  • Review the rest of this documentation for new features that you may wish to configure or activate.

Upgrading Distributed Configuration Database (confd) from 23.0.6 to 23.2

Preparation

Proceed to the following steps to insure prerequisites before the HA and confd upgrade are fulfilled:

  • Upgrade both hosts to same version of 23.2 through the UI, balance pools as necessary, and ensure cluster nodes are online.

  • Ensure hiavd and confd services are online.

  • You have already installed the BrickStor SP GUI 23.2.

BrickStor SP should prompt two errors, hiavd is running 23.0 instead of 23.2, and a confd issue.
If not logged onto domain controller, make time source <IP of Time Server> and click sync now.
  • Make sure that the windows system can ping all members of the cluster, and vice versa.

Some versions of windows may disable ICMP echo either by default or by policy.

HA Prerequisites

Instance 0

To upgrade a confd from an Instance 0 install on the witness:

  • Install confd as Instance 0 - don’t start the service

Instance must be specified to 0.
  • Disable the existing confd service

  • Open the existing confd instance folder (eg. c:\racktop*example*)

  • Copy the entire original data directory to c:\program files\racktop\brickstor\confd\00\data

  • Copy the .svc.creds from c:\racktop to c:\program files\racktop\brickstor\confd\00\cfg

  • Copy the confd.conf from c:\racktop to c:\program files\racktop\brickstor\confd\00\cfg

  • From the Administrator command line, run c:\program files\racktop\brickstor\confd\00\confd.exe -svc

  • If you see authentication errors, input ctrl+c

  • From the Administrator command line, run c:\program files\racktop\brickstor\confd\00\confd.exe -svc -node-acct-recovery

    • The default user/pass for the etcd database is root/racktop.

  • From the Administrator command line, run c:\program files\racktop\brickstor\confd\00\confd.exe -svc.

  • Input ctrl+c, and start the system normally.