Cisco Service Control Management Suite Collection Manager User Guide, Release 3.5.5
About this Guide

Table Of Contents

About this Guide

Introduction

Document Revision History

Organization

Related Publications

Conventions

Obtaining Documentation and Submitting a Service Request


About this Guide


Revised: July 23, 2009, OL-7208-10

Introduction

This guide describes the installation and configuration of the Cisco Service Control Management Suite (SCMS) Collection Manager (CM). This preface describes who should read the Cisco Service Control Management Suite Collection Manager User Guide, how it is organized, its document conventions, and how to obtain documentation and technical assistance.

This guide is intended for the networking or computer technician responsible for the onsite installation and configuration of the Cisco Service Control Management Suite (SCMS) Collection Manager (CM). It is also intended for the operator responsible for the daily operations of the CM, allowing the Service Provider operator to make enhancements in a subscriber-oriented environment. This guide assumes a basic familiarity with the concept of the Cisco Service Control solution, the Service Control Engine (SCE) platforms, and related components.

Document Revision History

The Document Revision History below records changes to this document.

Table 1 Document Revision History 

Revision
Cisco Service Control
Release and Date
Change Summary

OL-7208-09

3.5.5
July 23, 2009

Versioned document to Release 3.5.5

OL-7208-08

3.5.0
January, 2009

Added support for Red Hat Linux 5 and removed support for Red Hat Linux 3.0. See Checking System Prerequisites, page 3-2.

The bundled Sybase database for Red Hat is upgraded to version 15.0.2 to support Red Hat Linux 5

Added support for MySQL 5.1

Added support for Oracle 11g

The prunetable.sh and droptable.sh scripts are now supported on all supported databases. See Common Database Management Tasks, page 5-1.

The sceconf.py script has been renamed to sceconf.sh

Obsolete configuration parameters have been removed from the configuration files. See Configuration Files Descriptions, page B-1.

Added dbconf.sh script to configure external databases. See Configuring Databases, page 4-5.

Bundled Sybase general performance improvements

Added p3stats command line utility. See Viewing Database Statistics, page 4-12.

Removed the HTTPC Adapter.

update_statistics.sh script is supported for the bundled Sybase database.

version and dbversion options for CM. See Viewing Version Information, page 4-13.

OL-7208-07

3.1.6
May, 2008

Added ranges and default values to the configuration files descriptions. See Configuration Files Descriptions, page B-1.

Clarification of how to implement periodic delete. See Managing the Periodic Deletion of Old Records, page 5-3.

Minor changes throughout the guide.

OL-7208-06

3.1.5
November, 2007

Added section describing the TA Adapter memory requirements. See TA Adapter Memory Requirements, page 2-5.

Added section describing the support information scripts. See Collection Manager Support Information, page 4-2.

Added module describing the configuration parameters in the configuration files. See Configuration Files Descriptions, page B-1.

Added description of the ragadapter.xml file. See ragadapter.xml File, page A-6.

Removed the 'Controlling the Database' section and all references to the dbconf.sh script.

OL-7208-05

3.1.0
May, 2007

Added new script to manage virtual links semantics. See Managing Virtual Links, page 4-9.

Added support for Solaris 10 and removed support for Solaris 8

Added support for MySQL 5

Added support for Oracle 10

The bundled Sybase database for Solaris is upgraded to version 15

Removed --expert mode from the Sybase install script. The regular install mode allows the user to define the database capacity.

The periodic delete mechanism and dbtables.sh script are now supported for external databases. See Common Database Management Tasks, page 5-1.

The upgrade procedure to release 3.1 can preserve the previous version configuration. See install-cm.sh Options, page 3-10 and Upgrading the Collection Manager to Version 3.5.x, page 3-14.

OL-7208-04

3.0.5
November, 2006

Added the following sections to the document:

Managing Users, page 4-8

Enabling Adapters, page 4-4

Configuring the Categorizer, page 4-6

OL-7208-03

3.0.3
May, 2006

Added the following new features:

The check_prerequisites.sh script. See Checking System Prerequisites, page 3-2.

The monitor.sh script. See Monitoring System Health, page 4-6.

Removed the following, deprecated feature:

The --legacy flag of the installsyb.sh script

Added the following section to the document:

Configuring Escape of Nonprintable Characters, page 5-11

OL-7208-02

3.0
December, 2005

Added the following new feature:

HTTPC Adapter

Removed the following, deprecated feature:

Database Adapter

Added the following section to the document:

Code Samples, page A-1

OL-7208-01

2.5.5
February, 2005

First version of this document.


Organization

This guide contains the following sections:

Table 2 Document Organization 

Section
Title
Description

1

Cisco Service Control Overview

Provides a functional overview of the Cisco Service Control solution

2

Collection Manager Overview

Describes the functionality of the Collection Manager components

3

Installing the Collection Manager

Describes the procedures for installing the Collection Manager and its database, and explains how to run the Collection Manager

4

Chapter 4, "Managing the Collection Manager"

Explains how to use utility scripts to view and update Collection Manager parameters and other information

5

Chapter 5, "Managing Databases and the Comma Separated Value Repository"

Explains how to use utility scripts to manage the Collection Manager database and the CSV repository

6

Configuring Databases

Explains how to configure the Collection Manager to work with your database

A

Code Samples

Provides sample lists of code for configuration files

B

Configuration Files Descriptions

Describes the available parameters in all of the configuration files


Related Publications

Use this Cisco SCMS Collection Manager User Guide in conjunction with the following Cisco documentation:

Cisco Service Control Application for Broadband User Guide

Cisco Service Control Application for Broadband Reference Guide

Cisco SCA BB Service Configuration API Programmer Guide

Cisco Service Control Application Reporter User Guide

Conventions

This document uses the following conventions:

Table 3 Conventions 

Convention
Indication

bold font

Commands and keywords and user-entered text appear in bold font.

italic font

Document titles, new or emphasized terms, and arguments for which you supply values are in italic font.

[ ]

Elements in square brackets are optional.

{x | y | z }

Required alternative keywords are grouped in braces and separated by vertical bars.

[ x | y | z ]

Optional alternative keywords are grouped in brackets and separated by vertical bars.

string

A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

courier font

Terminal sessions and information the system displays appear in courier font.

< >

Nonprinting characters such as passwords are in angle brackets.

[ ]

Default responses to system prompts are in square brackets.

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.



Note Means reader take note.



Tip Means the following information will help you solve a problem.



Caution Means reader be careful. In this situation, you might perform an action that could result in equipment damage or loss of data.


Timesaver Means the described action saves time. You can save time by performing the action described in the paragraph.



Warning Means reader be warned. In this situation, you might perform an action that could result in bodily injury.


Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.