Installing → Configuration Guide
Prerequisites
The OnDemand module must be installed. Optionally a GeoLite2 geolocation database file can be installed.
Database Configuration
Interactive script configuration
The Open OnDemand XDMoD module adds an additional menu item to the XDMoD interactive setup software. Run the script as follows:
# xdmod-setup
and select the ‘Open OnDemand’ option in the main menu. The Open OnDemand
section only has a single option: setup the database. This option creates the
necessary database schema in the XDMoD
datawarehouse. You will need to provide the credentials for your MySQL root
user, or another user that has privileges to create databases. A single
database modw_ondemand
will be created. The database user that is
specified in the portal_settings.ini
will be granted access to this
database.
Manual configuration
If the database server is located on a different host than the webserver then it is necessary to setup the database manually.
Create a database schema called modw_ondemand
and grant permission for the XDMoD database user
account to access this schema.
Once the schema is created then the acl-config
command should be run:
$ /usr/xdmod/bin/acl-config
Resource Setup
Add a new resource to Open XDMoD using the xdmod-setup
script.
Instructions for adding the resource are on the main Open XDMoD page
The Open OnDemand resource must have a type set to gateway
.
The resource setup menu will prompt for the node and core count for the resource. These data are not currently used by the On Demand module, but it is recommmended to use the correct core and node counts for the Open OnDemand webserver for consistency.
The xdmod-ingestor
script must be run after the new resource is added. Running
xdmod-ingestor
loads the resource information into the XDMoD datawarehouse.
Configuration file
The /etc/xdmod/portal_settings.d/ondemand.ini
configuration
file settting are listed below:
Parameter Name | Description |
---|---|
geoip_database |
Full path to the GeoLite2 City file (in MMDB format). Set this to an empty string if no file is available (location data in XDMoD will show as Unknown). |
webserver_format_str |
The format string for the webserver access logs. This should be set to the same value as the LogFormat directive in the apache server for the Open OnDemand instance |