5.63 Client Configuration

The following configuration parameters may be set in the client configuration file (mam-client.conf):

Parameter Description
account.show [Name,Active,Users,Organization,Description] The default fields shown by mam-list-accounts.
accounting.mode [strict-allocation] The accounting mode can be one of usage-tracking, notional-charging, fast-allocation, or strict-allocation. The value of this parameter may modify the default fields displayed by certain commands such as mam-list-usagerecords.
allocation.enforcedisdiscrete [true] If enabled (the default), new allocations will be prevented from overlapping existing ones. This policy helps to improve clarity when reporting on allocation usage during a particular period.
allocation.show [Id,Fund,StartTime,EndTime,InitialDeposit,Allocated,CreditLimit,Remaining,PercentUsed] The default fields shown by mam-list-allocations.
balance.show [Id,Name,Balance,Reserved,Effective,CreditLimit,Available] The default fields shown by mam-balance.
currency.precision [0] Indicates the number of decimal places in the credit currency. For example, if you will be dealing with integer billable units like processor-seconds, use 0 (which is the default). If you will be charging dollars and cents, then use 2. This parameter should be the same in the mam-server.conf and mam-client.conf files.
event.show

[Id,FireCommand,FireTime,ArmTime,RearmPeriod,EndTime,Notify,RearmOnFailure,FailureCommand,CatchUp,CreationTime,Description]

-- The default fields shown by mam-list-events.

fund.show [Id,Name,Constraints,Allocated,Balance,DefaultDeposit,Description] The default fields shown by mam-list-funds.
lien.show [Id,Instance,Amount,StartTime,EndTime,UsageRecord,Funds,Description] The default fields shown by mam-list-liens.
log4perl.appender.Log.filename Used by log4perl to set the base name of the log file.
log4perl.appender.Log.max Used by log4perl to set the number of rolling backup logs.
log4perl.appender.Log.size Used by log4perl to set the size the log will grow to before it is rotated.
log4perl.appender.Log.Threshold Used by log4perl to set the debug level written to the log. The logging threshold can be one of TRACE, DEBUG, INFO, WARN, ERROR, and FATAL.
log4perl.appender.Screen.Threshold Used by log4perl to set the debug level written to the screen. The logging threshold can be one of TRACE, DEBUG, INFO, WARN, ERROR, and FATAL.
notification.show

[Id,Event,Type,Status,Code,Message,Key,Recipient,EndTime,CreationTime]

--The default fields shown by mam-list-notifications.

organization.show [Name,Description] The default fields shown by mam-list-organizations.
quote.show [Id,Amount,Pinned,Instance,UsageRecord,StartTime,EndTime,Duration,ChargeRates,Description] The default fields shown by mam-list-quotes.
response.chunking [false] Indicates whether large responses should be chunked (segmented). If set to false, large responses will be truncated.
response.chunksize [1000] Indicates the line length in the data response that will trigger message segmentation (or truncation). A value of 0 (zero) means unlimited, i.e., that the client will accept the chunksize set by the server. The response chunksize will be taken to be the smaller of the client and server chunksize settings.
security.authentication [true] Indicates whether outgoing message are signed.
security.encryption [false] Indicates whether outgoing messages are encrypted
security.promotion [suidperl] When using the symmetric key for security authentication or encryption, since the site configuration file is readable only by the accounting admin user, a method must be employed to temporarily elevate privileges in order to encrypt the communication with the symmetric key. One of two security promotion methods may be selected: suidperl or mamauth. Suiperl allows a Perl script to temporarily elevate privileges to the owner of the script if the setuid bit is set on the file. This method is recommended when suidperl can be installed on the system. If you prefer not to use suidperl or if it is not available for your system (such as with Perl 5.12 and higher), you will need to use the mamauth security promotion method. mamauth is a setuid binary that allows the request body to be passed in as standard input and returns the authenticated digest and signature. Currently, only suidperl can be used for encryption of client communication. The security promotion method should be configured at install time by specifying the --with-promotion configuration parameter and defaults to suidperl when it is available.
statement.show [Account,User,Machine] The default discriminator fields in mam-statement.
transaction.show [Id,Object,Action,Actor,Name,Child,Instance,Count,Amount,Delta,Balance,User,Account,Machine,Fund,Allocation,UsageRecord,Duration,Description] The default fields shown by mam-list-transactions.
usagerecord.show [Id,Type,Instance,Charge,Stage,User,Group,Account,Organization,Class,QualityOfService,Machine,Nodes,Processors,Memory,Duration,SubmitTime,StartTime,EndTime,Description] The default fields shown by mam-list-usagerecords.
user.show [Name,Active,CommonName,PhoneNumber,EmailAddress,DefaultAccount,Description] The default fields shown by mam-list-users.

© 2016 Adaptive Computing