Table Of Contents
Upgrading the Cisco Media Gateway Controller Software to Release 7.4
Removing a Previous Version of the Cisco MGC Software
Upgrading from a Previous Release
Upgrading from Software Release 7.3 to 7.4
Upgrading within Software Release 7.4
Upgrading the Cisco Media Gateway Controller Software to Release 7.4
This chapter describes how to upgrade the Cisco Media Gateway Controller (MGC) software to Release 7.4.
![]()
Note
For Release 7.4 and later, the Cisco telephony controller software is called the Cisco Media Gateway Controller software. If you are uninstalling a software release prior to Release 7.4, the Cisco MGC (formerly "telephony controller") software files and processes are located in the /opt/TransPath directory of your host server. In Release 7.4, they are in the /opt/CiscoMGC directory.
This chapter contains the following sections:
•
Upgrading from a Previous Release
![]()
Note
For information on configuring the Cisco MGC software, see the following publication: Cisco Media Gateway Controller Software Release 7 Provisioning Guide
Before You Start
![]()
CautionTo prevent the system from running out of disk space during installation and removing data files and databases to compensate, verify that there is enough hard disk space to support your intended installation. You can delete unnecessary log files (platform*.log), user-generated trace files (*.btr), call detail record (CDR) files (.bin or .csv), or user-generated toolkit files (in the /var/cust_specific/toolkit directory) to free space. You also need at least 4 GB of disk space for the /opt file system.
Before you start, perform the following steps:
•
Review the hardware and software requirements found in the document Release Notes for
Cisco Media Gateway Controller Software Release 7.•
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 Technical Assistance" section of the Cisco support contact information.)
•
Ensure that you have access to the console port on your Cisco MGC host.
Perform your installation according to the steps below.
![]()
Note
For the software to work properly, you must reboot the system every time you modify any file in the /etc directory.
When upgrading to Software Release 7.4 (9)C, you must check the /etc/group, /etc/passwd/ and /etc/shadow files for the occurrence of any user group ID that contains a line with 20000. If these lines exist, delete them before installing software release 7.4 (9)C.
Step 1
If the Sun Solaris 2.6 operating system is not already installed, start with "Installing the Sun Solaris 2.6 Operating System."
Step 2
With the Sun Solaris 2.6 operating system installed, back system data before upgrading to Software Release 7.4. See the "Backing Up System Data" section
Step 3
If you are upgrading from a previous release, follow the procedures found in the "Upgrading from a Previous Release" section.
![]()
Note
Monitor system output frequently for error messages during the installation process and correct any error conditions before continuing with the installation.
Backing Up System Data
To back up system data before you upgrade, make copies of the following directories:
•
/opt/CiscoMGC/etc
•
/opt/CiscoMGC/dialPlan
•
/opt/CiscoMGC/CONFIG_LIB
For instructions on backing up your system data, see the "Cisco MGC Backup and Restore Procedures" section in Chapter 3 of the Cisco Media Gateway Controller Software Release 7 Operations, Maintenance, and Troubleshooting Guide.
Removing a Previous Version of the Cisco MGC Software
Before upgrading an existing release of the Cisco MGC software, you must first uninstall the previous software version.
![]()
Note
For a sample output listing from the uninstall.sh script, see the "Sample Output from the uninstall.sh Script" section.
To remove the Cisco MGC software, complete the following steps:
Step 1
Log in at the console as the root user.
Step 2
Stop the Cisco MGC software by entering the following command:
# /etc/init.d/CiscoMGC stopWait until the system returns the following response:
Signalling procM to shut down...shutdown complete![]()
CautionStopping the Cisco MGC software on the active host takes all processes and links out of service.
Step 3
Insert the Cisco MGC Software Version 7.4 CD-ROM into the CD-ROM drive and enter the following commands:
# ./uninstall.shStep 4
If you are upgrading from a previous version of software Release 7, answer y to the following prompt. If this is an initial installation, answer n:
If you answer no to the following question you will lose all new provisioning work.Is the uninstall being done in order to upgrade to a new version of the software? [y] [y,n,?,q]Step 5
The system asks if you want to use the supplied administrative file to perform an unattended package removal. This process removes all the packages automatically.
![]()
Timesaver
If you do not accept the unattended removal, the system prompts you before removing each package individually.
Step 6
Type y (yes) and press Enter to accept unattended package removal. The system displays a list of packages as it removes them.
When package removal is finished, the following message appears:
Uninstallation log can be found in /tmp/uninstall.log.Step 7
Enter the following command:
cd /etcStep 8
Open the group file with your editor.
Step 9
Make sure that the "transpath" and "mgcgrp" groups are removed. These groups must be removed in order to accept default software installation later.
Step 10
Save any changes to the group file and close it.
This completes the removal of the previous version of the Cisco MGC software. If you have questions or need assistance, see the "Obtaining Technical Assistance" section.
Upgrading from a Previous Release
This section covers the following topics:
•
Upgrading from Software Release 7.3 to 7.4
•
Upgrading within Software Release 7.4
Upgrading from Software Release 7.3 to 7.4
If you are upgrading from Software Release 7.3 to Software Release 7.4, follow these steps:
![]()
CautionIf you have a continuous-service or high-availability system with two Cisco MGC hosts, you cannot upgrade from Software Release 7.3 to Software Release 7.4 without call interruption. You must shut down the Cisco MGC hosts before upgrading.
Step 1
Back up your system data (see Backing Up System Data).
Step 2
If you have a continuous-service or high-availability system, log in to the standby host (Host Y) as the root user. If you have a simplex configuration, log in to the host as the root user.
Step 3
On the standby host (Host Y), stop the Cisco MGC software by entering the /etc/init.d/TransPath stop command.
Step 4
Stop the Cisco MGC software by entering the /etc/init.d/TransPath stop command.
Step 5
Remove the Cisco MGC software. See the "Removing a Previous Version of the Cisco MGC Software" section.
Step 6
Install the new software. See the "Installing the Cisco MGC Software Release 7.4(x)" section. Complete the steps in Installing on a Simplex System.
![]()
Note
If you have a simplex system, you have completed the upgrade after performing the procedures in Installing on a Simplex System. To start the system, log in as root user and enter the /etc/init.d/CiscoMGC start command.
If you have a continuous-service or high-availability system, proceed immediately to Step 6, below; do not continue to Installing on a Fault Tolerant System.
Step 7
On the active host (Host X), stop the Cisco MGC software by entering the /etc/init.d/TransPath stop command.
Step 8
On Host Y, restart the software by entering the /etc/init.d/CiscoMGC start command.
Step 9
Remove Release 7.3 of the Cisco MGC software from Host X (see Removing a Previous Version of the Cisco MGC Software).
Step 10
On Host X, install the the Cisco MGC Software Release 7.4(x) and all the required patches.
Step 11
On Host X, restart the software by entering the /etc/init.d/CiscoMGC start command.
Step 12
On Host Y, enter the MML command sw-over::confirm to switch call processing to Host X. Verify that Host X is processing calls. In the unlikely event that the switchover to Host X fails, note down the procedure and details of the upgrade failure and open a TAC case with Cisco.
Upgrading within Software Release 7.4
Before you can upgrade the telephony controller software, you must first uninstall any previous version of the software. To uninstall a previous version, follow the instructions in the "Removing a Previous Version of the Cisco MGC Software" section.
![]()
Note
The following are important prerequisites to any upgrade on Continuous-Service or High-Availability Systems:
- Verify that both platforms (dual system) are operational and processing calls before starting the upgrade.
- Ensure that both servers are able to run as master immediately prior to the upgrade.
If you are upgrading within a software release (for example, upgrading from Software Release 7.4(8) to 7.4(9), perform the following steps:
Step 1
Back up your system data. See the "Backing Up System Data" section.
Step 2
If you have a continuous-service or high-availability system, log in to the standby host (Host Y) as the root user. If you have a simplex configuration, log in to the host as the root user.
Step 3
Stop the Cisco MGC software by entering the /etc/init.d/CiscoMGC stop command.
Step 4
Remove the Cisco MGC software. See the "Removing a Previous Version of the Cisco MGC Software" section.
Step 5
Install the new software. See the "Installing the Cisco MGC Software Release 7.4(x)" section. Complete the steps in Installing on a Simplex System.
![]()
Note
If you have a simplex system, you have completed the upgrade after performing the procedures in Installing on a Simplex System. To start the system, log in as root user and enter the /etc/init.d/CiscoMGC start command.
If you have a continuous-service or high-availability system, proceed immediately to Step 6, below; do not continue to Installing on a Fault Tolerant System.
Step 6
On Host Y, edit the XECfgParm.dat file in the /opt/CiscoMGC/etc directory to set the pom.dataSync parameter to false.
Step 7
Save changes to the XECfgParm.dat file and restart the software by entering the /etc/init.d/CiscoMGC start command.
Step 8
Log in to the active host (Host X) as the root user.Do a switchover by entering the sw-over::confirm command to switch call processing to Host Y. Call processing switches over from Host X to the standby host (Host Y).
Step 9
On Host Y, check that switchover succeeded and that the upgraded server is processing calls. If the switchover succeeded, proceed to Step 10.
If the switchover failed, switch back to the original load on Host X and resume traffic so there would be no downtime. Revert Host Y back to the original release and bring it back to service. Note down the procedure and details of the upgrade failure and open a TAC case with Cisco.
Step 10
On Host X, remove the MGC software. See the "Removing a Previous Version of the Cisco MGC Software" section.
Step 11
On Host X, install the new software. See the "Installing on a Fault Tolerant System" section.
Step 12
On Host X, check the XEConfigParm.dat file in the /opt/CiscoMGC/etc directory. Make sure that the pom.dataSync parameter is set to true. If the pom.dataSync parameter is set to false, edit the XEConfigParm.dat file to set the parameter to true.
Step 13
Enter the /etc/init.d/CiscoMGC start command to restart the software on Host X.
Step 14
On Host Y, enter the MML command sw-over::confirm to switch call processing to Host X. Verify that Host X is processing calls. In the unlikely event that the switchover to Host X fails, note down the procedure and details of the upgrade failure and open a TAC case with Cisco.
Step 15
On Host Y (now the standby host), stop the software by entering the /etc/init.d/CiscoMGC stop command.
Step 16
Edit the XECfgParm.dat file in the/opt/CiscoMGC directory to set the pom.dataSync parameter to true.
Step 17
Save changes to the XECfgParm.dat file and restart the software by entering the /etc/init.d/CiscoMGC start command.
Fall Back Procedures
![]()
Note
Before upgrading your Cisco MGC software, make sure that you back up all .dat files. Use the config-lib command located in /opt/CiscoMGC/local to back up these files.
If the upgrade fails for some reason, uninstall the new software release, fall back to the last software release installed on your system, note down the details of the upgrade failure, and open a TAC case with Cisco.
Do the following procedures to fall back to the last software release:
Step 1
Log in as root.
Step 2
At the prompt, enter the following command to uninstall the new software release you were attempting to install:
uninstall.shThe following message displays:
If you answer no to the following question you will lose all new provisioning work.Is the uninstall being done in order to upgrade to a new version of thesoftware? [y] [y,n,?,q]Step 3
Type n to fall back to the original software release. The following message displays:
Backup setup complete.Use supplied admin file for unattended removal? [n] [y,n,?,q] yStep 4
Type y to start unattended removal of the new software.
Step 5
Install the old Cisco MGC configuration by using the following command:
install.shStep 6
Call TAC for assistance after the old software is restored.
This completes the procedures for falling back to the last software release installed in your system. If you have questions or need assistance, see the "Obtaining Technical Assistance" section.