Upgrade from 2019.2

Unzip the file that contains the upgrade script:

tar -xvzf PATH/TO/promote_upgrade_2019.3.0.tar.gz

Navigate to the extracted Promote 2019.3.0 upgrade directory:

cd promote_upgrade_2019.3.0.tar.gz

Open the upgrade script with a text editor (such as vi):

vi upgrade.sh

After you open the file, you should see this:

# List ALL your existing nodes IPs to the NODE_IPS variable in bash array format.
# If your cluster has more than three nodes, add their IP addresses to the array.

NODE_IPS=( '' '' '' )

# Add your ssh user and key path here:

SSH_USER=''
KEY_PATH=''

Within each set of single quotation marks, use vi to insert this information:

After you update the empty fields with needed information, the file should look like this:

# List ALL your existing nodes IPs to the NODE_IPS variable in bash array format.
# If your cluster has more than three nodes, add their IP addresses to the array.

NODE_IPS=( 'NODE1_IP' 'NODE2_IP' 'NODE3_IP' 'NODE4_IP' )

# Add your ssh user and key path here:

SSH_USER='USERNAME_FOR_SSH'
KEY_PATH='PATH/TO/SSH/KEY'

Run the upgrade script:

sh ./upgrade.sh

The script prompts you to make a couple selections. Confirm that all information is correct by providing either a yes or no response:

If the script detects a custom-overlay subnet configuration in the promote.yml file on your nodes, the script asks if you would like to maintain it. We recommend that you answer yes if you see this prompt. If you answer no, the script removes your custom subnet configuration and continues with default settings.

The script asks if Promote is currently running. If so, answer yes, because you have to stop Promote to upgrade.

After you make those selections, the script kicks off several upgrade actions on your nodes:

1. Your manager node performs these actions:

2. All nodes perform these actions:

3. Promote then restarts, which triggers a redeploy of all models.

After the script completes, wait for Promote services to build the UI and verify that it is up and running. You can watch these services generate:

watch -n .3 docker services ls

Check the Promote UI to verify that it is running and that all your models successfully redeploy.