# Configuring the connection to RET

This page provides example configuration for connecting a suite of RET adapters to RET.

## Requirements

You require:

* SCS Relay details: host and port
* RET user account details

The values for the `host`, `port`, `username`, and `password` fields in the examples below are arbitrary and for illustrative purposes only.

**❗ IMPORTANT**\
RET user accounts cannot be shared. Each connection in a suite of RET adapters must use a unique RET user account.

For descriptions of all the available options in a `trapi-connection.properties` file, see [Configuration File: trapi-connection.properties](ret-trapi-connection-properties.md).

## Connecting a calendar adapter

A Calendar adapter’s `trapi-connection.properties` file consists of three sections:

* Common
* CalendarConnection
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/CalendarAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET calendar adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[CalendarConnection]
username=cal_proxy
password=letmein

[AdminConnection]
username=cal_admin
password=letmein
order_type=admin
```

## Connecting an LBN adapter

An LBN adapter’s `trapi-connection.properties` file consists of three sections:

* Common
* LBNConnection
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/LBNAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET LBN adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[LBNConnection]
username=lbn_proxy
password=letmein
order_type=LBN

[AdminConnection]
username=lbn_admin
password=letmein
order_type=admin
```

## Connecting a pricing adapter

A Pricing adapter’s `trapi-connection.properties` file consists of three sections:

* Common
* RatesConnection
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/PricingAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET pricing adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[RatesConnection]
username=rates_proxy
password=letmein

[AdminConnection]
username=rates_admin
password=letmein
order_type=admin
```

## Connecting an FX trading adapter

An FX trading adapter’s `trapi-connection.properties` file consists of four sections:

* Common
* TradingConnection1
* TradingConnection2
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/FxTradingAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET FX trading adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[TradingConnection1]
username=fx_proxy_1
password=letmein

[TradingConnection2]
username=fx_proxy_2
password=letmein

[AdminConnection]
username=fx_admin
password=letmein
order_type=admin
```

## Connecting a permissioning adapter

A permissioning adapter’s `trapi-connection.properties` file consists of three sections:

* Common
* CurrencyPairConnection
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/PermissioningAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET permissioning adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[CurrencyPairConnection]
username=perms_proxy
password=letmein

[AdminConnection]
username=perms_admin
password=letmein
order_type=admin
```

## Connecting a limit order adapter

A limit order adapter’s `trapi-connection.properties` file consists of three sections:

* Common
* MonitorConnection
* TradingConnection1
* TradingConnection2
* AdminConnection

After deployment of the adapter to a Caplin Deployment Framework, edit the file `global_config/overrides/LimitOrderAdapter/etc/trapi-connection.properties`. An example is shown below.

**Example trapi-connection.properties file for a RET limit order adapter**

```ini
[common]
host=192.168.1.50
port=8912
reconnection_exponential_initial_interval=5
reconnection_exponential_max_interval=600

[MonitorConnection]
username=monitor_proxy
password=letmein
order_type=limit_monitor

[TradingConnection1]
username=order_proxy_1
password=letmein
order_type=limit_trading

[TradingConnection2]
username=order_proxy_2
password=letmein
order_type=limit_trading

[AdminConnection]
username=order_admin
password=letmein
order_type=admin
```