Edit

Basic setup

Before the installation, ensure that you have prepared the servers and executed the precheck:

1. MASTER server
2. AGENT server(s)
3. RPA server
4. BI server

Remember to run the following commands as the application user from the directory, where you have downloaded and extracted the installation package, for example, /opt/workfusion/wf_installer.

cd PACKAGE_DIR # /opt/workfusion/wf_installer

note

If your security policy doesn't allow users to have sudo privileges, you can execute the preinstall root steps as another user, which already has sudo permissions. All you have to do is to provide ownership of the PACKAGE_DIR directory to that user, perform preinstall, and then revert ownership.

To install Linux server components:

1. On the Master server, run the following commands:

   $ ./install.sh preinstall master -c local --limit <current_host>  # execute the root steps
   $ ./install.sh install master -c local --limit <current_host>     # run installation
   

2. On the AGENT server, run the following commands:

   $ ./install.sh preinstall agent -c local --limit <current_host>  # execute the root steps
   $ ./install.sh install agent -c local --limit <current_host>     # run installation
   

   To install multiple AGENT servers, run the above commands on each AGENT server. Remember to change the --limit parameter accordingly for each server. It must reflect the hostname of the server, on which you are executing the command.

   note

   The OCR-Worker services are installed on the AGENT server automatically.

3. Clean up old workers via Marathon API. For that, on the first MASTER server (default marathon_port: 8480) run the following command. Remember to replace default values in it with your relevant data.

   $ curl -kv -X DELETE -u 'marathon:<marathon_web_pass>' https://127.0.0.1:<marathon_port>/v2/groups/worker?force=true
   

   warning

   During the upgrade, it is important to complete the step of killing workers before Business Processes are started. Otherwise, old workers are not destroyed and prevent new ones from running. This can lead to a system breakdown, and Business Processes cannot be processed.

4. On the Master server, verify the installation:

   $ ./install.sh check master -c local --limit <current_host>
   

5. On the AGENT server, verify the installation:

   $ ./install.sh check agent -c local --limit <current_host>