Gold Allocation Manager
Home Up Previous Next

Configuration Files

Gold uses two configuration files: one for the server (goldd.conf) and one for the clients (gold.conf). For configuration parameters that have hard-coded defaults, the default value is specified within brackets.

Server Configuration

The following configuration parameters may be set in the server configuration file (goldd.conf).

  • account.autogen [true] — If set to true, when a new project is created Gold will automatically create an associated default account. Additionally, if you try to make a deposit and no accounts match the specifications, an account will be created using the specified criteria and a deposit will be made into that account.

  • allocation.autogen [true] — If set to true, when a new account is created Gold will automatically create an associated default allocation with zero credits.

  • database.datasource [DBI:Pg:dbname=gold;host=localhost] — The Perl DBI data source name for the database you wish to connect to.

  • database.password — The password to be used for the database connection (if any).

  • database.user — The username to be used for the database connection (if any).

  • response.chunksize [0] — 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 server will not truncate or segment large responses unless overriden by a chunksize specification in a client request. The response chunksize will be taken to be the smaller of the client and server chunksize settings.

  • currency.precision [0] — Indicates the number of decimal places in the resource credit currency. For example, if you are will be dealing with processor-seconds of an integer resource unit, 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 goldd.conf and gold.conf files.

  • 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.

  • machine.autogen [false] — If set to true, Gold will automatically create new machines when they are first encountered in a job function (charge, reserve, or quote). Additionally, a new machine will be automatically created if you try to add an undefined machine as a member of a project or account.

  • machine.default [NONE] — If not set to NONE, Gold will use the specified default for the machine in a job function (charge, reserve, or quote) in which a machine was not specified.

  • project.autogen [false] — If set to true, Gold will automatically create new projects when they are first encountered in a job function (charge, reserve, or quote). Additionally, a new project will be automatically created if you try to add an undefined project as a member of an account.

  • project.default [NONE] — If not set to NONE, Gold will use the specified default for the project in a job function (charge, reserve, or quote) in which a project was not specified and no default project can be found for the user.

  • security.authentication [true] — Indicates whether incoming message authentication is required.

  • security.encryption [false] — Indicates whether incoming message encryption is required.

  • server.host [localhost] — The hostname on which the Gold server runs.

  • server.port [7112] — The port the Gold server listens on.

  • super.user [root] — The primary Gold system admin which by default can perform all actions on all objects. The super user is sometimes used as the actor in cases where an action is invoked from within another action.

  • user.autogen [false] — If set to true, Gold will automatically create new users when they are first encountered in a job function (charge, reserve, or quote). Additionally, a new user will be automatically created if you try to add an undefined user as a member of a project or account.

  • user.default [NONE] — If not set to NONE, Gold will use the specified default for the user in a job function (charge, reserve, or quote) in which a user was not specified.

Home Up Previous Next