Conventions

This page lists some conventions and notations used in this documentation.

Using sudo

Throughout this document, we’re assuming that commands which require root permissions can be issued by using sudo. If your system is not configured for this, you can either login directly as root (considered as “bad practice”) or use the su - command to switch to the root user.

note We highly recommend the usage of sudo though!

Operating systems

The recommended linux distributions are:

Icon Distribution name
debian Debian
ubuntu Ubuntu
rocky Rocky Linux
alma Alma Linux

We will use tabs to group the code and instructions for respective operating system families

Tab name Corresponding operating system family
Debian Debian, Ubuntu
RHEL RedHat, Rocky Linux, Alma Linux

Warning

Please notice that with release 3.1, we dropped support for macosx Mac OS X. HRM 3.0 is still known to work on Mac OS X from 10.5 (Leopard) onward, but no effort will be made to make future versions of the HRM compatible with Mac OS X. Also notice that the HRM was never tested on Mavericks.

Variables

Variable Description (Example) value
$WWW_ROOT Web server document root /var/www/html
$HRM_HOME HRM root (home) folder $WWW_ROOT/hrm
$HRM_CONFIG HRM configuration folder $HRM_HOME/config
$HRM_SAMPLES HRM configuration samples folder $HRM_HOME/config/samples
$HRM_RESRC HRM resources folder $HRM_HOME/resources
$HRM_SETUP HRM setup folder $HRM_HOME/setup
$HRM_BIN HRM executables folder $HRM_HOME/bin
$HRM_USER HRM customization folder $HRM_HOME/user
$HRM_LOG HRM logging folder /var/log/hrm
$HRM_DATA HRM data folder /data/hrm_data

If you want to use those variables in your interactive shell later on, just copy-paste the following lines into your session and adjust the values accordingly:

WWW_ROOT=/var/www/html                 # Web server document root
HRM_HOME=$WWW_ROOT/hrm                 # HRM root (home) folder
HRM_CONFIG=$HRM_HOME/config            # HRM configuration folder
HRM_SAMPLES=$HRM_HOME/config/samples   # HRM configuration samples folder
HRM_RESRC=$HRM_HOME/resources          # HRM resources folder
HRM_SETUP=$HRM_HOME/setup              # HRM setup folder
HRM_BIN=$HRM_HOME/bin                  # HRM executables folder
HRM_USER=$HRM_HOME/user                # HRM customization folder
HRM_LOG=/var/log/hrm                   # HRM logging folder
HRM_DATA=/data/hrm_data                # HRM data folder