|
Table Of Contents
Open Caveats - Release 2.2.8.4
Release Notes for VCLI Version 2.2.8.4
Upgrading to a New Software Release
New Software Features in Release 2.2.8.4
New Software Features in Release 2.1.3
Resolved Caveats - Release 2.2.8.4
Resolved Caveats - Release 2.2.8.2
Resolved Caveats - Release 2.2.8.1
Resolved Caveats - Release 2.2.8
Resolved Caveats - Release 2.1.3
Release Notes for VCLI Version 2.2.8.4
for Cisco MGX 8240
December 1999
Contents
Introduction
Hardware Supported
Software Compatibility
Upgrading to a New Software Release
New and Changed Information
New Software Features in Release 2.2.8.4
New Software Features in Release 2.1.3
Caveats
Open Caveats—Release 2.2.8.4
Resolved Caveats — Release 2.2.8.2
Resolved Caveats — Release 2.2.8.1
Resolved Caveats — Release 2.2.8
Resolved Caveats — Release 2.1.3
Related Documentation
Hardware Documents
Software Documents
Cisco Connection Online
Documentation CD-ROM
Introduction
The Virtual Command Line Interface (VCLI) is a management application that runs on UNIX. It manages the MGX 8240 switches in the network. All 8240 features are supported from the VCLI. The VCLI is independent of all other management applications that Cisco provides.
VCLI Software Release 2.2.8.4 has all the functionality of the previous VCLI software releases. The last official release of the VCLI was Release 2.1.3. There is a beta release of VCLI software that was given release 2.2.8.
Release 2.2.8.4 fixes problems with the SW upgrade for IMC cards. Those problems are described below in the list of Caveats.
Hardware Supported
All released hardware components of the MGX 8240 are supported.
Software Compatibility
There are no compatibility problems between this VCLI release and previous ones. This release should replace all earlier releases.
Upgrading to a New Software Release
The VCLI software is distributed on the VCLI CD and contains three files listed below. The files that have the `.tar.Z' suffix are compressed UNIX archive files. These files are uncompressed using the UNIX "uncompress <filename>" command, and un-archived using the "tar xvf <filename>" command.
vcli-install.txt
vcli-new-VERSION-2.2.8.4.tar.Z
vcli-upgrade-UPGRADE-2.2.8.4.tar.Z
The vcli-install.txt file contains instructions on how to install the VCLI from scratch (a new install) or upgrade an existing VCLI release.
Files included in the new install tar file are
vcli
bladeMon
snmp.mgr
vpasswd
ftpImage
image
vcliSetup
vpasswd
Files included in the upgrade tar file are
vcli
bladeMon
snmp.mgr
ftpImage
New and Changed Information
New Software Features in Release 2.2.8.4
Two major items new to this release are support for the newly introduced IMC card in the Cisco MGX 8240 switch, and significant enhancement to the background polling task functionality. There have also been bug fixes to the previous 2.1.3 Release.
The IMC card is the management card in the chassis, and compared to the CES cards has very few features to be managed. The VCLI supports the IMC redundancy feature, the MIB II system group table, and software upgrade. The IMC card cannot be managed in-bandin release 2.2.X of the Cisco MGX 8240 switch software. The IMC card replaces the CIM product that was shipped with all Cisco MGX 8240 switches.
New VCLI commands were added to support the IMC, including:
VCLI>> show imccard info
VCLI>> show imccard config
VCLI>> change imccard config
VCLI>> show imccard redundancy
VCLI>> change imccard redundancy
VCLI>> change imccard image
The background polling feature is referred to as BladeMonitor. In previous releases, background polling was done as part of the VCLI task process. Starting with this release, the VCLI will spawn a BladeMonitor sub-process. As a separate process, one BladeMonitor process will support all VCLI sessions that are started. The BladeMonitor process will continue to poll all cards and switches in the network while at least one VCLI session is active. The BladeMonitor process terminates itself after a few seconds when it detects all VCLI processes have been terminated. New features for the BladeMonitor are more efficient network polling, the ability to see how the BladeMonitor is interpreting network connectivity, and the BladeMonitor's own performance statistics.
New VCLI commands that were added to support the BladeMonitor, including:
VCLI>> show blademon statistics
VCLI>> show blademon information
This release of the VCLI will manage an Cisco MGX 8240 switch with or without the presence of an IMC card. If the Cisco MGX 8240 is still connected to a CIM, the VCLI will not have a problem managing the CES cards.
This release of the VCLI is also backward compatible; it supports all CES and IMC card software releases at or below 2.2.X. The software releases of the CES cards can be mixed in a chassis, and still be supported by the VCLI. The VCLI continues to support the in-bandor out-of-band IP management route discovery for the CES cards. When the in-bandroute is up and operational, in-bandmanagement continues to be the preferred route of all management traffic between the VCLI and the CES cards.
This release builds upon all other features of the VCLI. Features that existed in previous releases of the VCLI have not been removed. Please consult previous release notes and user guides for the list of features.
New Software Features in Release 2.1.3
The features in VCLI Release 2.1.3 are described here, and still apply. These descriptions remain as part of the VCLI 2.2.8.4 release notes to continue to describe all the new features since the last major VCLI release which was 2.0.X.
New in Release 2.1.3 of the VCLI is support for both CES card hardware types. The two types of CES cards that this release of the VCLI will support are
1. The original CES card type that supports the original I/O card with 3 channelized DS3s, and two OC3 ports.
2. The new CES (called the CS3) card type which can support the original I/O card type, as well as the new I/O card type with 4 OC3 ports (the DS3 ports are contained within the OC3 port).
Caveats
These are known problems and cautions with this release of the VCLI.
There is a known problem with the VCLI: it allows users to change the redundancy role of primary card to a role of `none', while the primary card is in the process of being forced back into service. The VCLI should not allow this change while the card is in this redundancy state. Changing the redundancy role of the primary card while in this state could cause a problem with the configuration database of the primary card. The DDTS number for this problem is CSCdm71570. There is no work around for this problem.
The VCLI has a problem with a switched out primary card when the primary card is not responding to SNMP PDUs. The VCLI should divert all user queries to the switched in backup card in this scenario. But instead the VCLI reports that it cannot communicate with the switched out primary. This is most likely to occur when the primary card is pulled out of the switch. The DDTS number for this problem is CSCdp39816. The work around for this is to specify the switched in backup card for all VCLI queries.
There is a problem for the VCLI creating Private Line circuits between two CES cards in two different switches when one card is running Release 1.1.2.10, and the other is running Release 2.X. The order of how the two endpoints are specified is important. When creating a circuit with the described scenario, the user must specify the Release 1.x release as endpoint 1. There is no problem if the two endpoints are on the same switch. DDTS CSCdp35740 identifies this problem.
To accommodate two card types in the same switch chassis, the upgrade procedure was changed from the previous releases of the VCLI. Previous releases of the VCLI updated the CPE card Software only. This release upgrades the Software for both IMC and CPE card types. This requires that the contents of the tar files, which contain the Software upgrades, have a new directory format. VCLI release 2.2.8.4 cannot use a Tar file built with the old directory format. All CPE and IMC card Software upgrade Tar files, beginning with release 2.2.0.3 of CPE and 2.2.0.11 of IMC, have this new format.In this release of the VCLI, the background polling process is a separate task from the VCLI process. The background polling process is called the BladeMon. The BladeMon process updates a file called `blade.db'. All VCLI processes read this file to get switch and blade connection information (e.g. whether to use the in-bandor OutOfBand interface to a CPE card). The BladeMon process can die. It doesn't happen unless it was explicitly terminated, or there was a UNIX related system problem. When it dies, the VCLI processes can't detect that it has died if the file `blade.db' remains. The VCLI processes continue to operate as before using whatever old information is in the `blade.db' file. This can remain for days, and not cause a problem. The symptom that is most common when this scenario occurs is that network additions/deletions or redundancy changes will not be reflected in the VCLI. The VCLI will continue to read the information that was present in the `blade.db' file when the BladeMon process died. DDTS CSCdm30982 chronicles this defect.Fixing the problem is easy. When this occurs, the `.blade.pid' file must be manually removed using the UNIX command "rm .blade.pid", and the VCLI restarted. When the VCLI restarts, it will restart the BladeMon process, which will read the VCLI switch database. Upon startup of the BladeMon process it will query all CPE and IMC cards in the network to quickly rebuild the `blade.db' file with fresh information. Old VCLI processes need not be terminated while this is going on. If they are terminated there is no problem.Resolved Caveats - Release 2.2.8.4
Resolved Caveats - Release 2.2.8.2
Resolved Caveats - Release 2.2.8.1
Resolved Caveats - Release 2.2.8
Resolved Caveats - Release 2.1.3
Related Documentation
Hardware Documents
Cisco MGX 8240 Hardware Installation Guide, DOC-7810084=. Gives information on installing the MGX 8240 chassis, including physical connectivity, logical connectivity, and cabling.
Cisco MGX 8240 Hardware User's Guide, DOC-7810083=. Gives theory of operations and usage information on the MGX 8240. Details physical description, traffic management, and FDOS.
Software Document
Cisco MGX 8240 VCLI User's Guide, DOC-7810082=. Gives information on installation and use of Virtual Command Line Interface (VCLI) for MGX 8240. Details installation, provisioning, and specific commands for the VCLI.
Cisco Connection Online
Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.
Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.
CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.
You can access CCO in the following ways:
•WWW: http://www.cisco.com
•WWW: http://www-europe.cisco.com
•WWW: http://www-china.cisco.com
•Telnet: cco.cisco.com
•Modem: From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.
For a copy of CCO's Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.
Note If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.com.
Documentation CD-ROM
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more current than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
If you are reading Cisco product documentation on the World Wide Web, you can submit comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco. We appreciate your comments.
This document is to be used in conjunction with the documents listed in the "Related Documentation" section.
Access Registrar, AccessPath, Any to Any, AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC, the Cisco logo, Cisco Certified Internetwork Expert logo, CiscoLink, the Cisco Management Connection logo, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Capital, the Cisco Systems Capital logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, the Cisco Technologies logo, ConnectWay, Fast Step, FireRunner, Follow Me Browsing, FormShare, GigaStack, IGX, Intelligence in the Optical Core, Internet Quotient, IP/VC, Kernel Proxy, MGX, MultiPath Data, MultiPath Voice, Natural Network Viewer, NetSonar, Network Registrar, the Networkers logo, Packet, PIX, Point and Click Internetworking, Policy Builder, Precept, ScriptShare, Secure Script, ServiceWay, Shop with Me, SlideCast, SMARTnet, The Cell, TrafficDirector, TransPath, ViewRunner, Virtual Loop Carrier System, Virtual Service Node, Virtual Voice Line, VisionWay, VlanDirector, Voice LAN, Wavelength Router, Wavelength Router Protocol, WaRP, WebViewer, Workgroup Director, and Workgroup Stack are trademarks; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, The Internet Economy, and The New Internet Economy are service marks; and ASIST, BPX, Catalyst, Cisco, Cisco IOS, the Cisco IOS logo, Cisco Systems, the Cisco Systems logo, the Cisco Systems Cisco Press logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, FastLink, FastPAD, FastSwitch, GeoTel, IOS, IP/TV, IPX, LightStream, LightSwitch, MICA, NetRanger, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries. All other trademarks mentioned in this document are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any of its resellers. (9911R)
Copyright © 1999, Cisco Systems, Inc.
All rights reserved.
Posted: Wed Aug 25 16:21:05 PDT 2004
All contents are Copyright © 1992--2004 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.