Installing aiWARE with AI Processing and AI Data on multiple nodes
000004262
Public
Product Selection
aiWare - aiWare
Article Details
To install aiWARE in multiple nodes, install the controller node first, and then install processing nodes. One of the nodes must run AI data services. You need to perform the steps once for each controller node, and as many times as processing nodes.
[Warning] You cannot change from single node aiWARE to multi-node aiWARE without uninstalling the aiWARE instance.
Optional: Although UUID tokens are automatically generated, you can create your own and overwrite the generated token.
[Warning] The installation database stores the generated UUID that is automatically generated or that you write (export) in aiWARE environment variables. If you generate and export a new UUID, then you need to remove the first installation and then restart the installation from scratch. If you generated and exported multiple UUIDs, you might see 403 errors or other connection problems in the output of the installation command in the terminal.
To get a UUID, do one of the following:
In the terminal, run the following command:
$ uuidgen
On a UUID generator site, generate a uuid. You can use uuidgenerator.net.
Copy the UUID and save it in a text file.
Steps in each node
For each node, complete the following pre-installation steps.
Optional: In air-gapped environments, create an allowlist. To the computer or VM in which you are installing aiWARE, add the following IP addresses in the allowlist.
Hostname
IP Addresses
get-static.aiware.com
13.248.195.1, 76.223.71.144
registry.central.aiware.com
15.197.255.19, 3.33.192.186
Installation steps
In each node type, do the appropriate installation:
Node type
Command line
Do the following:
Controller
sudo su export AIWARE_INIT_TOKEN=uuid export AIWARE_MODE=db,nfs,controller export AIWARE_HOST_EXPIRE=false export AIWARE_DOMAIN_NAME=dev-local.aiware.run curl -sfL https://get.aiware.com | sh -
Replace the 'uuid' with the UUID that you generated or that Veritone provided.
Copy and paste the command line commands in the terminal of the node that you want to install the services.
Replace the 'uuid' with the UUID that you generated or that Veritone provided.
Replace 'runmode' with the list of run modes that you want to install. The items on the list must be separated by comma and cannot contain spaces.
Replace 'license' with the AI Processing license key provided by Veritone.
Replace 'IP_OF_CONTROLLER_NODE' with the IP address of the controller node.
Copy and paste the command line commands in the terminal of the node that you want to install the services.
[Warning] Before proceeding to the next step, wait 20 minutes for background processes to load.
Optional: To watch as the install process downloads and starts new containers, and to check the system for initial problems from running aiWARE, you can perform checks during the installation.
[Tip] You need to add the list of mappings that is output in the command below in the /etc/hosts file in the computer or VM that runs the browser that you are going to use to access Veritone apps. If you are installing aiWARE with EC2 or Microsoft Azure, then edit the /etc/hosts file on your physical computer. If you are installing aiWARE with a VM, then edit the /etc/hosts file in the VM.
In the node for AI Data, type the following command, and then follow the instructions in the terminal.
ai hub install aidata
Startup processes start. Statuses are output in the terminal every minute. The installation command times out after 10 minutes of no progress with a timeout error.
In the terminal, restart the Docker container for aiware-haproxy in the ai Data node:
docker restart aiware-haproxy
In the controller node, log in to Veritone.
[Note] The superuser username is predefined by Veritone: sysadmin@aiware.run
[Warning] You must complete the login process within 24 hours of installing aiWARE. The URL expires after 24 hours.
In your browser, accept the risk for SSL certificates if prompted, and then go to the URL that the installation output earlier.
A password reset page appears.
Notes:
If you get the following error messages: "Connection Refused" or "Service Unavailable" wait for several minutes for the installation to fully come online.
If a login page appears instead of a password reset page, then there was an error creating the superuser account; for example, the URL may have expired. Re-enter the URL. If that fails, reinstall aiWARE.
Change and confirm the password. The Veritone app appears.
Post-installation steps
In the terminal of the controller node, after you curl the run modes down, create a softlink in NFS:
ls -alt /
rm -rf /cache
ln -s /opt/aiware/nfs /cache
docker restart aiware-controller
ls -alt / (expected output in line below)
