If you're having trouble at any stage please contact us at support@skyformation.com. 

Upgrading  Procedure

Before starting the upgrade process, a backup for your configurations will occur automatically. 

You will be asked to enter a full path to a non-existing directory where the configurations will be saved.

If the upgrade fails at one of the stages, it will automatically revert your system to its initial state, using the backup directory. In this case, you will receive the following message at the end of the rollback:

"The system has been reverted to its original state. Please open a support call and attach the update log saved in sk4-update-at-<current-date>"

You may use the following flags when running the upgrade: 

• -b or --backup_dir: backup directory for the configurations before the upgrade.
• --nobackup: skip backup configurations process. Note: if you use this flag and the upgrade fails, rollback to the original state will not be possible, not automatically nor manually

The upgrade procedure contains 3 mandatory steps:

1. Prerequisites

- Complete the tasks detailed at:
  SkyFormation Platform Prerequisites 

- Make sure you have your SkyFormation license key  

2. Running software updates

Note: the command uses "screen" in order to run the script in a separate process, such that if the session disconnects it will not disrupt the script's progress. If screen in not installed on the host, it is recommended that it is installed beforehand. If it is not possible to install screen, remove the word screen from the command; keep in mind that any disruption to the session will result in corrupt installation, and a manual restoration to a working state will be required.

 SSH into the SkyFormation app machine with a "sudo"er account

command to use if you have no proxy

sudo screen bash -c "$(curl -L https://download.skyformation.net/v2/download/installer/edge/pre-update.sh)"

command to use if you are running behind a proxy

sudo screen bash -c "$(curl -x https://proxyserver:8080 -L https://download.skyformation.net/v2/download/installer/edge/pre-update.sh)"

Note: if you have an authenticated proxy, and you have special characters in your username or password, you need to send them the curl -x parameter in url-encoded format.

You may use the following command line on your terminal to see the encoded format of your user and password (in this example the password is ab$#^%cd, replace it with yours):

 In case you're having trouble logging into our docker repository, refer to this guide. 

3. Configuring access

Verify that the SkyFormation web app is accessible

    Open your Chrome browser and enter the SkyFormation webapp URL as followed:
    https://<skyformationserver>:8443

    You will see a screen asking you to approve the SkyFormation web app certificate in use

• Press on "ADVANCED" link and then in the expanded part on "Proceed to ..."
  (see the screenshot above)

• Insert in the SkyFormation login screen your SkyFormation user and passowrd

Troubleshooting

If the upgrade failed, or you are interested in reverting the system to its original state manually, you may follow the steps in the following guide: Revert CC to the previous state.

DONE