Configure the Route Cache Controller

Perform this task to configure the Route Cache Controller (RCC) service after an initial installation of the MATRIXX software. Perform this procedure for each RCC 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 on which the Route Cache Controller service is to run.
  • Obtained the IP address or host name and port values (and VIP address or host name, if applicable) to use to configure the RCC for your environment. See the discussion about information requirements for sub-domain routing for details about connection-parameter values you must enter when configuring the Route Cache Controller.
  • Configured the TRA-RT-(SI/DR) service that communicates with the Route Cache Controller service. See the discussion about configuring MATRIXX Traffic Routing Agent for details about configuring a TRA-RT-(SI/DR).
  • Configured the TRA-RT-(SI/DR) service that is to run on the host with the Route Cache Controller, and validated its configuration (ran the validate_tra_config.py script). See the discussion about configuring a TRA-RT-(SI/DR) for details.
Important: Each RCC instance in your environment (active RCC, RCC level 1, standby RCC and inter-site RCC instances) must have its own configuration file (/opt/tra/data/rcc_base.cfg) with the correct IP address or host name (and VIP address or host name, if applicable) and port information for the host where the RCC instance is running.

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

Procedure

  1. Edit the Route Cache Controller configuration properties file (rcc_base.cfg):
    1. Log in to the host as a user with sudo permissions and change to user tra.
    2. Go to to the /opt/tra/data directory.
    3. Open the rcc_base.cfg file with a text editor.
    4. For each section of the file, edit the property values to match those of your environment. Make sure that the values that apply to the host on which the RCC service runs are set correctly.

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

    5. To auto-size the Route Cache tables, configure the following properties:
      • (Optional) subscribers.capacity
      • shared_memory_headroom_percent
      • subscribers.records_per_sub
      • sessions.per_sub
      Note: When configuring Route Cache auto-sizing, do not set the sessions.capacity property or set it to 0. If you set sessions.capacity to any other value, auto-sizing is not performed.
      For information about Route Cache sizing, see the discussion about Route Cache sizing and checkpoint configurations.
    6. Save and close the file.
  2. Run the create_rc_config.py script on the host to update the local configuration:
    create_rc_config.py /opt/tra/data/rcc_base.cfg
    The script enables the RCC service on the host and sets all required RCC configurations.
  3. Change to the TRA ${MTX_CONF_DIR} directory (/opt/tra/conf).
    cd_config_dir
  4. After the initial run of the create_rc_config.py script on the host, if you must 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.

What to do next

(If using the p2p network mode) Ensure that the Route Cache Proxy that communicates with the Route Cache Controller has been configured. See the discussion about configuring the Route Cache Proxy in MATRIXX Bare Metal Installation and Configuration.