Use the oncmsm utility to start a Connection
Manager.
About this task
A Connection Manager can be started before the database
servers it manages are started. If a connection unit is managed by
a Connection Manager, the Connection Manager connects to database
servers in the connection unit after the database servers start.
If
the database servers of a connection unit are online before a Connection
Manager is initialized, start the Connection Manager, and then direct
client application requests to the Connection Manager instead of the
database servers.
Procedure
- Install the Connection Manager as a service by running
the oncmsm utility with the i parameter,
the c parameter, and the name of the Connection
Manager configuration file.
oncmsm -i -c configuration_file
The default location for the configuration file is the %ONEDB_HOME%\etc directory.
- Initialize the Connection Manager by running the oncmsm utility
with the name of the Connection Manager that is specified in the Connection
Manager configuration file.
oncmsm connection_manager_name
The following message is displayed:
Specify the user and password to run this service.
Press <ENTER> to run Connection Manager as 'localsystem'
- Enter the informix user ID and password, or press Enter to
automatically create an informix-admin group and assign it
access rights.
- If you enabled Connection Manager logging by setting the
LOG and LOGFILE parameters in the Connection Manager's configuration
file, check the log to verify that the Connection Manager successfully
started.
The following message displays if the Connection
Manager started:
Connection Manager started successfully
Results
After a Connection Manager initializes, it attempts to connect
to the database servers or groups of database servers that are specified
by the ONEDB_SERVER parameter in the Connection Manager's configuration
file. The Connection Manager then searches for and connects to all
the database servers that are in each specified server's cluster,
grid, or replicate set.