Upgrading AON Software [Cisco AON Software]

Table Of Contents

Upgrading AON Software

Obtaining AON Software

Upgrade Paths

Upgrading AON 1.x Releases

Downloading Files

Upgrading to from AON 1.x to AON 2.1

Upgrading the AON Management Console

Upgrading the AON Appliance

Upgrading the AON-SM

Upgrading the AON-NM

Upgrading AON 2.1 Releases

Upgrading from AON 2.1 to AON 2.1.1

Upgrading from AON 2.1 to AON 2.1.2

Upgrading from AON 2.1.1 to AON 2.1.2

Upgrading Firmware on the AON Appliance

Upgrading to AON 2.4

Upgrading the AON Management Console to Version 2.4

Upgrading Nodes to Version 2.4

Upgrading AON Software

The procedure that follows explains how to upgrade your Application-Oriented Networking (AON) environment to Cisco Application-Oriented Networking 2.2. It includes the following sections:

•Obtaining AON Software

•Upgrade Paths

•Upgrading AON 1.x Releases

•Upgrading AON 2.1 Releases

•Upgrading to AON 2.4

Caution Data loss may occur if you attempt to upgrade from a 1.x release to AON version 2.1.1 or later. You must first upgrade from 1.x to version 2.1.

Obtaining AON Software

AON software is available at the following URL:

http://www.cisco.com/public/sw-center/aon.shtml

Upgrade Paths

Table 2-1 lists the valid upgrade paths for each AON software release.

Table 2-1 AON Upgrade Paths

Current AON Release

Valid Upgrade Paths

Node Upgrade Required

AON 1.x

AON 2.1 only

Yes

AON 2.1.0

Any AON 2.x

Only if upgrading to AON 2.4

AON 2.1.x

Any AON 2.x

Only if upgrading to AON 2.4

AON 2.2

AON 2.4

Yes¹

¹If you are upgrading an AON Appliance from version 2.1.1 or earlier, you must first upgrade firmware and BIOS on the appliance. See the "Upgrading Firmware on the AON Appliance" section.

Upgrading AON 1.x Releases

AON version 2.1 includes a new software architecture to improve the process of upgrading nodes for future AON software releases. Consequently, this upgrade has several unique steps that differ from previous upgrade procedures. After this migration, future upgrades will be delivered in smaller files, and upgrades will require less downtime to complete.

Note Be sure to read this procedure completely before beginning the upgrade. The upgrade procedure for version 2.x releases is different from that of version 1.x releases.

Downloading Files

To perform this upgrade, make sure you have downloaded the files listed in Table 2-2.

Table 2-2 Files Required to Upgrade from an AON 1.x Release

Platform

Required files

AON Management Console

aon-amc_2.1.0.173_k9_lnx.upgrade.bin

AON Development Studio

aon-ads_2.1.0.173_k9_installer_win.exe

Cisco 8340 AON Appliance

•APL-AON-8340-K9

Helper files:

•aon-apl-8340_2.1.0.173_k9_helper_lnx.pkg

•aon-apl-8340_2.1.0.173_k9_helper_lnx

•aon-apl-8340_2.1.0.173_k9_helper_lnx.prt1

Image files:

•aon-apl-8340_2.1.0.173_k9_lnx.pkg

•aon-apl-8340-full_2.1.0.173_k9_lnx.prt1

•aon-apl-8340-installer_2.1.0.173_k9_lnx.prt1

AON Service Module

Migration files:

•aon-svc_1.x_to_2.1.0.173_k9_helper_lnx.pkg

•aon-svc_1.x_to_2.1.0.173_k9_helper_lnx.prt1

•aon-svc_1.x_to_2.1.0.173_k9_helper_lnx.manifest

Helper files:

•aon-svc_2.1.0.173_k9_helper_lnx.pkg

•aon-svc_2.1.0.173_k9_helper_lnx.prt1

Image files:

•aon-svc_2.1.0.173_k9_lnx.pkg

•aon-svc-full_2.1.0.173_k9_lnx.prt1

•aon-svc-installer_2.1.0.173_k9_lnx.prt1

AON Network Module

Helper file

•aon-nm_2.1.0.173_k9_helper_lnx

Image files:

•aon-nm_2.1.0.173_k9_lnx.pkg

•aon-nm-full_2.1.0.173_k9_lnx.prt1

•aon-nm-installer_2.1.0.173_k9_lnx.prt1

Upgrading to from AON 1.x to AON 2.1

The steps that follow cover the tasks required for upgrading AMC and AON nodes and the order in which the must be performed. For more detailed instructions on the individual tasks that comprise this upgrade, see the following sections in this document:

•Upgrading the AON Management Console

•Upgrading the AON Appliance

•Upgrading the AON-SM

•Upgrading the AON-NM

Note This procedure refers to the default installation directory of /opt/amc. If your AMC is installed in a different directory, substitute that location when performing the steps below.

Upgrade Prerequisites

Before beginning, be sure to complete the following steps:

•Download all of the files needed to upgrade your AON environment. See Table 2-2 for a list of necessary files.

•Develop a backup and recovery strategy for the devices in your environment. At minimum you should have a TFTP server to store node configurations and external storage to back up your version 1.1 AMC installation.

•Verify that the Cisco IOS and CatOS versions for the switches and routers that host AON nodes, and upgrade any platforms as required. See the Release Notes for Cisco Application-Oriented Networking Version 2.1 for software requirements.

Caution You must ensure that any existing deployment requests are in the open (unstaged) state before you shut down AMC for the upgrade. Failure to do so may result in data loss.

To complete the upgrade, perform the following steps:

Step 1 Ensure that all users of ADS have synchronized PEP and message type changes before you begin the upgrade. Deploy these changes to nodes if necessary.

Step 2 Use tar or a similar command to back up the directory in which AMC is installed.

a. For example: tar cvzf amc1_1_backup.tar.gz /opt/amc

b. Copy the backup file to an external device.

Step 3 On each node being upgraded, copy the system and start-up configurations to a TFTP server.

a. Use copy running-config startup-config to save the current system configuration.

b. Use copy running-config tftp to copy the configuration to a TFTP server.

Step 4 Use the following steps to upgrade AMC to version 2.1.0.173.

a. Deactivate any active nodes.

b. Log in to the server running AMC as root.

c. Run aon-amc_2.1.0.173_k9_lnx.upgrade.bin. Near the end of the upgrade, it prompts you to start AMC. You must enter no here.

Note Do not start AMC until instructed to do so in Step 6.

For detailed instructions on upgrading AMC, see the "Upgrading the AON Management Console" section.

Step 5 Run the data upgrade script.

a. Change to the /opt/amc/bin directory.

b. Use ./upgradeData to run the script

Step 6 Use ./amcd start to launch AMC.

Step 7 Upgrade each node to version 2.1.0.173.

a. See the following sections of this document for detailed instructions:

–Upgrading the AON Appliance

–Upgrading the AON-SM

–Upgrading the AON-NM

b. After each node restarts, use configuration terminal mode to enter a new AON configuration so that the node can register with AMC.

c. Restart AON. Nodes will be shown as Registered on AMC, and you must activate each node.

Note You may see errors in aons.log when an upgraded node restarts. This occurs because the upgrade changes have not yet been deployed from AMC.

Step 8 Deploy the upgrade changes from Step 5.

a. Use AMC to deploy the property set changes to all nodes. There should be a global deployment request and a deployment request for each node.

b. Restart the nodes.

The initial bundle sent to the nodes contains the fully upgraded configuration.

Note Ensure that all AON Development Studio users uninstall all previous versions of ADS before they install ADS version 2.1.0.173.

Upgrading the AON Management Console

To upgrade AMC, perform the following steps.

Step 1 Copy the file to the local machine and make it executable.
[root@localhost root]# chmod +x aon-amc_2.1.0.173_k9_lnx.upgrade.bin 
Step 2 Execute the upgrade package and enter the information requested by the application.
[root@localhost root]# ./aon-amc_2.1.0.173_k9_lnx.upgrade.bin 
Preparing to install...
Enter the directory to install the AMC to [/opt/amc]:/opt/amc
Directory "/opt/amc" exists.            
Upgrade existing installation? [y|n]:y
Attempting to stop any AMC processes in /opt/amc
Stopping AMC...Waiting for services to complete...Killing process with id 14221
Done.
Stopping AMC Database...Done.
Extracting archive.
Configuring paths.
Configuring the ports that the AMC will listen on.
If you are installing more than one AMC, these values
must be unique to each installation.
Enter a port for https [7010]:
Enter a port for communication with AONS nodes [7011]:
Enter a port for server shutdown signals [7025]:
Enter a port for the database [2638]:
Enter AMC logging level (DEBUG|INFO|NOTICE|WARN|ERROR|FATAL) [INFO]:
Enter log file rollover threshold size (KB) [1024]:
Enter number of backup logs to keep [5]:
The AMC requires a keystore file and password
to communicate with the AONS node.
Enter the path to the keystore file [/root/amcKeystore.localhost.cisco.com.jks]:
You may optionally enter a keyname within the keystore.
Enter a keyname, otherwise enter none [none]:
Enter a password for this keystore:
about to load the root certs
Loading /opt/amc/admin/security/keystores/ciscocerts/cap-rtp-003.cer
Loading /opt/amc/admin/security/keystores/ciscocerts/cisco-root.cer
Loading /opt/amc/admin/security/keystores/ciscocerts/cisco-manu-ca.cer
Loading /opt/amc/admin/security/keystores/ciscocerts/cisco-manu-ca-dev.cer
Loading /opt/amc/admin/security/keystores/ciscocerts/cisco-test-ca-2048.cer
Setting permissions for AMC installation...
Finalizing installation...
Done.
Would you like to run the AMC now? [y|n]:n
Note Do not run AMC until you run the upgradeData script. See Step 5 for details.

Upgrading the AON Appliance

To upgrade the AON Appliance, perform the following steps:

Step 1 Use AMC to deactivate the node, then reboot the appliance. Wait for the bootloader prompt, then enter ***.
GRUB Loading stage2...
Please enter '***' to change boot configuration: ***
Probing pci nic...
[tg3-5704]Ethernet addr: 00:14:5E:1C:20:60
Tigon3 [partno(BCM95704A6) rev 2100 PHY(5704)] (PCIX:100MHz:64-bit)
Link is up at 10 Mbps, half duplex.
 Cisco Bootloader Version : 2.0.0.6
Cisco Bootloader>
Step 2 Use the config command to update the IP information as necessary and enter the name of the helper image.
Cisco Bootloader> config
IP Address > 192.168.51.2
IP Netmask > 255.255.255.0
TFTP Server > 192.168.1.1
Gateway IP Address > 192.168.50.1
Default Helper-file > aon-apl-8340_2.1.0.173_k9_helper_lnx 
Default Boot [none|disk] [disk] >
Step 3 Use the boot network command to boot the new helper image from the TFTP server.
Cisco Bootloader> boot network
Me: 192.168.51.2, Server: 192.168.1.1, Gateway: 192.168.50.1
Netbooting aon-apl-8340_2.1.0.173_k9_lnx.pkg (CTRL-C aborts)
Downloading aon-apl-8340_2.1.0.173_k9_lnx.pkg
Bytes downloaded :  94436
Validating package signature ... done
type:  application
WARNING:: Software installation will clear disk contents
Continue [n]? y
cleaning fs
prepfs.sh: olympus reiser /mnt clean
check_partition_count: 0
check_partition_flag: 1
The number of cylinders for this disk is set to 4306.
There is nothing wrong with that, but this is larger than 1024,
and could in certain setups cause problems with:
1) software that runs at boot time (e.g., old versions of LILO)
2) booting and partitioning software from other OSs
   (e.g., DOS FDISK, OS/2 FDISK)
Command (m for help): Partition number (1-4):
Command (m for help): Command action
   e   extended
   p   primary partition (1-4)
Partition number (1-4): First cylinder (1-4306, default 1): Using defa
1
Last cylinder or +size or +sizeM or +sizeK (1-4306, default 4306):
Command (m for help): The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.
<-------------mkreiserfs, 2003------------->
reiserfsprogs 3.6.8
mkreiserfs: Guessing about desired format..
mkreiserfs: Kernel 2.4.24 is running.
Initializing journal - 0%....20%....40%....60%....80%....100%
Starting payload download
Step 4 Once the helper loads, enter 1 to install software.
Welcome to Cisco Systems Helper Software
Please select from the following choices:
1       Install software
2       Install certificate
3       Reload module
4       Disk cleanup
5       Configure IP parameters
6       Display status of RAID array
(Type '?' at any time for help)
Choice: 1
Step 5 Enter the package name of the version 2.1 image and the URL for the server hosting the helper image. If the server is password-protected, enter the user and password required to gain access to the file. If no password is required, leave these fields blank.
Package name: aon-apl-8340_2.1.0.173_k9_lnx.pkg
Server url: http://192.168.1.1/aonimages/
Username:
Password:
Downloading  aon-apl-8340_2.1.0.173_k9_lnx.pkg
Bytes downloaded :  94436
Validating package signature ... done
type:  application
WARNING:: Software installation will clear disk contents
Continue [n]? y
cleaning fs
prepfs.sh: olympus reiser /mnt clean
check_partition_count: 0
check_partition_flag: 1
Note The output during software installation and startup is extensive. It has been removed here for brevity.
                Welcome to Cisco AON Engine
                    (Version: 2.1.0.173)
AON boot: hit RETURN to set boot flags: 0001
********** rc.aesop ****************
Setting timezone: timezone is America/Los_Angeles
Loading Tarari Drivers...
SUCCESS: Loaded Tarari Drivers
Loading Cisco WCCP module
wccp: v1.00 (20000327), debug=0
Kernel IP routing table
Destination     Gateway         Genmask         Flags   MSS Window  irtt Iface
Serial Number: KQGYY1M
Reading Manifest...Processing: /sw/installed/manifest/gpl_infrastructure_manifes
t.sig
Processing: /sw/installed/manifest/installer_manifest.sig
Processing: /sw/installed/manifest/oscore_manifest.sig
Processing: /sw/installed/manifest/global_manifest.sig
Processing: /sw/installed/manifest/aon_manifest.sig
Processing: /sw/installed/manifest/infrastructure_manifest.sig
Retrieved 4 sysdb nodes
Populating internal database .. complete.
[16640 refs]
Doing Certificate Check
Certificate Check Done
Loading Cisco CDP module
INIT: Entering runlevel: 2
********** rc.post_install ****************
****************************************
           post_install.sh
****************************************
Changing owners and file permissions.
Change owners and permissions complete.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: NameService
STARTED: CLIFrontEnd
STARTED: NTPMonitor
STARTED: CacheService
STARTED: ManagementAgent
STARTED: WCCPSubsystem
STARTED: CLIBackEnd
STARTED: StunnelServer
STARTED: StunnelClient
STARTED: RAIDMonitor
STARTED: dwnldr_startup.sh
 waiting 9 ...
Password :
Step 6 Enter your administrator password and go to configuration terminal mode, then create an AON configuration so the node can register with AMC.

Upgrading the AON-SM

In order to make the transition to the new architecture described in the "Upgrading AON 1.x Releases" section, the AON-SM requires a migration image that serves as a bridge from the old architecture to the new. To complete the upgrade, you will:

1. Reload and enter the version 1.1 helper.

2. Install the migration image. This will install a version 2.1 helper image into flash.

3. Reload and enter the version 2.1 helper.

4. Install the version 2.1 application image.

Note The AON-SM contains two helper images, the primary helper image on cf:4 and the secondary helper image on cf:5. For the transition to version 2.1, we recommend you dedicate one of these helper image to be an AON 2.1 helper image and the other helper image to contain the AON 1.1 helper image. This will enable the ability to install either AON 1.1 images or AON 2.1 images as desired.

This procedure assumes that you will use the primary helper (cf:4) for version 2.1 and the secondary helper (cf:5) for version 1.1.

To upgrade the AON-SM to version 2.1, complete the following steps:

Step 1 Use AMC to deactivate the node, then set the boot device to cf:4 and reset the module:

•CatOS:
Router> (enable) reset module_number cf:4
This command will reset module 5.
Unsaved configuration on module 5 will be lost
Do you want to continue (y/n) [n]? y
Module 5 shutdown in progress.
Do not remove module 5 until shutdown completes.
•Cisco IOS:
Router# hw-module module module_number reset cf:4
Device BOOT variable for reset = <cf:4>
Warning: Device list is not verified.
Proceed with reload of module? [confirm]y
Step 2 When the module finishes reloading, establish a session to it.

•CatOS:
Router# (enable) session module_number 
The default escape character is Ctrl-^, then x.
You can also type 'exit' at the remote prompt to end the session
Trying 127.0.0.31 ... Open
Starting Config
•Cisco IOS:
Router# session slot module_number processor 1
The default escape character is Ctrl-^, then x.
You can also type 'exit' at the remote prompt to end the session
Trying 127.0.0.31 ... Open
Starting Config
Step 3 Enter the IP configuration details in the version 1.1 helper.
                  Welcome To Cisco AON Installer
                      (Version: 1.1.0.189)
**********************************
* AON Installer IP Configuration *
**********************************
Please enter the IP address of your module: 10.94.0.20
Please enter the netmask of your module: 255.255.255.0
Please enter the default gateway for your module: 10.94.0.1
The following IP configuration is set:
  IP     : 10.94.0.20
  NETMASK: 255.255.255.0
  GATEWAY: 10.94.0.1
Do you wish to use this configuration (y,n) [n] y
Config Done.
Starting Client
SYSTEM ONLINE
Step 4 Use the software install command to install the migration image from your HTTP or FTP server.

•FTP:
AONinstaller#> software install package url 
ftp://server_ip_address/path_to_images/aon-svc_1.x_to_2.1.0.173_k9_helper_lnx.pkg 
user username password password
•HTTP:
AONinstaller#> software install package url 
http://server_ip_address/path_to_images/aon-svc_1.x_to_2.1.0.173_k9_helper_lnx.pkg 
Note The installer cannot resolve domain names. Be sure to use only an IP address when you enter a URL.
Connecting to host...
  % Total    % Received % Xferd  Average Speed          Time             Curr.
                                 Dload  Upload Total    Current  Left    Speed
100 27768  100 27768    0     0  27768      0  0:00:01  0:00:00  0:00:00 7712k
File listing is signed
Retrieving aon-svc_2.1.0.173_k9_lnx_slim_migration.manifest from 10.47.0.2
Manifest Version retrieved is 1.0
Manifest Version matches package version
WARNING: This is an unrecoverable operation!
WARNING: This will completely replace the existing AON helper image.
Do you wish to continue (y,n) [n] y
Which Helper would you like to update primary or secondary (p,s) [p] p
mke2fs 1.27 (8-Mar-2002)
Retrieving aon-svc_2.1.0.173_k9_lnx_slim_migration.prt1 from 10.47.0.2
Connecting to host...
  % Total    % Received % Xferd  Average Speed          Time             Curr.
                                 Dload  Upload Total    Current  Left    Speed
100 12.1M  100 12.1M    0     0  10.9M      0  0:00:01  0:00:01  0:00:00 10.9M
complete.
Validating security header...done
Extracting files from package...done
Installing software onto the system...
Wed Jan 25 00:56:01 UTC 2006
100% complete.
Done.
Installing bootloader...
done.
Cleaning up...complete.
Step 5 Once the migration image finishes loading, exit the session and reset the module.
AONinstaller#> exit
•CatOS:
Console> (enable) reset module_number cf:4
This command will reset module 5.
Unsaved configuration on module 5 will be lost
Do you want to continue (y/n) [n]? y
Module 5 shutdown in progress.
Do not remove module 5 until shutdown completes.
•Cisco IOS:
Router# hw-module module module_number reset cf:4
Device BOOT variable for reset = <cf:4>
Warning: Device list is not verified.
Proceed with reload of module? [confirm]y
Step 6 When the module resets, establish a session to the version 2.1 helper and enter 1 to install the version 2.1 software.
                   Welcome To Cisco AON Installer
                       (Version: 2.1.0.173)
              Welcome to Cisco Systems Helper Software
Please select from the following choices:
1       Install software
2       Install certificate
3       Exit session
4       Disk cleanup
5       Configure IP parameters
6       Temporarily disable login (for password recovery)
(Type '?' at any time for help)
Choice: 1
Step 7 Enter the IP configuration details in the migration helper.
The following IP configuration is set:
  IP     : 10.94.0.20
  NETMASK: 255.255.255.0
  GATEWAY: 10.94.0.1
Do you wish to use this configuration (y,n) [n] y
Step 8 Enter 1 to install software
Please select from the following choices:
1       Install software
2       Install certificate
3       Exit session
4       Disk cleanup
5       Configure IP parameters
6       Temporarily disable login (for password recovery)
(Type '?' at any time for help)
Choice: 1
Note The output produced during software installation and startup is extensive. It has been removed here for brevity.

Step 9 Enter the package name for the version 2.1 application image and the HTTP or FTP URL for the server hosting the files. Include any username or password needed to access the server.
Package name:  aon-svc_2.1.0.173_k9_lnx.pkg
Server url: http://10.47.0.2/aonimages/
Username:
Password:
Downloading  aon-svc_2.1.0.173_k9_lnx.pkg
Bytes downloaded :  95612
Validating package signature ... done
type:  application
WARNING:: Software installation will clear disk contents
Continue [n]? y
cleaning fs
prepfs.sh: kplus reiser /mnt clean
check_partition_count: 0
check_partition_flag: 1
Step 10 When the module reloads, reset the boot device to hdd:1.

•CatOS:
Console> (enable) reset module_number hdd:1
This command will reset module 5.
Unsaved configuration on module 5 will be lost
Do you want to continue (y/n) [n]? y
Module 5 shutdown in progress.
Do not remove module 5 until shutdown completes.
Console> (enable) 
•Cisco IOS:
Router# hw-module module module_number reset hdd:1
Device BOOT variable for reset = <hdd:1>
Warning: Device list is not verified.
Proceed with reload of module? [confirm]
Step 11 When the module reloads, establish a session and use configuration terminal to create an AON configuration to enable the node to register with AMC.

Upgrading the AON-NM

To upgrade an AON-NM, perform the following steps:

Step 1 Use AMC to deactivate the node, then reboot the AON-NM. Wait for the bootloader prompt, then enter ***.
Please enter '***' to change boot configuration: ***
Cisco Bootloader Version : 2.0.0.4
Step 2 Use the config command to change IP configuration as necessary and to enter the name of the new helper image.
Cisco Bootloader> config
IP Address [192.168.169.92] >
IP Netmask [255.255.255.0] >
TFTP Server [192.168.1.1] >
Gateway IP Address [192.168.169.65] >
Default Helper-file [aon-nm_2.1.0.173_k9_helper_lnx] >
Ethernet Interface [internal] >
Default Boot [none|disk] [disk] >
Default Bootloader [primary|secondary] [primary] >
Updating flash with bootloader configuration
Step 3 Use the boot network command to load the helper from the TFTP server.
Cisco Bootloader> boot network
Me: 192.168.169.92, Server: 192.168.1.1, Gateway: 192.168.169.65
Netbooting aon-nm_2.1.0.173_k9_helper_lnx (CTRL-C aborts)
Dbg: Final image size: 11962750
Debug: bl_sz: 126496
in verifysignature_md5, MD5 hash generated now, str format:hexmd5:15ab0186f45a4
0b01cd5a4719b811a11
Verifying signature now...
calling RSA decrypt now
RSA decrypt returned:33
verifysignature_md5, Orig MD5 hash generated during encryption:15ab0186f45a40b0
1cd5a4719b811a11
Image signature verified successfully
Note The output produced during software installation and startup is extensive. It has been removed here for brevity.

Step 4 Once the helper loads, enter 1 to install software.
        Welcome to Cisco Systems Helper Software
Please select from the following choices:
1       Install software
2       Install certificate
3       Reload module
4       Exit session
5       Disk cleanup
(Type '?' at any time for help)
Choice:1
Step 5 Enter the package name of the version 2.1 image and the URL for the server hosting the helper image. If the server is password-protected, enter the user and password required to gain access to the file. If no password is required, leave these fields blank.
Package name: aon-nm_2.1.0.173_k9_lnx.pkg
Server url: http://192.168.1.1/aonimages/
Username:
Password:
Downloading  aon-nm_2.1.0.173_k9_lnx.pkg
Bytes downloaded :  92817
Validating package signature ... done
                Welcome to Cisco AON Engine
                    (Version: 2.1.0.173)
Mon Mar  6 11:48:28 UTC 2006
AON boot: hit RETURN to set boot flags: 0001
****************************************
           post_install.sh
****************************************
Changing owners and file permissions.
Change owners and permissions complete.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: NameService
STARTED: CLIFrontEnd
STARTED: NTPMonitor
STARTED: CacheService
STARTED: ManagementAgent
STARTED: WCCPSubsystem
STARTED: CLIBackEnd
STARTED: StunnelServer
STARTED: StunnelClient
STARTED: dwnldr_startup.sh
 waiting 40 ...
Password :
Step 6 Enter your administrator password and go to configuration terminal mode, then create an AON configuration so the node can register with AMC.

Upgrading AON 2.1 Releases

Version 2.1.1 of Cisco Application-Oriented Networking provides you the ability to upgrade only AMC, while leaving some or all nodes at version 2.1. A mix of 2.1 and 2.1.1 nodes can interact with one another and with a version 2.1.1 AMC.

Additionally, AON 2.1.1 supports online upgrade of nodes. You can upgrade a node from within the AON application. It will download only the data needed to perform an incremental upgrade, then reboot, resulting in a much smaller period of downtime compared to previous AON releases.

Upgrading from AON 2.1 to AON 2.1.1

The steps that follow cover the tasks required for upgrading AMC and AON nodes from version 2.1 to version 2.1.1.

Caution Data loss may occur if you attempt to upgrade from a 1.x release to AON version 2.1.1. You must first upgrade from 1.x to version 2.1.

Note This procedure refers to the default installation directory of /opt/amc. If your AMC is installed in a different directory, substitute that location when performing the steps below.

Upgrade Prerequisites

Before beginning, be sure to complete the following steps:

•Download all of the files needed to upgrade your AON environment. If you are upgrading nodes, copy the appropriate files to an FTP server.

•Develop a backup and recovery strategy for the devices in your environment. At minimum you should have a TFTP server to store node configurations and external storage to back up your AMC installation.

•Verify that the Cisco IOS and CatOS versions for the switches and routers that host AON nodes, and upgrade any platforms as required.

Caution Data loss may occur if deployment requests are staged when you begin the upgrade. You must ensure that any existing deployment requests are in the open (unstaged) state before you shut down AMC for the upgrade.

This upgrade requires you to upgrade only AMC to version 2.1.1. You are not required to upgrade nodes unless you want the benefit of the software defects resolved since the previous release. Should you elect to upgrade only some nodes, your AON environment can operate with a mix of 2.1 and 2.1.1 nodes.

To complete the upgrade, perform the following steps:

Step 1 Ensure that all users of ADS have synchronized PEP and message type changes before you begin the upgrade. Deploy these changes to nodes if necessary.

Step 2 Use tar or a similar command to back up the directory in which AMC is installed.

c. For example: tar cvzf amc1_1_backup.tar.gz /opt/amc

d. Copy the backup file to an external device.

Step 3 On each node being upgraded, copy the system and start-up configurations to a TFTP server.

a. Use copy running-config startup-config to save the current system configuration.

b. Use copy running-config tftp to copy the configuration to a TFTP server.

Step 4 Use the following steps to upgrade AMC to version 2.1.1.53.

a. Deactivate any active nodes.

b. Log in to the server running AMC as root.

c. Run aon-amc_2.1.1.53_k9_lnx.upgrade.bin. Near the end of the upgrade, it prompts you to start AMC. You must enter no here.

Note Do not start AMC until instructed to do so in Step 6.

Step 5 Run the data upgrade script.

a. Change to the /opt/amc/bin directory.

b. Use ./upgradeData to run the script

Step 6 Use ./amcd start to launch AMC.

Note If you are upgrading only AMC, you have completed this procedure. If you are also upgrading nodes, proceed to Step 7.

Step 7 Establish a session to the node you are upgrading, then use the software install command to load the upgrade package.
aon-sm-1> $software install upgrade url ftp://server-address/aon-svc_2.1.1.53_k9_lnx.pkg  
username user password password$
Note Only FTP is supported for online software upgrades.
WARNING:: This command will install the necessary software to 
WARNING:: complete an upgrade.
Would you like to continue? [n] y
Downloading  aon-svc_2.1.1.53_k9_lnx.pkg
Bytes downloaded :  95927 
Validating package signature ... done
Validating installed manifests .......complete.
Starting payload download
File :  aon-svc-full_2.1.1.53_k9_lnx.prt1  Bytes :  177750810 
Validating payloads match registered checksums...
 - aon-svc-full_2.1.1.53_k9_lnx.prt1 
..........................................................................................
................................................................................verified
Note The output produced during software installation and startup is extensive. It has been removed here for brevity.

Step 8 After waiting a few moments, session to the AON node and verify that it has successfully started. Use the show version command to verify that the node is running new software version.
aon-sm-1> show version
CPU Model:                    Pentium III (Coppermine)
CPU Speed (MHz):              996.909
CPU Cache (KByte):            256
Chassis Type:                 CAT6K
Module Type:                  Catalyst 6500 Series AON Module (WS-SVC-AON-1-K9)
Module Serial:                SAD092007UK
Global Software Version:      2.1.1.53
Step 9 Use AMC to activate the node, then go to Network Node > Manage > Show to confirm that AMC reflects the node's new software version.

Upgrading from AON 2.1 to AON 2.1.2

The steps that follow cover the tasks required for upgrading AMC and AON nodes from version 2.1 to version 2.1.2.

Caution Data loss may occur if you attempt to upgrade from a 1.x release to AON version 2.1.2. You must first upgrade from 1.x to version 2.1.

Note This procedure refers to the default installation directory of /opt/amc. If your AMC is installed in a different directory, substitute that location when performing the steps below.

Upgrade Prerequisites

Before beginning, be sure to complete the following steps:

•Download all of the files needed to upgrade your AON environment. If you are upgrading nodes, copy the appropriate files to an FTP server.

•Develop a backup and recovery strategy for the devices in your environment. At minimum you should have a TFTP server to store node configurations and external storage to back up your AMC installation.

•Verify that the Cisco IOS and CatOS versions for the switches and routers that host AON nodes, and upgrade any platforms as required.

Caution Data loss may occur if deployment requests are staged when you begin the upgrade. You must ensure that any existing deployment requests are in the open (unstaged) state before you shut down AMC for the upgrade.

This upgrade requires you to upgrade only AMC to version 2.1.2. You are not required to upgrade nodes unless you want the benefit of the software defects resolved since the previous release. Should you elect to upgrade only some nodes, your AON environment can operate with a mix of 2.1 and 2.1.2 nodes.

To complete the upgrade, perform the following steps:

Step 1 Ensure that all users of ADS have synchronized PEP and message type changes before you begin the upgrade. Deploy these changes to nodes if necessary.

Step 2 Use AMC to deactivate all active nodes.

Step 3 Use tar or a similar command to back up the directory in which AMC is installed.

c. For example: tar cvzf amc1_1_backup.tar.gz /opt/amc

d. Copy the backup file to an external device.

Step 4 On each node being upgraded, copy the system and start-up configurations to a TFTP server.

a. Use copy running-config startup-config to save the current system configuration.

b. Use copy running-config tftp to copy the configuration to a TFTP server.

Step 5 Use the following steps to upgrade AMC to version 2.1.2.29.

a. Deactivate any active nodes.

b. Log in to the server running AMC as root.

c. Run aon-amc_2.1.2.29_k9_lnx.upgrade.bin. Near the end of the upgrade, it prompts you to start AMC. You must enter no here.

Note Do not start AMC until instructed to do so in Step 7.

Step 6 Run the data upgrade script.

a. Change to the /opt/amc/bin directory.

b. Use ./upgradeData to run the script

Step 7 Use ./amcd start to launch AMC.

Note If you are upgrading only AMC, you have completed this procedure. If you are also upgrading nodes, proceed to Step 8.

Step 8 Establish a session to the node you are upgrading, then use the software install command to load the upgrade package.
aon-sm-1> $software install upgrade url ftp://server-address/aon-svc_2.1.2.29_k9_lnx.pkg  
username user password password$
Note Only FTP is supported for online software upgrades.
WARNING:: This command will install the necessary software to 
WARNING:: complete an upgrade.
Would you like to continue? [n] y
Downloading  aon-svc_2.1.2.29_k9_lnx.pkg
Bytes downloaded :  95927 
Validating package signature ... done
Validating installed manifests .......complete.
Starting payload download
File :  aon-svc-full_2.1.2.29_k9_lnx.prt1  Bytes : 177744975 
Validating payloads match registered checksums...
 - aon-svc-full_2.1.2.29_k9_lnx.prt1 
..........................................................................................
................................................................................verified
Calculating delta.... complete.
Retrieving calculated file change sets:
 - Installed file sets...complete.
 - Target file change sets...complete.
Comparing changed source and target files...complete.
Calculating upgrade work order ... complete.
Creating uninstall change sets:
 complete. No added files found.
 - logging added components ... complete.  No removed files found.
Clearing previous downgrade files ... complete.
Uninstall change set processing complete.
Writing upgrade work order to disk ... complete.
[17813 refs]
. 
Disabling disk spindown on /dev/hdc
/dev/hdc:
 setting standby to 0 (off)
SHUTDOWN: cli_state.sh shutdown Success
SHUTDOWN: AONSShutdown Success
SHUTDOWN: procMgr -p ntp stop Success
SHUTDOWN: procMgr -p stunnel_client stop Success
SHUTDOWN: procMgr -p stunnel_server stop Success
install-files.sh /dwnld/.work_order
Remove  ///sw/installed/manifest/global_manifest.sig
add_file /dwnld/pkgdata/aon-svc_2.1.2.29_k9_lnx.pkg 1 / 
sw/installed/manifest/global_manifest.sig none
Remove  //dwnld/pkgdata/aon-svc_2.1.2.29_k9_lnx.pkg
Remove  //dwnld/pkgdata/aon-svc-full_2.1.2.29_k9_lnx.prt1
Console> (enable) 
The AON node reboots and returns you to the command line of the host router or switch.

Step 9 After waiting a few moments, session to the AON node and verify that it has successfully started. Use the show version command to verify that the node is running new software version.
aon-sm-1> show version
CPU Model:                    Pentium III (Coppermine)
CPU Speed (MHz):              996.909
CPU Cache (KByte):            256
Chassis Type:                 CAT6K
Module Type:                  Catalyst 6500 Series AON Module (WS-SVC-AON-1-K9)
Module Serial:                SAD092007UK
Global Software Version:      2.1.2.29
Step 10 Use AMC to activate the node, then go to Network Node > Manage > Show to confirm that AMC reflects the node's new software version.

Upgrading from AON 2.1.1 to AON 2.1.2

To upgrade from AON 2.1.1 to AON 2.1.2 run the AON upgrade installer— aon-amc_2.1.2.29_k9_lnx.upgrade.bin—and upgrade the firmware for Cisco 8300 AON Appliance series.

Upgrading Firmware on the AON Appliance

If you are upgrading software on an existing Cisco 8300 AON Appliance, the firmware upgrade must be completed before installing AON 2.1.2 or later software images.

Note The Cisco Application-Oriented Networking version 2.1.2 images already contain the updated device drivers needed for the new firmware.

Note Once you upgrade to AON version 2.1.2, you cannot downgrade to an earlier AON software version. This new firmware set works on the older version of Cisco 8300 AON Appliance hardware.

Warning Once you start the upgrade process, do not remove the CD from the system until you complete Step 23.

Warning Do not remove power or reboot the system while one of the updates are running. Removal of power in the middle of a firmware update can damage components.

For more detailed instructions on the individual tasks that comprise this upgrade, see the following sections in this document:

•Upgrade Prerequisites

•Upgrading Firmware and BIOS

Upgrade Prerequisites

•You must be physically present wherever the hardware is installed to manually insert the CD containing the software.

•