10.6 Starting and Stopping Oracle Connection Manager

After configuring Oracle Connection Manager, you can start and administer it using the Oracle Connection Manager Control (CMCTL) utility.

At the operating system command line, the basic syntax for this utility is:

cmctl [command] [argument1 . . . argumentN] [-c instance_name]

The -c parameter specifies the Oracle Connection Manager instance that you want to administer. Instances are defined in the cman.ora file.

Note:

The use of password access to Oracle Connection Manager parameters is desupported in Oracle Database 23ai.

Oracle provides an enhanced connection method, Local Operating System Authentication" (LOSA), which permits only the user who started CMAN to perform admin operations. This method is consistent with other operating system authentication methods used with Oracle Database. If you are currently using password access to CMAN, then Oracle recommends that you remove the CMAN password, and instead rely on LOSA.

To start and stop Oracle Connection Manager using the Oracle Connection Manager Control utility:

1. Create the cman.ora file.
   A sample file is located in the ORACLE_BASE_HOME/network/admin/samples directory after installation of Oracle Connection Manager.
2. Start Oracle Connection Manager using one of the following methods:
   • At the command line:

     Run the STARTUP command. For example:

     cmctl STARTUP -c [cman_example_instance]

     The command starts the listener, Connection Manager Administration (CMADMIN), and gateway processes for an instance named cman_example_instance.

   • At the CMCTL prompt:

     At the command line, enter cmctl with no arguments to obtain the CMCTL prompt, and then run the ADMINISTER and STARTUP commands. For example:

     cmctl
     CMCTL> ADMINISTER [cman_example_instance]
     CMCTL> STARTUP
     

3. Stop a running instance of Oracle Connection Manager using one of the following methods:
   • At the command line:

     Run the SHUTDOWN command. For example:

     cmctl SHUTDOWN -c [cman_example_instance]

   • At the CMCTL prompt:

     At the command line, enter cmctl with no arguments to obtain the CMCTL prompt, and then run the ADMINISTER and SHUTDOWN commands. For example:

     cmctl
     CMCTL> ADMINISTER [cman_example_instance]
     CMCTL> SHUTDOWN