cc/td/doc/product/wanbu/mgx8240/rel30
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Release Notes for VCLI Version 3.0.0.9
for Cisco MGX 8240

Release Notes for VCLI Version 3.0.0.9

for Cisco MGX 8240

September 2000

Contents

Introduction

Hardware Supported

Software Compatibility

Upgrading to VCLI Release 3.0.0.9

New and Changed Information

New Software Features in Release 3.0.0.9

New Software Features in Release 2.2.8.4

Caveats

Open Caveats — Release 3.0.0.9

Resolved Caveats—Release 2.2.8.5

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.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 3.0.0.9 has all the functionality of the previous VCLI software releases. The last official release of the VCLI was Release 2.2.8.4. There is a beta release of VCLI software that was given release 2.2.8.

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 VCLI Release 3.0.0.9

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-3.0.0.9.tar.Z

vcli-upgrade-VERSION-3.0.0.9.tar.Z

The vcli-install.txt file contains instructions on how to install the VCLI from scratch ( a new install ) or upgrade and 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

Files included in the upgrade tar file are

vcli

bladeMon

snmp.mgr

ftpImage

New and Changed Information

VCLI Software Release 3.0.0.9 has all the functionality of the previous VCLI software releases. The last official release of the VCLI was Release 2.2.8.5. There have also been bug fixes to the previous 2.1.3 release.

New Software Features in Release 3.0.0.9

The following are the commands added to support switch software 3.0.0.9:

Change cescard linkinfo

Change switch sntp

Change cescard selfcheck

Show cescard linkinfo

Show switch sntp config

Show switch sntp status

Show cescard selfcheck

Show switch summary

The following commands have been changed to reflect changes to the MIBs:

Change physicalport ds3

Show cescard info

Show imccard info

Show physicalport ds3 config

Show physicalport ds1 config

Show blademon info

Add system cescard

The following commands are no longer supported by VCLI:

Change system cescard (use change cescard linkinfo instead)

Show system cescard (use show cescard linkinfo instead)

Due to the changes that occurred in VCLI Release 3.0.X, the following commands are no longer backward compatible in 3.0.0.9:

Add system cescard

Add connection pl

Change physicalport ds1

Change physicalport ds3

Show blademon info (for cescards only)

Show physicalport ds3 config

Show system cescard

This version of the VLCI will manage an MGX 8240switch with or without the presence of an IMC card. If the MGX 8240is still connected to a CIM, the VCLI will not have a problem managing the CES cards.

This version of the VCLI is also backward compatible, in that it supports all CES and IMC card software versions at or below 3.0.0.9. The software versions of the CES cards can be mixed in a chassis, and still be supported by the VCLI. The VCLI continues to support the In-Band or Out-Of-Band IP management route discovery for the CES cards. When the In-Band route is up and operational, In-Band management 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. No features that existed in previous releases of the VCLI have been removed. Please consult previous release notes and user guide documentation for the list of features.

New Software Features in Release 2.2.8.4

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. Some of these problems are covered by DDTSs which are defined below. Those items in this section that aren't covered by a DDTS are cautions and not problems.

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 explicitly specify the switched in backup card for all VCLI queries.

The VCLI has a problem with delete connection pl -epid xxxx command. It delete one end in the switch database.

The other end is still there. The work around is straight forward: type delete connection pl -epid yyy command again will delete the whole circuit(s). Here xxx or yyy can be either epid number or "all". The DDTS number for this problem is CSCdr75567.

Open Caveats - Release 3.0.0.9

DDTS Number Severity Functional Area Problem Description Comments

CSCdp39816

High

Redundancy

Unable to communicate to switched out primary and the switched in backup when the primary card is not responding to SNMP PDUs.

See note above.

CSCdm90826

High

OC3 status

The Sonet path operational status of the Access side as reported by the VCLI can be incorrect if the Access OC3 port is APS protection switched to the protection line.

Should be fine if APS is not enabled or the working line is active.

CSCsn05508

Medium

APS

VCLI displays an error if def card is invalid for command 'change cescard aps?'

Occurs only when help is requested.

CSCdp35469

Medium

IMC

The VCLI doesn't report the SW version of the backup IMC card from backup IMC. It displays the SW Version of the Primary card for the backup too.

CSCsn05671

Low

Performance

Request to increase VCLI performance when creating a pl connection

Not a bug. It's just slow

CSCsn05455

Low

Show cmds

Some show commands don't recognize that the user has entered invalid options. The VCLI ignores these options because they are not needed rather than telling the user that the options are illegal.

CSCsn04479

New feature

Useablity

Curses doesn't work - need real terminal mode for line editing. An enhancement will allow true cursor controlled line edits.

Use the built- in VCLI line editing.

CSCsn04947

New feature

Config files

Enhancements: Add capability to back up and restore config files.

CSCsn04974

New feature

Sw upgrade

Download related code should display info about user, time downloaded, where it was downloaded from etc., for record keeping.

CSCsn05072

Low

Switch database

For -network 1 options it would be better if switch names were alphabetically ordered.

CSCsn05073

New feature

Trap handling

Need to integrate VCLI's trap handling with redundancy related code. This way VCLI knows when to switch between in-band and out-of-band.

CSCdp08025

Medium

Redundancy

When the CES software has a I/O card incompatibility problem, the CES card reports a redundancy role value of '3'. This is not a legal value according to the SNMP definition of the redundancy role. When the CPE card returns this value, the VCLI displays a '-' for role.

When the I/O card is incompatible, this is a serious CPE problem, and the vcli display of a '-' is minor in comparison.

CSCdp40302

Low

Output display

The 'q' to quit command to cease the output of data to the screen doesn't work the first time for the command show physical oc3 stat.

CSCdp23296

Low

Chassis cmd

When a chassis -level command is given on the VCLI, the VCLI will go only so far before prompting user "Hit Return to Continue, 'q' and return to quit". For chassis commands, the VCLI should not stop to query user.

CSCsn05714

Low

Change cmd

When a required command line argument is not given, the VCLI should display the argument that is missing, not a generic message.

CSCdp33107

Low

Download Help

Help for the command download -card ? doesn't inform user that IMC is card 1, and CPE are cards 2-16.

CSCdr75567

Medium

Delete

Remote endpoint circuit is not deleted once.

Resolved Caveats - Release 3.0.0.9

DDTS Number Severity Functional Area Problem Description Comments

CSCdm73811

High

Connection creation

VCLI can not make connection between CES cards running different SW versions.

CSCdp35740

Medium

Connection creation

VCLI can not create a circuit from Rel 2 to Rel 1 on difference switch. Function call used to pause the Blade Monitor process.

CSCdm71570

High

Redundancy

VCLI allows configuration change to cards while their redundancy state is FBP (Force Back in Progress).

CSCdp40572

Medium

SONET Path Thresholds

VCLI cannot change the Error thresholds values for the Sonet Path level on the Channelized Access OC3 ports.

CSCdp34882

Medium

Ckt Bert

VCLI cannot set the transmit and receive bit inversion attributes for PL and SegPL type circuit BERT tests.

These attributes only apply to User data pattern configured BERT tests.

CSCdp35483

Medium

IMC

The command 'show imc info' doesn't check if backup IMC is present in the switch. Consequently if the backup card is not present the command takes several seconds to complete.

CSCdm70079

New feature

Show connections

Add feature to show what the default physical ports are when listing the connections on a card

Feature request.

CSCdm30982

Medium

Background polling

When BladeMon process fails, the redundancy status of the 1600 cards in the network gets stale without the VCLI being aware of it.

Remove the file 'blade.pid' and restart VCLI.

CSCsn05494

Low

CES card addtion

If two or more users make changes database changes to the VCLI database ( .e.,g add/delete cards, add/delete switches), then changes can be overwritten in the VCLI database.

Only a single user should make database changes.

CSCdp37110

Low

Connection creation

The VCLI will create a local pl connection without having the second endpoint specified on the command line. Both endpoints should be specified on the command line for any type of pl circuit.

CSCdm88355

Medium

Bert

The VCLI doesn't display any digits after the decimal point for the attribute PercentErrorFreeSeconds when viewing Bert Status for DS1 or Circuit Bert tests.

CSCdp33137

Low

Download cmd

In the download command, the VCLI doesn't give an informative error message, when the cardtype argument doesn't match the slot of the card.

Resolved Caveats - Release 2.2.8.5

DDTS Number Severity Functional Area Problem Description Comments

CSCdp72170

High

SW upgrade

The VCLI continues to proceed with a CES and IMC SW upgrade even though a crucial file 'contents' is not found in the directory containing the new SW images. If this file is not found, the VCLI stops the upgrade process.

CSCdp72169

High

Blade Monitor

The Blade Monitor process would stop polling the network. The fix to this was to change the UNIX function call used to pause the Blade Monitor process.

Resolved Caveats - Release 2.2.8.4

DDTS Number Severity Functional Area Problem Description Comments

CSCdp36225

High

Ascend provisioning

The stored ascend uplink string was truncated if the MGX 8240 slot was greater than 9. This prevented theascend provisioning server from creating the ATM connection in the Ascend cloud.

CSCdp38898

High

BladeMon

Illegal characters in a switch name cause the BladeMonitor to cease working properly. The VCLI now checks for legal characters in switch name when users add new switches to the VCLI database.

CSCdp38890

Medium

BladeMon

BladeMonitor was reporting the OutOfBand link to be down when the In-Band Link was up. The OutOfBand link status should be reported regardless of the In-Band link state.

CSCdp38871

Medium

BladeMon

The command show blademon info displayed the I-Band communication state to a card down twice if the OutOfBand and I-Band link were down

Resolved Caveats - Release 2.2.8.2

DDTS Number Severity Functional Area Problem Description Comments

CSCdp33196

High

IMC SW upgrade

The VCLI isn't waiting long enough for the IMC redundancy situation to settle after the backup IMC has rebooted, and is ready to become primary. The VCLI is proceeding with the upgrade of the second IMC too soon.

CSCdp02650

Medium

IMC redundancy

If the IMC card with a U1600 chassis is not available for IP communication, then the VCLI command show switch redundancy shows that it is. All other IMC commands fail.

Yes

CSCdp33191

High

IMC SW upgrade

When the VCLI initiates the upgrade on the backup IMC, if the backup IMC returns an error to the SNMP_SET request, the VCLI didn't cease the upgrade, and continued attempting to upgrade the other IMC card in the chassis.

Resolved Caveats - Release 2.2.8.1

DDTS Number Severity Functional Area Problem Description Comments

CSCdp02650

Medium

IMC redundancy

If the IMC card with a U1600 chassis is not available for IP communication, then the VCLI command show switch redundancy shows that it is. All other IMC commands fail.

CSCdp00218

Low

CES redundancy

In the show switch redundancy command, VCLI does not differentiate between configured cards that cannot be communicated with and empty slots when it cannot communicate to these cards. The vcli will show a '-' in both these cases. It should display 'unknown' for configured cards.

Yes

CSCdm73051

Medium

Connection deletion

VCLI does not delete far end endpoint of a pl type connection, when only the near end endpoint of the connection is given. But the converse is not true: both endpoints will be deleted if the farend endpoint is given on the command line

The workaround was to delete farend, or to delete both endpoints seperately.

Yes

CSCdp01075

Low

CES card addition

When a CES card is added to a switch, and that card already exists, the VCLI returns an uninformative error message.

Yes

CSCdm73801

High, Status is Closed

M13 IP address

Cmd 'change system cescard -m13?ip 0' doesn't work.

This was never a bug. Changing IP addresses requires a few seconds for the CPE card to make the change visible to the VCLI.

Setting '0.0.0.0' always works.

Yes

CSCdp00556

Low

PL ckt config

The loopback state of a PL type circuit is not shown anywhere in the VCLI. This state should be displayed in the output of the command 'show conn pl config'

Resolved Caveats - Release 2.2.8

DDTS Number Severity Functional Area Problem Description Comments

CSCsn05808

Medium

Show conn

VCLI displayed the incorrect circuit type on a backup CES card with the command show conn all sum when a backup was switched in for a primary.

CSCdm73146

Medium

Change BERT

User was unable to tell a circuit that was currently running a bert test to invert the transmit pattern. The command was change connection segpl -txpattinv on -epid <endPointid>.

CSCdm77694

High

Show CES info

In release 2.1.X of the VCLI, it didn't read the manufacturing related information attributes correctly for CES cards for the command show cescard info.

Yes

CSCdm77832

High

ATM Port stats

VCLI returned error when trying to retrieve the stats for the command show logicalport atm stat.

Yes

CSCdm77686

Medium

Show phy ds1

The row label for DS1 Frame errors didn't say that Frame Errors are measured as any second that contained a frame error. Instead, it led the user to believe that the count displayed was the actual number of frame errors.

CSCsn05790

High

Redundancy

In certain situations the VCLI used to give an error when the user attempted to put a CES card in the primary role from a role of None. A second attempt seemed to work.

Yes

CSCdm75085

High

Show OC3 sum

VCLI shows the operational state of the Sonet Path layer on the Access OC3 to be up when either the Sonet Section, Sonet Line Layers are operational down.

Yes

CSCdm82392

Medium

Change sys switch

Using the command change system switch -sname <new_name> didn't update the VCLI database files.

Yes

CSCsn05541

Medium

BladeMon

VCLI takes a long time to establish communication with CES card after the card reboots. Now it communicates within seconds after the CES card is available for communication.

CSCsn05684

Medium

BladeMon

Duplicate problem of CSCsn05541

CSCsn05781

Low

BladeMon

Exit and restart of VCLI causes delay in communicating with the CES cards in the network. Now the BladeMon process keeps in contact for the VCLI.

CSCsn05736

Low

BladeMon

Need to make BladeMonitor a stand alone application

Resolved Caveats - Release 2.1.3

DDTS Number Severity Functional Area Problem Description Comments

CSCsn05743

High

Connection creation

Connection created on switched out primary card, shows type Remote-Pl

CSCsn05744

High

Show command

Inconsistent or misleading information with show cescard info command.

CSCsn04734

High

Connection deletion

When not able to delete connection, the EPID is not given.

CSCdm60856

Medium

Switch names

Switch names cannot take the underline char.

CSCdm59553

High

Change OC3

Missing feature to change the AIS to RDI flag.

CSCsn05811

High

Switch names

Only 3 characters of the switch name are displayed on error.

CSCsn05846

High

Ds3 summary

Missing check for container down state in command show phy ds3 summary.

CSCsn05864

High

Connection deletion

Partially created circuits cannot always be deleted.

CSCsn05771

High

Redundancy

Loss of communication when redundancy state of the CES cards is in unknown state.

CSCsn05715

Medium

Connection creation

Can't delete an invalid connection.

CSCdm72267

Medium

Connection creation

VCLI doesn't show the name of the cktid when a connection is created.

CSCsn05815

Medium

User response

Acceptance of Y/y and N/n instead of complete word when user acceptance is required.

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:

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.

Access Registrar, AccessPath, Are You Ready, ATM Director, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC, CiscoLink, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Networking Academy, Fast Step, FireRunner, Follow Me Browsing, FormShare, GigaStack, IGX, Intelligence in the Optical Core, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, iQuick Study, iQ Readiness Scorecard, The iQ Logo, Kernel Proxy, MGX, Natural Network Viewer, Network Registrar, the Networkers logo, Packet, PIX, Point and Click Internetworking, Policy Builder, RateMUX, ReyMaster, ReyView, ScriptShare, Secure Script, Shop with Me, SlideCast, SMARTnet, SVX, TrafficDirector, TransPath, VlanDirector, Voice LAN, Wavelength Router, Workgroup Director, and Workgroup Stack are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, Cisco, the Cisco Certified Internetwork Expert Logo, Cisco IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Collision Free, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, FastLink, FastPAD, IOS, IP/TV, IPX, LightStream, LightSwitch, MICA, NetRanger, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries.

All other brands, names, or trademarks mentioned in this document/website 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. (0008R)

Copyright © 2000, Cisco Systems, Inc
All rights reserved.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Sat Sep 28 20:05:20 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.