9.3

Edit

Servers preparation and high-level installation flow

Before installing WorkFusion Software, read this section carefully and perform the required preparations.

Servers preparation

Make sure the requirements given in the system requirements are met for each server.

note

The VDS acronym (Virtual Data Scientist) is a former name for the AutoML component. VDS refers to AutoML in all cases.

It is recommended to use mounted HDD/SDD volume for the installation and keep it separate from the root volume where Operating System is installed.

WorkFusion SPA is designed to be installed via a non-privileged user account. When first provisioning servers for the WorkFusion SPA installation, make sure the system packages listed in Required packages are installed.

If you skip this step, root permissions will be required to install these packages later. Besides installation of required packages, root permissions will be required for execution of a small number of operations on the servers before actual installation. All these operations are documented in detail in Run preinstall manually.

If during the installation, you will not have root permissions, you should request root access or ask server administrators to execute everything from Run preinstall manually. If root access is available, you don't need to care about any preparations. The installer will perform all of them automatically.

High-level installation flow

The information below will give you the big picture of what to expect during the installation of Workfusion SPA.

The entire WorkFusion SPA product consists of a small number of components.

These components are logically grouped into seven roles distributed across seven servers as the default ones:

  • DB (Linux)
  • APP (Linux)
  • APM (Linux)
  • OCR (Linux or Windows)
  • AutoML (AutoML-Cluster) (Linux)
  • RPA (Windows)
  • BI (Windows)

Mind the following:

  • Each server role (APP, DB, APM, and so on) represents a predefined set of software (workfusion-produced binaries and integrated third-party software).
  • Each server role is assumed to be installed on a separate server for best performance, although some custom combinations of components and their custom distribution across servers is supported (for example, for high-availability scenarios).
  • Custom installation schemes can be performed individually per-customer on-demand;This installation guide describes the default installation scheme (components are distributed across servers as per scheme described in the product architecture section - seven servers with predefined set of software components).
  • The installation process is a defined set of actions that needs to be performed on each server. DB server should be installed first. The second is APP server. Other servers don't have dependencies from each other and can be installed in parallel or one-by-one in any order. Installation of software components on each Linux server is performed using the same single installation package. It doesn't matter what server role you are provisioning (DB, APP, APM, OCR or AutoML), you'll use the same installation package and the same common config files for any of them.

Installation process on each Linux server (DB, APP, APM, OCR, AutoML (vds-master, vds-slave)) consists of the following steps:

  1. Upload installation package to each server and unarchive it.
  2. Fill two config files on DB server (config.yml and secrets.yml) inside the folder where the package was unpacked.
  3. Put required for installation TLS certificates into the <PACKAGE_DIR>/certificates directory on DB server. You have two options on how to do it:
    1. Use self-signed certs. For this, execute the generate-certificates.sh script bundled into the installer. It will generate all required certificates and put them into the certificates directory.
    2. Provide your own certs. Requirements for certificates are described in Using TLS certificates.
  4. Copy config files (config.yml and secrets.yml) and the certificates directory with all certs from DB server to all other Linux servers.
  5. On APP server, put your license.properties file to the directory where you extracted the installation package.
  6. Prepare Servers for installation. It is recommended to do it in automated fashion using single command: ./install.sh preinstall <SERVER_ROLE> as the root user. If you don't have root access, ask your system administrator to provide it. If it is not an option, request system administrator to ensure that all steps from Run preinstall manually are performed on Linux servers. Otherwise, you'll not be able to proceed with installation.
  7. Execute the ./install.sh install <SERVER_ROLE> command on each server. Available server roles are db, app, ocr, apm, vds-master, vds-slave. This is the actual installation.
  8. Execute the ./install.sh check <SERVER_ROLE> command on each server. This ensures the software is operational.

Password complexity verification

Since 9.0.0.8

New feature "password complexity verification" was implemented. We recommend the use of stronger passwords for better security. The mandatory password complexity requirements are listed below.

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: "$", "&".

All passwords settings are configured in the secrets.yml file. If these rules aren't applicable, you can turn off the password complexity verification in the config.yml file by setting the variable passwords_check: false.

Domain name configuration

The steps below assume that you have provisioned the 7 servers where WorkFusion Software will be installed (5 Linux servers + 2 Windows servers);Before performing any installation steps, please configure DNS names for the servers as described in 9.3.x DNS Names Configuration section.

Network availability between servers

The steps below assume that you have provisioned the 7 servers where Workfusion Software will be installed (5 Linux servers + 2 Windows servers). Check that the following network ports are opened between servers and for end users as described in Application ports.

Installation packages

Download links for all required installation packages are provided by WorkFusion. The full distribution of Workfusion Software is a set of files (archives):

  • For DB, APP, APM, OCR, AutoML Linux Servers: workfusion-full-package-.tar.gz
  • For RPA Server (Windows): RPAInstaller-.zip
  • Java SE Runtime Environment. Download from Oracle.
  • For OCR Server (Windows): OCRInstaller-.zip
  • For BI Server (Windows): WorkFusionAnalyticsInstaller-.zip, WorkFusionAnalyticsWorkbooks-.zip

Linux installation package structure

The main installation package workfusion-full-package-.tar.gz is used for provisioning all Linux servers has the following file structure.

AutoML installation types

AutoML supports two types of installation. Choose the one that best suits your needs.

AutoML Cluster:AutoML Cluster is a combination of one AutoML Master + one or more AutoML Agents. Additional agents may be configured and added as required at any point after the initial setup.

When installing AutoML Cluster, ensure system requirements for your infrastructure are met as described in the system requirements.

AutoML Cluster

The AutoML Cluster installation consists of a AutoML Master server and a number of separate AutoML Agent servers.

Choose NFS approach before proceeding!Note, that AutoML Cluster uses NFS for sharing data between the master and the agents. There are several ways of using NFS for clustered AutoML setup.

  • NFS on AutoML Master: This is the default behavior when using clustered AutoML. No changes are required.
  • NFS on a separate server (provided by customer): If you have a dedicated NFS server for AutoML, it is necessary to set up and provide the shared location.
  • NFS on a separate server (configured via the installer): NFS will be configured by the installer on a separate server. Follow the instructions in Preparation steps and Linux Servers installation using vds-nfs as server_role before installing AutoML Cluster. Once you've chosen one of the options above, you should follow the requirements of that configuration according to the System requirements section. Re-configuring an already installed AutoML NFS component is not supported.

Once NFS has been configured:

← PreviousNext →