(Click to open topic with navigation)

Installation > Installation overview

Installation overview

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. (These dependencies are listed in the "Requirements" section of each component's installation instructions.) However, if you do not require a certain component (Moab Viewpoint, 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 TORQUE (see Installing TORQUE).
  2. Install Moab Workload Manager (see Installing Moab Workload Manager).
  3. Install Moab Web Services (see Installing Moab Web Services).
  4. Install Moab Viewpoint (see Installing Moab Viewpoint).

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

Install the 64-bit RPM version of Oracle® Java® 7 Runtime Environment.

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.

Do the following:

Install Tomcat

Installing MongoDB

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

To install and enable MongoDB

MongoDB 2.0.8 is still supported in Moab HPC Suite 7.5.0; however, MongoDB 2.4.8 is recommended.

  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=10gen Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64
gpgcheck=0
enabled=1

      Install mongo-10gen and mongo-10gen-server.

      [root]# yum install mongo-10gen mongo-10gen-server
    • SLES:
      • [root]# zypper ar http://download.opensuse.org/repositories/server:/database/SLE_11_SP2 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. 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

    You may need to wait a minute or two for Mongo to initialize.

  3. Prepare the MongoDB database by doing the following:
    1. Add the required MongoDB users.
      2. [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.

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

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

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

Related topics