License and Install Promote

Before installing, verify that your system meets the System Requirements.

Licensing

To download and install Promote, you are required to have a valid license key (also known as QUAY credentials). You will need to contact your account executive, or Alteryx Fulfillment, in order to get these credentials before you can proceed.

Automated installation

Three servers are required to run Promote. For more information, see the System Requirements.

The automated installation is packaged into an .RPM binary file that you can install on the three servers to be used with Promote. The package installs a daemonized web server that you can interact with on port 8000 through a GUI. You are prompted to register (username and password are required, and are supplied by Alteryx Fulfillment) and then are taken through a series of steps to download and install Promote. When the process is finished (approximately 15 minutes), you are redirected to the Alteryx Promote registration page.

Extract the installation file

Extract the Alteryx Promote installation file you obtained. Type:
```
tar -xvzf PATH/TO/promote-2019.3.0-release.tar.gz
```
Navigate to the extracted Promote 2019.3.0 installation directory. Type:
```
cd promote-2019.3.0
```

Copy .RPM to servers

The .RPM file must be copied to each server in order to run the installer. For Windows users, we suggest a file transfer utility such as WinSCP, or the Linux subsystem shell if enabled in the OS. For Mac and Linux users, we recommend copying the file via SSH (secure shell).

Ensure you have SSH access to the remote cluster with a key pair (see System requirements/SSH)
Using SCP (secure copy protocol), copy the .RPM file to each node. Type:
```
scp -r promote-installer-2019.3.0-el7.x86_64.rpm <user@ServerIP:>
```

Typing the colon after the IP address will send the file to the default user home directory. On a new CentOS 7 machine, the default home directory is /home/centos.

If you receive a permissions error from SCP, try specifying your SSH key. Type:

scp -i <PATH/TO/key.pem> -r promote-installer-2019.3.0-el7.x86_64.rpm <user@ServerIP:>

Install .RPM

Install .RPM file on all three servers using a package manager. By default, CentOS uses Yum and RPM.

Type:

 sudo yum install promote-installer-2019.3.0-el7.x86_64.rpm

Now that RPM is installed, you can view the installer GUI.

Welcome

The installer GUI guides you through the download and installation processes of Promote.

Connect to port 8000 via the browser on the machine you will use as the master server. In the address bar type:
```
http://MasterServerIP:8000
```
Click Next to enter the server information.

Servers

Enter the internal and external IP addresses of the three servers to be used for Promote.
Click the radio button to designate the machine you are currently accessing the installer GUI from as the master server. If you want to select a different machine as the master server, close your window and begin again using new machine’s respective IP to load the installer GUI.
Click Next to enter the Registry Credentials used for accessing the Promote registry.

If you do not have a different external IP address, enter them both as the same IP. The field cannot be left blank.

Credentials

Locate your registry credentials (provided by Alteryx Fulfillment) and copy and paste them into the appropriate fields.
Click Next to enter the System Requirements.

System requirements

If the System Requirements check fails, the process stops and you will see a message letting you know how to fix the issues and to reinstall when the issues are resolved.

If necessary, repeat the automated installation process.

Linux kernel upgrade

Click Next to perform the upgrade.
After the process has completed, click Next.

Download and install

Promote will download and install on your three servers.

A Success screen displays when the installation is complete.

Finish

You can now sign in with your Promote credentials. You are automatically redirected to the registration screen. If you are not redirected, point your browser to the master server. In the address field, type

http://MasterServerIP

Click Submit.

Alteryx Promote is launched and the home screen is displayed.

Installer logs

To view the service logs for the Promote Installer, you can run the following command on your master node, type:

journalctl -u promote-installer

To tail the logs, type:

journalctl -f -u promote-installer

For more information about journalctl. click here.