Configure an RCC-L1 Instance

Perform this task to configure the Route Cache Controller level 1 (RCC-L1) service. Perform this procedure for each RCC-L1 service that is to run in your environment.

About this task

This procedure assumes you have already done the following:
  • Downloaded the Traffic Routing Agent RPM on the host on which the RCC-L1 service is to run.
  • Obtained the IP address or hostname and port values (and VIP address or hostname, if applicable) to use to configure the RCC-L1 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-L1 instance in your environment must have its own configuration file (/opt/tra/data/rcc_cli_base.cfg) with the correct IP address or hostname (and VIP address or hostname, if applicable) and port information for the host where the RCC instance is running.

Procedure

  1. Edit the Route Cache Controller configuration properties file (rcc_cli_base.cfg):
    1. Log in to the host as a user with sudo permissions and change to user tra.
    2. Navigate to the /opt/tra/data directory.
    3. Open the rcc_cli_base.cfg file with a text editor.
  2. 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.
    1. Configure the following values in the [service] section:
      • Set type to rcc.
      • Set network_mode to client.
    2. Configure or add the [l1] section and set the following values:
      • Set enabled to true.
      • Set rca.port to the local server port of the RCC-L1 RCA.
    For more information, see the discussion about Route Cache Controller configuration properties.
    Note: The [standby] and [intersite] sections are not applicable to RCC-L1 instances, and therefore not required.
  3. Run the create_rc_config.py script on the host to update the local configuration:
    create_rc_config.py /opt/tra/data/rcc_cli_base.cfg
    The script enables the RCC service on the host and sets all required RCC configurations.
  4. Change to the TRA ${MTX_CONF_DIR} directory (/opt/tra/conf).
    cd_config_dir
  5. 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.

Example

The following is an example [l1] section in the rcc_cli_base.cfg properties file for deploying an RCC-L1 instance.
#------------------------------------------------------------------------------
# route-cache level-1 interface configuration
#------------------------------------------------------------------------------
[l1]
# set to 'true' if deploying a route cache l1
enabled = true
# set the local IP address of the RCA server (can be empty).
# empty address means bind-to-any
rca.address =
# set the RCA server port
rca.port = 4095