UBMoD - RPM Install

RPM Installation

This document will attempt to outline a basic install of UBMoD.

This installation document assumes you are running a Red Hat based Linux system and already have Apache, PHP, Perl and MySQL installed and running.

Download UBMoD

Download the latest RPM release (ubmod-x.x.x-x.el6.noarch.rpm) here.

Install the RPM

# rpm -Uvh ubmod-x.x.x-x.el6.noarch.rpm

Set up the MySQL database

mysql> create database ubmod;
mysql> grant all on ubmod.* to ubmoduser@localhost identified by 'password';
mysql> quit;

$ mysql -u ubmoduser -p ubmod < /usr/share/doc/ubmod-x.x.x/ddl/ubmod.sql

Edit the UBMoD config file

Update the file /etc/ubmod/settings.ini with your site specific settings.

[database]
host = localhost
dbname = ubmod
user = ubmoduser
password = password

Load in accounting log data

For PBS/TORQUE:

$ ubmod-shredder -v -s -H your.host.org -f pbs -d /var/spool/pbs/server_priv/accounting

For SGE:

$ ubmod-shredder -v -s -H your.host.org -f sge -i /var/lib/gridengine/default/common/accounting

For Slurm:

$ ./shredder/bin/ubmod-slurm-helper -v

Aggregate accounting log data

$ ubmod-shredder -v -u

Set up the web application

Update the file /etc/httpd/conf.d/ubmod.conf with your site specific settings.

Listen 8080
<VirtualHost *:8080>
    DocumentRoot /usr/share/ubmod/html
    <Directory /usr/share/ubmod/html>
        RewriteEngine On
        RewriteRule ^api/rest/(.*)$ api/rest/index.php?path_info=$1 [L,QSA]
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^(.*)$ index.php?path_info=$1 [L,QSA]
    </Directory>
</VirtualHost>

* Note this is a basic example of setting up Apache for use with UBMoD for demo purposes only and not intended for production use. UBMoD does not have built-in authentication or authorization access controls.

Reload the Apache configuration

# /etc/init.d/httpd reload

Point your browser to http://localhost:8080/.