To install aiWARE in multiple nodes, install the controller node first, and then install processing nodes. You need to perform the steps once for each controller node, and as many times as there are processing nodes.
[Warning] You cannot change from single node aiWARE to multi-node aiWARE without uninstalling the aiWARE instance.
Pre-installation steps
One-time steps
Complete the following pre-installation steps.
- Verify system requirements.
- Write down the IP of the controller node.
- 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.
- Gather the credentials for the root user.
- Install a platform for containers.
- 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 |
|---|
| registry.central.aiware.com | 15.197.255.19, 3.33.192.186 |
Installation steps
- Install aiWARE on the controller node.
| Command line | Do the following: |
|---|
sudo su
export AIWARE_INIT_TOKEN=uuid
export AIWARE_MODE=db,nfs,controller
export AIWARE_HOST_EXPIRE=false
export AIWARE_LICENSE=license
export AIWARE_LICENSING_ENABLED=yes
curl -sfL https://get.aiware.com | sh - |
- Replace the 'uuid' with the UUID that you generated or that Veritone provided.
- Replace 'license' with the AI Processing license key provided by Veritone.
- Copy and paste the command line commands in the terminal of the node that you want to install the services.
|
- Install aiWARE on the processing node.
| Command line | Do the following: |
|---|
sudo su
export AIWARE_MODE=engine
export AIWARE_HOST_EXPIRE=false
export AIWARE_CONTROLLER=http://IP_OF_CONTROLLER_NODE:9000/edge/v1
curl -sfL https://get.aiware.com | sh -
|
- 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.
|
- 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.
- Open ports between services.
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)
The response should look like this:
lrwxrwxrwx 1 root root 15 Mar 8 15:25 cache -> /opt/aiware/nfs
