Layout of Scheduler Components
Moab Workload Manager®

3.1 Layout of Scheduler Components

Moab is initially unpacked into a simple one-deep directory structure as shown below. Some of the files (such as log and statistics files) are created while Moab runs.

  • $(MOABHOMEDIR)
    • moab.cfg - general configuration file
    • moab-private.cfg - secure configuration file containing private information
    • moab.dat - configuration file generated by Moab Cluster Manager
    • moab.lic - license file
    • .moab.ck - checkpoint file
    • .moab.pid - lock file
    • bin - directory for executable files
      • moab - Moab binary
      • {showq, setres, ...} - client commands
    • spool - directory for temporary files
    • log - directory for log files
      • moab.log - log file
      • moab.log.1 - previous log file
    • stats - directory for statistics files
      • events.<date> - event files
      • {DAY|WEEK|MONTH|YEAR}.<date> - usage profiling data
      • FS.<PARTITION>.<epochtime> - fairshare usage data
    • docs - directory for documentation
    • samples - directory for sample configuration files, simulation trace files, and so forth
    • contrib - directory containing contributed code and plug-ins
  • $(MOABINSTDIR)
    • bin - directory for installed client commands
    • sbin - directory for installed server daemons
      • moab - Moab binary
    • tools - directory for RM interfaces and local scripts
  • /etc/moab.cfg - optional file used to override default $(MOABHOMEDIR) settings that should contain the string MOABHOMEDIR $(DIRECTORY) to override the built-in $(MOABHOMEDIR) setting.

When Moab is configured via the configure script, the user is queried for the location of the Moab home directory and the $(MOABHOMEDIR) directory is compiled in as the default MOABHOMEDIR directory when Moab is built. Unless specified otherwise, Moab looks to this directory for configuration files. If you want to run Moab from a different directory, you can override the default home directory setting by editing the /etc/moab.cfg file. Look for the string containing MOABHOMEDIR <DIRECTORY> and set the environment variable MOABHOMEDIR, or specify that the configuration file explicitly use the -C command line option on Moab and the Moab client commands.

When Moab runs, it creates a log file, moab.log, in the log directory and creates a statistics file in the stats directory with the naming convention events.WWW_MMM_DD_YYYY. (Example: events.Sat_Feb_16_2008). Additionally, a checkpoint file, .moab.ck and lock file .moab.pid are maintained in the Moab home directory.

See Also