Source Installation Guide
Install Source Package
$ tar zxvf xdmod-x.y.z.tar.gz $ cd xdmod-x.y.z # ./install --prefix=/opt/xdmod
Change the prefix as desired. The default installation prefix is
/usr/local/xdmod. These instructions assume you are installing Open
Create Open XDMoD User And Group
For improved security, create an Open XDMoD user and group that will have access to sensitive data:
# groupadd -r xdmod # useradd -r -M -c "Open XDMoD" -g xdmod -d /opt/xdmod/lib -s /sbin/nologin xdmod
Secure the file containing database passwords:
# chmod 440 /opt/xdmod/etc/portal_settings.ini # chown apache:xdmod /opt/xdmod/etc/portal_settings.ini
portal_settings.ini file must be readable by Apache and any
user that will run the Open XDMoD commands. Replace the Apache username
apache) with the appropriate name if it is different on your system.
Add any user that will run Open XDMoD to the
# usermod -a -G xdmod jdoe
jdoe with an appropriate username. Typically, you will need to log
out of your system and log back in for this change to take effect.
Update log directory and file ownership and permissions:
# chmod 775 /opt/xdmod/logs # chown apache:xdmod /opt/xdmod/logs # touch /opt/xdmod/logs/exceptions.log # chmod 664 /opt/xdmod/logs/exceptions.log # chown apache:xdmod /opt/xdmod/logs/exceptions.log # touch /opt/xdmod/logs/query.log # chmod 664 /opt/xdmod/logs/query.log # chown apache:xdmod /opt/xdmod/logs/query.log
query.log may be written to by both Apache and Open
Run Configuration Script
Complete each setup section with the required information.
See the Configuration Guide for more details.
Copy Configuration Files
# cp /opt/xdmod/etc/apache.d/xdmod.conf /etc/apache2/conf.d/xdmod.conf # cp /opt/xdmod/etc/cron.d/xdmod /etc/cron.d/xdmod # cp /opt/xdmod/etc/logrotate.d/xdmod /etc/logrotate.d/xdmod
The directories where these files are needed may differ depending on your operating system. By default, the Apache configuration creates a virtual host on port 8080.
Depending on which resource manager you use, your accounting logs may be stored in a single file, a directory containing multiple files or in a database that is queried using a specific command. Each of these is handled with different options in Open XDMoD.
See the Shredder Guide and the resource manager notes for more details.
PBS stores its accounting logs in a directory where the name of each
file corresponds to the end date of the jobs it contains. A directory
such as this can be specified using the
$ /opt/xdmod/bin/xdmod-shredder -v -r *resource* -f pbs \ -d /var/spool/pbs/server_priv/accounting
SGE stores its accounting logs in a single file so the
option should be used:
$ /opt/xdmod/bin/xdmod-shredder -v -r *resource* -f sge \ -i /var/lib/gridengine/default/common/accounting
Slurm stores its accounting logs in a database that can be queried using
sacct command. Since the accounting data is not directly
accessible in files Open XDMoD provides a helper script that writes the
data to a file and then shreds that file:
$ /opt/xdmod/bin/xdmod-slurm-helper -v -r *resource*
The resource name here must match the one supplied to the setup script.
NOTE: This command only works if Open XDMoD is on a machine with the
sacct command or if you have configured your
file with a command that accepts the same arguments as
sacct (such as
ssh with a public key to run the command on another machine).
$ /opt/xdmod/bin/xdmod-ingestor -v
See the Ingestor Guide for more details.
# /etc/init.d/apache2 restart
This command may be different depending on your operating system.