You can create administered objects for storage in EMS using either the administration tool or the administration APIs, or directly in the configuration files. This section describes how to create administered objects using the administration tool.
To create a connection factory, use the create factory command in the EMS Administration Tool. For example, to create a generic connection factory, named
myFactory, that establishes a TCP connection to port 7344 on
server1, start the EMS Administration Tool and enter:
The connection factory data stored on the EMS server is located in the factories.conf file. You can use the
show factories command to list all of the connection factories on your EMS server and the
show factory command to show the configuration details of a specific connection factory.
A connection factory may include optional properties for balancing server load and establishing thresholds for attempted connections, as described in
Connection Factory Parameters. These properties can be specified when creating the factory or modified for an existing factory using the
addprop factory,
setprop factory, and
removeprop factory commands.
For example, to set the maximum number of connection attempts for the connection factory,
myFactory, from the default value of 2 to 5, start the EMS Administration Tool and enter:
This section describes how to create a static connection factory for establishing an SSL connection. Similar SSL parameters must be used when looking up the connection factory, as described in
Performing Secure Lookups.
For example, to create a generic connection factory, named mySecureFactory, that establishes a SSL connection to port 7243 on
server1, start the EMS Administration Tool and enter:
To create a factory to set up a topic connection, check the server's certificate (but not the name inside the certificate), and to set the
ssl_auth_only parameter so that SSL is only used by the client when creating the connection, enter (all one line):
When connecting a fault-tolerant client to EMS, you must specify two or more EMS servers in your connection factory. When creating a connection factory for a fault-tolerant client, specify multiple server URLs in the
url argument of the
create factory command.
For example, to create a generic connection factory, named myFtFactory, that establishes TCP connections to port 7545 on the primary server,
server0, and port 7344 on the backup server,
server1, start the EMS Administration Tool and enter (on one line):
Should server0 become unavailable, the client will connect to
server1. See
Chapter 19, Fault Tolerance for details.