Cisco Media Gateway Controller Software Installation and Configuration Guide (Releases 9.1 through 9.6)
Migrating to Cisco MGC Software Release 9.3(1)
Downloads: This chapterpdf (PDF - 451.0KB) The complete bookPDF (PDF - 4.76MB) | Feedback

Migrating to Cisco MGC Software Release 9.3(1)

Table Of Contents

Migrating to Cisco MGC Software Release 9.3(1)

Before you Begin

Conditions for Migration

Quick Guide to Migration

Migrating Host B (Standby Box)

Verify the Existing Network Status

Back Up the PGW Configuration on Host A

Back Up the PGW Configuration on Host B

Remove Cisco MGC 9.2(2) from Host B

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host B

Stop Cisco MGC 9.2(2) on Host A

Start Cisco MGC 9.3(1) on Host B

Migration Verification on Host B

Migrating Host A (Active Box)

Remove Cisco MGC 9.2(2) from Host A

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host A

Start Cisco MGC 9.3(1) on Host A

Migration Verification on Host A

Failover Testing

Backout Procedures

Backout After Migration on Host B

Stop Cisco MGC 9.3(1) on Host B

Start Cisco MGC 9.2(2) on Host A

Backout Verification

Remove Cisco MGC 9.3(1) from Host B

Install Cisco MGC 9.2(2) and Cisco MGC Patches on Host B

Start Cisco MGC 9.2(2) on Host B

Backout Verification on Host B

Backout After Migration on Host B and Host A

Stop Cisco MGC 9.3(1) on Host A

Remove Cisco MGC 9.3(1) from Host A

Install Cisco MGC 9.2(2) and 9.2(2) Patches on Host A

Stop Cisco MGC 9.3(1) on Host B

Start Cisco MGC 9.2(2) on Host A

Post Backout Verification on Host A

Remove Cisco 9.3(1) from Host B

Install Cisco MGC 9.2(2) and 9.2(2) Patches on Host B

Start Cisco MGC 9.2(2) on Host B

Post Backout Verification on Host B

Failover Testing


Migrating to Cisco MGC Software Release 9.3(1)


This chapter describes procedures for migrating to the Cisco MGC 9.3(1) software from Cisco MGC software release 9.2(2).

Before you Begin


Caution Before starting the upgrade, verify the existing system status and make sure there are no major alarms.

To ensure a smooth migration, we recommend the following steps:

1. Start the procedure on the standby box (Host B).

2. After Host B is migrated to Release 9.3(1), shut down the active box (Host A) before starting Cisco MGC 9.3(1) on Host B. A brief service interruption will occur while both systems are out of service.

3. After starting Cisco MGC 9.3(1) on Host B, perform acceptance testing to verify that the migration is successful.


Note Do not make any provisioning changes during the migration and verification period.

If any part of the testing fails, try to resolve the problems within a reasonable period of time. If the problem cannot be resolved, perform backout procedures.


4. When migration of both Host A and Host B to Release 9.3(1) is complete, perform failover testing to verify redundancy.

Conditions for Migration

Your hardware and software environment must meet the following conditions before you can use the procedures provided below to migrate your software to the Cisco MGC software release 9.3(1):

1. Your system must have at least 2 disks.

2. The disks in the system must be at least 18 GB in size.

3. You (or the person doing the upgrade) must be an experienced Solaris system administrator. You must be familiar with system administration tasks such as mounting file systems and running tar to save and restore files.

Quick Guide to Migration


Caution Always start migration from the standby box (Host B).

The following table provides a quick guide to migrating to Cisco MGC software release 9.31). For details, refer to the page numbers located on the right-hande column of the table.

Procedure
Details on Page...

Migrating Host B (Standby Box)

page 2

Verify the Existing Network Status

page 2

Back Up the PGW Configuration on Host A

page 3

Back Up the PGW Configuration on Host B

page 3

Remove Cisco MGC 9.2(2) from Host B

page 4

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host B

page 5

Stop Cisco MGC 9.2(2) on Host A

page 5

Start Cisco MGC 9.3(1) on Host B

page 5

Migration Verification on Host B

page 5

Migrating Host A (Active Box)

page 6

Remove Cisco MGC 9.2(2) from Host A

page 6

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host A

page 7

Start Cisco MGC 9.3(1) on Host A

page 7

Migration Verification on Host A

page 7

Failover Testing

page 8

Backout Procedures

page 8

Backout After Migration on Host B

page 8

Backout After Migration on Host B and Host A

page 10


Migrating Host B (Standby Box)

Verify the Existing Network Status

From Host B (standby box):


Step 1 Verify that there are no existing alarms. Log in to both Host A (active box) and Host B (standby box) and enter the following command:

mml>rtv-alms

Step 2 If alarms are found, resolve all before proceeding with migration.


Proceed to the following procedure, "Back Up the PGW Configuration on Host A".

Back Up the PGW Configuration on Host A

To back up the PGW configuration on Host A:


Step 1 Log in as mgcusr.

Step 2 Enter the following command:

mml>prov-exp:all:dirname="922-backup" 

Step 3 Go to /opt/CiscoMGC/etc. Enter the following command:

% cd /opt/CiscoMGC/etc

Step 4 Record the active link. Enter the following command:

% ls -l

Step 5 Create an mgc-922-backup directory under /tmp. Enter the following command:

% mkdir /tmp/mgc-922-backup

Step 6 Go to /opt/CiscoMGC/local. Enter the following command:

% cd /opt/CiscoMGC/local

Step 7 Back up the PGW configuration on Host A. Enter the following commands:

% mgcbackup -d /tmp/mgc-922-backup
% cd /tmp/mgc-922-backup

Step 8 Using FTP, transfer the backup configuration files to a remote server and a remote storage location such as a laptop computer.


Caution These files must now be moved to a remote server and remote storage location so they can be recovered if necessary. You are responsible for providing the mechanism and storage location.

Proceed to back up Host B.

Back Up the PGW Configuration on Host B

To back up Host B's PGW configuration:


Step 1 Log in as mgcusr.

Step 2 Create an mgc-922-backup directory under /tmp. Enter the following command:

% mkdir /tmp/mgc-922-backup

Step 3 Enter the following command:

% mgcbackup -d /tmp/mgc-922-backup 

Step 4 Go to /opt/CiscoMGC/etc. Enter the following command:

% cd /opt/CiscoMGC/etc

Step 5 Copy the XECfgParm.dat file. Enter the following command:

% cp XECfgParm.dat/tmp/922-backup/XECfgParm.dat.922

Step 6 Verify whether both the backup and XECfgParm.dat.922 files are present, indicating that the backup is successful. Enter the following command:

% cd /tmp/922-backup

Step 7 Using FTP, transfer the backup and XECfgParm.dat.922 files to a remote server and a remote storage location such as a laptop computer.


Caution These files must now be moved to a remote server and remote storage location so they can be recovered if necessary. You are responsible for providing the mechanism and storage location.

Proceed to the following section, "Remove Cisco MGC 9.2(2) from Host B".

Remove Cisco MGC 9.2(2) from Host B

To remove Cisco MGC 9.2(2) from Host B:


Step 1 Log out and log back in as root.

Step 2 Stop the Cisco MGC. Enter the following command:

# /etc/init.d/CiscoMGC stop

Step 3 Load the CD-ROM containing Cisco MGC 9.3(1) into the CD-ROM drive. Enter the following command:

# cd /cdrom/cdrom0

Step 4 Enter the following command:

# ./uninstall.sh

Text similar to the following is displayed:

Is the uninstall being done in order to upgrade to a 
new version of the software? [y] [y,n,?,q] y

Step 5 Type y and press Enter to accept unattended package removal. The system displays a list of the packages as it removes them.

Step 6 Check the uninstall log for any errors.

Step 7 If the uninstallation procedure is successful, continue with the migration. If errors are present in the log, try to resolve the problem or contact your Cisco Support Engineer.


Proceed to the next section, "Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host B".

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host B

To install Cisco MGC 9.3(1) and the latest Cisco MGC patches on Host B, refer to the "Installing the Cisco MGC Software 9.2(x) and Higher Releases" section on page 3-3.

For the most recent released Cisco MGC patches, refer to the Release Notes for the Cisco Media Gateway Controller Software Release 9.3(1) located at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/relnote/rn931.htm

Stop Cisco MGC 9.2(2) on Host A


Caution Make sure to stop the older software version in the active box before starting the newly-installed Cisco MGC 9.3(1) software. Use the command /etc/init.d/CiscoMGC stop to stop the older software version in the active box.


Step 1 At the active box, Host A, log in as root.

Step 2 Stop the Cisco MGC 9.2(2). Enter the following command:

# /etc/init.d/CiscoMGC stop


Proceed to the next section, "Start Cisco MGC 9.3(1) on Host B".

Start Cisco MGC 9.3(1) on Host B

To start Cisco MGC 9.3(1) on Host B:


Step 1 Log out as root and log in as mgcusr.

Step 2 Start Cisco MGC 9.3(1) on Host B. Enter the following command:

# /etc/init.d/CiscoMGC start

Proceed to the next section, "Migration Verification on Host B" to verify that the migration is successful.

Migration Verification on Host B

To verify that Host B migration is successful, enter the following commands:

mml > rtrv-softw:all
mml > rtrv-ne
mml > rtrv-ne-health
mml > rtrv-c7lnk:all
mml > rtrv-iplnk:all
mml > rtrv-tc:all
mml > rtrv-dest:all


Note The rtrv-dest:all command verifies the following:

- Platform state is in-service
- Software processes have started
- All links are in service


Proceed to the following section, "Migrating Host A (Active Box)".

Migrating Host A (Active Box)

To migrate Host A to Cisco MGC 9.3(1):

Remove Cisco MGC 9.2(2) from Host A

To remove Cisco MGC 9.2(2) from Host A:


Step 1 Log in as root.

Step 2 Stop the Cisco MGC. Enter the following command:

# /etc/init.d/CiscoMGC stop

Step 3 Load the CD-ROM containing Cisco MGC 9.3(1) into the CD-ROM drive. Enter the following command:

# cd /cdrom/cdrom0

Step 4 Enter the following command:

# ./uninstall.sh

Step 5 You will be prompted for the rest of the uninstallation steps. The system displays a list of packages as they are removed. Check the uninstall log for any errors.

Step 6 If the uninstallation procedure is successful, continue with the migration. If errors are present in the log, contact your Cisco Support Engineer.


Proceed to the next section, "Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host A".

Install Cisco MGC 9.3(1) and Cisco MGC Patches on Host A

To install Cisco MGC 9.3(1) and the latest Cisco MGC patches on Host A, refer to the "Installing the Cisco MGC Software 9.2(x) and Higher Releases" section on page 3-3.

For the most recent released Cisco MGC patches, refer to the Release Notes for the Cisco Media Gateway Controller Software Release 9.3(1) located at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/relnote/rn931.htm

Proceed to the following section, "Start Cisco MGC 9.3(1) on Host A".

Start Cisco MGC 9.3(1) on Host A

To start Cisco MGC 9.3(1) on Host A:


Step 1 Enter the following command:

# /etc/init.d/CiscoMGC start

Step 2 Log out as root and log in as mgcusr.

Step 3 Verify that the system is running on standby. Enter the following command:

mml > rtrv-ne


Proceed to the next section, "Migration Verification on Host A".

Migration Verification on Host A

To verify that Host A migration is successful, enter the following commands:

mml > rtrv-softw:all
mml > rtrv-ne
mml > rtrv-ne-health
mml > rtrv-c7lnk:all
mml > rtrv-iplnk:all
mml > rtrv-dest:all


Note The rtrv-dest:all command verifies the following:

- Platform state is in-service
- Software processes have started
- All links are in service



Proceed to the following section, "Failover Testing".

Failover Testing

Use the following command to verify the PGW failover:

mml>sw-over::confirm

If no errors are found, the migration is complete. Let the system run for a day and monitor all alarms and logs.

If errors are found and the tests fail, try to resolve the problems immediately. If problems cannot be resolved, call Cisco TAC. You may need to back out of the migration, as described in the following section, "Backout Procedures".

Backout Procedures

To back out of the migration, perform the following procedures:

Backout After Migration on Host B

Stop Cisco MGC 9.3(1) on Host B


Step 1 Log in to Host B as root.

Step 2 Stop Cisco MGC 9.3(1) on Host B. Enter the following command:

# /etc/init.d/CiscoMGC stop


Proceed to the next section, "Start Cisco MGC 9.2(2) on Host A".

Start Cisco MGC 9.2(2) on Host A

Start Cisco MGC 9.3(1) on Host A. Enter the following command:

# /etc/init.d/CiscoMGC start

Proceed to the next section, "Backout Verification".

Backout Verification

To verify that the system is working after backing out of the migration, enter the following commands:

mml > rtrv-softw:all
mml > rtrv-ne-health
mml > rtrv-iplnk:all
mml > rtrv-c7lnk:all
mml > rtrv-tc:all
mml > rtrv-dest:all


Note The rtrv-dest:all command verifies the following:

- Platform state is in-service
- Software processes have started
- All links are in service


Proceed to the following section, "Remove Cisco MGC 9.3(1) from Host B".

Remove Cisco MGC 9.3(1) from Host B

To remove Cisco MGC 9.3(1) from Host B:


Step 1 Log out and log back in as root.

Step 2 Stop the Cisco MGC. Enter the following command:

# /etc/init.d/CiscoMGC stop

Step 3 At the prompt, enter the following command to remove the new software release you were attempting to install:

# ./uninstall.sh

A message similar to the following is displayed:

If you answer no to the following question, you will lose  
all new provisionng work.
Is the uninstall being done in order to upgrade to a new version  
of the software? [y] [y,n,?,q] n

Step 4 Type n to fall back to Cisco MGC 9.2(2).

A message similar to the following is displayed:

Use supplied admin file for unattended removal? [n] [y,n,?,q] y

Step 5 Type y to start the unattended removal of the software.

Step 6 Check the uninstall log for any errors. If the uninstallation procedure is successful, continue with the migration. If errors are present in the log, contact Cisco TAC.


Proceed to the next section.

Install Cisco MGC 9.2(2) and Cisco MGC Patches on Host B


Note Make sure you re-install the patches that were previously loaded on Host B before you started the migration.


To install Cisco MGC 9.2(2) and the original Cisco MGC patches on Host B, refer to the "Installing the Cisco MGC Software 9.2(x) and Higher Releases" section on page 3-3.

For the applicable Cisco MGC9.2(2) patches, refer to the Release Notes for the Cisco Media Gateway Controller Software Release 9.2(2) located at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/relnote/rn922.htm

Proceed to the following section, "Start Cisco MGC 9.2(2) on Host B".

Start Cisco MGC 9.2(2) on Host B


Note You may change your password at this point.



Step 1 Log in as mgcusr.

Step 2 Enter the following command to start Cisco MGC 9.2(2):

# /etc/init.d/CiscoMGC start


Proceed to the following section,

Backout Verification on Host B

To verify that the backout from Cisco MGC 9.3(1) is successful, enter the following commands:

mml > rtrv-softw:all
mml > rtrv-ne-health
mml > rtrv-iplnk:all
mml > rtrv-c7lnk:all
mml > rtrv-dest:all


Note The rtrv-dest:all command verifies the following:

- Platform state is in-service
- Software processes have started
- All links are in service


Proceed to the following section, "Backout After Migration on Host B and Host A".

Backout After Migration on Host B and Host A


Note Make sure Host A is running in standby mode.


Stop Cisco MGC 9.3(1) on Host A


Step 1 Log in as root.

Step 2 Enter the following command to stop Cisco MGC 9.3(1):

# /etc/init.d/CiscoMGC stop


Proceed to the following section.

Remove Cisco MGC 9.3(1) from Host A


Step 1 Enter the following command:

# ./uninstall.sh

Step 2 Load the Cisco 9.3(1) CD-ROM into the Host A CD-ROM drive.

Step 3 Enter the following command:

# cd /cdrom/cdrom0

Step 4 At the prompt, enter the following command to remove the new software release you were attempting to install:

# ./uninstall.sh

A message similar to the following is displayed:

If you answer no to the following question, you will lose  
all new provisionng work.
Is the uninstall being done in order to upgrade to a new version  
of the software? [y] [y,n,?,q] n

Step 5 Type n to fall back to Cisco MGC 9.2(2).

A message similar to the following is displayed:

Use supplied admin file for unattended removal? [n] [y,n,?,q] y

Step 6 Type y to start the unattended removal of the software.

Step 7 Check the uninstall log for any errors. If the uninstallation procedure is successful, continue with the migration. If errors are present in the log, contact Cisco TAC.


Proceed to the following section.

Install Cisco MGC 9.2(2) and 9.2(2) Patches on Host A


Note Make sure you re-install the patches previously loaded on Host A before you started the migration.



Step 1 For installation procedures, refer to the "Installing the Cisco MGC Software 9.2(x) and Higher Releases" section on page 3-3.

For the applicable Cisco MGC9.2(2) patches, refer to the Release Notes for the Cisco Media Gateway Controller Software Release 9.2(2) located at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/relnote/rn922.htm

Step 2 Log in as mgcusr. FTP your backup files from the remote server or remote storage.


Note Make sure that you are logged in as mgcusr.


Step 3 Enter the following command to restore the backup files:

% mgcrestore -d /opt/CiscoMGC/local -f mgc_XXXXX_backup

Step 4 Verify that the backup file was successfully restored. Enter the following command:

% cd /opt/CiscoMGC/etc
% ls -l

Note Use the ls -l command to verify whether the active link is the same link as the one before the migration (see Step 4 on page 11-3).



Proceed to the following section.

Stop Cisco MGC 9.3(1) on Host B

Log in as root and enter the following command:

# /etc/init.d/CiscoMGC stop

Start Cisco MGC 9.2(2) on Host A

Enter the following command:

# /etc/init.d/CiscoMGC start

Post Backout Verification on Host A

Verify that the backout on Host A is successful. Enter the following commands:

mml > rtrv-ne-health

Note The rtrv-ne-health command verifies whether Host A is in the active mode.


mml > rtrv-softw:all
mml > rtrv-iplnk:all
mml > rtrv-c7lnk:all
mml > rtrv-dest

Proceed to the following section.

Remove Cisco 9.3(1) from Host B


Step 1 Log out and log back in as root.

Step 2 Stop the Cisco MGC. Enter the following command:

# /etc/init.d/CiscoMGC stop

Step 3 At the prompt, enter the following command to remove the new software release you were attempting to install:

# ./uninstall.sh

A message similar to the following is displayed:

If you answer no to the following question, you will lose  
all new provisionng work.
Is the uninstall being done in order to upgrade to a new version  
of the software? [y] [y,n,?,q] n

Step 4 Type n to fall back to Cisco MGC 9.2(2).

A message similar to the following is displayed:

Use supplied admin file for unattended removal? [n] [y,n,?,q] y

Step 5 Type y to start the unattended removal of the software.

Step 6 Check the uninstall log for any errors. If the uninstallation procedure is successful, continue with the migration. If errors are present in the log, try to resolve the problem. Otherwise, contact Cisco TAC.


Proceed to the following section.

Install Cisco MGC 9.2(2) and 9.2(2) Patches on Host B


Note Make sure you re-install the patches that were previously loaded on Host B before you started the migration.


For installation procedures, refer to the "Installing the Cisco MGC Software 9.2(x) and Higher Releases" section on page 3-3.

For the applicable Cisco MGC9.2(2) patches, refer to the Release Notes for the Cisco Media Gateway Controller Software Release 9.2(2) located at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/relnote/rn922.htm

Proceed to the following section.

Start Cisco MGC 9.2(2) on Host B

Proceed to the following section after staring Cisco 9.2(2) on Host B.

Post Backout Verification on Host B

Verify that the backout on Host B is successful. Enter the following commands:

mml > rtrv-softw:all
mml > rtrv-ne-health
mml > rtrv-iplnk:all
mml > rtrv-c7lnk:all
mml > rtrv-tc:all
mml > rtrv-dest:all

Note The rtrv-dest:all command verifies the following:

- Platform state is in-service
- Software processes have started
- All links are in service


Proceed to the following section.

Failover Testing

Enter the following command to verify the PGW failover:

mml>sw-over::confirm

This completes the migration to Cisco MGC software release 9.3(1).