Install RTP Proxy
Install the RTP proxy.
Active Node
Follow these steps to install the RTP Proxy on the primary node.
- Download and extract the rtp-proxy-8.3.0.0.0.tar.gz file.
tar xvf rtp-proxy-8.3.0.0.0.tar.gzThis creates a directory called
ORACLE_HOME. - Copy the contents to the
ORACLE_HOMEdirectory to your actual Oracle home directory.cp -r ORACLE_HOME/* /scratch/occas/Oracle/Middleware/Oracle_Home/ - Set the RP_CONFIG_PATH and RP_LOG_PATH variables.
export RP_CONFIG_PATH=/scratch/occas/Oracle/Middleware/Oracle_Home/config export RP_LOG_PATH=/scratch/occas/Oracle/Middleware/Oracle_Home/log - Create the config.json file, the log4j2.xml file, and the tangosol-coherence-override.xml file.
cd $RP_CONFIG_PATH mv config.json.sample config.json mv log4j2.xml.sample log4j2.xml mv tangosol-coherence-override.xml.sample tangosol-coherence-override.xml - Modify the
config.jsonfile to match the details of your environment. Pay attention to the following parameters:- Controller.main.server – The IP address and port where you are running the RTP Proxy.
- Controller.metrics.server – The IP address and port that will serve up metrics.
- Controller.vips – The virtual IP addresses used by the RTP Proxy
- Controller.tls.enabled – Whether TLS is enabled (true) or disabled (false)
- Datapath.spec.portConfig.ports – Configure port information
- Datapath.spec.domains – Configure domains
- Datapath.spec.vipEndpoints – Set the IP address and port for the virtual IP endpoints
- Add the active and standby RTP Proxy IP addresses to the
tangosol-coherence-override.xmlfile.<member-name system-property="coherence.member">RtpProxy1</member-name> <well-known-addresses> <address id="1"><ACTIVE_RTP_PROXY_IP></address> <address id="2"><STANDBY_RTP_PROXY_IP></address> <!-- Add as many WKA addresses as needed for your cluster --> </well-known-addresses> <address system-property="coherence.localhost"><ACTIVE_RTP_PROXY_IP></address>If your active node has the IP address of 10.1.1.1 and your standby the IP address of 10.2.2.2, your
tangosol-coherence-override.xmlfile would contain the following:<member-name system-property="coherence.member">RtpProxy1</member-name> <well-known-addresses> <address id="1">10.1.1.1</address> <address id="2">10.2.2.2</address> <!-- Add as many WKA addresses as needed for your cluster --> </well-known-addresses> <address system-property="coherence.localhost">10.1.1.1</address> - Install the RTP proxy service.
cd $ORACLE_HOME/systemd ./install-systemd.sh - Start the service.
sudo systemctl enable --now rtp-proxy-datapath sudo systemctl enable --now rtp-proxy-controller
See the README.md file for comprehensive details.
Standby Node
When installing the RTP proxy service on the standby node, follow the steps for the primary node with these differences:
- In the
config.jsonfile, set the IP address of the following parameters to the standby IP address:- Controller.main.server.host
- Controller.metrics.server.host
- In the
tangosol-coherence-override.xmlfile, flip the <address> nodes so that the secondary node uses the ID attribute of 1 and the primary of 2. For example, if your active node has the IP address of 10.1.1.1 and your standby the IP address of 10.2.2.2, yourtangosol-coherence-override.xmlfile would contain the following:<member-name system-property="coherence.member">RtpProxy1</member-name> <well-known-addresses> <address id="1">10.2.2.2</address> <address id="2">10.1.1.1</address> <!-- Add as many WKA addresses as needed for your cluster --> </well-known-addresses> <address system-property="coherence.localhost">10.2.2.2</address>