Configure the property files

Configure the source database property file

Before you start OpenEdge Replication on the source database, you must configure the replication server. You configure the server by saving and then editing the sample source properties file provided when you install OpenEdge Replication as part of OpenEdge. Each of the properties is listed and described in Server properties.

To configure the source database property file:

1. Make a copy of the sample source.repl.properties file, which is located by default in OpenEdge-install-dir\properties.
2. Name this new file db-name.repl.properties, where db-name is the name of your source database.
3. Place this new file in the same directory as your source database.
4. To change any of the default property values, simply modify them in the property file, as follows:
   • If you are on UNIX, you can use vi, emacs, or your preferred text editor to change the properties file. You can also use OpenEdge Management or OpenEdge Explorer.
   • If you are in Windows, you can use OpenEdge Management or OpenEdge Explorer to change the properties file. You can also use Notepad.

   For information about configuring the properties file in OpenEdge Management or OpenEdge Explorer, see Configure OpenEdge Components with OpenEdge Management.

Configure the target database property file

Before you start OpenEdge Replication on the target database, you must configure the agent. You configure the agent by saving and then editing the sample target properties file provided when you install OpenEdge Replication as part of OpenEdge. Each of the properties is listed and described in Agent properties.

Use the following steps to configure the target database property file:

1. Make a copy of the target.repl.properties file, which is located by default in OpenEdge-install-dir\properties.
2. Name this new file db-name.repl.properties, where db-name is the name of your target database.
3. Place this new file in the same directory as the target database.
4. To change any of the default property values, edit and save the file.

   If you are on UNIX, you can use vi, emacs, your favorite text editor, or OpenEdge Explorer to change the properties file. If you are in Windows, you can use Notepad or OpenEdge Explorer to change your properties file. You can also use OpenEdge Management if you have purchased a license.

   For more information about configuring the properties file in OpenEdge Management or OpenEdge Explorer, see Configure OpenEdge Components with OpenEdge Management.

Validate the property files

The DSRUTIL properties validation utility enables you to validate the replication properties of replication-enabled source and target databases and confirm running status of target database brokers.

When run against the replication source database, the utility performs the same validation made during startup of the replication server, validating all properties listed in the [server], [control-agent], and [transition] sections of the properties file. For each control-agent listed in the [server].control-agents property, the utility also pings the target database on the hostname and port in the associated [control-agent] section of the properties file.

When run against the replication target database, the utility performs the same validation made during startup of the replication agent, validating all properties listed in the [agent] and [transition] sections of the properties file. If there is a [server] section defined in the target database’s properties file, the length of each control-agent name in the [server].control-agents property is validated.

The utility writes all properties file errors to both standard out and the database log file.

The utility can be run while the database is online or in single-user mode.

The command for the utility is as shown:

db-name

The name of the database to perform the action on. The name of the database must be the first argument and must be a valid name.

• The utility adds the ability for the source database to report on the running status of any target database brokers using messages 19460 and 19461.

  Database db-name for agent agent-name is online. Broker is running on hostname:port-num. 19460

  Unable to contact database db-name on hostname:port-num for agent agent-name. 19461