ai-center
2022.4
true
AI Center Installation Guide
Automation CloudAutomation SuiteStandalone
Last updated Jun 6, 2024

Procedure

Step 1: Downloading the installation script

Copy the interactive install wizard to the target machine for the installation.

  1. Connect to the one multi-node machine using SSH.
    • If you set a password, the command is as follows:
      ssh <user>@<dns_of_vm>ssh <user>@<dns_of_vm>
    • If you used an SSH key, the command is as follows:
      ssh -i <path/to/Key.pem> <user>@<dns_of_vm>ssh -i <path/to/Key.pem> <user>@<dns_of_vm>
  2. Become root:
    sudo su -sudo su -
  3. Move to home directory:
    cd ~cd ~
  4. Download the installUiPathAS.sh. For instructions, see installUiPathAS.sh. Make sure to download the package suitable for your AI Center version.
  5. Install unzip and jq.
    yum install jq unzip wget -yyum install jq unzip wget -y
  6. Create the installation folder.
    mkdir -p /opt/UiPathAutomationSuite/mkdir -p /opt/UiPathAutomationSuite/

Step 2: Copy the Orchestrator certificate to the virtual machine

Note: In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.
Download and save the Orchestrator certificate on your local machine. You can do this by using a browser, or you can ask your IT department to provide the certificate. Certificates must be base64 and .cer format. Copy the certificate to the virtual machine using the command below.
Make sure that /opt/UiPathAutomationSuite has the right permission for files to be copied over scp, or copy the file into your home directory and then move it to /opt/UiPathAutomationSuite.
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuitescp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
If Identity Server is different from Orchestrator, repeat the steps for identityserver.cer as well.

Chain certificates

When using a domain-issued certificate, make sure to export the root certificate as follows:

  1. Open the certificate, go to the Certification Path tab and select the first certificate. Click on View certificate.


  2. Once the root certificate is displayed, go to the Details tab and click Copy to file.


  3. Make sure to select base64 cer file format.
  4. Save it with the name of your choice and then send it to AI Center machine.

The resulting file should be similar to the example below.

-----BEGIN CERTIFICATE----- 
certificate
base64
encoded
-----END CERTIFICATE----------BEGIN CERTIFICATE----- 
certificate
base64
encoded
-----END CERTIFICATE-----

Step 3: Configuring the installation

3.1 Use the interactive wizard to create the base config file

Important: Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise.

Start interactive wizard using the commands below.

Note: This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.
cd /opt/UiPathAutomationSuite 
chmod +x ./installUiPathAS.sh
./installUiPathAS.shcd /opt/UiPathAutomationSuite 
chmod +x ./installUiPathAS.sh
./installUiPathAS.sh

Screen-by-screen sequence

Upon starting the installation wizard, the main menu is displayed. From this menu you need to choose the desired deployment mode: single-node or multi-node. You are prompted with details about each mode once a choice is made. After that, you have the option to continue with the current choice or go back to the main menu.

  1. Accept the license agreement.
  2. Select the deployment mode: select the Multi-node deployment option.


  3. Select continue.
  4. Select online installation.
  5. Select Complete installation.
  6. Enter the DNS hostname.
  7. Specify whether you want to use Kerberos Auth for SQL connections.
  8. Enter the SQL Server URL. Follow the prompt to enter the connection port, username, and password.
  9. Specify whether you want the installer to automatically create the necessary databases.


The cluster configuration file will be generated with a folder as shown in the following image.



Note: As soon as you generate the configuration file and the folder, you can exit the wizard and proceed with the remaining steps below to complete installation. You can ignore the list of products as we will update this in the following steps.
A first version of the cluster_config.json file is now generated. We will update this file to the purpose of the AI Center installation.

3.2 Add AI Center-specific config

vi /opt/UiPathAutomationSuite/cluster_config.jsonvi /opt/UiPathAutomationSuite/cluster_config.json

Replace the following block:

"aicenter": {
  "enabled": "false"
},"aicenter": {
  "enabled": "false"
},
Note: Document Understanding is enabled by default if AI Center is enabled.
With the following information (replacing the information between <> with your values):
"aicenter": {
  "enabled": "true",
  "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
  "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
  "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_access_token": "<placeholder will be replaced later>"
  "metering_api_key": "<placeholder will be replaced later>"
},"aicenter": {
  "enabled": "true",
  "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
  "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
  "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_access_token": "<placeholder will be replaced later>"
  "metering_api_key": "<placeholder will be replaced later>"
},
Note: metering_api_key is the Document Understanding API Key from the AI Center cloud account as in the screenshot below.


3.3 (Optional) Advanced configuration

You can find the cluster_config.json file in the UiPathAutomationSuite folder. You can use this file to configure your SQL DBs and their respective connection strings and certificates. You can also enable proxy settings if you use a proxy for internet connection.

For advanced configuration, see Using the configuration file.

Step 4: Running the installation

  1. Go to the installation folder and unzip the bundle then provide right permission to the folder by using the command below.
    sudo su - 
    cd /opt/UiPathAutomationSuite
    unzip ./sf-installer.zip -d .
    chmod -R 755 /opt/UiPathAutomationSuitesudo su - 
    cd /opt/UiPathAutomationSuite
    unzip ./sf-installer.zip -d .
    chmod -R 755 /opt/UiPathAutomationSuite
  2. Run the infrastructure installer on the server node.
    Run the installer with the AI Center standalone flag.
    ./install-uipath.sh -i cluster_config.json -o output.json -k --accept-license-agreement --install-standalone-aicenter./install-uipath.sh -i cluster_config.json -o output.json -k --accept-license-agreement --install-standalone-aicenter
  3. Run the infrastructure installer on all the nodes.

    Other nodes can be installed as a server for multi-masters or as agents.

    Run the installer with the AI Center stand-alone flag to add additional server.
    ./install-uipath.sh -i cluster_config.json -o output.json -k -j server --accept-license-agreement --install-standalone-aicenter./install-uipath.sh -i cluster_config.json -o output.json -k -j server --accept-license-agreement --install-standalone-aicenter
  4. Run the installer with the AI Center standalone flag to add additional agent.
    ./install-uipath.sh -i cluster_config.json -o output.json -k -j agent --accept-license-agreement --install-standalone-aicenter./install-uipath.sh -i cluster_config.json -o output.json -k -j agent --accept-license-agreement --install-standalone-aicenter
  5. Install fabric (software components).
    Run the installer with the AI Center standalone flag.
    ./install-uipath.sh --accept-license-agreement --install-standalone-aicenter -i cluster_config.json -o output.json -f./install-uipath.sh --accept-license-agreement --install-standalone-aicenter -i cluster_config.json -o output.json -f
  6. Run the software installer. First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.
    ./install-uipath.sh --accept-license-agreement --install-standalone-aicenter -i cluster_config.json -o output.json -s./install-uipath.sh --accept-license-agreement --install-standalone-aicenter -i cluster_config.json -o output.json -s
At the end of the installation, AI Center will be accessible at the following address:https://your-dns.com/ai-app.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.