500. License server installation

The Foretellix tools need two license servers, one for Foretify and one for Foretify Manager. Both of these are described here.

500.1 Requirements

To install the license servers you need:

An Ubuntu server, accessible from the HPC/Application server (low CPU/RAM resources required)
A root or superuser account on the server, referred to in this document as USER
License Server tar files (LCU1803_ubuntu1604.tar.gz, FManager_lic_server.tar.gz)
License files
License server ports accessible from the internal network. These are defined in the license files.

500.2 Install license server for Foretify

500.2.1 Setup

To install the license server:

Install the dependencies:
Shell command: install license dependencies
```
$ sudo apt install -y lsb-core
```
Choose the installation path.

The directory used here is /opt/foretellix, but you can choose any location you like.
Create the path and enter it:
Shell commands: create directory and change to it
```
$ mkdir -p /opt/foretellix
$ cd /opt/foretellix
```
Connect to Foretellix's SFTP server and download LCU1803_ubuntu1604.tar.gz:
Shell commands: download the tar file
```
$ sftp <username>@<IP>
> get download/LCU1803_ubuntu1604.tar.gz
> exit
```
Un-tar the file in the installation directory.
Shell command: open the tar file<
```
$ tar xzvf LCU1803_ubuntu1604.tar.gz
```
Change the ownership recursively on the /opt/foretellix/lcu directory to the current user account.
Shell command: change ownership
```
chown -R <USER> /opt/foretellix/lcu
```

This is the end of the license server installation procedure. In order to continue the next steps, you need a Foretify license file issued from Foretellix.

500.2.2 Install the license

To install the Foretify license:

Place the license file in /opt/foretellix/lcu (or your chosen path) and give the current user account full access to it:
Shell commands: change permissions on the license file
```
$ cd /opt/foretellix/lcu
$ chmod u+rw <license.file>
```
Open the license file using a text editor and search for the line starting with "SERVER".

Verify that the physical address specified in the file matches the physical address of the one of the server’s NICs.
In that same line, replace the first argument with the server hostname:
License file syntax: add server attributes
```
SERVER <server.hostname> <physical.address> 5280
```
You should make sure that compute nodes that use the license server have access to the license server IP and port, for example 143.254.32.14, 5280 and 15280.
Once verified, log into the server using the selected user credentials and invoke the license manager daemon:
Shell command: run the license manager daemon
```
$ /opt/foretellix/lcu/current/tools.lnx86/bin/64bit/lmgrd -c <path/to/license.file> -l license_check.log
```
Check license_check.log for errors.
If there are no errors stop the daemon with CTRL+C.

The license server should be run as a service, so that it will automatically start on reboot or other events that stop it.

500.2.3 Run license server

To run the license server as a service:

Create the ftx_license.service file:

Shell commands: create the license service file

$ touch /usr/lib/systemd/system/ftx_license.service
$ vi /usr/lib/systemd/system/ftx_license.service

Add the following to ftx_license.service file:

License service file syntax: add attributes

[Unit]
Description=Foretify License server daemon
After=syslog.target
After=network.target

[Service]
Type=simple
ExecStart=/opt/foretellix/lcu/lmgrd -z -c /opt/foretellix/lcu/license.txt -l /var/log/foretellix/ftx_license.log
SuccessExitStatus=15
Restart=always
RestartSec=30s

[Install]
WantedBy=multi-user.target

Create the Foretellix log output folder:
Shell commands: create log output directory
```
$ mkdir /var/log/foretellix
$ chmod -R 777 /var/log/foretellix
```

Enable and start the ftx_license.service:

Shell commands: start the service

$ sudo systemctl enable ftx_license.service
$ sudo systemctl start ftx_license.service
$ sudo systemctl status ftx_license.service

500.3 Installation steps for Foretify Manager

500.3.1 Setup

To install the license server:

Change directory to the installation directory.
Shell commands: change to installation directory
```
$ cd /opt/foretellix
```
Install the dependencies.
Shell command: install license server dependencies
```
$ sudo apt install -y lsb-core
```
Connect to Foretellix's SFTP server and download FManager_lic_server.tar.gz.
Shell command: download the Foretify Manager license server
```
$ sftp <username>@<IP>
> get download/FManager_lic_server.tar.gz
> exit
```
Un-tar the file.
Shell command: open the tar file
```
$ tar xzvf FManager_lic_server.tar.gz
```
Change the ownership recursively on the /opt/foretellix/FManager_lic_server directory.
Shell command: change ownership recursively
```
$ chown -R <A_USER> /opt/foretellix/FManager_lic_server
```

This is the end of the license server installation procedure. In order to continue the next steps, you need a Foretify Manager license file issued from Foretellix.

500.3.2 Install the license

To install the license file:

Place the license file in /opt/foretellix/FManager_lic_server (or your chosen path) and change permissions on it to give the current user full access to it:
Shell command: change ownership on the license file
```
$ cd /opt/foretellix/FManager_lic_server
$ chmod u+rw <fmanager_license.file>
```
Open the license file using a text editor and search for the line starting with "SERVER".

Verify that the physical address specified in the file matches the physical address of the one of the server’s NICs.
In that same line, replace the first argument with the server hostname:
License file syntax: add attributes
```
SERVER <server.hostname> <physical.address> 5280
```
You should make sure that compute nodes that use the license server have access to the license server IP and port (e.g. 143.254.32.14, 5280 and 15280)
Once verified, log into the server using the selected user credentials and invoke the license manager daemon:
Shell command: invoke the license manager daemon
```
$ /opt/foretellix/FManager_lic_server/lmgrd -c <path/to/fmanager_license.file> -l license_check.log
```
Check license_check.log for errors.
If there are no errors, stop the daemon with CTRL+C and continue to next and final step.

The license server should be run as a service, so that it will automatically start on reboot or other events that stop it.

500.3.3 Run license server

To run the license server as a service:

Create the fmanager_license.service file:

Shell command: create the license service file

$ touch /usr/lib/systemd/system/fmanager_license.service
$ vi /usr/lib/systemd/system/fmanager_license.service

Add the following to fmanager_license.service file:

License service file syntax: add properties

[Unit]
Description=Foretify Manager License server daemon
After=syslog.target
After=network.target

[Service]
Type=simple
ExecStart=/opt/foretellix/FManager_lic_server/lmgrd -z -c /opt/foretellix/FManager_lic_server/fmanager_license.txt -l /var/log/foretellix/fmanager_license.log
SuccessExitStatus=15
Restart=always
RestartSec=30s

[Install]
WantedBy=multi-user.target

Enable and start the license service:

Shell commands: start license service

$ sudo systemctl enable fmanager_license.service
$ sudo systemctl start fmanager_license.service
$ sudo systemctl status fmanager_license.service