To allow the Replication Server and Replication Agent(s) to communicate through a firewall, apart from the
target database Broker port (-S), the
Agent listener ports that the rpagent process starts on (listener-minport, listener-maxport ) must be open on the firewall.
1. The
target database Broker port is defined by :
- The Service (-S) target database startup parameter
- The port value listed in the [control-agent.agent] section of the source.repl.properties configuration file.
- The control-agent.agent port defined in the configuration sourcedb.repl.properties file is the same as the -S Service value used to start the target database. They are referred to differently by the various code-path network communications.
- [control-agent.agent1]
.....
port=4501
2. The
Agent listener ports
- The listener-minport and listener-maxport aren't known until after the RPLS is able to connect to the target database Broker listener port
- Once the RPLS is connected to the target database login broker port, the rpagent (RPLA) takes a port in the range defined by the listener-minport and listener-maxport range defined in the [agent] section of the target.repl.properties configuration file to communicate with the RPLS.
- Replication uses 1 tcp/ip connection between the replication server (RPLS) and agent (RPLA). This range be reduced down to as little as one port if it can be guaranteed to always be available, but not advised. When DSRUTIL is used to failover or failback it will open a connection peer on the other end depending on the failover configuration set. DSRUTIL -C MONITOR does not use tcp/ip at all.
- The replication agent listener-minport port must not start with the same number as the port defined for the replication target database in the sourcedb.repl.properties file under the control-agent.agent1 section
- The Service Port (-S) the target database is started with must not be be part of the listener-minport listener-maxport range.
- If two target databases are configured, then consider all agent port definitions
- If replication failover or OpenEdge 11.7 replication sets are configured, there is also the 'agent' port of the source database to consider
- The default values are:
listener-minport=4387
listener-maxport=4500
Example:
If the target database is served using port 4501 (-S) and the repl.properties have:
listener-minport=4495
listener-maxport=4500
The firewall will needed to have the following bidirectional ports open: 4501, 4495 to 4500.