Installing the TREP Adapter

Requirements

To deploy the TREP Adapter, you require the following:

  • TREP Adapter installation kit (CPB_TREPAdapter-<version>.zip)

  • Caplin Deployment Framework 7

To ease log-file analysis across servers, time zones, and daylight savings transitions, we recommend that you set the system clocks of all hosts in a Caplin stack to UTC.

Pre-deployment tasks

Perform the following tasks before deploying the adapter:

  1. Install the Deployment Framework. For more information, see Installing the Deployment Framework.

  2. Deploy Liberator 7. For more information, see Installing Liberator.

Deploying the adapter

Follow the steps below to deploy the TREP Adapter:

  1. Copy the installation kit (CPB_TREPAdapter-<version>.zip) to your Deployment Framework’s kits directory.

  2. From the root of your deployment framework, run the command below to stop all running components in the Deployment Framework:

    ./dfw stop
  3. From the root of your deployment framework, run the command below to deploy the TREP Adapter:

    ./dfw deploy
  4. Run the command below to specify the hostnames of the primary and secondary server on which the adapter should run (for more information on this command, see dfw hosts):

    ./dfw hosts TREPAdapter <primary-server> <secondary-server>
    If you are installing the adapter on a developer’s machine, you can specify localhost for both the primary and secondary servers: ./dfw hosts TREPAdapter localhost localhost

Configuring the adapter

Before starting the adapter, make the following minimum configuration changes to the file global_config/TREPAdapter/DataSource/etc/upasrc.conf.

  1. Uncomment the configuration items upa-address and upa-port. Set them to the address and port of your gateway to the Refinitiv Enterprise Platform:

    upa-address      hostname_or_IP_address
    upa-port         port
  2. If the TREP Adapter requires a username to connect to TREP, specify it with the upa-username configuration item.

    upa-username     username
  3. If you want the TREP Adapter to supply news data, uncomment the following configuration:

    add-item
        name    "/I/N2_UBMS"
        request
    end-item
    add-item
        bcast
        name    /NEWS
    end-item
    
    news-writedir   ${ccd}/../news/

    To tune Liberator and Transformer’s handling of news data, see Liberator: News configuration and Transformer: News configuration.

  4. If you want the TREP Adapter to supply historical charting data to Transformer’s Charting Service, then deploy the TS1 Decoder Service to Transformer. The TS1 Decoder Service transforms TS1 charting data served by the TREP Adapter into a format that the Charting Service can consume.

Generating DataSource field definitions for Refinitiv fields

After deploying the TREP Adapter for the first time, and after deploying any new version of the TREP Adapter, follow the instructions in Generating DataSource field definitions to update the fields-reuters.conf file with field definitions for Reuters fields.

Starting and stopping the adapter

To start the adapter, run the command below from the root directory of your Deployment Framework:

./dfw start TREPAdapter

To stop the adapter, run the command below from the root directory of your Deployment Framework:

./dfw stop TREPAdapter

See also: