System Requirements

• Linux CentOS 7
• At least 16GB RAM
• At least 4 Cores
• At least a 100 gb available partition mounted on /var. A 100 gb root partition (/) is also sufficient as long as /var does not have a smaller, separate mount point.

• All servers require all ports open to inbound TCP connections from all Promote machines. This only applies to internal network access, not to public IPs.
• UDP ports needs to be open to internal traffic between Promote machines on ports 7946, 4789, and 5002.
• All servers require open outbound traffic so packages and model requirements can be downloaded (must be able to access internet).

• Ports 8000, 80 and 443 need to be open to all external TCP traffic to allow prediction requests to be processed.

• To avoid networking conflicts with Docker, please ensure that the internal IP of each node in your cluster does not reside in the following IP blocks:

  10.0.0.0/21 (10.0.0.0 - 10.0.7.255)

  172.17.0.1/16 (172.17.0.0 - 172.17.255.255)

  172.18.0.0/16 (172.18.0.0 - 172.18.255.255)

  10.255.0.0/16 (10.255.0.0 - 10.255.255.255)

The installation script requires SSH with an authentication key. If you do not have this, follow the procedure below to setup a “promote” user with an authentication key.

Run these commands on all the nodes:

1. SSH onto the machine with sudo privileges.
2. Add the promote user: adduser promote
3. Create a password: passwd promote
4. Add the user to the wheel: usermod -aG wheel {promote}
5. Make this user have passwordless sudo
   • become root: sudo su
   • edit the sudoers file by running the command: visudo
   • Below the comment “# Same thing without a password, add the line promote ALL=(ALL) NOPASSWD: ALL

We now need to add an authorization key that we can use to authorize our SSH sessions. If you are using a Windows machine to setup these servers, you will need bash - we recommend Git Bash.

1. Create a new public/private key pair on your machine: ssh-keygen
2. When prompted for a save location, save to a known location. When prompted for a password, leave the field blank.
3. SSH onto the promote machines profile.
4. Make a .ssh directory in the home folder for your user, for the case of the promote user the command is: mkdir /home/promote/.ssh/
5. Create a file in the home directory for your user called authorized_keys using the command: touch /home/promote/.ssh/authorized_keys
6. Copy the contents of the public key from your laptop.
7. Open the authorized_keys file paste the public key from your machine into the file: vi /home/promote/.ssh/authorized_keys
8. Update the permissions on the .ssh folder and the authorized_keys file:
   • chown -R promote:promote /home/promote/.ssh
   • chmod 700 /home/promote/.ssh
   • chmod 600 /home/promote/.ssh/authorized_keys
9. Ensure that this works from your machine by running the command: ssh -i “/path/to/key” promote@IP

• Apple® Safari®
• Google Chrome™
• Mozilla® Firefox®