9.3

Edit

Upgrade from v8.5.x to v9.3.x

Overview

This guide describes the steps for in-place SPA upgrade from 8.5.x to 9.3.x. During the upgrade procedure, the installer creates a backup of the current config files, replaces them with new versions, and overrides values in new files with those from the old installation.

Do not change passwords when performing this upgrade. Use the same passwords from your SPA 8.5 installation. Otherwise, upgrade will fail. Changing passwords is supported after upgrading to SPA 9.3. Do not use dots "." in paths

Prerequisites

  • WorkFusion SPA 8.5.x is installed on RHEL 7.
  • WorkFusion SPA 9.3.x product install packages are downloaded and extracted to <PACKAGE_DIR> on all servers.
  • s3_hostname added as additional A or CNAME record for APP server.
  • APP server's TLS certificate must be valid for both app_hostname and s3_hostname (either wildcard, or SAN).
  • Prepare Business Processes to upgrade Migration Notes.

Predefined common variables (set your own values in config.yml before installation):

  • WorkFusion user. Default is wfuser.
  • WorkFusion Home Directory. Default is /opt/workfusion.
  • WorkFusion Installer Directory. Default is /opt/workfusion/wf_installer. Available:
  • apm: APM server
  • app: APP server
  • db: DB server
  • ocr: OCR server
  • vds-master: AutoML Master server
  • vds-slave: AutoML Agent server

Preparation steps

Ensure, that DNS names for servers are configured according to DNS names configuration section.

The following DNS names are not required in 9.3 and can be removed:

crowdcontrol.taglib.db.example.com
cv-help.db.example.com
doc-upload.db.example.com
logos.crowdcomputing.db.example.com
public.crowdcontrol.db.example.com
recorder-images.db.example.com
secdocs.db.example.com
tinymce-resources.db.example.com
vds-models.db.example.com
vds-resources.db.example.com
workfusion-resources.db.example.com
workfusiondevelopment.db.example.com
workspace-resources.db.example.com

  1. Stop all processes on all servers.

    • SSH into the <SERVER_ROLE> server.

    • Run as:

    wfmanager stop all

  2. Copy certificates and configs into <PACKAGE_DIR>.

  3. The old certificates, secrets and config files can be reused from previous installation. Run as <WF_USER> on all servers:

    cd <PACKAGE_DIR>
cp -r <INSTALL_DIR>/distr/2018-04-28-1524913731/certificates .
cp <INSTALL_DIR>/distr/2018-04-28-1524913731/config.yml ./config_overrides.yml
cp <INSTALL_DIR>/distr/2018-04-28-1524913731/secrets.yml ./secrets_overrides.yml

  4. Turn off passwords verification checks. Starting from version 9.1, we introduced verification for passwords complexity on precheck phase:

    Note the following password policy rules for secrets.yml:

    • In passwords, English alphabetical characters must be used.
    • Passwords must contain 6-20 characters.
    • Passwords must contain at least one capital letter [A-Z].
    • Passwords must contain at least one number [0-9].
    • Passwords must contain at least one of the following special symbols unless limitations are explicitly described in comments: "!", "*", "#", "%", "^", "@".
    • Passwords must not contain the following symbols: "$", "&".

    The passwords verification may cause failures during the upgrade. The thing is passwords from previous installation will be used during the upgrade and they may not satisfy new passwords requirements.

    cd <PACKAGE_DIR>
echo "passwords_check: false" >> ./config_overrides.yml

  5. Add s3_hostname into the config file:

    cd <PACKAGE_DIR>
echo "s3_hostname: app-s3.hostname" >> ./config_overrides.yml

  6. Copy the license file. The license file should be copied to APP Server only.

    Run as <WF_USER>.

    cp <INSTALL_DIR>/license.properties .

Upgrade order

  • DB Server

  • APP Server

  • Other Servers (can be updated in parallel)

Upgrade steps

Go to WorkFusion Installer Directory:

cd <PACKAGE_DIR>

DB, APP, APM, OCR servers

  1. Perform precheck and preinstall operations.

    Run as root

    ./install.sh precheck <SERVER_ROLE> -e @config_overrides.yml -e @secrets_overrides.yml
./install.sh preinstall <SERVER_ROLE> -e @config_overrides.yml -e @secrets_overrides.yml

  2. Perform installation and post-install check operations.

    Run as:

    ./install.sh install <SERVER_ROLE> -e @config_overrides.yml -e @secrets_overrides.yml
./install.sh check <SERVER_ROLE> -e @config_overrides.yml -e @secrets_overrides.yml

AutoML Master Server

  1. Perform precheck and preinstall operations.

    Run as root:

    ./install.sh precheck vds-master -e @config_overrides.yml -e @secrets_overrides.yml -e ''{\'vds_update_zookeeper_config\':false}''
./install.sh preinstall vds-master -e @config_overrides.yml -e @secrets_overrides.yml -e ''{\'vds_update_zookeeper_config\':false}''

  2. Perform installation and post-install check operations.

    ./install.sh install vds-master -e @config_overrides.yml -e @secrets_overrides.yml -e ''{\'vds_update_zookeeper_config\':false}''
./install.sh check vds-master -e @config_overrides.yml -e @secrets_overrides.yml -e ''{\'vds_update_zookeeper_config\':false}''

AutoML Agent Server

  1. Perform precheck and preinstall operations.

    Run as root:

    ./install.sh precheck vds-slave -e @config_overrides.yml -e @secrets_overrides.yml
./install.sh preinstall vds-slave -e @config_overrides.yml -e @secrets_overrides.yml

  2. Perform installation and post-install check operations.

    ./install.sh install vds-slave -e @config_overrides.yml -e @secrets_overrides.yml
./install.sh check vds-slave -e @config_overrides.yml -e @secrets_overrides.yml

After upgrade to 9.3, the default workfusion password will be changed to wf_password from secrets.yml.

Post-upgrade steps

You can review difference between old configuration files and new in changes log: /distr/latest/diff_changes_.log

Note that if Riak was used as an S3, you'll need to perform data migration from Riak to MinIO for S3 in accordance with the MinIO upgrade and migration guide, since starting from 9.0.4 version, Riak was deprecated and replaced by MinIO.

Follow the steps from Post installation to make sure the environment works properly.

← PreviousNext →