ai-center

2022.4

true

Getting Started
- About this guide
- About installation
  - Supported use cases for single-node and multi-node installations
  - Downloading installation packages
Network requirements
- Requirements
Single-node requirements and installation
Multi-node requirements and installation
Post-installation
- Overview
Provisioning a GPU
- Provisioning a GPU
Using the configuration file
- About the configuration file
Node scheduling
- Manage node scheduling
Migration and upgrade
- Migrating to the standalone or Automation Suite environment
- Upgrading AI Center
Basic Troubleshooting Guide
- General AI Center troubleshooting and FAQs
- AI Center standalone troubleshooting

AI Center Installation Guide

DELIVERY:

Automation Cloud Automation Suite Standalone

Last updated Jun 6, 2024

Procedure

Step 1: Downloading the installation script

Connect to the 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>
```
Become root:
```
sudo su -sudo su -
```
Move to home directory:
```
cd ~cd ~
```

Install unzip and jq.

yum install jq unzip wget -yyum install jq unzip wget -y

Create the installation folder.

mkdir -p /opt/UiPathAutomationSuite/mkdir -p /opt/UiPathAutomationSuite/

Download the installUiPathAS.sh and sf-installer.zip installers. For instructions, see installUiPathAS.sh and sf-installer.zip. Make sure to download the packages suitable for your AI Center version.
Note: This step generates a configuration file that will be used during the following installation process.

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.

scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuitescp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite

Chain certificates

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

Open the certificate, go to the Certification Path tab and select the first certificate. Click on View certificate.
Once the root certificate is displayed, go to the Details tab and click Copy to file.
Make sure to select base64 cer file format.
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 interactive wizard to create 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

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.

Accept the license agreement.
Select the deployment mode: select the Single-node deployment option.
Select continue.
Select online installation.
Select basic installation.
Enter the DNS hostname.
Specify whether you want to use Kerberos Auth for SQL connections.
Enter the SQL Server URL. Follow the prompt to enter the connection port, username, and password.
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

Open the file with your editor (e.g.: vi):

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 single-node installation, note that you cannot enable High Availability.

For advanced configuration, see Using the configuration file.

Step 4: Running the installation

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

Run the infrastructure installer.

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 -k./install-uipath.sh --accept-license-agreement --install-standalone-aicenter -i cluster_config.json -o output.json -k

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

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
```