CHAPTER 4 This chapter describes how to install the Call Data Mediator (CDM) service on a Linux system. For details on using the CDM service, see the Working with the Call Data Mediator chapter of the Cisco Signaling Gateway Manager User Guide. This chapter includes the following sections: Overview of Installing CDM, page 4-1 CDM System Requirements, page 4-1 Becoming the Root User, page 4-2, page 4-2 Starting the CDM CLI, page 4-4 Uninstalling CDM, page 4-5 Overview of Installing CDM You can install the CDM service on a Linux system using the following installation menu option, accessed from the SGM installation menu: Install SGM Call Data Mediator service When the CDM installation program prompts you for a response, it displays the default value for each prompt in square brackets [ ]. To accept the default value, press Return. (When in doubt, accept the default.) To stop the CDM installation program at any time, press Ctrl-C. CDM System Requirements CDM must be installed on on RedHat Linux Enterprise 3.0 AS AMD64 running on a Sun Fire V20z Server with a single AMD Opteron 244 processor, 1 GB RAM and 1 73 GB HDD. If CDM will be running concurrently with SGM, then a minimum of 2 GB RAM is required. 4-1
Becoming the Root User Chapter 4 Becoming the Root User To install and configure CDM, you must be logged in as the root user on the system where you want to install CDM. Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands you use. If you are a relatively inexperienced UNIX user, limit your activities as the root user to the tasks described in this manual. If you are not logged in, log in as the root user: > login: root > Password: root-password If you are already logged in, but not as the root user, use the su command to change your login to root: # su # Password: root-password Step 1 Log in as the root user, as described in the Becoming the Root User section on page 4-2. Step 2 Mount the CD-ROM drive, as described in Appendix A, Mounting and Unmounting the CD-ROM Drive on Solaris/Linux. Change to the mounted directory using the cd command: # cd /mnt/cdrom/linux Step 4 Step 5 Start the installation script by entering the following command: #./setup.sh Select the CDM option from the SGM installation menu: 1) Review README File First (Recommended) 2) Install SGM Server 3) Install SGM Call Data Mediation Server 4) Exit Setup Please choose an option -> Step 6 Step 7 To install CDM, type 3 and press Return. The CDM install tool begins. The following question appears: Where should the product be installed? [/opt] Press Return to accept the default directory, or type in a different directory and press Return. CDM then searches for available file systems. The following question appears: Where should CDM store CDR records? [/opt] Press Return to accept the default directory, or type in a different directory and press Return. 4-2
Chapter 4 Step 8 CDM installation begins. Output similar to the following appears: ============================- Installing CDM -======================== Preparing... ################################################## CSCOcdm ################################################## Preparing... ################################################## CSCOcdm-j2re ################################################## INFO: updating files... Updating /opt/cscocdm/etc/cdrconfig.properties Updating /opt/cscocdm/etc/cdm.xml Updating /opt/cscocdm/etc/cdmclient.xml Updating /opt/cscocdm/etc/logger.xml ===========================- Error Summary -========================== No Errors were encountered during installation. Started : Tue Feb 15 07:48:21 EST 2005 Finished: Tue Feb 15 07:53:46 EST 2005 ======================- CDM Install Tool Completed -================== Please review /var/tmp/cisco_cdm_install.log for detailed results. Press Return to continue -> Step 9 Step 10 Press Return to continue. (Optional) Before starting the CDM server, you can modify the CDRConfig.properties file to change which fields are included in the content of CDRs stored within datastores. For details, see the Cisco Signaling Gateway Manager User Guide. The CDM startup program appears: 1) Start Call Data Mediation Server 2) Exit Setup Please choose an option -> To start the CDM server, type 1 and press Return. You must start the server in order to run the CLI (to start the CLI, see the Starting the CDM CLI section on page 4-4.) To exit setup without starting the CDM server, type 2 and press Return. 4-3
Starting the CDM CLI Chapter 4 Step 11 (Optional) To verify that the CDM server has been successfully installed, enter the following commands: # /bin/rpm -q CSCOcdm # /bin/rpm -q CSCOcdm-j2re You should receive output similar to the following for each query: CSCOcdm-3.0.0-1 CSCOcdm-j2re-1.4.2-06 Step 12 (Optional) Use the ls command to verify that you have a new directory structure containing the CDM software. For the CDM server, the default directory is /opt/cscocdm. For CDM record storage, the default directory is /opt/cscocdm-ds. If you installed CDM in a directory other than /opt, then the CSCOcdm and CSCOcdm-ds directories are located in that directory. Starting the CDM CLI Once the CDM server is started, you can start the CDM CLI. Step 1 Log in as the root user, as described in the Becoming the Root User section on page 4-2. Step 2 Using the cd command, change to the default directory (or wherever you installed CDM): # cd /opt/cscocdm/bin Start the CDM CLI by entering the following command: #./cdmcli.sh The CDM CLI appears: cdm-cli> For details on using the CDM CLI, see Chapter 17, Working with the Call Data Mediator in the Cisco Signaling Gateway Manager User Guide. 4-4
Chapter 4 Stopping the CDM Server Stopping the CDM Server Step 1 Log in as the root user, as described in the Becoming the Root User section on page 4-2. Step 2 Using the cd command, change to the default directory (or wherever you installed CDM): cd /opt/cscocdm/bin Stop the CDM server by entering the following command:./cdmstop.sh The following message appears: Info: Found CDM server process 24544 Info: Stopped CDM server process 24544 Uninstalling CDM When you run the uninstall program, remember the following information: The default for each prompt is the value in square brackets [ ]. To accept the default value, press Return. To stop the installation script at any time, press Ctrl-C. Tip You do not need to stop the CDM server; the CDM uninstall program stops the server automatically. To uninstall the CDM software: Step 1 Log in as the root user as described in the Becoming the Root User section on page 4-2. Step 2 To start the uninstall script, enter the following command: # /opt/cscocdm/install/uninstall.sh Note If you did not install CDM in the default directory, replace /opt/cscocdm with the alternate directory. The CDM uninstall tool begins. The following question appears: This will uninstall the Call Data Mediator. Do you want to continue? (y/n)? [n] Type y and press Return to continue with the uninstall. 4-5
Uninstalling CDM Chapter 4 Step 4 The CDM uninstall program asks you to verify that you want to delete the CDM datastore directories. Caution Any files in the datastore directories will also be deleted. Step 5 Step 6 When prompted, type y to verify this action, or type n if you want to preserve any data in your datastore directories (the default directory is /opt/cscocdm-ds). Press Return. When uninstall is complete, the CDM uninstall program displays an error summary: ============== Error Summary============== No Errors were encountered during installation. Press Return to continue. (Optional) To verify that the CDM server has been uninstalled, enter the following commands: # /bin/rpm -q CSCOcdm # /bin/rpm -q CSCOcdm-j2re You should receive output similar to the following for each query: package CSCOcdm is not installed package CSCOcdm-j2re is not installed 4-6