Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary

These instructions explain how to upgrade from a version of BrickStorOS 15.1021 and later. Instructions do not provide a specific ID to install, other than in the example below. Each OS image is an entire operating system, and as a result, when installed an OS image does not replace parts of the OS, instead, it is pointed at, and upon reboot is activated. This means that there are no package to update and there is no possibility of a partial update or a failed update, etc. Each image has integrity checking built in, in more than one way to assure that if it installs, it will be correct.

Images are identified via a friendly version alphanumeric string, such as in example below, 16.0108.001ER, and via a less friendly unique identifier such as a5ac36d7ab7bef47b39dcffb13a10213. Command line based tools operate on the less friendly identifier, while the UI offers the more friendly version string.

Installation of an OS image consists of a few steps, whether one uses UI or CLI, they are: download, install, activate, and eventually reboot. It is perfectly safe to download and install a new image at any time. Without activating it, the system will remain as it was before the image being installed. To switch to newly installed image, it must be activated, followed by reboot of operating system.

When a Brickstor is able to reach the internet, it will periodically check for updated OS versions and will inform about new OS being available in the Hardware section of the UI, as seen in the example below.

There may be cases where due to a bug an emergency fix is made and new OS needs to be installed, but the fix may not be published, which will result in Support providing the steps necessary to complete in order to install this emergency fix. Such cases are exceedingly rare. It is also possible that a system unable to reach the internet, in which case similar manual process will have to be followed for installing every OS.

 

Installation

Using myRack Manager

Download the latest image by expanding the Hardware view and clicking on the download arrow next to the desired image.

Image Modified

  1. The download process will display a progress bar. When download is complete, click the thumbs-up icon to activate.



  2. Reboot to load the new image by checking the Reboot option.



  3. Commit and confirm your entry.



  4. When your system has rebooted, the Hardware view should display the following.



Using the console

Obtaining information about what is currently installed on the system is quite trivial both via UI and CLI. Running bsradm os without any further arguments will return pertinent information about current system. An example can be seen below. This is an example from a system running a development build of the OS, but any system in production use will have an R: Release, or ER: Early Release. ERs are produced more frequently, roughly every month, while R's are released quarterly. Stability is not really a matter of choosing R versus ER, but ERs may have features which are young and perhaps not well established yet, while core features while be no less stable than in R.

Code Block
languagetext
themeEclipse
# bsradm os
BootGuid       : 9bf1631fc6fa67e1d933cbacd67821c3
BootloaderVer  : 28
BuildDate      : 2018-07-27 00:00:00 +0000 UTC
DatasetPath    : bp/ROOT/9bf1631fc6fa67e1d933cbacd67821c3
Debug          : false
Node           : bsr-e98896ab
Os             : BrickStorOS
Release        : 18.07
Stability      : Development
Summary        : Development build
Version        : 18.0727.001D
  1. Using any suitable ssh client connect to Brickstor appliance on which OS is going to be updated. Once logged in, you should see a # prompt...
  2. Type bsradm os list -a from and ssh or console session to obtain a list of available OSs. Images are listed oldest to newest, usually latest on the list is what we want.
  3. One will notice that some images appear with an asterisk (*) while others do not. Images with asterisk exist for debug purposes and should not be installed without explicit instruction from support to do so.
  4. Note the guid for the image you want to download.
  5. Type bsradm os download <guid>, alternatively, word download could be abbreviated to dl, without any changes in outcome.
  6. Once downloaded, type bsradm os install <guid>, alternatively, word install could be abbreviated to in, without any changes in outcome.
  7. After installation, type bsradm os activate <guid>, alternatively, word activate could be abbreviated to ac, without any changes in outcome.
  8. You may now reboot your system to load the new image, or reboot at another time. It is perfectly fine to run for an indefinite period of time with image installed and activated.

    Code Block
    languagetext
    themeEclipse
    # bsradm os download a5ac36d7ab7bef47b39dcffb13a10213
    # bsradm os install a5ac36d7ab7bef47b39dcffb13a10213
    # bsradm os activate a5ac36d7ab7bef47b39dcffb13a10213
    # reboot

Manual Installation

These steps are only necessary if system is disconnected from the internet and has no means of downloading using integrated tools as described above.

  1. Contact support for assistance with obtaining latest, or in some cases specifically recommended version of the OS.
  2. Copy the <image_name>.rap file to /var/cache/bsrupdate.
  3. Type bsradm os list -c to list available imagesType images in the cache. You should now expect to see guid of the image that was copied in previous step.
  4. Type bsradm os install <guid> to install the imageType , alternatively, word install could be abbreviated to in, without any changes in outcome.
  5. After installation, type bsradm os activate <guid> to activate the image, alternatively, word activate could be abbreviated to ac, without any changes in outcome.
  6. You may now reboot your system to load the new image, or reboot at another time. It is perfectly fine to run for an indefinite period of time with image installed and activated.