Syntax and Parameters for a Resource File

product_name.attribute:value

• Resource file entries can be only one line long (80 characters).

• rs_init does not recognize end-of-line characters, carriage returns, or backslashes.

• rs_init ignores blank lines and lines that begin with a pound sign (#).

• If you do not enter a valid value for every required attribute, rs_init returns an error when you use the resource file.

• If a Sybase-defined default value exists for an attribute, you can specify the default with the special value USE_DEFAULT.

• Certain resource file attributes can take lists of values. Attributes that can accept lists of values end with “_list.” Use commas to separate values. For example:

  rs.rs_rs_network_protocol_list:tcp,ipx

• If you use a resource file to upgrade or modify a Replication Server, you can use the UNCHANGED value to indicate that a particular attribute should remain unchanged.
• You cannot use the USE_DEFAULT or the UNCHANGED value for required attributes with a null default value and you cannot enter USE_DEFAULT or UNCHANGED for the passwords that you specify with these attributes:

  Password Attribute	User ID
  rs.rs_idserver_pass	ID Server user
  rs.rs_rs_sa_pass	Replication Server sa login
  rs.rs_rssd_prim_pass	RSSD primary user
  rs.rs_db_maint_password	Database maintenance user
  rs.rs_rssd_maint_pass	RSSD maintenance user
  rs.rs_ltm_rs_pass	Log transfer manager login ID
  rs.rs_rs_pass	Replication Server login name

  You must provide passwords for these attributes. If the attribute has no value or is not in the resource file, you see a message in the stdout. For example, if you do not provide a value for the rs_db_maint_password attribute in the setupdb.rs resource file, you see:

  Attribute 'rs_db_maint_password' could not be set because '' is an invalid value

  To ensure security, you must enter a password that complies with the password security requirements such as a minimum password length that administrator has enforced. See Replication Server Administration Guide Volume 1 > Manage Replication Server Security > Managing Replication Server User Security > Manage Replication Server Login Names and Passwords > Password Configuration Options for All Users.
• If you are rebuilding an existing Replication Server, you must drop the RSSD or ERSSD before you start rs_init.