|
|
This document describes the External Portware Download feature, first introduced for the Cisco AS5800 for Cisco IOS Release 11.3(5)AA. This feature supports upgrading the Cisco AS5800 modem firmware from an external flash memory device, such as a PCMCIA Flash card.
The External Portware Download feature modifies the existing firmware command. The previous version of the command was limited to upgrading dial shelf modem firmware from the bundled image. In order to upgrade the modem firmware, the entire dial shelf feature board images containing the new bundled modem firmware would have to be upgraded first.
The new command adds the capability of upgrading dial shelf modem firmware from an externally sourced file without first upgrading either the router shelf or dial shelf images. The firmware command now enables the user to copy non-bundled modem firmware out of Cisco AS5800 Flash memory down to the modems in the system shelf. The portware upgrade file can be previously copied to the router shelf from a variety of media or network sources, whenever new modem firmware becomes available. The external firmware upgrade file (portware) can be acquired from a variety of media or network sources, such as a TFTP server, Cisco Connection Online (CCO), or a floppy disk. The firmware is copied to a local Flash device, such as a PCMCIA Flash memory card in the Cisco AS5800.
This feature makes use of the conventions available in the Cisco IOS File System (IFS).
The External Portware Download feature consists of one new config-modem-pool subcommand that specifies the IFS path in the router for the Cisco AS5800 Flash memory device, containing the external firmware upgrade file.
The modified firmware command still retains the original capability of downloading firmware from an onboard bundled source, such as a Cisco IOS image.
The External Portware Download feature provides the following benefits:
ISF---Cisco IOS File System
modem range---A range of ports in the modem pool defined by a starting shelf/slot/port number and an ending shelf/slot/port number.
PCMCIA---Personal Computer Memory Card International Association
bundled image file---A modem firmware file that is bundled with the router image.
external portware---A modem firmware file that is freestanding and not bundled with the router image.
(none currently)
For more information on the Cisco AS5300, go to the Cisco Connection Online (CCO), http://www.cisco.com or the Cisco Documentation CD-ROM. The CCO path is:
Cisco Connection Online: Cisco Product Documentation: Access Servers and Access Routers: Access Servers: Cisco AS5800: Cisco IOS 11.3 AA New Features: Cisco AS5800 New Dial and System Management Features.
The path on the Cisco Documentation CD-ROM almost identical to that on CCO. You can also use the CCO search facility.
For additional software configuration information, see the following publications:
This feature is supported on these platforms:
None are applicable.
In conjunction with the pool-range modem configuration subcommand, the firmware command allows you to separately upgrade modem firmware for individual or ranges of modems consisting of virtual groups of six modems or multiples thereof. (For more information, see the Command Reference section.)
A valid pool range must exist (that is, the pool-range modem pool configuration subcommand must have been configured) for modem overwrites to occur. Modem pooling allows you to define, select, and use separate modem pools within a single access server or router to enable different dial-in services for different customers. In this case, the modem pool specifies which modems are loaded with the new firmware image.
The specified firmware image is loaded on every modem for every slot specified in the pool range. If the modem is busy, the firmware change is deferred until the modem is available. When the modem is available, the firmware change takes place immediately.
When the Cisco 5800 router shelf boots up and parses its NVRAM, the modem cards will not be up. As a result, the overwrite firmware name is stored in the modem pool structures and no action will be taken. At boot-up time, the default firmware image is loaded first. If there is a firmware image specified by the firmware command, it is then loaded onto the modem card.
When a modem card becomes active, it sends a startup message to the router shelf. The router shelf then triggers a search in the various modem pools to see if any modem modules on the modem card have a specified firmware overwrite. If yes, the firmware overwrite request is relayed to the modem card, which will load the specified overwrite firmware image on the indicated modem modules.
As a result, the modem modules that are destined to run an overwrite firmware image will experience two firmware downloads at bootup time. The default modem firmware image is loaded first, followed by the overwrite modem firmware image.
Determine which form of the command you want to use: the bundled firmware form or the external portware form.
Upgrading the Cisco AS5800 modem firmware from bundled firmware is summarized as follows:
1. The download file from the bundled image is identified.
2. The modem-pool is created and its range specified.
3. The form of the firmware command is specified and the download is initiated.
Upgrading the Cisco AS5800 modem firmware from an external flash memory device is summarized as follows:
1. The download image is copied to the router Flash memory from a TFTP server, or, if the download is to be from the bundled image, the download file is identified.
2. The modem-pool is created and its range specified.
3. The form of the firmware command is specified and the download is initiated.
The table below is an example procedure for upgrading modem firmware upgrade using the firmware command and other related commands. Begin in privileged EXEC mode.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| router# show modem version | Determine the firmware version currently running on the modem card. If the version needs to be upgraded, proceed. | ||
| 5800# show modem bundled-firmware | If you wish to know the bundled firmware currently residing in the modems, determine the available bundled modem firmware images per slot. | ||
| 5800# copy tftp flash | If you are using external portware to upgrade the modems, copy the portware from a TFTP server to Flash memory in the Cisco AS5800. | ||
| 5800# Enter configuration commands, one per line. End with CNTL/Z. | Enter global configuration mode. You are prompted how to enter the commands. | ||
| 5800(config)# modem-pool pool-name | You are in global configuration mode as indicated by the prompt. Enter modem pool configuration mode and create a modem pool. | ||
| 5800(config-modem-pool)# pool-range shelf/slot/port shelf/slot/port | Create the range (from, up to and including) of modems whose firmware you want to overwrite. A modem range must be coextensive with the boundaries of each virtual group of six modems on a modem card. These group boundaries apply regardless of the type of modem SIMMs used on the card. Thus, numbering range examples might include: shelf/slot/0 shelf/slot/5 (port 0 to port 5 of the first group) or shelf/slot/0 shelf/slot/11 (the first two groups) or shelf/slot/6 shelf/slot/23 (the last three groups), etc. (You must type the slashes (/) as part of the command.) | ||
| 5800(config-modem-pool)# firmware file_specifier_string | If you are downloading external portware, enter the string identifying the portware file copied to the Cisco AS5800 Flash memory, such as an (IFS) file system specifier, as in the example: slot0:mica-firmware.2222.bin. If you are downloading from the bundled image, enter the firmware version. | ||
| 5800(config-modem-pool)# Ctrl-Z 5800 #
%SYS-5-CONFIG_I: Configured from console by console | Press Return to verify your command registers, then type Ctrl-Z to exit the modem-pool configuration mode and return to privileged EXEC mode. The router prompt returns. A confirmation messages indicates the firmware file used as the download file and range n n of modems being downloaded to. (In this case, the external portware form of the command is used as an example.) After the displaying the confirmation message, a "Configured from console" message is displayed. This is expected and does not indicate an error. | ||
| 5800# copy running-config startup-config | Save your configuration when ready. |
To verify you have configured downloaded the firmware to the modems:
Slot 8: Firmware being upgraded to slot0:portware.2222.ios for modems in modem-pool x
5800# > show modem version
Modem Range Module Firmware Rev
1/6/00 1/6/05 0 2.2.2.2
1/6/06 1/6/11 1 2.2.2.2
1/6/12 1/6/17 2 2.2.2.2
1/6/18 1/6/23 3 2.2.2.2
1/6/24 1/6/29 4 2.2.2.2
1/6/30 1/6/35 5 2.2.2.2
1/6/36 1/6/41 6 2.2.2.2
1/6/42 1/6/47 7 2.2.2.2
1/6/48 1/6/53 8 2.2.2.2
1/6/54 1/6/59 9 2.2.2.2
1/6/60 1/6/65 10 2.2.2.2
1/6/66 1/6/71 11 2.2.2.2
Modem board HW version info:
Modem Range: 1/6/00 1/6/05 Modem Module: 0
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298557,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/06 1/6/11 Modem Module: 1
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298553,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/12 1/6/17 Modem Module: 2
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298017,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/18 1/6/23 Modem Module: 3
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298019,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/24 1/6/29 Modem Module: 4
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298200,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/30 1/6/35 Modem Module: 5
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298590,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/36 1/6/41 Modem Module: 6
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298446,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/42 1/6/47 Modem Module: 7
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298593,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/48 1/6/53 Modem Module: 8
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298233,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/54 1/6/59 Modem Module: 9
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298309,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/60 1/6/65 Modem Module: 10
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06297954,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Modem Range: 1/6/66 1/6/71 Modem Module: 11
Manufacture Cookie Info:
EEPROM Type 0x0101, EEPROM Version 0x01, Board ID 0x06,
Board Hardware Version 1.0, Item Number 73-2522-2,
Board Revision 051, Serial Number 06298008,
PLD/ISP Version 255.255, Manufacture Date 17-Jul-1997.
Error messages result if the following circumstances exist:
5800# (config)# no modem-pool test
The following example creates a modem pool called denver, assigns a pool range to denver beginning from dial shelf 6, slot 5, ports 0 and extending through dial shelf 6, slot 5, port 5 (a 6 modem boundary), and downloads from the ISF-specified path in the router shelf's Flash memory where the external portware file containing firmware version 2.2.2.2 resides:
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# modem-pool denver router(config-modem-pool)# pool-range 6/5/0-6/5/5 router(config-modem-pool)# firmware slot0:portware.2222.ios Slot 5: Firmware being upgraded to slot0:portware.2222.ios for modems in modem-pool denver router(config-modem-pool)# end router#
The string, slot0:portware.2222.ios, identifies ISF file specifier path of the external portware file that has previously be loaded in an Cisco AS5800 Flash memory device. Slot 0 is the location of the memory device. The file name is portware.2222.ios. The user has previously copied this file to Flash memory using the copy tftp flash command.
This sequence identifies and downloads bundled image file, 2.2.2.2, to all the modems in modem pool x, which is created and whose range is specified.
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# modem-pool x router(config-modem-pool)# pool-range 6/5/0-6/5/5 router(config-modem-pool)# firmware 2.2.2.2 Slot 5: Firmware being upgraded to 2.2.2.2 for modems in modem-pool x router(config-modem-pool)# end router#
This section is a command reference for the firmware command. The new command is modified to allow for downloading external portware files in addition to bundled image files. Therefore, there are two forms of the command: one for downloading a file from the bundled image, the other for downloading an external portware file.
To download a bundled firmware image or an external portware image to modem-pool range, use the firmware modem pool configuration command. To download the default bundled firmware image, use the no form of the command.
firmware {file-specifier-string | version}
file-specifier-string | (For external portware) The string that ISF-specifies the external portware file that has previously be loaded in an Cisco AS5800 Flash memory device. For example: |
version | (For bundled firmware) The string describing the bundled firmware image you want to download. This version name is usually a number, for example: |
The firmware version bundled with the current Cisco IOS software image is downloaded to the modem-pool range.
Modem pool configuration
config-modem-pool
This command first appeared in Cisco IOS Release 11.3(2)AA. The command was changed in Cisco IOS Release 11.3(6)AA to include external portware.
A valid pool range must exist (that is, the pool-range modem pool configuration command must have been configured). Modem pooling allows service providers to define, select, and use separate pools of modems within a single access server or router to enable different dial-in services for different customers. In this case, the modem pool specifies which modems are loaded with the new firmware image.
For all access servers with internal MICA modems, the modem pool commands operate only on 6-modem boundaries. (Modems are grouped together using ranges based on 6-port boundaries.)
The specified firmware image is loaded on every modem specified in the pool-range. If the modem is busy, the firmware change is deferred until the modem is available. When the modem is available, the firmware change takes place immediately.
To determine what firmware image is currently running on the modem card, use the show modem version EXEC command.
To determine a list of valid firmware images, use the show modem bundled-firmware EXEC command. If you specify a firmware image that does not exist, the information is stored so that if the modem card is updated at a later date with a modem card image that contains that firmware image it will be loaded when the modem card image boots.
At boot-up time, the default firmware image is loaded first. If there is a firmware image specified by the firmware command, it is loaded on the modem card following the loading of the default firmware image.
The following example creates a modem pool called denver, assigns a pool range to denver beginning from dial shelf 6, slot 5, ports 0 and extending through dial shelf 6, slot 5, port 5 (a 6 modem boundary), and downloads from the ISF-specified path in the router shelf's Flash memory where the external portware file containing firmware version 2.2.2.2 resides:
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# modem-pool denver router(config-modem-pool)# pool-range 6/5/0-6/5/5 router(config-modem-pool)# firmware slot0:portware.2222.ios Slot 5: Firmware being upgraded to slot0:portware.2222.ios for modems in modem-pool denver router(config-modem-pool)# end router#
This sequence identifies and downloads bundled image file, 2.2.2.2, to all the modems in modem pool x, which is created and whose range is specified.
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# modem-pool x router(config-modem-pool)# pool-range 6/5/0-6/5/5 router(config-modem-pool)# firmware 2.2.2.2 Slot 5: Firmware being upgraded to 2.2.2.2 for modems in modem-pool x router(config-modem-pool)# end router#
You can use the master indexes or search online to find documentation of related commands.
copy ios-bundled modem
copy modem
copy tftp flash
modem-pool
pool-range
show modem
show modem bundled-firmware
show modem-pool
show modem version
Posted: Tue Feb 16 19:01:37 PST 1999
Copyright 1989-1999©Cisco Systems Inc.