You are here: Appendices > Appendix L Cray-Specific Power Management and Energy-Consumption-by-Job Accounting > Moab Energy-Consumption-by-Job Accounting > Moab Job Energy Consumption Accounting Configuration

L.5 Moab Job Energy Consumption Accounting Configuration

Moab Workload Manager may need a modification to its configuration file and the Moab Accounting Manager will need modification of its configuration for them to charge for the energy a job uses.

L.5.1 Moab Workload Manager Configuration

The energy_used generic metric is an additional unique generic metric name the Moab Workload Manager must track. If the quantity of unique generic metric names Moab is tracking is equal to the maximum unique generic metric names configured in the moab.cfg file by the MAXGMETRIC parameter before configuring use of the energy_used generic metric, the value of the MAXGMETRIC parameter must be incremented by one before Moab can process the energy_used generic metric.

The default value for the MAXGMETRIC parameter is 10. To err on the side of caution, it should be at least 25, and more if Nvidia GPUs and/or Intel MICs are present in the HPC cluster as they produce many metrics recorded by Torque and Moab.

L.5.2 Moab Accounting Manager Configuration

In order for the Moab Accounting Manager (MAM) to charge for the new EnergyUsed generic metric, MAM must be configured so its Usage Record will contain the generic metric.

Add the new EnergyUsed field to the MAM Usage Record configuration by executing the following command:

$ mam-shell Attribute Create Object=UsageRecord Name=EnergyUsed DataType=Float Description=\"Energy Used\"

Configure the mam-list-usagerecords command so MAM will display the new EnergyUsed field by executing the following command to edit MAM’s configuration file.
$ vi /opt/mam/etc/mam-client.conf

Modify the usagerecord.show assignment, similar to the example below.

usagerecord.show = Id,Type,Instance,Charge,Stage,User,Group,Account,Organization,Class,QualityOfService,Machine,Nodes,Processors,Memory,EnergyUsed,Duration,StartTime,EndTime,Description

Save the file and exit the editor.
Now add a charge rate for calculating the cost of the energy used by executing the following command:
$ mam-create-chargerate -n EnergyUsed -z 0.15/3600000 -d "15 cents per kilowatt-hour (3.6M joules)"

The Moab Accounting Manager now has the configuration information it needs to compute a cost for the energy used by a job.