Fork me on GitHub

Software Requirements

Open XDMoD requires the following software:

Linux Distribution Packages

Open XDMoD can be run on any Linux distribution, but has been tested on Ubuntu 14.04 and CentOS 7.

Most of the requirements can be installed with the package managers available from these distributions.

Ubuntu 14.04

# apt-get install apache2 php5 php5-cli php5-mysql php5-gd \
                  php5-mcrypt libgmp-dev php5-gmp php-pear \
                  php-log php-mdb2 php-mdb2-driver-mysql \
                  default-jre-headless openjdk-7-jdk phantomjs \
                  mysql-server mysql-client cron logrotate

CentOS 7 / RHEL 7

NOTE: The package list below includes packages included with EPEL. This repository can be added with this command for CentOS 7:

# yum install epel-release

And for RHEL 7:

# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

NOTE: Users of RHEL will need to enable the optional (rhel-7-server-optional-rpms) and extras (rhel-7-server-extras-rpms) repositories.

# yum install httpd php php-cli php-mysql php-gd php-mcrypt \
              gmp-devel php-gmp php-pdo php-xml php-pear-Log \
              php-pear-MDB2 php-pear-MDB2-Driver-mysql \
              java-1.7.0-openjdk java-1.7.0-openjdk-devel \
              mariadb-server mariadb cronie logrotate

NOTE: Neither the CentOS repositories nor EPEL include PhantomJS, so that must be installed manually. Packages are available for download from the PhantomJS website.

NOTE: After installing Apache and MySQL you must make sure that they are running. CentOS may not start these services and they will not start after a reboot unless you have configured them to do so.

Additional Notes

PHP

Some Linux distributions (including CentOS) do not set the timezone used by PHP in their default configuration. This will result in many warning messages from PHP. You should set the timezone in your php.ini file by adding the following, but substituting your timezone:

date.timezone = America/New_York

The PHP website contains the full list of supported timezones.

Apache

Open XDMoD requires that mod_rewrite be installed and enabled. Since the Open XDMoD portal is a web application you will also need to make sure you have configured your firewall properly to allow appropriate network access.

MySQL

MySQL 5.5 is currently recommended for use with Open XDMoD.

Some versions of MySQL have binary logging enabled by default. This can be an issue during the setup process if the user specified to create the databases does not have the SUPER privilege. If binary logging is not required you should disable it in your MySQL configuration. If that is not an option you can use the less safe log_bin_trust_function_creators variable. You may also grant the SUPER privilege to the user that is used to create the Open XDMoD database.

PhantomJS

If you are running PhantomJS 1.4 or earlier you will also need Xvfb running on port 99.

On Ubuntu 12.04 (and other operating systems using Upstart), create a file /etc/init/xvfb.conf containing the following:

description "Xvfb X Server"
start on (net-device-up
          and local-filesystems
          and runlevel [2345])
stop on runlevel [016]
exec su -s /bin/sh -c 'exec "$0" "$@"' daemon -- /usr/bin/Xvfb :99 -screen 0 1024x768x24

This will start Xvfb when your system boots. To start Xvfb manually:

# service xvfb start

NOTE: PhantomJS does not work properly with the default CentOS SELinux security policy. You will need to disable SELinux or create a custom policy.

Creating a custom SELinux Policy for PhantomJS

If you have already tried to generate a report and got an error with phantom JS you can use the audit2allow command to generate a policy for you

# grep phantomjs /var/log/audit/audit.log | audit2allow -M httpd_phantomjs
# semodule -i httpd_phantomjs.pp

The other way is to compile the module

# yum install selinux-policy-devel
# mkdir /tmp/httpd_phantomjs
# cd /tmp/httpd_phantomjs
# cat << EOF >> httpd_phantomjs
module httpd_phantomjs 1.0;

require {
	type httpd_t;
	type fonts_t;
	type ld_so_cache_t;
	type fonts_cache_t;
	class process execmem;
	class file execute;
}

#============= httpd_t ==============
allow httpd_t fonts_cache_t:file execute;
allow httpd_t fonts_t:file execute;
allow httpd_t ld_so_cache_t:file execute;

#!!!! This avc is allowed in the current policy
allow httpd_t self:process execmem;
EOF

# make -f /usr/share/selinux/devel/Makefile
# semodule -i httpd_phantomjs.pp
# rm -rf /tmp/httpd_phantomjs