(Click to open topic with navigation)

Preparing for installation

The installation process of the Moab HPC Suite includes installing the separate components in the suite. This guide contains detailed instructions for installing each component.

Many individual components have dependencies on other components (see Requirements). However, if you do not require a certain component (Moab Web Services, for example), you do not have to install it.

The install instructions for each component include information about system requirements and dependencies. Some include prerequisite instructions that you will need to complete before you begin the install. Please read this information carefully, and make sure you have installed all the dependencies and packages that are necessary in order to avoid errors during the Moab HPC Suite install process.

Because many system-level files and directories are accessed during the installation, the instructions in this guide should be executed with root privileges.

You will see that the instructions execute commands as the root user. Please note that the same commands will work for a non-root user with the sudo command.

To install the Moab HPC Suite, install the packages in the following order:

  1. Install the TORQUE and Moab Workload Manager dependencies (see the dependency installation instructions below).
  2. Install TORQUE (see Installing TORQUE).
  3. Install Moab Workload Manager (see Installing Moab Workload Manager).
  4. Install Moab Web Services (see Installing Moab Web Services).

Install TORQUE and Moab Workload Manager dependencies

You must install the following dependencies in order to use TORQUE and Moab Workload Manager:

Use the following commands to install the required dependencies and packages.

Install Java

You must install the 64-bit RPM version of Oracle® Java® 7 Runtime Environment if you are installing Moab Web Services.

Oracle Java 7 Runtime Environment is the recommended Java environment, but Oracle Java 6 is also supported. All other versions of Java, including OpenJDK/IcedTea, GNU Compiler for Java, and so on cannot run Moab Web Services.

The Oracle® Java® download page has moved and requires a web-enabled workstation to accept the license agreement and download the software.

Do the following:

  1. Download Java 7 on a web-enabled workstation.
    1. Open a web browser and connect to the Java downloads page.
    2. Select the radio button to accept the license agreement.
    3. Click the download link for the Linux x64 RPM file.
  2. Copy the Java 7 RPM to the MWS server using scp, rsync, or any similar network copy utility.
  3. On the MWS server, run the following to install Java 7: 
    [root]# rpm -Uh <RPMfilename>

Install Tomcat

You must install Tomcat if you are installing Moab Web Services.

Opening ports

A few ports need to be available through your firewall so components of the suite can communicate with each other. Some features of some components might need additional ports configured. The individual component documentation indicates when additional ports are needed.

The ports required for basic suite functionality are:

To open ports in your firewall

Install MongoDB

You must install MongoDB if you are installing Moab Web Services.

To install and enable MongoDB

  1. Install MongoDB.
    • RHEL and CentOS, and Scientific Linux:

      • Create a file called /etc/yum.repos.d/10gen.repo and add the following lines.

      [10gen]
name=MongoDB Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64
gpgcheck=0
enabled=1

      Install mongo-10gen-server.

      [root]# yum install mongo-10gen-server --exclude mongodb-org,mongodb-org-server
    • SLES:
      • [root]# zypper ar http://download.opensuse.org/repositories/server:/database/SLE_11_SP3 OpenSuseDatabase
[root]# zypper install mongodb
  2. Start MongoDB.
    • RHEL and CentOS, and Scientific Linux:
      • [root]# chkconfig mongod on
[root]# service mongod start
    • SLES:
      • [root]# chkconfig mongodb on
[root]# service mongodb start

    3. There may be a short delay (approximately 3 minutes) for Mongo to start the first time.

    If you see errors while running the chkconfig command, make sure that /sbin is in your PATH environment variable, then run chkconfig again.

    export PATH=/sbin:$PATH
  3. Prepare the MongoDB database by doing the following:
    1. Add the required MongoDB users.

      2. The passwords used below (secret1, secret2, and secret3) are examples. Choose your own passwords for these users.

      [root]# mongo
> use admin;
> db.addUser("admin_user", "secret1");
> db.auth ("admin_user", "secret1");

> use moab;
> db.addUser("moab_user", "secret2");
> db.addUser("mws_user", "secret3", true);

> use mws;
> db.addUser("mws_user", "secret3");
> exit

      Because the admin_user has read and write rights to the admin database, it also has read and write rights to all other databases. See Control Access to MongoDB Instances with Authentication for more information.

    2. Enable authentication in MongoDB.
      • RHEL and CentOS, and Scientific Linux:
        • [root]# vi /etc/mongod.conf

auth = true
         
[root]# service mongod restart
      • SLES:
        • [root]# vi /etc/mongodb.conf 
         
auth = true
         
[root]# service mongodb restart

        On SLES machines, auth = true is enabled by default.

Install PostgreSQL

To install PostreSQL

  1. Install and initialize PostgreSQL.

    CentOS, RHEL, and Scientific Linux

    [root]# yum install postgresql-server

    [root]# service postgresql initdb

    SLES

    [root]# zypper install postgresql-server
[root]# service postgresql start

  2. Configure trusted connections.

    Edit or add a "host" line in the pg_hba.conf file for the interface from which the server(s) (for example, Moab Workload Manager and/or Moab Accounting Manager) will be connecting to the database and ensure that it specifies a secure password-based authentication method (for example, md5).

    [root]# vi /var/lib/pgsql/data/pg_hba.conf
							
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

  3. Configure PostgreSQL to accept connections from your host.

    [root]# vi /var/lib/pgsql/data/postgresql.conf
     
    # Uncomment the listen addresses line in the configuration:

listen_addresses = 'localhost'          # what IP address(es) to listen on;

  4. Start or restart the database.

    [root]# chkconfig postgresql on
[root]# service postgresql restart

Related topics 

© 2015 Adaptive Computing