Install RTP Proxy

Install the RTP proxy.

Active Node

Follow these steps to install the RTP Proxy on the primary node.

  1. Download and extract the rtp-proxy-8.3.0.0.0.tar.gz file.
    tar xvf rtp-proxy-8.3.0.0.0.tar.gz

    This creates a directory called ORACLE_HOME.

  2. Copy the contents to the ORACLE_HOME directory to your actual Oracle home directory.
    cp -r ORACLE_HOME/* /scratch/occas/Oracle/Middleware/Oracle_Home/
  3. 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
  4. 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
  5. Modify the config.json file 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
  6. Add the active and standby RTP Proxy IP addresses to the tangosol-coherence-override.xml file.
    <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.xml file 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>
  7. Install the RTP proxy service.
    cd $ORACLE_HOME/systemd
    ./install-systemd.sh
  8. 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:
  1. In the config.json file, set the IP address of the following parameters to the standby IP address:
    • Controller.main.server.host
    • Controller.metrics.server.host
  2. In the tangosol-coherence-override.xml file, 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, your tangosol-coherence-override.xml file 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>