Table Of Contents
Upgrading the Application Networking Manager Server Software
Information About Upgrading ANM Server Software
Preparing for the Upgrade
Installing the Upgrade Software
Upgrading to ANM 4.1 in Standalone Mode with a Red Hat Upgrade
Upgrading to ANM 4.1 in HA Mode with a Red Hat Upgrade
Upgrading to ANM 4.1 in Standalone Mode without a Red Hat Upgrade
Upgrading to ANM 4.1 in HA Mode without a Red Hat Upgrade
Upgrading the Application Networking Manager Server Software
Date: 9/24/10
This chapter describes how to upgrade the Application Networking Manager server software to ANM 4.1. This chapter includes the following sections:
•
Information About Upgrading ANM Server Software
•Preparing for the Upgrade
•Installing the Upgrade Software
Information About Upgrading ANM Server Software
This section provides information about upgrading to ANM server software version 4.1 from a previous version.
Table 3-1 shows the upgrade path that you must follow before you upgrade to the ANM server 4.1 release. If you want to ensure that all network elements (both staged and imported) are migrated, you must deploy network elements that are not yet imported (staged objects). Otherwise, you can choose to import any staged network elements after the upgrade completes.
Table 3-1 Upgrade Path for ANM
Current Release
|
Previous Releases
|
Upgrade to ANM server 4.1
|
From ANM 3.0, ANM 3.1 and ANM 3.2 only
Note If you need to upgrade to ANM 3.0 before upgrading to ANM 4.1, when you upgrade the ANM software to version 3.0, the network elements that were already imported into ANM software versions 2.2, 2.1(1), 2.1, or 2.0 will properly migrate. If you need to upgrade to ANM 3.1 before upgrading to ANM 4.1, when you upgrade the ANM software to version 4.1 the network elements that were already imported into ANM software 3.0 will properly migrate.
Note ANM 3.2 can be upgraded from ANM 3.0 or ANM 3.1.
|
Upgrade to ANM 3.0, ANM 3.1 and ANM 3.2
|
From ANM 1.2, requires an intermediate upgrade to ANM 2.2, 2.1(1), 2.1, or 2.0. See the Installation Guide for Application Networking Manager 2.2 and 2.1 for details.
Note We recommend that you initially upgrade to ANM 2.2 before you upgrade to ANM 3.0 as described in this document.
|
Table 3-2 contains the upgrade summary of ANM.
Table 3-3 contains a list of many features and their status after the upgrade has occurred. For explanations and information about these features, see User Guide for the Cisco Application Networking Manager 3.1.
Table 3-3 Post Upgrade Feature Status
Feature
|
Upgrade
|
Upgrade Status
|
Network Elements
|
Y
|
All imported network elements are migrated.
|
Staged objects (those that never deployed)
|
N
|
If you are upgrading to ANM 3.0 before upgrading to ANM 4.1, staged objects do not migrate to ANM 3.0 from previous versions of ANM. Perform network element import to add network elements.
Note Before the upgrade, ensure that staged objects are deployed or the data will be lost.
|
Building Blocks
|
Y
|
Building Blocks are migrated.
|
Role Based Access Control (RBAC)
|
Y
|
Usernames, roles, domains, and all relationships are maintained.
|
User-roles
|
Y
|
Custom roles will be retained.
|
Preparing for the Upgrade
If HTTP was enabled on ANM prior to the upgrade, it will be enabled after the upgrade completes. If you prefer to make your connection more secure by using HTTPS, you need to change the properties file and restart ANM.
If you restore the ANM database from a backup repository and a virtual context that is in the repository has been removed from the network element, ANM removes that context from the database and the context does not appear in the ANM user interface.
You must ensure that staged objects are deployed before you upgrade ANM. If you choose not to redeploy staged objects, you must import any staged objects on a network element after the upgrade completes.
Installing the Upgrade Software
You can upgrade ANM in either High Availability (HA) or standalone mode along with or without a Red Hat upgrade. This section includes the following topics:
•Upgrading to ANM 4.1 in Standalone Mode with a Red Hat Upgrade
•Upgrading to ANM 4.1 in HA Mode with a Red Hat Upgrade
•Upgrading to ANM 4.1 in Standalone Mode without a Red Hat Upgrade
•Upgrading to ANM 4.1 in HA Mode without a Red Hat Upgrade
Upgrading to ANM 4.1 in Standalone Mode with a Red Hat Upgrade
You can upgrade to ANM 4.1 in standalone mode. During an ANM upgrade, MySQL is automatically installed. If your system contains a different version of MySQL than the one used by ANM, it will be replaced with the version used by ANM during installation.
Tip If you are installing RHEL for the first time, or are experiencing performance problems with an already installed version of RHEL and ANM, see the "Red Hat Operating System Installation Tips" section on page A-1.
Note The procedure in this section includes creating a backup of your current ANM server configuration, which you later copy back onto the ANM server. When copying the backup onto the ANM server, do not use a backup created from an ANM Virtual Appliance because ANM server does not support this type of backup.
Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands that you use. If you are an inexperienced Linux user, you should limit your activities as the root user to the tasks described in this procedure.
Procedure
Step 1 From the Linux command line, log in as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 2 As a root user, enter the /opt/CSCOanm/bin/anm-tool backup path-to-backup-file command to create an ANM backup file.
Step 3 Copy the backup file to a safe, remote (nonlocal) location, such as a different computer, a USB flash or external drive, or CD-RW disk.
Step 4 Install Red Hat Enterprise Linux following the procedure described in the "Red Hat Operating System Installation Tips" section on page A-1.
Step 5 From the Linux command line, log in as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 6 Copy the ANM backup file that you created in Step 2 to the ANM server.
Step 7 Insert the ANM 4.1 CD-ROM into the drive of the Linux server and mount to the /cdrom directory.
Step 8 Change your directory to the /cdrom directory or the directory on which you mounted the CD.
Step 9 As a root user, enter the ./anm-4.1.bin upgrade path-to-backup-file command to start the upgrade.
The installation and upgrade begins and status messages appear on your login window. When Done appears, the upgrade script has finished.
Step 10 Unmount the CD-ROM.
Note After upgrading to ANM 4.1, be sure to clear the browser cache on all client devices before accessing the ANM GUI to avoid possible issues with the GUI function buttons being inaccessible.
Upgrading to ANM 4.1 in HA Mode with a Red Hat Upgrade
You can upgrade to ANM 4.1 in HA mode. During the ANM upgrade, MySQL is automatically installed. If your system contains a different version of MySQL than the one used by ANM, it will be replaced with the version used by ANM during installation.
Tip If you are installing RHEL for the first time, or are experiencing performance problems with an already installed version of RHEL and ANM, see the "Red Hat Operating System Installation Tips" section on page A-1.
Note The procedure in this section includes creating a backup of your current ANM server configuration, which you later copy back onto the ANM server. When copying the backup onto the ANM server, do not use a backup created from an ANM Virtual Appliance because ANM server does not support this type of backup.
Procedure
Step 1 Log into your current running version of ANM and make sure that active and standby ANM servers are synchronized. See the ANM context sensitive online help for more information on how to do this.
Note To upgrade you must enter a number of commands on two servers at different times in the sequence specified in the procedure.
Step 2 Log in to the standby server as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 3 As a root user, enter the /opt/CSCOanm/bin/anm-tool backup path-to-backup-file command to create an ANM backup file.
Note The specials characters allowed in the file name while a taking backup using /opt/CSCOanm/bin/anm-tool backup path-to-backup-file: ! , @ , $, % , ^ , _ , + , = , {, }, [, ] , :, , , (comma), ?.
Step 4 Copy the backup file to a safe, remote (nonlocal) location, such as a different computer, a USB flash or external drive, or CD-RW disk.
Step 5 Install Red Hat Enterprise Linux following the procedure described in the "Red Hat Operating System Installation Tips" section on page A-1.
Step 6 Repeat Steps 2 through 5 for the active server.
Step 7 Log in to the former standby server as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 8 Copy the ANM backup file that you created in Step 3 to the ANM server.
Step 9 Insert the ANM 4.1 CD-ROM into the drive of the Linux server and mount to the /cdrom directory.
Step 10 Change your directory to the /cdrom directory or the directory to which you mounted the CD.
Step 11 As a root user, enter the ./anm-4.1.bin upgrade path-to-backup-file command to begin the upgrade.
The installation and upgrade begins and status messages appear on your window. When Done appears, the upgrade script has finished.
Step 12 Unmount the CD-ROM.
Step 13 Repeat Steps 7 through 12 for the former active server.
Note After upgrading to ANM 4.1, be sure to clear the browser cache on all client devices before accessing the ANM GUI to avoid possible issues with the GUI function buttons being inaccessible.
Note A backup file taken from a 32-bit Server Edition can be used to upgrade ANM 4.1 operating in a 64-bit Server Edition either in standalone or HA mode.
Upgrading to ANM 4.1 in Standalone Mode without a Red Hat Upgrade
During the ANM upgrade, MySQL automatically installed. If your system contains a different version of MySQL than the one used by ANM, it will be replaced with the version used by ANM during installation.
Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands that you use. If you are an inexperienced Linux user, you should limit your activities as the root user to the tasks described in this procedure.
Procedure
Step 1 From the Linux command line, log in as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 2 As a root user, enter the /opt/CSCOanm/bin/anm-tool backup path-to-backup-file command to create an ANM backup file.
Step 3 As a root user, enter the /opt/CSCOanm/bin/anm-tool uninstall command to uninstall ANM.
Step 4 Insert the ANM 4.1 CD-ROM into the drive of the Linux server and mount to the /cdrom directory.
Step 5 Change your directory to the /cdrom directory or the directory to which you mounted the CD.
Step 6 As a root user, enter the ./anm-4.1.bin upgrade path-to-backup-file command to begin the upgrade.
The installation and upgrade begins and status messages appear on your window. When Done appears, the upgrade script has finished.
Step 7 Unmount the CD-ROM.
Note After upgrading to ANM 4.1, be sure to clear the browser cache on all client devices before accessing the ANM GUI to avoid possible issues with the GUI function buttons being inaccessible.
Upgrading to ANM 4.1 in HA Mode without a Red Hat Upgrade
During the ANM upgrade, MySQL is automatically installed. If your system contains a different version of MySQL than the one used by ANM, it will be replaced with the version used by ANM during installation.
Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands that you use. If you are an inexperienced Linux user, you should limit your activities as the root user to the tasks described in this procedure.
Procedure
Step 1 Log into your current running version of ANM and make sure that active and standby ANM servers are synchronized. See the ANM context sensitive online help for more information.
Note To upgrade, you must enter a number of commands on two servers at different times in the sequence specified in the procedure.
Step 2 Log into the standby server as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 3 As a root user, enter the /opt/CSCOanm/bin/anm-tool backup path-to-backup-file command to create an ANM backup file.
As a root user, enter the /opt/CSCOanm/bin/anm-tool uninstall command to uninstall ANM.
Step 4 Repeat Steps 2 and 3 for the active server.
Step 5 Log in to the former standby server as the root user as described in the "Becoming the Root User" section on page 1-6.
Step 6 Insert the ANM 4.1 CD-ROM into the drive of the Linux server and mount to the /cdrom directory.
Step 7 As a root user, enter the ./anm-4.1.bin upgrade path-to-backup-file command to change your directory to the /cdrom directory or the directory to which you mounted the CD.
The installation and upgrade begins and status messages appear on your window. When Done appears, the upgrade script has finished.
Step 8 Unmount the CD-ROM.
Step 9 Repeat Steps 5 to 8 for the former active server.
Note After upgrading to ANM 4.1, be sure to clear the browser cache on all client devices before accessing the ANM GUI to avoid possible issues with the GUI function buttons being inaccessible.
Feedback
