Installing CDM on Linux

Installing CDM on Linux
C H A P T E R
4
Installing CDM on Linux
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
•
Installing CDM on Linux, 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.
Cisco Signaling Gateway Manager Installation Guide
OL-8096-01
4-1
Chapter 4
Installing CDM on Linux
Becoming the Root User
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
Installing CDM on Linux
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.”
Step 3
Change to the mounted directory using the cd command:
# cd /mnt/cdrom/linux
Step 4
Start the installation script by entering the following command:
# ./setup.sh
Step 5
Select the CDM option from the SGM installation menu:
1)
2)
3)
4)
Review README File First (Recommended)
Install SGM Server
Install SGM Call Data Mediation Server
Exit Setup
Please choose an option ->
To install CDM, type 3 and press Return.
Step 6
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.
Step 7
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.
Cisco Signaling Gateway Manager Installation Guide
4-2
OL-8096-01
Chapter 4
Installing CDM on Linux
Installing CDM on Linux
Step 8
CDM installation begins. Output similar to the following appears:
======================================================================
============================- Installing CDM -========================
======================================================================
Preparing...
CSCOcdm
Preparing...
CSCOcdm-j2re
##################################################
##################################################
##################################################
##################################################
======================================================================
INFO: updating files...
======================================================================
Updating
Updating
Updating
Updating
/opt/CSCOcdm/etc/CDRConfig.properties
/opt/CSCOcdm/etc/cdm.xml
/opt/CSCOcdm/etc/cdmclient.xml
/opt/CSCOcdm/etc/logger.xml
===========================- Error Summary -==========================
No Errors were encountered during installation.
======================================================================
Started :
Finished:
Tue Feb 15 07:48:21 EST 2005
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 ->
Press Return to continue.
Step 9
(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.
Step 10
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.
Cisco Signaling Gateway Manager Installation Guide
OL-8096-01
4-3
Chapter 4
Installing CDM on Linux
Starting the CDM CLI
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
Step 3
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.
Cisco Signaling Gateway Manager Installation Guide
4-4
OL-8096-01
Chapter 4
Installing CDM on Linux
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
Step 3
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:
Tip
•
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.
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
Step 3
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.
Cisco Signaling Gateway Manager Installation Guide
OL-8096-01
4-5
Chapter 4
Installing CDM on Linux
Uninstalling CDM
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.
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.
Step 5
When uninstall is complete, the CDM uninstall program displays an error summary:
============== Error Summary==============
No Errors were encountered during installation.
Press Return to continue.
Step 6
(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
Cisco Signaling Gateway Manager Installation Guide
4-6
OL-8096-01
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising