Installing Oracle Connection Manager Using an Image File

Starting with Oracle Database Client 26ai Release Update 23.7, Oracle Connection Manager is available as an image file for installation and configuration.

You must extract the image software (client_cman_home.zip) into the directory where you want your Oracle Database Client home to be located, and then run the Setup Wizard to start the Oracle Connection Manager installation and configuration.

Have all the information you need to provide regarding storage paths before you start the installation. During installation, you are asked to run configuration scripts as the root user. You must run these scripts manually as root when prompted.

Log in as the Oracle installation owner user account (oracle).
Download the Oracle Database Client installation image files (client_cman_home.zip) to a directory of your choice. For example, you can download the image files to the /tmp directory.
Create the Oracle home directory and extract the image files that you have downloaded in to this Oracle home directory. For example:
```
mkdir -p /u01/app/oracle/product/23.0.0/client_1
chgrp oinstall /u01/app/oracle/product/23.0.0/client_1
cd /u01/app/oracle/product/23.0.0/client_1
unzip -q /tmp/client_cman_home.zip
```
Note:
- Oracle recommends that the Oracle home directory path you create is in compliance with the Oracle Optimal Flexible Architecture recommendations. Also, unzip the installation image files only in this Oracle home directory that you created.
- Oracle home or Oracle base cannot be symlinks, nor can any of their parent directories, all the way to up to the root directory.
From the Oracle home directory, run the runInstaller command to start the Oracle Database Client Setup Wizard.
```
$ cd /u01/app/oracle/product/23.0.0/client_1
$ ./runInstaller
```
Note:
Run the runInstaller command from the Oracle home directory only. Do not use the runInstaller command that resides at $ORACLE_HOME/oui/bin/, or any other location, to install Oracle AI Database, Oracle Database Client, or Oracle Grid Infrastructure.
The setup wizard starts the Oracle Connection Manager type installation of Oracle Database Client.

Respond to the configuration prompts as needed to provide information such as the Oracle base and Oracle inventory.

Note:
At any time during installation, if you have a question about what you are being asked to do, click Help.

Moving an Existing Oracle Connection Manager to the Latest Version

Learn how to move an existing Oracle Connection Manager (CMAN) 26ai version to the latest Oracle Connection Manager version.

Install the latest version of Oracle Connection Manager 26ai using an image file in the new Oracle home. See Installing Oracle Connection Manager Using an Image File.
Stop the existing cman service using the Oracle Connection Manager Control utility (cmctl). For example, for the 23.5 Oracle home, at the command line, enter cmctl with no arguments to obtain the CMCTL prompt, and then run the ADMINISTER and SHUTDOWN commands.
```
./cmctl
CMCTL> ADMINISTER [cman_instance]
CMCTL> SHUTDOWN
```
Move the existing configuration file (cman.ora) to the new Oracle home.
Start the cman services from the new Oracle home using the Oracle Connection Manager Control utility (cmctl). For example, from the 26.x Oracle home, at the command line, enter cmctl with no arguments to obtain the CMCTL prompt, and then run the ADMINISTER and STARTUP commands.
```
./cmctl
CMCTL> ADMINISTER [cman_instance]
CMCTL> STARTUP
```