Managing system settings

System settings identify default values for various user settings and enable or disable certain functions. All settings have a default value that is used only if a setting is not defined in the database. You can use the database to manage modifications to the default value to modify system behavior.

You can add or edit settings for the _system user. The values of these settings apply throughout a system. You can override some system settings for an individual user (see Managing user settings).

To add or change system settings

  1. On the System tab, in the left menu, click Settings, and then do one of the following:
    • To add a new system setting, in the upper-right corner, click New Setting, and then enter the name and value of the setting.
    • To modify an existing system setting, click the required setting and modify its value as appropriate.
  2. Click the Submit icon ().

System settings



add_instance_user_infoAdds VL_USER_ID and VL_USER_NAME to Instance logs. Allows you to define whether to automatically insert user credentials as properties on an instance during creation.
api_portAn integer value to be used as a port on which the API service is responding to the incoming commands. Use this value to change the default API socket-based port.

A link to a location where package instances are stored.

auto_logout_minutesAllows you to define the default number of minutes of the idle activity before the user is logged out of the BMC Release Package and Deployment (RPD).

Timeout value used when attempting each step in establishing a connection to a server

displayed as
Server Read Timeout
Allows you to define the number of seconds RPD will attempt to perform a read command before timing out
displayed as
Server WriteTimeout
Allows you to define the number of seconds RPD will attempt to perform a write command before timing out
Allows you to ignore a case sensitive name matching during the expansion of the config set variable

Reserved for future use

console_base_url Allows you to define the base URL of RPD
dashboard Allows you to define the initial landing page when navigating to the Deploy tab
dashboard_instance_age Allows you to define the timespan measured in days, during which the deployment with the Route Complete status will remain on the launchpad

PHP date() format for date strings for the user (see for details). If no value is specified, the _system value is used.


The default domain is used to transform the username which you enter in the Destination Email Address field to the full email address (for example, (if the default_domain="")).


Default maximum number of engines that a single host is allowed to run. This value can be overridden on each host. See Managing engines and engine hosts.


Role associated with a user at logon if the user has not been assigned a role


Sets the order of precedence for properties in a deployment process. The default is Y (yes) if not set, with the following precedence rules:

  • In version 4.2, the order of precedence for a deployment process properties is (highest to lowest):
    User > Channel > Blueprint > Environment > Deployment > Instance > Package
    Properties defined for the user override the same property definitions at all other levels.
  • In version 5.0, the default precedence is:
    Deployment > User > Channel > Channel Template > Environment > Instance > Package > Reference
    To adhere to the 4.2 order of precedence while using version 5.0, set this system setting (deployment_properties_take_precedence) to N. This enables the BMC Release Process Management software to override deployment properties when used with the RPD software.

This is a non-default preference. This preference can be set to 'y' or 'n', which stands for 'yes' or 'no' respectively. It allows you to enable the engine logging information in the engine_debug.log file and store it in the  RLMhome/releases/productVersion/app/tmp/logs directory by default. To activate the changes, you must restart the engine service.

engine_debug_filepathThis is a non-default preference. It allows you to specify the directory where the engine_debug.log file will be stored.

Minimum number of engines available at any time to accept work. If the available free engine count is less than this number, more engines are created until this number is reached.


Number of tasks an engine can run before being recycled. After completing the specified number of tasks, the engine terminates and the system creates a new engine as needed.


Maximum lifespan of an engine in hours. An engine that persists this long finishes its actions and then terminates, assuming that any constraints are satisfied.


Maximum number of engines available at any time to accept work. If the available free engine count exceeds this number, engines are terminated until this number is reached.


After completing a task, the time in seconds that an engine should wait before checking the work queue for a new task


Number of seconds to wait between checks for engine processes that have unexpectedly terminated

ignore_smtp_send_errorsAllows you to define whether RPD will ignore any mail server errors, allowing the processing to continue afterwards. If set to Yes, the Send Email Notification (starting with RPD, Send Notification) action passes even if there are mail server errors.

Number of items to include per page when displaying something that can be paginated


National language of the user. The user value overrides the default _system user value. In this release, eng and eng_VL are the only supported languages.

Currently, BMC Release Package and Deployment (RPD) supports the following languages:

  • eng: Currently used names of the RPD application items
  • eng_VL: Previously used names of the RPD application items
    (for example, blueprint instead of channel template; bridge instead of server)
ldap_base_dn, ldap_user_search

Parameters that comprise the search string for locating users in LDAP, after the system connects as the query user:

  • ldap_base_dn: Preference that defines the search root
  • ldap_user_search: String that scopes the search to a specific user. On MSAD, an example would be sAMAccount=%. On UNIX, it might be (name=%|uid=%). The % in the string is replaced with the value typed at logon. If the search results return only one record, the system pulls the DN from that result and tries to connect to the LDAP server using that DN and the password supplied at logon. If the connection is successful, the user is authenticated.

URL where your LDAP or Microsoft Active Directory (MSAD) server resides, in the form ldap//<hostname>.com


Distinguished name (DN) of a user who can connect to the LDAP server and perform searches for users


Password for the ldap_query_dn user


Name of the attribute in a user record that contains the groups where the user is a member. In MSAD, this is member, and the user record "member" attribute is an array of the groups that include the user as a member.

ldap_roots_dn, ldap_techs_dn

Preferences specifying the distinguished name of an LDAP group, used to map LDAP groups to user roles:

  • A user in the group specified in ldap_roots_dn gets the root role.
  • The group identified in ldap_techs_dn gets the Tech role.

Value containing your license key for licensing your installation. The license key includes an expiration date. When your license expires, you must request a new value from BMC and enter it. An expired or nonexistent license causes servers to return errors for all actions.

log_date_format Allows you to define the format in which dates are displayed in RPD application logs.

Allows you to specify the level of log details for engines in RPD. The default value is Error. Therefore, only messages of the Error and Fatal severity will be logged. RPD logs are stored in the brpd_file.log file in RLMhome/releases/productVersion/RPD/app/tmp/logs. For more information about the severity of a logging message, see Apache log4php.


Number of seconds a lock can live in the system. If a data object gets stuck or lost, its lock is automatically released after this time.


The From: header in outgoing emails

mail_smtp_authpass, mail_smtp_authuser

The user name and password used for authentication when connecting to the SMTP server


Preference for the "hello" message returned by your mail server. For example, if your mail server returns a nonstandard hello message when you connect to it, you can change that value by setting this preference.


The SMTP port


Host name of the SMTP server


Maximum number of seconds that the system waits for a response from an SMTP server


You can use this setting starting with RPD
Maximum number of checks on a file for corruption that RPD performs before the file is transferred. By default, RPD performs up to three checks. If all of them are negative, then you get an error that the file is corrupted and it cannot be sent.

This setting is not listed by default in System > Settings. If you want to change the number of checks, add a new setting with the ref_retry_count name and the appropriate integer value.


Version number of the schema in the current installation


HTTP request header that contains the authenticated user name on a single-sign-on system


Preference defining the maximum size of a binary large object (BLOB). When a package is instantiated for deployment, the contents of the URIs are fetched and stored as solids, in the form of BLOBs in the database. Larger values provide more efficient storage, as long as you do not exceed the maximum BLOB size for your database.


User time zone for date displays. The _system user value is the default, but a user setting can override it.


This is a non-default preference for the NSH agent type. This preference can be set to y (yes) or n (no). If you add this preference with the y value, you will receive more detailed logs when:

  • Performing deployments for all libraries except Send Instance Content, Manage Semaphore, Manual Task, Promote To Next Environment, Restart Last Failed Activity, Send Action Content, Send Email Notification (starting with, changed to Send Notification).
  • Instance creations for all reference methods except null and file.

Related topics

Managing user settings

Was this page helpful? Yes No Submitting... Thank you