Cisco Systems PGW 2200 Software Directory Structure

4-3

Cisco PGW 2200 Softswitch Release 9.8 Software Installation and Configuration Guide

OL-18083-01

Chapter 4 Configuring the Cisco PGW 2200 Softswitch Software

Before You Start

• Have your company's internal support and Cisco support contact information readily available so

you can get help with the installation if needed. (If you have questions or need assistance, see the

“Obtaining Documentation and Submitting a Service Request” section on page x of the Cisco

support contact information.)

• Ensure that you have access to the console port on your Cisco PGW 2200 Softswitch host.

Caution The Cisco PGW 2200 Softswitch software is case-sensitive. Ensure that you enter parameter names

correctly, or the maximum number of configurations will not be modified.

Software Directory Structure

Table 4-2 shows the Cisco PGW 2200 Softswitch software directory structure.

Caution Do not edit any .dat files (except for the XECfgParm.dat and trigger.dat files). Use MML or the GUI

provisioning tool to make changes to your configuration. In addition, only make changes to the call

screening database by using MML or the GUI provisioning tool.

Table 4-2 Software Directory Structure

Directory Contents

/etc/init.d Control scripts, including scripts used to stop and start the

software.

/opt/CiscoMGC Root location of base software installation.

/opt/CiscoMGC/bin Stores executable Cisco PGW 2200 Softswitch system

files.

/opt/CiscoMGC/license Cisco PGW 2200 Softswitch license files.

/opt/CiscoMGC/local User accounts home directory.

/opt/CiscoMGC/etc Contains active configuration data files and the

configuration library.

/opt/CiscoMGC/etc/CONFIG_LIB Library of all configuration data files.

/opt/CiscoMGC/etc/CONFIG_LIB/new The initial startup configuration supplied with a new

installation of the software.

/opt/CiscoMGC/etc/active_link The active running configuration that has been committed

or deployed.

/opt/CiscoMGC/etc/prov_link The latest provisioned configuration that has not yet been

committed or deployed.

/opt/CiscoMGC/etc/cust_specific Location of configurations that have been exported using

the prov-exp MML command.

/opt/CiscoMGC/lib System software libraries of *.so object files (including

protocol and system libraries).

/opt/CiscoMGC/snmp SNMP support directory. MIBs are named *.my and are in

ASN.1 syntax.

Contents

Main Page CONTENTS Page Page Page Page Page Preface Document Objectives Audience Related Documentation Obtaining Documentation and Submitting a Service Request Document Change History Preparing for Sun Solaris Operating System and Cisco PGW 2200 Softswitch Software Installation Supported Platforms and Cisco Products Required Software Media Minimum System Requirements Required Site-Specific Information Required Machine-Specific Information Required Tasks Page Installing the Sun Solaris 10 Operating System Supported Platforms Supported Disk Drives Cautions, Notes, and Tips Loading the Sun Solaris 10 Operating System Devices on Supported Platforms Installing the Sun Solaris 10 Operating System for Sparc-based Platforms Page 2-5 2-6 2-7 2-8 2-9 2-10 2-11 2-12 Step 7 Enter no to continue the reconfiguration process and press Enter. The system displays information similar to the following: Installing the Sun Solaris 10 Operating System for Opteron-based Platforms 2-14 f. Save your changes and exit the Setup menu. Information similar to the following is displayed: choose solaris. If you use serial console, select solaris ttya. 2-15 2-16 2-17 2-18 2-19 2-20 2-21 2-22 2-23 2-24 2-25 2-26 2-27 2-28 2-29 2-30 2-31 2-32 2-33 2-34 2-35 2-36 2-37 2-38 2-39 2-40 2-41 2-42 2-43 2-44 2-45 2-46 2-47 2-48 2-49 hardware. You do not need to open any of these tools to complete this installation. port). Cisco recommends that you use the default terminal while you are installing software. Configuring Your Host 2-51 to the following is displayed: Page Page Page Page Page Page 2-58 continue. Text similar to the following is displayed: the search domains. Text similar to the following is displayed: 2-59 Step 25 Confirm your previous answers and press ESC-2 to continue. Eastern time. ESC-2 to continue. 2-60 ESC-2 to continue. c. Use the arrow keys to move the cursor to your time zone (in this example, Eastern Time is selected) and press the space bar to select it. Press ESC-2 to continue. Step 27 Enter the correct date and time and press ESC-2 to continue. 2-61 Step 28 Verify the information and press ESC-2 to continue. Text similar to the following might be displayed: Step 29 Enter no to continue the reconfiguration process and press Enter. Note On Opteron-based platforms, you can select a terminal type from the picklist, or the default Platform-Specific Installation Procedures Page 2-64 2-65 2-66 2-67 2-68 2-69 2-70 2-71 Step 7. a. Change to the root directory by entering the following command and pressing Enter: b. Unmount the cdrom directory from the CD-ROM drive by entering the following command and pressing Enter: Loading the Sun Solaris 10 Operating Environment Installing the Sparc-based Solaris 10 Patches Package (CSCOh022) Page Installing the Opteron-based Solaris 10 Patches Package (CSCOh032) Page Installing the Solstice DiskSuite (CSCOh023) 2-78 command to install the DiskSuite installation scripts: Text similar to the following is displayed. Note You can also download the Solaris 10 DiskSuite package (CSCOh023) from Cisco.com. For Step 2 Press Enter to accept the default answer all. Text similar to the following is displayed: 2-79 Step 4 Change directories. Enter the following command: Step 5 Run the first script. Enter the following command: 2-80 2-81 2-82 2-83 /opt/sun_install/DiskSuite. Enter the following command: Step 9 Run the second script. Enter the following command: 2-84 Note The system continues to issue these re-synchronization messages until the replication is complete. Once the replication is complete, the system returns a prompt. replication is dependent upon the size of the disk drives in your host. It may take several hours. Step 11 Press Enter to continue the installation. Text similar to the following is displayed: Rebooting from the Mirrored (Secondary) Disk on Sparc-based Platforms Page Rebooting from the Mirrored (Secondary) Disk on Opteron-based Platforms Removing the Solstice DiskSuite Installing the Log and Spool File Systems (CSCOh024) Page Page 2-92 Step 4 Answer y and press Enter to install the files. Text similar to the following is displayed: Step 5 Type y and press Enter to continue. Text similar to the following is displayed: script. 2-93 2-94 2-95 2-96 Uninstalling the Log and Spool File System Installing Cisco BAMS Archive Partition (CSCOh027) Page 2-100 2-101 2-102 Installing the Sparc-based Communications and Alarm Software Package (CSCOh026) Page 2-105 Step 4 Enter the following commands to change directories and execute the installation script. Note The following command output is truncated. These lists vary over time. 2-106 2-107 2-108 2-109 2-110 2-111 2-112 2-113 2-114 2-115 2-116 2-117 following is displayed: type the following command and press Enter: Installing the Opteron-based Communications Software Package (CSCOh036) 2-119 Step 4 Enter the following commands to change directories and execute the installation script: These lists vary over time. 2-120 2-121 2-122 2-123 2-124 2-125 2-126 2-127 2-128 following is displayed: Installing the Verification Test Suite Script Package (CSCOh021) 2-130 Note You can also download the VTS script package (CSCOh021) from Cisco.com. For example, Step 3 Press Enter to select all packages. Text similar to the following is displayed: Using the SunVTS Test Package Normal Unit Test 2-132 2-133 2-134 2-135 Note See Table 2-5 for the approximate amount of time the test will take on the different platforms Step 1 Change directories to the /var/tmp directory. Enter the following command: supported. Running a Test in Brief Mode Running a Test in Full Mode vts_script Execution Times Removing the VTS Package (CSCOh021) Configuring Lights-Out Management (LOM) or the Integrated Lights Out Manager (ILOM) Configuring LOM on Sun Fire V40z Platform Configuring the Service Processor Logging in Service Processor Using Secure HTTP Page Page Configuring ILOM on Sun Fire X4600 Platform Configuring the Static IP Address Using the Command Line Interface (CLI) Page Start ILOM Using Secure HTTP Configuring ILOM on Sun Netra X4200 M2 Platform Configuring the IP Address with CLI Configuring the IP Address in BIOS Start ILOM Using Secure HTTP Page An Example of Using ILOM Page Page Page Installing the Cisco PGW 2200 Softswitch Software Release 9.8 and Higher Cautions, Notes, and Tips Installing the Cisco PGW 2200 Softswitch Software Release 9.8 and Higher Releases Installing Cisco PGW 2200 Softswitch Software on a Simplex System Page 3-5 c. Enter y and press Enter. Note This procedure can take approximately 1 hour to complete. Text similar to the following is displayed, showing the packages that were installed: 3-6 3-7 3-8 3-9 3-10 used and the installation process takes more time. Proceed to Step 12. installation. The following prompt is displayed: Page Installing the Cisco Security Package (CSCOh020) 3-13 Step 3 Enter y and press Enter to continue. Text similar to the following is displayed: b. Type y and press Enter to continue. allow remote users to log in as root, enter n and press Enter, then proceed to Step 6. a. Type y and press Enter. Page Enabling Sudo Installing the License File Installing the License File if the Cisco PGW 2200 Softswitch is NOT Running Installing the License File if the Cisco PGW 2200 Softswitch is Running Installing on a Fault Tolerant System Page Configuring the Cisco PGW 2200 Softswitch Software Quick Guide to Configuring the Cisco PGW 2200 Softswitch Software Page Software Directory Structure Initial Cisco PGW 2200 Softswitch Software Configuration Page Page Parameters Required for Initial Setup Using the Cisco MGC Environment Configuration Tool Page Page Configuring Groups and Users Verifying the mgcgrp Group Adding a User with Full MML Privileges Adding a User with Minimal MML Privileges Configuring SNMP Support Resources Basic Tasks Before You Run the config-snmp Utility Running the config-snmp Utility 4-16 b. To che ck critagt: Step 6 Enter your selection number (1 through 25) to view your configuration entries. If the critagt process is running, text similar to the following is displayed: Step 4 To start the config-snmp utility, enter the following commands and press Enter: Adding an SNMP Community Entry Continuing from Step 6, above (of the section Running the config-snmp Utility): Step 1 Enter 12 to select snmpCommunityEntry and view the entries: Text similar to the following and the SNMPD Configuration Main Menu are displayed. Step 2 You are prompted to make a selection. Enter 2 to add an SNMP Community. Page Deleting an SNMP COMMUNITY Adding a Trap Destination Page Deleting a Trap Destination Activating the New Settings 4-24 Verifying the SNMP Configuration Migration Note The following entries are examples only. Step 1 To start the config-snmp utility, type the following command and press Enter: When the SNMPD Configuration Main Menu is displayed, you are prompted to make a selection: Step 2 Enter 1 to view the configuration entries. Configuring the Execution Environment Changing XECfgParm.dat File Parameters Changing XECfgParm.dat File Parameters in a Running Fault Tolerant System Configuring Basic System Information Page Specifying IP Addresses Page Configuring Engine Parameters Page Setting the Call Cutoff Timer Enabling Call Screening Configuring Call Detail Record File Output Configuring the Clearing Location and Default Location Parameters Page Page Configuring Switchover Page Initializing the Provisioning Object Manager Configuring SCP Queries Before You Start Modifying trigger.dat file parameters with provisioning commands Configuring the trigger.dat File Attributes Configuring the Translation Type Attribute Sample trigger.dat File 4-46 4-47 4-48 4-49 4-50 4-51 4-52 4-53 4-54 4-55 4-56 4-57 4-58 4-59 4-60 4-61 4-62 4-63 4-64 4-65 4-66 4-67 4-68 4-69 4-70 4-71 4-72 4-73 4-74 4-75 4-76 4-77 4-78 4-79 4-80 4-81 Initializing the Call Screening Database .odbc.ini File Information Setting Up Replication Network Requirements Identifying data store hosts (UNIX and VxWorks) Initializing Database Replication Verifying Database Replication Troubleshooting the Main Memory Database Replication Displaying the Main Memory Database Replication Status Verifying Database Synchronization Synchronizing Databases Checking for Installation Errors Reinstalling CSCOga002 Configuring Cisco ITP-Ls Configuring Disk Monitor During Initial Software Configuration Configuring the Data Dumper Page Configuring the Data Dumper to Support Cisco BAMS Migrating to Solaris 10 and Cisco PGW 2200 Softswitch Software Release 9.8 Conditions for Migration Cautions and Notes Required Software License Installation Recording System Data Migration Overview Migration from Release 9.5 or 9.6 to Release 9.8 without Platform Changes Migrating the Second Cisco PGW 2200 Softswitch Software to Release 9.8 Backing Up the Cisco PGW 2200 Softswitch Configuration Files Page Page Installing Sun Solaris 10 Loading the Sun Solaris 10 Operating Environment Packages Restoring Data Files Installing and Verifying the Cisco PGW 2200 Softswitch Software Migrating the First Cisco PGW 2200 Softswitch Software to Release 9.8 Backing Up the Cisco PGW 2200 Softswitch Configuration Files Page Installing Sun Solaris 10 Loading the Sun Solaris 10 Operating Environment Packages Restoring Data Files Installing and Verifying the Cisco PGW 2200 Softswitch Software Transferring Additional Configuration Files Page Page Page Migration from Release 9.7 to Release 9.8 without Platform Changes Upgrading Lively from Sparc-based Platforms to Opteron-based Platforms Before You Start Live Upgrade Procedure Page 5-24 database. Step 19 Change the login to mgcusr using the following command: Step 20 Run db_count.sh script to verify that the TimesTen database is empty. Step 21 Import the database files from the ttbackup.tar using the following command: Page Falling Back Overview Falling Back to the Cisco PGW 2200 Softswitch Software Release 9.7 without Platform Changes Falling Back to Solaris 8 and Cisco PGW 2200 Softswitch Release 9.5 or 9.6 Falling Back to Solaris 8 If Hard Drives Were Replaced During the Upgrade Falling Back to Solaris 8 on the Second Disk Drive 5-29 Step 6 Enter 4 to remove a disk for replacement. Step 7 Enter list to list all disks: Step 8 Enter rootdiska at the following prompt: Step 9 Enter y and press Enter at the prompt to continue: 5-30 Step 11 Use the vxdisk command to verify that rootdiska is removed. Step 12 Shut down and boot from disk1. Step 13 Log in as root and run vxdiskadm. Step 14 Enter 5 to replace a failed disk. 5-31 hours. Step 19 Enter y and press Enter to continue. Step 20 Enter n and press Enter when asked to replace the disk. Step 21 Enter q and press Enter to quit. Falling Back to Previous Cisco PGW 2200 Softswitch Software Releases with Platform Changes Replacing Hard Disks on an Existing Solaris 10 Platform Backup Procedure Hard Disk Replacement Procedure Loading the Solaris 10 Operating System Loading the Sun Solaris 10 Operating Environment Packages Installing the Cisco PGW 2200 Softswitch Restoring the System Page Configuring the Local Area Network Switch LAN Switch Overview Catalyst 2900 XL Series Catalyst 5500 and 5000 Series A XECfgParm.dat File Parameters Understanding the XECfgParm.dat File Format Cisco PGW 2200 Softswitch XECfgParm.dat Files Facility Names Cisco PGW 2200 Softswitch 9.x XECfgParm.dat File Parameter Definitions Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page B Client/Server and Secure Connectivity Relationships Client/Server and Secure Connectivity Relationships Secure Connectivity Among Cisco PGW 2200 Softswitch Applications B-2 Secure Connectivity Between Cisco PGW 2200 Softswitch Application Platforms Secure Connectivity Between Cisco BAMS Application Platforms B-3 Secure Connectivity Between Cisco BAMS and Cisco PGW 2200 Softswitch Application Platforms Page C HP OpenView Sample SNMP Configuration Configuring the Cisco PGW 2200 Softswitch to Send Alarms to HP OpenView Page Formatting Trap Messages Page D Sample Installation Scripts Sample Output from install.sh D-2 D-3 D-4 D-5 D-6 D-7 D-8 D-9 D-10 D-11 Updated Configuration File Sample D-12 D-13 Sample Configured snmpd.cnf File The following shows a sample snmpd.cnf file. traps when the software is initializedone for version1 and one for version 2. D-14 D-15 D-16 Sample Configured XECfgParm.dat Files for Cisco PGW 2200 Softswitch Release 9.8(1) The following sample XECfgParm.dat files for Cisco PGW 2200 Softswitch Release 9.8(1) are located D-17 D-18 D-19 D-20 D-21 D-22 D-23 D-24 D-25 D-26 D-27 Sample Configured XECfgParm.dat Files for Cisco PGW 2200 Softswitch Release 9.7(3) The following sample XECfgParm.dat files for Cisco PGW 2200 Softswitch Release 9.7(3) are located D-28 D-29 D-30 D-31 D-32 D-33 D-34 D-35 D-36 D-37 Sample Configured XECfgParm.dat Files for Cisco PGW 2200 Softswitch Release 9.6(1) The following sample XECfgParm.dat files for Cisco PGW 2200 Softswitch Release 9.6(1) are located D-38 D-39 D-40 D-41 D-42 D-43 D-44 D-45 D-46 E Sample Uninstall Scripts Removing a Cisco PGW 2200 Softswitch Software Version: Sample Output for uninstall.sh E-2 E-3 E-4 E-5 E-6 E-7 E-8 F-1 F Sample LAN Configurations Sample Configuration for Cisco Catalyst 5500 A Output similar to the following appears: F-2 F-3 F-4 F-5 F-6 F-7 Sample Configuration for Cisco Catalyst 5500 A RSM F-8 Sample Configuration for Cisco Catalyst 5500 B F-9 F-10 F-11 F-12 F-13 F-14 F-15 Sample Configuration for Cisco Catalyst 5500 B RSM F-16