Configure the Route Cache Proxy

Perform this task to configure the Route Cache Proxy (RCP) service after an initial installation of the MATRIXX software. Perform this procedure for each RCP service that is to run in your environment.

Before you begin

This procedure assumes you have already done the following:

  • Downloaded the Traffic Routing Agent RPM on the host where the Route Cache Proxy service is to run.
  • Obtained the IP addresses or hostnames and port values (and VIP address(es) or hostnames, if applicable) to use to configure the RCP for your environment. See the discussion about information requirements for sub-domain routing in MATRIXX Bare Metal Installation and Configuration for details about connection-parameter values you must enter when configuring the Route Cache Proxy.
  • Configured the MATRIXX Engine that is to run on the host with the Route Cache Proxy (ran the create_config.py script). See the discussion about information requirements for sub-domain routing in MATRIXX Bare Metal Installation and Configuration for details about connection-parameter values you must set on the MATRIXX Engine for sub-domain routing.
  • Configured the TRA-PROC service that is to run on the host with the Route Cache Proxy, and validated its configuration (ran the validate_tra_config.py script). See the discussion about configuring MATRIXX Traffic Routing Agent in MATRIXX Bare Metal Installation and Configuration for details about configuring a TRA-PROC with RCP.

For more information about the MATRIXX environment variables, see the discussion about container directories and environment variables in MATRIXX Installation and Upgrade.

About this task

To configure the Route Cache Proxy:

Procedure

  1. Edit the Route Cache Proxy configuration properties file (rcp_base.cfg):
    1. Log in to the engine server as a user with sudo permissions and change to user tra.
    2. Navigate to the /opt/tra/data directory.
    3. Open the rcp_base.cfg file with a text editor.
    4. For each section of the file, edit the property values to match those of your environment (the values that apply to the engine server you are logged into).

      For information about each property, see the Route Cache Proxy configuration properties reference.

  2. Change to the TRA-PROC with RCP ${MTX_CONF_DIR} directory (/opt/tra/conf).
    cd_config_dir
  3. Run the create_rc_config.py script on the host to update the local configuration:
    create_rc_config.py /opt/tra/data/rcp_base.cfg
    The script enables the RCP service on the host and sets all required RCP configurations.
  4. After the initial run of the create_rc_config.py script on the host, if you need to re-run the script to re-set an RCC connection parameter on the local configuration, do the following:
    1. Run create_config.py.
    2. Run validate_tra_config.py.
    3. Run create_rc_config.py.