(Click to open topic with navigation)

You are here: Manual Installation > Installation > Installing Moab Accounting Manager

2.4 Installing Moab Accounting Manager

This topic contains instructions on how to install and start Moab Accounting Manager (MAM).

Perform the following in order:

2.4.1 Plan Your Installation

The first step is determining the number of different hosts (physical machines) required for your MAM installation.

Your MAM installation includes:

Each of these components can be installed on their own hosts (meaning the actual physical machine) or can be combined on same hosts. For example, the MAM Database can be installed on the same host as the MAM Server. Or the MAM Server may be installed on the same host you installed the Moab Server.

If your configuration will have the MAM PostgresSQL database on the same host as the Insight PostgreSQL database, the MAM PostgreSQL database must be same version as the Insight PostgreSQL database. See 2.4 Installing Moab Accounting Manager for supported database versions.

Once you have determined which components are installed on which hosts, complete the rest of the instructions for the MAM installation.

The instructions that follow in this topic will use the term Host after each component to reflect installing on a host (again, meaning the physical machine). For example, MAM Server Host and MAM Database Host. Depending on your configuration, Host may refer to as installed on its own machine or installed on the same machine as another component.

2.4.2 Open Necessary Ports

If your site is running firewall software on its hosts, you will need to configure the firewall to allow connections to the necessary ports.

Do the following as needed:

  1. If you will be installing the MAM Server on a different host from where you installed the Moab Server or you will be installing the MAM Clients on other hosts, then on the MAM Server Host, open the MAM Server port (7112) in the firewall.
    [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 7112 -j ACCEPT
				
[root]# iptables-restore < /tmp/iptables.mod
				
[root]# service iptables save
  2. If using the MAM GUI, then on the MAM GUI Host, open the https port (443) in the firewall for secure browser communication.
    [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 443 -j ACCEPT
				
[root]# iptables-restore < /tmp/iptables.mod
				
[root]# service iptables save
  3. If you will be installing the MAM PostgreSQL Database on a different host from the MAM Server, then on the host where the MAM PostgreSQL Database Host will reside, open the postgres port (5432) in the firewall. 
    [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 5432 -j ACCEPT

[root]# iptables-restore < /tmp/iptables.mod

[root]# service iptables save

2.4.3 Install and Initialize the PostgreSQL Server

Moab Accounting Manager uses a database for transactions and data persistence.

The MAM PostgreSQL database may be installed on:

On the host where the MAM PostgreSQL database will reside, do the following:

These instructions assume you will be installing the MAM PostgreSQL database on a different host from where the Insight PostgreSQL database will reside.

If you wish to install both the MAM and the Insight PostgreSQL databases on the same host, different instructions are required. For example, you will need to enable the Insight-specific postgresql RPM repo by following the RPM instructions to prepare the host (see 3.2 Preparing the Host – Typical Method or 3.4 Preparing the Host – Offline Method) and you will need to modify the MAM PostgreSQL install instructions to reflect the different version of PostgreSQL required by Insight (see 3.10.2.C Install PostgreSQL for an example of how to install PostgreSQL for Insight).

  1. Install and initialize the PostgreSQL Server.
    [root]# yum install postgresql-server
[root]# service postgresql initdb
  2. Configure trusted connections.

    Edit or add a "host" line in the pg_hba.conf file for the interface from which the MAM Server 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

# Replace 127.0.0.1 with the IP address of the MAM Server Host if the
# MAM PostgreSQL server is on a separate host from the MAM server.
host    all             all             127.0.0.1/32            md5
host    all             all             ::1/128                 md5

---
  3. If the MAM Database Host is installed on a different host from where you will install the MAM Server, configure PostgreSQL to accept connections from the MAM Server Host. 
    [root]# vi /var/lib/pgsql/data/postgresql.conf

# Replace <mam-server-host> with the interface name from which the MAM server
# will be connecting to the database.
listen_addresses = '<mam-server-host>'

---
  4. Start or restart the database.
    [root]# chkconfig postgresql on
[root]# service postgresql restart

2.4.4 Install Dependencies, Packages, or Clients

Use the following instructions to install the required Moab Accounting Manager dependencies, packages, or clients.

Depending on your configuration, the MAM Server Host and the MAM GUI Host may be installed on the same host. The MAM Client Host is automatically installed on the same host as the MAM Server Host; however, you can also install the MAM Client Host on any other hosts on which you want to have the MAM client commands available to users or administrators.

  1. On the MAM Server Host, the MAM GUI Host, and the MAM Client Hosts, do the following:
    [root]# yum install gcc redhat-lsb-core perl rrdtool perl-Config-Tiny perl-Crypt-CBC perl-Crypt-DES perl-Crypt-DES_EDE3 perl-Digest-HMAC perl-Error perl-Log-Dispatch-FileRotate perl-Log-Log4perl perl-XML-LibXML

    If installing on RHEL, some packages may not be found in the standard RHEL distribution repositories.

    • One way to overcome this problem is to install the missing dependencies from EPEL or other reputable repositories. For example (for the current RHEL 7 repositories):
    [root]# rpm -Uvh http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-6.noarch.rpm
[root]# yum install yum-utils
[root]# yum-config-manager --disable epel
[root]# yum install --enablerepo=epel,rhel-7-server-optional-rpms gcc redhat-lsb-core perl rrdtool perl-Config-Tiny perl-Crypt-CBC perl-Crypt-DES perl-Crypt-DES_EDE3 perl-Digest-HMAC perl-Error perl-Log-Dispatch-FileRotate perl-Log-Log4perl perl-XML-LibXML
    • Alternatively, you can install the available packages in the RHEL repository and then install the missing modules from CPAN.
    [root]# yum install --skip-broken gcc redhat-lsb-core perl rrdtool perl-Config-Tiny perl-Crypt-CBC perl-Crypt-DES perl-Crypt-DES_EDE3 perl-Digest-HMAC perl-Error perl-Log-Dispatch-FileRotate perl-Log-Log4perl perl-XML-LibXML perl-CPAN
[root]# cpan YAML Config::Tiny Log::Log4perl Log::Dispatch::FileRotate Compress::Zlib

    You may need to run the cpan command more than once for it to complete successfully.

  2. On the MAM Server Host, do the following:
    [root]# yum install postgresql postgresql-libs perl-DBD-Pg perl-Date-Manip perl-Time-HiRes perl-DBI
  3. On the MAM GUI Host, do the following:
    [root]# yum install httpd mod_ssl perl-CGI perl-CGI-Session
  4. On each of the MAM Client Hosts (including the MAM Server Host), do the following: 
    [root]# yum install perl-suidperl perl-Term-ReadLine-Gnu perl-TermReadKey

If any of the Perl module packages fail to install or are unavailable for your system, you can install it from CPAN by running cpan MODULENAME where MODULENAME is the respective perl module name.

2.4.5 (Optional) Build a Custom RPM

If you want to build a custom RPM, do the following:

  1. Install rpm-build. 
    [root]# yum install rpm-build
  2. Download the latest MAM build (mam-<version>.tar.gz) from the Adaptive Computing Moab HPC Suite Download Center.

    The variable marked <version> indicates the build's version.

  3. Untar the downloaded package.
  4. Change directories into the untarred directory.
  5. Edit the ./mam.spec file for RPM customization.
  6. Run ./rpm-build.
  7. Locate the custom RPM in rpm/RPMS/x86_64.

2.4.6 Install MAM Server

On the MAM Server Host, do the following:

  1. Create a user called mam and switch to that user. 
    [root]# useradd -m mam
[root]# su - mam
[mam]$ mkdir src
[mam]$ cd src
  2. Download the latest MAM build (mam-<version>.tar.gz) from the Adaptive Computing Moab HPC Suite Download Center.

    The variable marked <version> indicates the build's version.

  3. Untar the MAM tarball. 
    [mam]$ tar -zxvf mam-9.0.2.tar.gz
  4. Navigate to mam-9.0.2. 
    [mam]$ cd mam-9.0.2
  5. Configure the software. For a list of all the configuration options, see 2.14 Moab Accounting Manager Configuration Options. 
    [mam]$ ./configure
  6. Compile the software. 
    [mam]$ make

    If you only need to install the clients on a particular system, replace make with make clients-only. If you only need to install the web GUI on a particular system, replace make with make gui-only.

  7. Install the software. 
    [mam]$ exit
[root]# cd ~mam/src/mam-9.0.2
[root]# make install

    If you only need to install the clients on a particular system, replace make install with make install-clients-only. If you only need to install the web GUI on a particular system, replace make install with make install-gui-only.

  8. As the database user, create a database called mam and grant database privileges to the mam user.

    PostgreSQL should have previously been installed using the instructions in 2.1 Preparing for Manual Installation.

    [root]# su - postgres
[postgres]$ psql

create database mam;
create user mam with password 'changeme!';
\q

[postgres]$ exit

    The password you define must be synchronized with the database.password value in /opt/mam/etc/mam-server.conf

    [root]# vi /opt/mam/etc/mam-server.conf

database.password = changeme!
  9. Run the hpc.sql script to populate the Moab Accounting Manager database with objects, actions, and attributes necessary to function as an Accounting Manager. 
    [root]# su - mam
[mam]$ cd src/mam-9.0.2
[mam]$ psql mam < hpc.sql
[mam]$ exit
  10. Configure MAM to automatically start up at system boot; start the mam service.
    [root]# chkconfig --add mam
[root]# service mam start

2.4.7 Configure the MAM GUI

If you plan to use the web GUI, then on the MAM GUI Host, do the following:

  1. As root, add or edit the SSL virtual host definition as appropriate for your environment. To do so, configure the cgi-bin directory in ssl.conf. Below the cgi-bin directory element, create an alias for /cgi-bin pointing to your cgi-bin directory. If you chose to install to a cgi-bin sub-directory, you might want to create an alias for that as well. Also, add index.cgi to the DirectoryIndex so you can use the shorter sub-directory name. 
    [root]# vi /etc/httpd/conf.d/ssl.conf

<Directory "/var/www/cgi-bin">
## Add these lines
  Options ExecCGI
  AddHandler cgi-script .cgi
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>

# Aliases for /cgi-bin
Alias /cgi-bin/ /var/www/cgi-bin/
Alias /mam /var/www/cgi-bin/mam/

# Make shorter sub-dir name available
DirectoryIndex index.cgi
  2. If Security Enhanced Linux (SELinux) is enforced, you may need to customize SELinux to allow the web server to make network connections, use setuid for authentication, and write to the log file.
    1. Determine the current mode of SELinux. 
      [root]# getenforce

Enforcing
      • If the command returns a mode of Disabled or Permissive, or if the getenforce command is not found, you can skip the rest of this step.
      • If the command returns a mode of Enforcing, you can choose between options of customizing SELinux to allow the web GUI to perform its required functions or disabling SELinux on your system.
    2. If you choose to customize SELinux, do the following:

      SELinux can vary by version and architecture and that these instructions may not work in all possible environments.

      If you used the --prefix=<prefix> configuration option when you configured Moab Accounting Manager, you must replace references to /opt/mam in the example below with the <prefix> you specified. See 2.14 Moab Accounting Manager Configuration Options.

      [root]# cat > mamgui.te <<EOF
module mamgui 1.0;
require {
        type httpd_sys_script_t;
        type port_t;
        class capability setuid;
        class tcp_socket name_connect;
}
allow httpd_sys_script_t port_t:tcp_socket name_connect;
allow httpd_sys_script_t self:capability setuid;
EOF
[root]# checkmodule -M -m -o mamgui.mod mamgui.te
[root]# semodule_package -m mamgui.mod -o mamgui.pp
[root]# semodule -i mamgui.pp
[root]# setenforce 0
[root]# chcon -v -t httpd_sys_content_t /opt/mam/log
[root]# setenforce 1
  3. For the highest security, it is recommended that you install a public key certificate that has been signed by a certificate authority. The exact steps to do this are specific to your distribution and the chosen certificate authority. An overview of this process for CentOS 7 is documented here.

    Alternatively, if your network domain can be secured from man-in-the-middle attacks, you could use a self-signed certificate. Often this does not require any additional steps since in many distributions, such as Red Hat, the Apache SSL configuration provides self-signed certificates by default.

    If your configuration uses self-signed certificates, no action is required; Red Hat ships with ready-made certificates.

  4. Start or restart the HTTP server daemon.
    [root]# chkconfig httpd on
[root]# service httpd restart

2.4.8 Access the MAM GUI

If you plan to use the web GUI, then on the MAM Server Host, do the following:

  1. Create a password for the mam user to be used with the MAM Web GUI. 
    [root]# su - mam
[mam]$ mam-set-password
[mam]$ exit
  2. Verify the connection.
    1. Open a web browser and navigate to https://<mam-server-host>/cgi-bin/mam.
    2. Log in as the mam user with the password you set in step 1.

2.4.9 Configure Moab Workload Manager to Use Moab Accounting Manager

Do the following:

  1. Configure Moab to talk to MAM

    Do one of the following:

    • MAM Option. If you are will be using the MAM (direct network) accounting manager interface with Moab Workload Manager (this is the default), do the following:
      1. On the Moab Server Host, edit the Moab configuration file, uncomment the AMCFG lines and set the TYPE to MAM and set the HOST. If the Moab Server and the MAM Server are on the same host, set HOST to 'localhost'; otherwise, set HOST to the host name for the MAM Server (MAM Server Host). 
        [root]# vi /opt/moab/etc/moab.cfg
AMCFG[mam] TYPE=MAM HOST=<mam_server_host>

        Customize additionally as needed. See Accounting, Charging, and Allocation Management in the Moab Workload Manager Administrator Guide

      2. Configure Moab to authenticate with MAM using the MAM secret key.
        1. On the MAM Server Host, copy the auto-generated secret key from the token.value value in the /opt/mam/etc/mam-site.conf file.
        2. On the Moab Server Host, add the secret key to the moab-private.cfg file as the value of the CLIENTCFG KEY attribute.
          [root]# vi /opt/moab/etc/moab-private.cfg
CLIENTCFG[AM:mam] KEY=<MAMSecretKey>
    • Native Option. If you are will be using the Native (custom script) accounting manager interface with Moab Workload Manager, do the following:
      1. On the Moab Server Host, edit the Moab configuration file, uncomment the AMCFG lines and set the TYPE to NATIVE.
        [root]# vi /opt/moab/etc/moab.cfg
AMCFG[mam] TYPE=NATIVE
      2. If you are installing Moab Accounting Manager on a different host (MAM Server Host) from the Moab Server (Moab Server Host), you will need to install the Moab Accounting Manager client on the Moab Server Host in order for the custom scripts to use the MAM API.

        3. On the Moab Server Host, follow the instructions in 2.4.4 Install Dependencies, Packages, or Clients and 2.4.6 Install MAM Server; with the following exceptions:

        • Install only the dependent packages applicable to MAM Client Hosts
        • Use the configure option ‑‑without‑init
        • Instead of running make, use make clients-only
        • Instead of running make install, use make install-clients-only
        • Omit the step to create the database and all of the steps thereafter
  2. On the Moab Server Host, restart Moab.
    service moab restart

2.4.10 Initialize Moab Accounting Manager

You will need to initialize Moab Accounting Manager to function in the way that is most applicable to the needs of your site. See Initial Setup in the Moab Accounting Manager Administrator Guide to set up Moab Accounting Manager for your desired accounting mode.

Related Topics 

  • 2.1 Preparing for Manual Installation

    • © 2016 Adaptive Computing