Because the TIBCO EMS server environment can be complex, you can configure the client
connection to the server environment in various ways.
About this task
When you configure the client connection to the TIBCO EMS server environment, you can define the
target server environment in the following ways.
- As a single host.
- As a fault-tolerant host pair.
- As a group of host where load is distributed across member according to a distribution
algorithm.
- As a group of host where load is distributed across member according to a distribution algorithm
where each member can be a fault-tolerant host pair.
During configuration, be aware of the following property combinations. You can define properties
that are not needed and are ignored.
- If you define a connection that is not for a single host, any value in the
Host field is ignored.
- If you define a connection for a single host, the load distribution algorithm is ignored.
Procedure
- In the search field, enter ems.
- From the search results, enter TIBCO EMS Server.
- Click Add.
- Define the basic properties - Name, administrative state, and
comments.
- Define the credentials to connect to the server.
- In the Username field, specify the username.
- From the Password alias list, select the password
alias.
- Define the server environment that can be a single host, a single fault-tolerant pair of
host, or a group of hosts. When defined as a group of host, load is distributed to members by using
a defined algorithm. Any host in the group can be defined as a fault-tolerate pair.
When
you define a host, enter the hostname or IP address with the listening port of the TIBCO EMS server
in the
host:port format. Without a port, the
value is 7222.
- Single host
- Enter the host in the Host field.
- Group of hosts
- Use the following steps to define the host for load distribution and as needed fault tolerance
in the Load-balancing area.
- Click Add.
- Enter the host for load distribution in the Primary host field.
- For fault tolerance of this host, enter a backup host in the Backup host
field.
- Click Apply to save changes to the running
configuration.
- Repeat this step to define another host to the group.
- In the Connection client ID field, enter the string that
identifies the connection client
- When defined as a group of hosts, select the load distribution algorithm.
- From the TLS client profile list, select the profile to secure
connections to the server.
- Define message criteria.
- Set Transactional to enable or disable transactional
processing. In a transacted session, a group of related messages is sent and received in a single
transaction.
- In the Memory threshold field, enter the memory allocation for
pending messages.
- In the Max message size field, enter the MTU for the current
server.
The MTU defines the maximum size of messages that this server can process.
Messages that are larger than the specified value are dropped.
- From the Default message type list, select the default message
type that defines the message payload. This value is used when the message type cannot be determined
from message headers.
- Define the session and connection limits. When the number of current connections is less
than the connection limit, a new session request establishes a new connection.
- In the Total connection limit field, enter the maximum number
of concurrent, open connections to allow.
- In the Max number of sessions per connection field, enter the
maximum number of concurrent multiplexed sessions that a single connection supports.
You define 5 total connections and 20 sessions per connection. With three active
connections, a new session request generates the establishment of a fourth
connection.
- Optional: Enable automatic critical error-recovery to reestablish
a connection that was closed in response to an error condition.
- Set Automatic retry to enable the procedure.
- In the Retry interval field, enter the interval between
attempts.
- Set Enable JMS-specific logging to enable or
disable the enhanced JMS-specific logging facility.
- Click Apply to save changes to the running
configuration.
- Click Save to save changes to the persisted
configuration.