(Click to open topic with navigation)

6.15 Installing Nitro

This topic contains instructions on how to install Nitro.

Nitro

In this topic:

6.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 6.14 Installing RLM Server for instructions on how to set up a new RLM Server.

Do the following:

  1. 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>
  2. Email [email protected] for a license and include the hostid and hostname you just obtained.
  3. Adaptive Computing will generate the license and send you the Nitro license file (.lic) file in a return email.
  4. 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 6.14 Installing RLM Server (manual installation method) or 6.38 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 6.14 Installing RLM Server (manual installation method) or 6.38 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

6.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
[root]# firewall-cmd --add-port=47000-47003/tcp --permanent
[root]# firewall-cmd --reload
[root]# vi /etc/sysconfig/SuSEfirewall2

FW_SERVICES_EXT_TCP="47000 47001 47002 47003"

[root]# service SuSEfirewall2_setup restart
[root]# vi /etc/sysconfig/SuSEfirewall2

FW_SERVICES_EXT_TCP="47000 47001 47002 47003"

[root]# service SuSEfirewall2 restart

6.15.3 Install Nitro

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

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

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

  1. If you have not already done so, complete the steps to prepare the host. See 6.17 Preparing for Nitro Manual Installation or Upgrade.

  2. Change the directory to the root of the unpacked Nitro tarball bundle.

    [root]# cd nitro-tarball-bundle-<version>-<OS>
  3. Identify the Nitro product tarball (nitro-<version>-<OS>.tar.gz).
  4. As the root user, run each of the following commands in order.
    [root]# mkdir /opt/nitro
[root]# tar xzvpf nitro-<version>-<OS>.tar.gz -C /opt/nitro --strip-components=1
  1. 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/
  2. 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
  3. 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.

  4. 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.
  5. 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

6.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.

Related Topics 

© 2017 Adaptive Computing