You are here: RPM Installation > Installation and Configuration > Nitro Integration > Installing Nitro

3.15 Installing Nitro

This topic contains instructions on how to install Nitro.

Nitro

needs to be available to all of the nodes that will be used as part of the Nitro job.
can be installed either to each node individually or to a shared file system that each node can access.
can be installed to integrate with a scheduler, such as Moab, or without (Nitro standalone). The instructions are the same.

In this topic:

3.15.1 Obtain a Nitro License
3.15.2 Open Necessary Ports
3.15.3 Install Nitro
3.15.4 Verify Network Communication

3.15.1 Obtain a Nitro License

The Nitro license file is installed on an RLM Server.

These instructions assume you already have access to an RLM Server. See 2.6 Installing RLM Server for instructions on how to set up a new RLM Server.

Do the following:

On the RLM server, obtain the hostid and hostname.

hostid

[root]# /opt/rlm/rlmhostid

You should see output similar to the following.

rlmhostid v12.1
Copyright (C) 2006-2016, Reprise Software, Inc. All rights reserved.            

Hostid of this machine: 00259096f004

hostname

[root]# /opt/rlm/rlmhostid host

You should see output similar to the following.

rlmhostid v12.1      
Copyright (C) 2006-2016, Reprise Software, Inc. All rights reserved.
				
Hostid of this machine: host=<your-host-name>

Email [email protected] for a license and include the hostid and hostname you just obtained.
Adaptive Computing will generate the license and send you the Nitro license file (.lic) file in a return email.
On the RLM server, do the following:
1. Download and install the license file.
```
[root]# cd /opt/rlm
[root]# chown rlm:rlm <licenseFileName>.lic
```
2. If the RLM Server in your configuration uses a firewall, edit the license file to reference the ISV adaptiveco port for the Adaptive license-enabled products. This is the same port number you opened during the RLM Server installation. See the instructions to open necessary ports in the 2.6 Installing RLM Server (manual installation method) or 3.12 Installing RLM Server (RPM installation method) for more information.
```
[root]# vi /opt/rlm/nitro.lic


ISV adaptiveco port=5135
```
  The license file already references the RLM Server port (5053 by default).
  If the RLM Server in your configuration uses different ports, you will need to modify the license file to reflect the actual ports. See the instructions to open necessary ports in the 2.6 Installing RLM Server (manual installation method) or 3.12 Installing RLM Server (RPM installation method) for more information.
3. If you did not install an RLM Server using the file available from Adaptive Computing (for example, because your system configuration already uses one), do the following:
  1. Download the 'adaptiveco.set' file from the Adaptive Computing Nitro Download Center.
  2. Copy the 'adaptiveco.set' file into the same directory where the Nitro license resides (/opt/rlm).
4. Perform a reread to update the RLM Server with your license.
```
[root]# /opt/rlm/rlmreread
```

3.15.2 Open Necessary Ports

Nitro uses several ports for communication between the workers and the coordinator.

The default port is 47000, and up to four ports are used in running Nitro (ports 47000-47003).

On each compute node (coordinator), open the necessary ports.

[root]# iptables-save > /tmp/iptables.mod
[root]# vi /tmp/iptables.mod

# Add the following lines immediately *before* the line matching
# "-A INPUT -j REJECT --reject-with icmp-host-prohibited"

-A INPUT -p tcp --dport 47000:47003 -j ACCEPT
				
[root]# iptables-restore < /tmp/iptables.mod
[root]# service iptables save

3.15.3 Install Nitro

You must complete the tasks to obtain a Nitro license before installing Nitro. See 3.15.1 Obtain a Nitro License.

If your configuration uses firewalls, you must also open the necessary ports before installing Nitro. See 3.15.2 Open Necessary Ports.

On the host on where Nitro will reside, do the following:

If you are installing Nitro on its own host or on a host that does not have another RPM installation, complete the steps to prepare the host. See 3.2 Preparing the Host – Typical Method or 3.4 Preparing the Host – Offline Method.
Install the RPM.
```
[root]# yum install nitro
```

Copy the license file you generated earlier in this topic to each compute node (coordinator). On each compute node, or on the shared file system, do the following:
```
[root]# cp <licenseFileName>.lic /opt/nitro/bin/
```
Identify the launch_nitro.sh script version for your resource manager. This script will be copied to the bin directory from where user job scripts will execute Nitro. See the Nitro Administrator Guide for more information.
Reference scripts are provided in /opt/nitro/scripts.
```
[root]# find /opt/nitro -name launch_nitro.sh

./scripts/lsf/launch_nitro.sh
./scripts/torque/launch_nitro.sh
./scripts/slurm/launch_nitro.sh
./scripts/alps/torque/launch_nitro.sh
./scripts/alps/slurm/launch_nitro.sh
```
Copy the launch script to the bin directory. (This example uses the Torque-based launch script.)
```
[root]# cp /opt/nitro/scripts/torque/launch_nitro.sh /opt/nitro/bin/
```
This is a "copy" file operation and not a "move" operation. This allows you to customize your version of the script and always have the factory version available for consultation and/or comparison.
Customize the bin/launch_nitro.sh script as needed for your site's administrative policies. For example, to enable the Nitro coordinator's host to always execute a local Nitro worker, modify the bin/launch_nitro.sh script version to always pass the ‑‑run‑local‑worker command line option to the coordinator. See the Nitro Administrator Guide for more information on editing the launch script.
If you are not using a shared file system, copy the Nitro installation directory to all hosts.
```
[root]# scp -r /opt/nitro root@host002:/opt
```

3.15.4 Verify Network Communication

Verify that the nodes that will be running Nitro are able to communicate with the Nitro ports and that the nodes are able to communicate with one another.