DataSync Agent Connections Overview

Overview

This section provides an overview of the general structure of the configuration directives used to provide access to the outside world. For example, connections are typically used to connect to the Perspectium Integration Mesh, the Perspectium Management and Reporting infrastructure etc.

All connections will route through the <message_connection> tag.

The structure of the connection directive is:

<message_connection attributes...>scheme:host:port</message_connection>

Each connection should have at minimum the following attributes:

• user
• password

Additional attributes may be supported by the implementation of the connection directive, see DataSync Agent configuration.

Setting Up the Basic Connection

Let's take a closer look at an example of the <message_connection> directive.

<message_connection password="pwd" user="admin">amqp://acme.perspectium.net</message_connection>

In this example the directive contains the attributes user and password. These attributes are used to connect to the Perspectium Integration Mesh. In our example we provide the user name and the user's password which are used to 'login' to the Message Bus.

Within the value field of the <message_connection> element is the URI. In our example it's: amqp:acme.perspecitum.net. This URI consists of the scheme, which in our case is amqp, followed by the literal ':' and then the host, which is acme.perspectium.net.

Different Connection Schemes

We're using the ampq scheme but Perspectium also supports specifying the amqps, http or https schemes. Using the amqps scheme is similar to using https instead of http. The amqps scheme will provide data communication over a secure channel. The later two schemes, http and https are useful when you have constraints that prevent you from connecting to entities on the internet using protocols other than these typical standards.

The following attributes are optional but also available using the standard connection directives.