Starting Connection Managers on Windows

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

  1. 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 %INFORMIXDIR%\etc directory.
  2. 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'
  3. Enter the informix user ID and password, or press Enter to automatically create an informix-admin group and assign it access rights.
  4. 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 INFORMIXSERVER 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.