ra_config

Syntax

ra_config [ { param [, value] | password_parameter, [value] } ]

Parameters

param – The name of a Replication Agent configuration parameter.
value – The value to be assigned to the configuration parameter specified in the param option. You can use the keyword default to set the specified parameter to its default value.

password_parameter – Affects password security parameters.

Password Parameters
`password_parameter`	Description and `value`	Default Value
min_password_len	Minimum number of characters required. Range – 6 to 12.	-1 (no minimum length)
max_password_len	Maximum number of characters. Always set max_password_len to a value greater than min_password_len. Range – 13 to 255.	255 characters
password_lowercase_required	Whether lowercase characters are required. True – required. False – not required.	False
password_uppercase_required	Whether uppercase characters are required. True – required. False – not required.	False
password_numeric_required	Whether a numeric character is required. True – required. False – not required.	False
password_special_required	Whether a special character is required. True – required. False - not required.	False
password_expiration	Number of days after which the password expires. 0 – password never expires (default). Range – 0 to 32,767. If the password has expired, the account is locked and the Replication Agent notifies the user that the password has expired. The account is unlocked only after a password that complies with the password security requirements is set. An administrator can override the initial password expiration value that is set during the upgrade process.	0 (password never expires)

Examples

Example 1 –
```
ra_config
```
When ra_config is issued with no parameters, it returns a list of all Replication Agent configuration parameters.
Example 2 –
```
ra_config use_rssd
```
This command returns the current value of the use_rssd configuration parameter.
Example 3 –
```
ra_config scan_sleep_max, 60
```
This command changes the value of the scan_sleep_max parameter to 60.
Example 4 –
```
ra_config max_password_len, 15
```
This command changes the value of the max_password_len parameter to 15 for all users.

Usage

If ra_config is invoked with no option, it returns a list of all Replication Agent configuration parameters.
If ra_config is invoked with the param option, it returns information only for the specified configuration parameter.
If ra_config is invoked with the param and value options, it changes the setting of the specified configuration parameter to the value specified in the value option.
You can use the keyword default in place of the value option to reset a configuration parameter to its default value. For example:
```
ra_config use_rssd, default
```
The following information is returned for each configuration parameter:
- Parameter name – the name of the parameter.
- Parameter type – the datatype of the parameter value (for example, string, numeric, or Boolean).
- Current value – the value of the parameter in effect at the time ra_config is invoked.
- Pending value – if different from the current value, the value to which the parameter was set by a previous invocation of the ra_config command, but which has not yet taken effect.
- Default value – the value of the parameter when the Replication Agent instance configuration file is created.
- Legal values – the values that are allowed for the parameter, for example, a range of numbers or a list of specific strings.
- Category – refers to the Replication Agent component affected by the value of the parameter.
- Restart – refers to parameters that require the Replication Agent instance to be shut down and restarted before a change in value takes effect.
When ra_config is invoked with either no option, or only the param option, the command is valid when the Replication Agent instance is in the Admin, Replicating, or Replication Down state.
If ra_config is invoked when the Replication Agent instance is in Replicating state, with the param and value options for a parameter that can be changed only in Admin state, it returns an error.
When ra_config is invoked with the param and value options, the command is always valid when the Replication Agent instance is in the Admin or Replication Down state.