Guest

Cisco Element Manager System

Release Notes for Cisco Element Manager System 3.1

  • Viewing Options

  • PDF (465.2 KB)
  • Feedback
Release Notes for Cisco Element Management Framework v3.1

Table Of Contents

Release Notes for
Cisco Element Management Framework v3.1

Contents

Introduction

Northbound Event Interfaces

CORBA Gateway

Event Manager

Introduction of Versioned Shared Libraries

System Requirements

Software Compatibility

Enhancements in this Release

Backup Mechanism

Known issues

Future enhancements

Known Limitations in the Release

Cisco EMF CORBA Gateway Runtime component

How to remove the Orbix demon from Cisco EMF process control

Installation

Important Notes

Default Backup Directory

Desktop Color Setup

Caveats

Open Caveats

Resolved Caveats

Resolved Between Cisco EMF v3.1 EFT and This Release

Caveats Resolved By Cisco EMF v3.0 Patches Applied Between Cisco EMF v3.1 EFT and This Release

Bugs Fixed in CEMF 3.0 Patch 7

Bugs Fixed in CEMF 3.0 Patch 6

Bugs Fixed in CEMF 3.0 Patch 5

Bugs Fixed in CEMF 3.0 Patch 4

Troubleshooting

Documentation Updates

Installing Cisco EMF

Firewall Configurations

TAC Support Tool

Updating Server

Errors

Upgrading Cisco EMF

Omissions

Related Documentation

Cisco Connection Online

Documentation CD-ROM


Release Notes for
Cisco Element Management Framework v3.1


Contents

This document is divided into the following sections:

"Introduction" section

"System Requirements" section

"Enhancements in this Release" section

"Known Limitations in the Release" section

"Installation" section

"Important Notes" section

"Caveats" section

"Troubleshooting" section

"Documentation Updates" section

"Related Documentation" section

"Cisco Connection Online" section

"Documentation CD-ROM" section

Introduction

Cisco Element Management Framework (Cisco EMF) is the homogeneous element management layer of the Cisco Internet Operation Support System (OSS) building on and adding to the Cisco EMF v3.0 product functionality. It comprises a highly scalable framework designed to support carrier-class Element Managers (EMs) across Cisco's service-provider product lines with network event management. This flexible, modular model allows Service Providers to install the mix of Element Managers they need to support their dynamic businesses. It also enables rapid development and deployment of new Element Managers, permitting Service Providers to more rapidly introduce and manage new services.

Cisco EMF provides common interfaces and element management services to applications in the network and service management levels of Cisco Internet OSS. Cisco's EcoSystem partners can also build third-party element management systems to provide element management support in mixed network environments.

Cisco EMF v3.1 end customer functionality focuses on integrating and bundling the Event Manager application and improving the northbound event interfaces supported by the framework to further enhance integration of Cisco EMF into customers' OSS environments.

Northbound Event Interfaces

Forwarding of Cisco EMF Events encapsulated in SNMP Traps to any SNMP Network Management System.

For example, with HP-OEMF Version 4.0, the information on both the managed network and the events occurring within the managed network is passed northbound to the HP-OEMF umbrella fault management system, and the managed network in the form of Cisco EMF Object Model is exported via a flat file.

CORBA Gateway

CORBA Gateway v2.0 introduces support for a CORBA event feed to enable asynchronous event notification from Element Managers to external CORBA clients. The event feed supports the ability to specify interest registration, via an appropriate filtering mechanism.

Event Manager

The Event Manager is integrated as a constituent part of Cisco EMF v3.1 functionality. The main benefits of the Event Manager functions are:

A more intuitive and flexible view of current network status via user-defined Event Groups and Scoreboards.

Notification of event status via external media such as fax, e-mail, pager.

Sophisticated thresholding capability to enable the user to capture events which may not be proactively indicated by the network. This is particularly useful for network elements which do not issue a large number of SNMP traps.

Introduction of Versioned Shared Libraries

In addition Cisco EMF v3.1 introduces versioned libraries. This is a key technology enhancement which significantly increases the ability for Cisco to make library patches and maintenance releases to the framework where previously a full, minor release would have been required. This directly improves the longevity and stability of deployed software, for example allowing framework bugs that are affecting an Element Manager to be patched live without impacting other Element Managers deployed on the same platform.

System Requirements

Cisco EMF can be deployed in a number of different configurations, from a single hardware system to a multi-site management system, using Sun Solaris/SPARC hardware with Solaris, Release 2.6.

Software Compatibility

Cisco Element Management Framework v3.1 is compatible with the following:

Cisco EMF-Software Development Toolkit v1.3

Cisco EMF CORBA Gateway Developer Toolkit v2.0

Enhancements in this Release

1. The Northbound Event Interface has been added in order to provide generation of events based on Cisco EMF alarms in the form of SNMP v1 traps and/or ASCII event records. Refer to the Northbound Event Interface section in the Cisco Element Management Framework Installation and Administration Guide, Part Number 78-10792-01 for more information.

2. The CORBA Gateway has been enhanced as follows:

CORBA Notification Service to forward events related to faults and information

Creating, deleting, populating and using object groups

Security

ORB runtime has been updated to Iona Orbix v3.0.1

Synchronous access to the Data Abstractor


Note Please refer to the Cisco EMF CORBA Gateway Developer Guide (part of the CORBA Gateway Development Kit) for more information.


3. TAC Support Tool

4. Ability to restore databases onto a different machine

5. Ability to change hostname and/or IP address of machine

6. Authentication level security of SNMP v3

Backup Mechanism

The backup mechanism has been modified in Cisco EMF 3.1 to ensure that database integrity is maintained for backup and restore. This is not the case in releases prior to Cisco EMF 3.0 Patch 9.

Before a backup commences, Cisco EMF locks deployment, alarm processing, installation and changes to the object model. They are unlocked when backup ends.

Messages relating to this are displayed while a backup is in progress.

During a backup, the user will not be able:

to provision new objects but those objects that are in the process of being created will be allowed to complete. In Cisco EMF 3.1 Patch 1, new provisioning requests will be queued rather than rejected by Cisco EMF.

to delete objects

to install/deinstall work packages. A backup will not be allowed if an installation/de-installation is in progress.

to rename/reparent objects. Alarm processing will be suspended periodically so the user may see a delay between the time an alarm is sent from the device to being seen in an application such as the event browser.

Known issues

1. Patching locking

Patching and backing up must be mutually exclusive to avoid configuration file inconsistencies in the restored system. Therefore, we advise to avoid patching Cisco EMF around times of backup.

2. ObjectGroup locking

Object groups can be modified by the GUI while backup is in progress so the user may need to repopulate the Object Group when databases are restored.

Future enhancements

In this release, Cisco EMF fails attempts to provision when backup is in progress. In Cisco EMF 3.1 Patch 1, Cisco EMF will buffer new requests until it is safe to resume.

Known Limitations in the Release

Cisco EMF CORBA Gateway Runtime component

Iona Orbix issue : If Cisco EMF is installed on a Sun workstation which is not running Domain Naming Service (DNS), the Cisco EMF-CORBA Gateway Runtime Server fails to start.

Workaround: either

re-install Cisco EMF, and when asked for a domain press Return, this enters an empty string. Do not re-install Orbix

or

install Cisco EMF only on workstations which run DNS.

How to remove the Orbix demon from Cisco EMF process control

Some clients may wish the CORBA Orbix demon to run constantly even after Cisco EMF has shutdown. To do this the client must execute the following commands:

> cd <CEMF_ROOT>

> mkdir backupProcessFile

> cd config/processes/

> mv S08orbixd_3.0.x /<CEMF_ROOT>/backupProcessFile/.

> cd <CEMF_ROOT>/bin

> sysmgrClient -k orbixd

> <CEMF_ROOT>/Orbix/bin/orbixd -s &

where <CEMF_ROOT> is substituted for the current installation directory.

Installation

The Cisco Element Management Framework Installation and Administration Guide Version v3.1, Part Number 78-10792-01, provides information to install, license, and configure the product and includes detailed administration tasks.

Important Notes

Default Backup Directory

If the default installation settings were used to install v3.0, the default backup directory has changed between versions as follows:

Cisco EMF v3.0 default backup directory
Cisco EMF v3.1 default backup directory

/opt/AVBackup

/opt/Backup


Desktop Color Setup

Cisco EMF uses the color setup of your display. If your system is set up to display text in white, this may give problems in some Cisco EMF applications, for example on an event group icon in the Event Groups application. To avoid this, select the default color configuration.

Caveats


Note Cisco EMF v3.1 incorporates all resolved bugs and fixes incorporated in Cisco EMF v3.0 Patches 4 to 7.



Note This section provides concise descriptions of the problems which have been identified upto the date the software is released. Cisco EMF v3.1 is constantly improving, and caveats will be resolved and workarounds provided after the release date. For the most up-to-date information refer to the Release Note and Customer Note enclosures provided in DDTS on Cisco Connection Online.


Open Caveats

CSCat08870

Problem: The path is not getting updated while adding objects.

Cisco EMF provides the feature to allow more than one reference to an object to exist in the same view. For example:

Physical:/Site-1/object1

Physical:/Region-2/object1

Some applications, for example the Map Viewer, will display the path of the current object being displayed in the title bar. This is often the first containment path which can be found in the current view.

The fact that a new path which is given to an object, for example by adding it beneath another object, is not displayed in the Map Viewers title does not mean that the path does not exist.

Workaround: This can be checked by expanding the view on the left hand side of the Map Viewer to find the references to an object.

CSCat10881

Problem: ./avload -remove does not clear profileContainment for Element Managers.

It is possible to design Element Manager dialogs which allow profiles to be created and used. Profiles in this context are pre-defined values for a number of attributes, which can be applied to one or more objects.

If such profiles are created using an Element Manager dialog, and the Element Manager is removed from Cisco EMF, the profiles will not be removed from the system.

When the same Element Manager is subsequently reinstalled, the profiles from before may be visible again, though they may not operate correctly.

Workaround: The workaround is to remove all profiles manually, by using the Delete Profile option on the Edit menu in the relevant dialogs, prior to normal removal of the Element Manager.

CSCat11245

Problem: Selection of Objects when Invoking a Controller Action

Element Manager dialogs can be designed using Cisco EMF-SDK to allow actions to be launched on particular objects, by presenting a button for the user to press. In some cases, the action may be a scheduled one, in which case the user is prompted for the time at which the action should be carried out.

Once the correct date and time have been entered, the objects upon which the action will be invoked will be the objects selected in the Element Manager dialog at that time. If the user changes the object selection after the schedule dialog appears, then the new selection of objects will be used.

Workaround: None

CSCat11186.

Problem: Auto Discovery and Changing IP Addresses

If you need to change the IP Address of a managed object in Cisco EMF, special care is required to ensure the correct operation of Auto Discovery. The reasons for this are described briefly below, along with simple steps which can be taken to change addresses consistently.

When a managed object in Cisco EMF has an IP Address, this information is normally stored as an attribute of the object. However, Auto Discovery also records this IP Address by using it for the object name inside the Network view.

If you need to change the IP Address of an object which Auto Discovery is aware of, then it is also important to rename the object in the Network view. When you attempt to change the IP Address using Object Configuration, a warning to this effect is given.

Similarly, if a user renames an object in the Network view, this should only be done because the IP Address has changed. The new name should be the new IP Address of the object, and this address should also be set using Object Configuration. When a user attempts to rename an object in the Network view, a warning to this effect is given.

If the IP Address of an object is only changed by setting the IP Address attribute using Object Configuration, then the following will occur:

a. It will be possible for Auto Discovery to be used to rediscover the object via its new address, because only the old address is mentioned in the Network view. This will result in two managed objects with the same IP Address, which could be confusing.

b. It will not be possible for Auto Discovery to be used to discover an object which has the old address, because the old address is still mentioned in the Network view. It might be that this discovery operation is attempted by a completely different user, much later than the IP Address change, which would cause confusion.

If an object is renamed to a new address within the Network view, without changing the IP Address attribute, then any attributes which are retrieved in respect of the object which rely on the IP Address will continue to be retrieved using the old address, contrary to what a user might expect by looking in the Network view.

Workaround: To change the IP Address of a managed object while avoiding the above is simple:

Step 1 Set the new address using Object Configuration, which is available under Tools from the popup menu in the Map Viewer.

Step 2 Rename the object, by selecting Rename Object, which is available under View Manipulation from the popup menu in the Map Viewer. This can be launched from any occurrence of the object in a View; there is no need to find the object in the Network view, as the Rename dialog will show all occurrences which can be renamed.

The following documentation may be useful, in the section Managing Objects in Cisco EMF in the Cisco EMF v3.1 User Guide and Help system:

Viewing and Opening Object Configuration

Renaming an Object


Note The above does not apply when the change of IP Address would imply that the object has been moved from one network to another. In this situation, we would recommend that the object be deleted and then recreated.



Note If the IP Address of an object is changed using Object Configuration, a dialog will appear to remind the user to rename the object, and to confirm that the change in address should go ahead. No such warning will appear in Element Manager dialogs which have been created using Cisco EMF-SDK.



CSCat15584

Problem: User can not move up the container hierarchy while focus is on an object itself

In the Map Viewer application, the up arrow key can be used to move the cursor up the View representation on the left hand side.

However, if the keyboard focus is on the Map on the right hand side, the up arrow key will do nothing.

Workaround: To show a map for a higher level within the view, the appropriate object should be selected on the left hand side, or the up arrow on the toolbar should be clicked using the mouse.

CSCat16798

Problem: Upgrade Unix EM produces two options for av install -r - DEP. This occurs in the case when the Unix Manager Element Manager is installed on Cisco EMF and an upgrade for this Element Manager is installed.

When trying to remove the Element Manager from the system two options will be selectable, the original version and the upgraded version, even though only the upgraded version is installed.

Workaround: Selecting either option for removal will successfully remove the Unix Manager Element Manager from the system.

CSCat17526

Problem: Availability of Popup Menu Options in Applications

Some applications allow a popup menu to be shown for objects in the system, so that further applications can be launched.

In some cases, features will appear to be available from these menus, when they are not applicable to the user. However, security is maintained when the user actually selects an option, because at this point a check is made to ensure that the feature is genuinely available.

Workaround: None

CSCat17594

Problem: discoverySchedule interval ignored if Cisco EMF is restarted. This means that Cisco EMF does not remember when the last scheduled discovery took place if Cisco EMF is stopped and restarted.

For example, this is observed when a discoverySchedule file is added with a StartTime of say 11:00 am; and a Period of 100 days. If this schedule has already been run in the previous day, and Cisco EMF is stopped (./cemf stop) and restarted, it will be rerun on the day Cisco EMF is restarted when 11:00 am rolls around.

Two significant consequences of this are:

a. scheduled discovery precludes the use of auto discovery thereby blocking a user's actions.

b. Discovery may consume a large amount of machine resources unexpectedly.

Explanation: This is expected system behavior. The Auto Discovery application does not record when scheduled discoveries are run. All discovery scheduler timers are restarted following restarts and so discoveries will next to be run when their start time is reached.

If Cisco EMF is restarted, all scheduled discoveries will be run when their start time is next reached. This means if we have a discovery scheduled for 11am every seven days, and two days after this scheduled discovery has been run, Cisco EMF needs to be restarted, the next time this scheduled discovery will be run, will be at the next 11am reached and not in five days time.

Workaround: None

CSCat17589

Problem: ./cemf session succeeds without any Cisco EMF processes running.

If the user attempts to start a session on a Cisco EMF Client installation, when the corresponding Server has not been started, the session will fail to open and no error will be displayed. It may also be necessary to cancel the operation using the CTRL-C interrupt sequence.

Workaround: The workaround is to ensure that the Server installation is running properly before attempting to start the session on the Client.

CSCat17732

Problem: [CSCdp31915] accelerator keys in most of the places are not working

Use of Accelerator Keys in Applications

It is common for applications to allow some menu options to be selected by use of accelerator keys, for example, Ctrl+Q. In some applications within Cisco EMF, these short keys will fail to operate.

Workaround: In such cases, this is not a failure of the operation: simply choose the option from the correct menu using the mouse, and it will be available.

CSCat16465

Problem: Parsers should check type of file before parsing

Symptom: Cisco EMF can fail to start properly or fail to de-install.

Condition: 'Rogue' files are put into directories that are parsed by Cisco EMF. Examples are core files, corrupt files and duplicate files. This condition is most likely to happen during development.

Workaround: Ensure that only the correct file types are in the assigned directories.

CSCat19696

Problem: Object Group Manager hogs the processor when a query on all objects-DEP

Symptom: The system can become unresponsive after running a query.

Condition: The query specifies all objects in a view and all object types.

Workaround: Queries based on many types should not be performed on large scopes.

CSCat19751

Problem: Alarms loading in acked state when they haven't been acked

The Event Browser application can be used to acknowledge events. Problems can occur if the same Cisco EMF user runs several sessions, each with an Event Browser opened on a different object. This can happen, for example, when several people log in as the admin user, Event Browsers in one session may appear to show events as acknowledged, as a result of events being acknowledge in a browser in another session, even though it may be on a different object. This does not occur when a different Cisco EMF user is logged in to each session.

Workaround: If the Event Browser is believed to show incorrect information, the refresh option can be selected to remedy this.

CSCat20378

Problem: [CSCdr88128] site objects are allowed to be deployed on network tree

Symptom: Class-site objects can be incorrectly deployed via the Corba Gateway.

Condition: It is possible to incorrectly deploy an object of class site in the Network view through the Corba Gateway. It should not be possible to place objects of that class in the Network view.

However, at the moment it is the responsibility of the CORBA client to follow containment rules correctly in the absence of platform validation.

Workaround: There is currently no workaround for this.

CSCat20391

Problem: Access Manager allows the user to delete the other users.

When a user has been given sufficient privileges to change other users' passwords in the Access Manager, then such a user will also be allowed to delete other users.

Workaround: Care must be taken when allowing this level of access, to ensure that users will only be deleted when this is really desired.

CSCat20699

Problem: Possible core dump if you delete an alarm group while you edit it

This issue relates to editing an event group in the Event Groups application (available by selecting 'Event Groups' from the Cisco EMF Launch Pad).

While a user is editing the notification profiles assigned to an event group:

- if the user closes the event group editor

- or if the same user or another user deletes the same event group

Then the Event Groups application can exit if the Finish button is clicked on the Notification Profile Dialog that will still be open.

Workaround: The workaround is to click the Cancel button instead of the Finish button.

CSCat20783

Problem: Get told the trigger condition has changed when it hasn't

This issue relates to editing an event group in the Event Groups application (available by selecting 'Event Groups' from the Cisco EMF Launch Pad).

When one user edits an event group, any other user who is editing the same event group (or the same user editing the event group with a second editor) will be informed of the changes that have been made to the event group.

No matter what change has been made, the second user is always informed that the trigger conditions have changed. For example, if user1 only edits the name, user2 is informed that the name and the trigger conditions have been changed.

The user should be aware that, in these circumstances, if they are informed the trigger conditions have changed, they may not have.

Workaround: None

CSCat20890

Problem: [CSCdr57032] Auto discover SNMP community strings wrong

Symptom: The user is unable to save configuration changes to auto discovered devices.

Condition: During auto discovery, the system sets the read/write community strings to the first community string to which a device responds. By default, this will be public. The device will fail to save any configuration changes while the write community is set to this value.

Workaround: To avoid the condition, in the Auto Discovery dialog, remove the public community string and then add the private community string to the community list. Then, auto discovering as normal will set both community strings to private which should allow configuration changes to be made.

To resolve the condition, the write community can be set to private by using the relevant Object Configuration dialog for the device.

CSCat21046

Problem: The command "./cemf install -o -fullhelp" does not work correctly.

Symptom: The commands "cemf help full" and "cemf install -o fullhelp" do not appear to work.

Condition: When running "cemf help full" or "cemf install -o fullhelp" an error is returned.

Workaround: The command "cemf install -o fullhelp" is erroneous and should not be used.

There is no workaround for command "cemf help full". However, standard help can be requested by running "cemf help".

CSCat21116

Problem: 2 scheduled discoveries within same address range - neither takes place

Auto Discovery can read schedules from an initialisation file and carry out operations as a result.

However, when one of these scheduled operations fails, the resulting behavior is not defined.

Workaround: The workaround is to arrange that when multiple operations are scheduled, they are not dependent on any other operation having completed successfully, reducing the likelihood of failure.

CSCat10080

Problem: deploymentWizard:- Problem error reporting when attrs fail

Symptom: If an object is deployed, and the deployment fails to set some attribute values, Cisco EMF will report this. However it may also report that the object could not be added to one or more views.

Conditions: If objects are deployed and one or more of the attributes on those objects fail to have their values set as part of this deployment, then the status message may also indicate that the object could not be added to one or more views.

Workaround: The misleading error message regarding view failure can be safely ignored.

CSCat10863

Problem: Batching problems with ObjectFileParser - DEV

Symptom: Objects deployed via file can fail to be unloaded if deployment fails.

Conditions: /config/init/objectFileParser.ini has a "MaxPerContext" setting that defaults to 100. If more than this number of objects are loaded into Cisco EMF using the objectFileParser, and one or more of the specifications contains an error, then some of the previously loaded objects will not be unloaded.

Workaround: Ensure that object specification files loaded using objectFileParser contain less than 100 object specifications.

CSCat11631

Problem: if corba client dies while processing context, part cycle will hang

Symptom: Participation does not proceed when a participant does not receive the participation context.

Conditions: If a controller (which is a participant) crashes while it has the participation context, participation will not proceed as the next participant will not receive the context.

Workaround: Cisco EMF clients (e.g. EMs) written to be participants in the Cisco EMF deployment process must return the deployment context to the participation cycle. This allows deployment to proceed to the next participant in the cycle. Cisco EMF will be enhanced in the future to take account of the case where a controller may crash during deployment, and to react accordingly.

CSCat11945

Problem: Deployment wizard hangs when deploying 8000+ objects.

Symptom: Deploying or deleting more than 100 objects in the same deployment context may sometimes cause the operation to fail.

Conditions: Currently within Cisco EMF there is a limit of 100 objects that can be contained within a participation context. Exceeding this limit may result in a participant failing to de-serialize the context, and the deployment or deletion operation may fail as a result of this.

Workaround: Ensure that a participation context contains no more than 100 objects.

CSCat15078

Problem: Installation appears to attempt license key copy even if answered "n".

Symptom: During Cisco EMF installation, if the response to the question "Do you have a valid license key?" is "n", a message similar to the following will be seen:

AccessVision License Installer... Installing /opt/cemf/config/licenses/* Cannot find license file /opt/cemf/config/licenses/*

Conditions: Cisco EMF installation is being performed and no valid license key is provided by the person carrying out the installation.

Workaround: The message simply confirms that no license file was found, and that no license key has been copied. It can therefore be ignored.

CSCat16142

Problem: class action checking in avload needs to be switched on

Symptom: If an error occurs during installation, the errors are correctly reported, but are followed by a misleading message saying that installation was successful.

Conditions: Cisco EMF installation is being performed and an error occurs.

Workaround: This message should be ignored if previous errors have been reported.

CSCat16379

Problem: EM installation overwrites files, and could cause problems.-DEP

Symptom: Installing an EM may result in all of its configuration files not being parsed. Deinstalling the EM may then leave Cisco EMF in an inconsistent state.

Conditions: If an EM includes files of the same name as those present in the default Cisco EMF installation, they will not be re-parsed when the EM is installed. De-installing the the EM will remove these files, which could leave Cisco EMF in an inconsistent state.

Workaround: EMs should add new files where possible, rather than overwriting standard Cisco EMF files.

CSCat16645

Problem: EM deinstallation unable to remove the Object Group

Symptom: When an Element Manager is de-installed from Cisco EMF, an error may be reported that an object group failed to be removed.

Conditions: If object groups are created as a result of installing an Element Manager, then de-installing the Element Manager will not remove those object groups. Cisco EMF will indicate that they could not be removed.

Workaround: This error can safely be ignored as it has no detrimental effect on the system. Object groups are not removed as part of an Element Manager de-installation, so that when the same Element Manager is installed again, then the object group will not need to be created as it already exists.

CSCat16965

Problem: PAS could cause problems for OSTransactionControl users

Symptom: Client code can cause ObjectStore exceptions to be thrown.

Conditions: After retrieving a persistent pointer, client code may call a function that updates the PersistentAttributeStore instance. If afterwards, the client code does not request the persistent pointer again, but instead reuses the original address, the original address may now be invalid and so could cause the client code to throw an objectStoreexception.

Workaround: Ensure that client code retrieves pointers to persistent data each time it is needed, or whenever subsequent calls have been made to code that may update the persistent attribute store.

CSCat17258

Problem: attribute value cache persists between runs of nbinterface

Symptom: The Northbound Event Interface's databases grow in size after registering and deregistering of many filters

Conditions: The client registers and de-registers many filters which have many objects in their scopes.

Workaround: The client can deregister all the filters, then stop Cisco EMF, delete the databases:

/db/nbinterfaceCache.db & /db/nbinterfaceOGM.db

The client will have to re-start CEMF then re-register its filters.

CSCat17988

Problem: dump file in /tmp is not updated when new objects are deployed in Viewer

Symptom: When exporting an object within the domain of the Northbound Event Interface, newly created objects are not always present in the dump.

Conditions: A dump on a NEI filter is done a second time, and the objects satisfying the filter's containment scope have changed since the first dump.

Workaround: The filter needs to be de-registered and then re-registered before performing the second dump.

CSCat18004

Problem: [CSCdr42275] IP Address Range Query Problem

Symptom: It is not possible to perform IP address range queries.

Conditions: Attempting to perform an IP address range query through the LocalQueryManagerInterface class.

Workaround: None

CSCat18505

Problem: Query editor not updating when a map object is deleted.

Symptom: Query editor is not updated when a map object is deleted.

Conditions: When a map object that is used by an event group (the event group is collecting events on that map object) is deleted, and the Query Editor is launched on the event group, the Query Editor prompts to save the changes to the query event though the query has not been changed.

A side-effect of this is that the databased event group may retain the deleted map object.

Workaround: Re-run the query containing the deleted object.

CSCat18940

Problem: AHS under heavy load

Symptom: Historical data of some objects' attributes are not being stored.

Conditions: Cisco EMF is under extremely heavy load due to performance polling, and a History Storage Criteria uses an Object Group.

New objects to be polled are added to the storage Object Group while in the order of 1000 attributes are being polled per second. The new objects' attributes may not be stored.

Workaround: After decreasing the system load temporarily, load a new History Storage Criteria, identical to the original except in name.

CSCat19030

Problem: System appears to run up even tho 2 processes crashed

Symptom: A "cemf session" will not start.

Conditions: Some Cisco EMF processes failed to start. No indication of this was reported by the "cemf start" command.

Examining the "sysmgr.log" file in /logs on system startup will show if processes haven't started.

Workaround: Stop Cisco EMF. Contact Cisco TAC to find solution to problem. Restart Cisco EMF.

CSCat19538

Problem: enum type in varbind shows integer value instead of text

Symptom: Alarm messages in the Event Browser have numbers in the places where strings should be.

Conditions: If a varbind for a trap is defined as an enum variable in the MIB, it is displayed as an integer value in the alarm message in the Event Browser application.

Workaround: None

CSCat19815

Problem: Containment Server stores an invalid object

Symptom: It is possible for a deleted object to be added to a containment view.

Conditions: The scenario required to reproduce this is not likely to happen in deployments: it relies on an object being moved to a view at the same time as it is being deleted.

For example, using the Map Viewer an object can be copied to another location on a view using the "Add Object(s) to ..." menu option. While the user is selecting a parent destination for the object the object can be deleted using a second Map Viewer. The now invalid object is still added to the new location.

Workaround: Objects should not be moved at the same time as they are being deleted.

CSCat19852

Problem: trapBuilder does not allow OID varbind values... - DEV

Symptom: The /bin/trapBuilder test utility fails to generate traps with OIDs specified as varbinds.

Conditions: A user wants to generate traps with OIDs specified as varbinds.

Workaround: If OIDs need to be specified as varbinds, a simulator should be used.

CSCat20377

Problem: [CSCdr88102] Inconsistent meta data information returned by data abstract

Symptom: The list of attributes retrieved via mdsClassAttributes may differ from the attributes retrieved by getting all the attributes from all of a class's types.

Conditions: Using the the Data Abstractor to get all of a class's attributes.

Workaround: Retrieve the data by getting the attributes of the class's types, rather than by mdsClassAttributes.

CSCat20378

Problem: [CSCdr88128] site objects are allowed to be deployed on network tree

Symptom: Objects of class site can be incorrectly deployed via the Corba Gateway.

Conditions: It is possible to incorrectly deploy an object of class site in the Network view through the Corba Gateway.

Workaround: CORBA clients should follow containment rules in the absence of platform validation.

CSCat20381

Problem: [CSCdr90130] Two OGs with same name and in same dep. context can be dep

Symptom: It is possible to incorrectly deploy two Object Groups with the same name and put them in the same point in containment.

Conditions: This situation can only occur by using the CORBA Gateway API's to erroneously create a deployment context with two objects having the same parent and object name.

Workaround: The CORBA client should ensure that objects with the same name and parent do not appear in the same deployment context.

CSCat20389

Problem: [CSCdr92254] ObjectGroup.moveObjects should move all or no objects

Symptom: When an operation to move a number of objects from one group to another fails for some but not all of the objects, the complete operation is not rolled back.

Conditions: This situation only occurs when using the CORBA Gateway Object Group API to move objects from one group to another. Note that the problem can only occur as the result of erroneous object details being entered by the CORBA client code.

Workaround: The CORBA client code needs to ensure that if it is to move objects from one group to another, all the objects exist in the source Object Group.

CSCat20517

Problem: CEMF Bugs:TrapAlarmMapper does not handle Unsigned32

Symptom: Cisco EMF fails to map traps using Unsigned32 attributes.

Conditions: If a trap has attributes that are declared as Unsigned32, then it cannot be mapped to a managed device.

Workaround: Ensure that each attribute declared as an Unsigned32 is redefined to be an INTEGER in the MIB.

CSCat20526

Problem: PerfPollTask intermittently create perf. object group without group name

Symptom: A performance polling object group can be created with no name.

Conditions: When a Performance polling object group is specified using a GROUP_NAME, the group is created but with an empty string for a name.

Workaround: Override the createPerformanceObjectGroup method and specify the value of m_groupName.

CSCat20554

Problem: [CSCdr94148] OG.rename does not rename the OG in the OG tree

Symptom: Renaming an Object Group using the OGManagerInterface API does not rename the Object Group in the ObjectGroup view.

Conditions: If an Object Group is directly renamed via the CORBA Gateway then the name in the containment will not be automatically changed.

Workaround: If the Object Group is renamed in the Object Group then it must be renamed in containment as well, and vice versa.

CSCat20684

Problem: objectFileParser fails to parse multi-line text or text with brackets

Symptom: The Cisco EMF file parser objectTypeFileParser does not support attribute value definitions spread over multiple lines nor string value definitions containing brackets, "(" and")".

Conditions: The Cisco EMF objectTypeFileParser is being run on files containing attributes spread over more than one line, or containing string-value definitions with brackets.

Workaround: Concatenate the multi-line definition onto a single line. Other brackets, e.g. <>, {}, [] can be used rather than ().

CSCat20773

Problem: No progress dialog in Event B when you launch it from object.

Symptom: No query progress bar is displayed and it is not possible to cancel a query.

Conditions: This happens when the Event Browser is launched on an object from the Map Viewer.

Workaround: There is no workaround.

CSCat20792

Problem: CEMF CGW IDL is not OMG compliant

Symptom: Compiling CORBA Gateway IDL files produces errors regarding symbols used.

Conditions: Compiling IDL with a strict OMG compliant compiler that produces errors regarding the overloading of names to represent different types e.g. struct, enum, enum fields.

Workaround: The workaround is to use a different compiler which is not as strict. The IDL compiles with Iona's IDL compiler for CORBA 3.0.

CSCat20806

Problem: datalook get (..) rows x on mo (..) broken

Symptom: When the Cisco EMF datalook utility is used to retrieve a table attribute, and a maximum number of rows to be retrieved is specified, the entire table is retrieved.

Conditions: The Cisco EMF datalook utility is attempting to retrieve attribute details with a maximum number of rows defined.

Workaround: There is currently no workaround.

CSCat20861

Problem: [CSCds06353] Possible inefficiencies in deployment process

Symptom: There is a theoretical decrease in system performance due to participant contexts being passed to participants that do not require it.

Conditions: During deployment of objects, some participants are unnecessarily called (e.g. when the participation context of the participants is registered as a ManagedObject there is no need to send this context if the level is a Provision_Creation_Tree).

Workaround: There is currently no workaround.

CSCat20864

Problem: CSCds06543 CGW : Event Ohannel.- removed event type should not be sent

Symptom: When CORBA event types are removed from the channel's set of event types, the types are sent to the consumer.

Conditions: A CORBA client is registered on a channel and the eventTypes attribute of the channel is changed.

Workaround: There is currently no workaround.

CSCat20874

Problem: [CSCdp54476] Renaming objects to existing ones fails without flagging ER

Symptom: The ContainmentInterface class does not return an error condition when an object rename operation fails.

Conditions: In connected views, sibling objects must have different names. Renaming an object to have the same name as one of its siblings in a connected view fails as expected. However, the ContainmentInterface class does not return an error condition.

Workaround: There is currently no workaround.

CSCat21043

Problem: [CSCdr82780] Error: ObjectFileParer: create/delete failure after -upgrade

Symptom: When using "cemf remove forupgrade" to upgrade an EM, the following message can be displayed:

ObjectFileParser: create/delete failure.

Conditions: Upgrading an EM via "cemf remove forupgrade".

Workaround: This can be safely ignored. It is due to an attempt to recreate the EM's view, which already exists.

Note that if the upgraded EM's view has different properties to the original EM's view, e.g. a change to its visibility, it is the responsibility of the EM to make this change along with any other changes to the EM's object model.

CSCat21098

Problem: trapManager fails with invalid trap forwarding file

Symptom: The trapManager process exits.

Conditions: Within a trap forwarding file, there isn't a space followed by a tab between the hostname and the trap pattern rule, or the headings for the rules are missing.

Workaround: Ensure the hostname and trap mapping rule in a trap forwarding file are separated by both a space and a tab. Ensure the file contains a heading of the form:

System Traps

CSCat21235

Problem: Event Browser User filter on cleared alarms not working.

Symptom: Querying cleared alarms by user through the Event Browser results in some alarms being displayed that were cleared by other users.

Conditions: Different alarms have been cleared by different users. A query is invoked through the Event Browser for alarms that have been cleared by one user.

Workaround: There is currently no workaround.

CSCat21262

Problem: Logger logs when shouldn't: logfiles fill with junk, making debug harder

Symptom: Logs in /logs may contain a list of the contents of ObjAttrList objects included for diagnostic purposes, marked as ERRORs.

Conditions: The ObjAttrList::dump(ObjAttrList&) method has been used.

Workaround: Calls to "ObjAttrList::dump" should be removed after EM development if these error messages are not wanted.

CSCat21362

Problem: [CSCds17854] Copies of OGs created via CGW are not visible in OG tree

Symptom: An Object Group created by copying an existing one does not appear in the object group containment.

Conditions: A CORBA client calls OGManagerInterface::performGroupOperations(), with OGCopyOp specified as an operation type.

Workaround: The EM can add the group to containment via the ContainmentInterface::addObjects() method.

CSCat21404

Problem: dev: Setting random data in events cause vector server problems

Symptom: The vectorServer process exits.

Conditions: A test rig raises test events on an event channel which the vectorServer process uses. The data in the events is not valid.

Workaround: There is no workaround, the scenario only occurs during development testing.

CSCat21409

Problem: Alarm propagation doesn't seem to work in some cases when reparenting.

Symptom: When an object is reparented to a different view, no propagation will be seen for the alarms presently on the object. When new alarms arrive on the object, they will propagate correctly.

Conditions: Reparenting an object from one view to another.

Workaround: There is no workaround.

CSCds28585

Problem: Trap Forwarding file format inflexible to white-space

Symptom: The trapManager process exits.

Conditions: Within a trap forwarding file, there isn't a space followed by a tab between the hostname and the trap pattern rule, or the headings for the rules are missing.

Workaround: Ensure the hostname and trap mapping rule in a trap forwarding file are separated by both a space and a tab. Ensure the file contains a heading of the form:

System Traps

CSCds31895

Problem: ObjectStore cache manager exits with error

Symptom: The objectStore cache manager exits and leaves the following message in /var/adm/messages Cache manager ran out of space in the action set.

As a result of this client applications will crash with errors such as No handler for exception: ObjectStore internal error The Cache Manager process appears to have disappeared.

Conditions: This can occur in highly concurrent applications and may also be linked to occasions when the root partition becomes full. It occurs when the Cache Manager's fixed sized cache overflows.

Workaround: It is possible to increase the size of the Cache Manager's cache by setting the following ObjectStore environment variables. In the 'C' shell enter the following commands before running cemf shell. Alternatively, the root user can make the settings permanent by editing their .cshrc file in their home directory.

setenv OS_ACTION_SET_INITIAL_SIZE 40960 setenv OS_COMMSEG_RESERVED_SIZE 16777216

Note that the default values are 20480 and 8388608 respectively.

CSCds32996

Problem: Comms ERRORs when executing many scripts or raising events

Symptom: The following messages are logged into the file 'notificationServer.log', in the /logs directory.

Gateway: WARN commsHandle.cc:259 CommsHandle::connectInternal Invalid ConnectionSpec object provided Gateway: ERROR CommsGateway::sendcommsGateway.cc:775 Failed to send message general: ERROR EventChannelManagerProxy::distributeEvents Failed to send message general: ERROREventTransferFIFO: distribute events failed general: ERROR EventTransderFIFO: failed on sending Gateway: ERROR CommsGateway::process_socket commsGate-way.cc:1247 read failed, closing connection (errstr="Connection reset by peer")

Conditions: Cisco EMF executes hundreds of scripts or events simultaneously. This is a scalability issue that depends partly on machine specification and configuration.

Workaround: Staggering notifications alleviates the symptom.

CSCds33257

Problem: EventChannel Server cores when receiving events with filter setup

Symptom: The CORBA Notification Service (process called "EventChannel_svr") exits.

Conditions: The CORBA Notification Service exits when a filter is applied to a CORBA channel which supplies alarm events and the CORBA client has subscribed for this type of event.

(Alarm Events are only sent on the AlarmChangedEventChannel and AlarmAddedEventChannel)

Workaround: The client needs to remove the filter and then code a filter inside their CORBA client if required.

If a client has applied a filter and the crash has happened, the client has to restart the corbaEventChannelManger by executing...

> sysmgrClient -k corbaEventChannelManager; sysmgrClient -x corbaEventChannelManager

This does not mean that clients cannot receive alarm events, they cannot apply a filter.

CSCds36703

Problem: vectorServer consumes all swappable memory

Symptom: The vectorServer may grow in size, eventually consuming all memory.

Conditions: Many alarms are raised against one object.

Workaround: Add a clear correlation rule to specify that when a new alarm is raised on an object, it automatically clears all active alarms of the same class on that object. The rule is as follows:

CLEAR_CORRELATION_RULE INCOMING_ALARM_CLASS X ALARM_CLASS_TO_CLEAR X NO_CLEAR_LAST_ALARM END_RULE

and should be saved in a file. To add this rule, run

> cemf shell > cd /bin > ./clearCorrelationFileParser

This should be performed while Cisco EMF is running.

CSCat11317

Problem: object group access not updated for client

It is possible to use the Access Manager to allow certain application features to be restricted for a user. In particular, an Access Specification can be created to restrict features to objects in a particular object group.

If however, the contents of such a group changes while a particular Cisco EMF session is running, the change will not appear popup menus in, for exa mple, the Map Viewer.

This means that, where an object is removed from a group, features will still appear to be available. Where an object is added to a group, the features may appear to be unavailable.

This does not affect the actual security of the features when they are launched: at this point, object group membership is checked and access to features will be as intended.

Workaround: The workaround to correct the popup menus is to close the session and open a new one.

CSCat16665

Problem: [CSCdr09383] Obj Config Dialog not moving to table and takes too long t

Workaround: There is currently no workaround.

CSCat17410

Problem: [CSCdr25497] Cant view beyond 10,000 traps in Event Browser

The event browser displays a maximum of 10,000 events.

If the user has set up a query that should contain more events than this then they will see the button at the bottom left of the browser stating there are "10,000 of XXX" events, where XXX is the correct total.

The events are not necessarily the most recent events and sorting occurs on the events displayed in the browser. To see the most recent events, the user should query by time.

Workaround: The suggested workaround is to set up a query that displays less than 10,000 events.

CSCat17497

Problem: [CSCdr26527] Network: object does not rename itself

Workaround: There is currently no workaround.

CSCat17500

Problem: [CSCdr26799] Dialogs invoked from object list on another dialog fails.

Element Manager dialogs which have been created using Cisco EMF SDK can be launched from the popup menu in the Map Viewer. If the same dialog is then launched again, using the popup menu from the Element Manager dialog, it is possible that a different selection of objects will be displayed from those expected. This occurs when the dialog being launched from has more than one object list on it. This will cause the launched dialog to only display those objects selected in the source dialog, or any objects leading to those objects in the view.

Workaround: If this is not the desired behaviour, then subsequent dialogs should be launched in the same manner as the first, that is, from the popup menu in the Map Viewer.

CSCat17535

Problem: [CSCdr16205] Network: Does not look at variable length subnet mask

The Auto Discovery server keeps track of objects and the networks they belong to using the Network view.

However, it does not make use of Variable Length Subnet Masks. Instead, it assumes that an object belongs to a network of the size implied by the class of the address.

This can mean that, for example, a class B-addressed object which belongs to a subnet will be positioned beneath a network object representing the class B network. As such, there may be many more objects underneath that network than there are in the smaller, subnet. This can make finding an object harder.

Workaround: There is no workaround to this.

CSCat19533

Problem: OGM won't display path when object only in EM view

The Object Groups application allows the contents of an object group to be examined in a list within a window, with some information shown for each of the entries.

For objects which do not exist in the Physical view, the object name will not be shown.

Workaround: There is no workaround for this.

CSCat20031

Problem: [CSCdp74281] NO warning if attempt to close change screen

It is possible for attributes of objects to be modified by using the Element Manager dialogs which have been designed through AVMT.

When the user modifies the values of attributes in one of these dialogs, and chooses to exit without saving, no warning is displayed.

Workaround: The workaround is to save prior to exiting the dialog, if the changes are to be kept.

This also applies to the Object Configuration dialog, where available.

CSCat20166

Problem: many ERRORs seen once CEMF had been started

Workaround: There is currently no workaround.

CSCat20381

Problem: [CSCdr90130] Two OGs with same name and in same dep. context can be dep

It is possible to incorrectly deploy two Object Groups with the same name and put them in the same point in containment by placing the groups in the same deployment context.

Note this situation can only occur by using the CORBA Gateway APIs in an erroneous way. The CORBA client should be fixed so that this situation doesn't occur.

Workaround: None

CSCat20383

Problem: Unable to cancel any changes made in Object Group Manager.

The object group manager can be launched by clicking the "Groups" icon on the CEMF Launchpad.

When an object is created initially with no query and it is later edited by specifying a query for it and clicking the "Re-run query" button on the "object group dialog",

the object group editor does not get "busied off."

There seem to be a problem in the server code, in that the dialog does not receive the callback( the result of the re-run query operation) to indicate whether the operation was successful or not so that the dialog will be "busied off."

Workaround: There is currently no workaround.

CSCat20546

Problem: (CSCat20433) AV allows TNet Radios to be re-parented to subnets

Deployment templates can arrange that different kinds of objects can only be deployed in certain places.

However, once an object has been deployed into an appropriate place, it is possible to reparent it so that it lives beneath, for example, an inappropriate container for the technology in question.

Workaround: Users must be aware of the view relationships which apply to the technology they are administering.

CSCat20554

Problem: [CSCdr94148] OG.rename does not rename the OG in the OG tree

Symptom: Renaming an Object Group using the OGManagerInterface API does not rename the Object Group in the ObjectGroup view.

Conditions: If an Object Group is directly renamed via the CORBA Gateway then the name in the containment will not be automatically changed.

Workaround: If the Object Group is renamed in the Object Group then it must be renamed in containment server as well, and vice versa.

CSCat20799

Problem: ObjectListViewer displays objs multiple times under certain conditions.

The Object Groups application allows the contents of an object group to be examined in a list within a window, with some information shown for each of the entries.

For objects which do not exist in the Physical view, the object name will not be shown.

Workaround: None

CSCat20803

Problem: The network view (Read only) details can be re-named from any view?

Workaround: There is currently no workaround.

CSCat20877

Problem: [CSCdr08600] deletion of object service fails if deployment wizard is o

If a user is in the process of deploying objects using the Deployment Wizard, for example by selecting it from the popup menu in the Map Viewer, it is not possible to delete objects at the same time.

Workaround: The workaround is to complete or cancel the deployment operation prior to performing the deletion, and then to resume the deployment if required.

CSCat20879

Problem: [CSCdr22246] Image not removed from chassis view after module is delete

When EM developers define maps, no relationship checking is enforced, which means that objects can appear on incorrect maps. Objects must only appear on a map if they are immediate children of the object whose map is being defined. This is necessary to ensure that alarms do not appear twice in the same map, to avoid operator confusion. If object are added which

do not meet this criteria, then when they are deleted CEMF will not remove them from the map, because it does not expect them to be there.

Workaround: None

CSCat20930

Problem: [CSCdr59277] dialog hangs if clearing event button is pressed for norma

If the user opens the Full Event Description dialog from an event on an Event Browser, and then clicks the Clearing Event button, the dialog can sometimes hang.

Workaround: This is only under particular circumstances and the user will then only be able to close the dialog via the Window System close.

CSCat21041

Problem: [CSCdr69348] Event Browser does not close even if CEMF window is closed

Workaround: There is currently no workaround.

CSCat21060

Problem: Deletion of object from map don't remove link object from containment

Using the Map Builder, it is possible to create a link object which joins two managed objects on the same map.

If one of these linked objects is deleted, the link object will not be automatically deleted, though it will no longer be shown in the map.

Workaround: To arrange that it is deleted, the map should manually be removed, using "Delete objects..." from the popup menu, prior to deletion of the object which is linked.

CSCat21088

Problem: cemf hangs after object deletion.

In the Viewer application, the dialog can sometime hang when objects are deleted. It has been noted most commonly if the user deletes objects immediately after opening the Viewer but it is a timing issue and so may happen at other times.

Workaround: The only workaround for this is to close the Viewer from the Window system menu.

CSCat21121

Problem: Event Browser sorts only on alarms present in the cache

The Event Browser can only display a maximum of 10,000 events. It is also possible to sort the events displayed in the Event Browser.

If the user attempts to display more than the maximum displayable then he could be mislead, for example, if 10,000 minor events are raised and the Event Browser displays them and then 10 critical events are raised, these will not be displayed and it may mislead the user into thinking there are only minor events, when it is simply that he is showing the maximum amount of events.

Workaround: The suggested workaround is to use the query of the Event Browser to display a manageable number of events that is less than the maximum.

CSCat21132

Problem: Object Gui logs misleading messages after object deletion

When objects are deleted from Cisco EMF, is is possible that the Map Viewer application will generate error messages in its logfile, objectGui.log, under CEMFROOT/logs. This does not indicate a malfunction in the deletion operation; these messages can safely be ignored.

Workaround: None

CSCat21143

Problem: Edited query not saved for query populated Object Group

When a user edits a query populated object group, unless they select to re-run the query at that point, the query will not be saved.

To edit an object group, the user will open the Object Group Editor. From here, he will launch the query editor dialog, change the query and on closing this dialog, he will be prompted as to whether he would like to save his changes. This will return him to the Object Group Editor. If the user simply closes this dialog, then the changes he made to the query will not be saved.

Workaround: The workaround is that when the user returns to the Object Group Editor after editing the query, he should select the menu to re-run the query at that point.

CSCat21145

Problem: Remove object service is sometimes not displayed

Workaround: There is currently no workaround.

CSCat21208

Problem: Access manager Read Only service still allows User to edit maps?

Workaround: There is currently no workaround.

CSCat21242

Problem: Insufficient colors dialog on session start is hidden.

If a Cisco EMF session is opened on a workstation where there are insufficient colors available, for example as a result of another application using many already, a warning dialog is displayed.

However, sometimes this dialog can be obscured by the Cisco EMF Launchpad window.

Workaround: The workaround is to move the Cisco EMF Launchpad away to one side, allowing the warning dialog to be dismissed. Instructions for moving windows can be obtained from the documentation for the window manager being used.

CSCat21252

Problem: 1st time Close button is clicked on Event dialog and event browser cores

Workaround: There is currently no workaround.

CSCat21336

Problem: Event group icon and event browser not auto populating when filter chan

Editing an Event Group in the Event Groups Applications available from launching 'Event Grps' from the Cisco EMF launch Pad )

When the user edits the Event Group query, the Event Group is not automatically updated with the events that match the new query. The Re-run query menu option needs to be invoked. Similarly if there is an Event Browser open for the Event Group this will not update until the Re-run query menu is invoked.

Workaround: The workaround is to use the Re-run query to ensure the Event Group is up-to-date.

CSCat21338

Problem: Event group can be created with invalid characters

Creating an Event Group in the Event Groups Application available from launching 'Event Grps' on Cisco EMF launch Pad)

When you create an Event Group and the name has invalid characters, the user is not informed that there was a problem but the Event Group does not appear to be created, i.e. the user will not be able to see it on screen.

However, the Event group has been created and so if the user attempts to create an Event Group with the same name, then they will be informed that an Event Group with that name already exists.

Workaround: The workaround is not to attempt to create an Event Group with an invalid name.

CSCat21341

Problem: Edited event group name can contain invalid characters

Editing an Event Group in the Event Groups Application available by selecting 'Event Grps' from the Cisco EMF Launch Pad )

When you edit an Event Group and enter invalid characters for its name, then the tree display on the left hand side of the dialog shows the original name, but when you open an Event Group Editor you see the invalid name.

Workaround: The workaround is not to attempt to give the Event Group a name with invalid characters.

CSCat21365

Problem: Unexpected behavior when trigger cond = reset cond

The Thresholding Regime Application (available from launching 'Thresholds' from the Cisco EMF Launch Pad )

If the user has set up a thresholding regime with a threshold that has a trigger condition that is equal to the reset condition and is checking this frequently, then it is possible that two notification profiles can start running when there should only be one. This may result in being informed twice about the same threshold condition.

Workaround: The workaround is not to set up a threshold where the trigger and reset conditions are equal.

CSCat21402

Problem: Event group editor takes longer to close when edit query

Editing an Event Group in the Event Groups Application ( available from launching 'Event Grps' from the Cisco EMF Launch Pad). When a user edits the Event Group in any way, it can take up to 6 seconds for the Event Group Editor to close.

Workaround: The workaround is to be aware that it can take this amount of time for this operation.

CSCat21405

Problem: Wrongly configured Solaris hostname on client hangs session startup

If the Solaris hostname of the client is wrongly configured, then this can cause the CEMF session to hang, ie the splash screen and login will open but hang after the username and password have been entered.

This is due to the clients machine name being mismatched with its name in DNS. On the client machine, hostame will return 'nameA' but on the Manager, doing an nslookup for 'nameA' fails. In DNS, the client machine is called 'nameB'.

Workaround: The workaround is to change the files:/etc/hostname.hme0, /etc/hosts and /opt/cemf/config/env/avCore.sh to use 'nameB'.

CSCat21408

Problem: ObjectGroups-Edit feature list doesn't contain all reqd features

Users are given access to features of Applications in CEMF by placing them in User Groups and assigning Access Specifications to them. Access Specifications are collections of feature lists.

There are some feature lists that are rely on other feature lists also being assigned to the user. For example, - the ObjectGroups-Edit feature list does not contain all the required features. It will not let the user open the object group application.

Therefore, when assigning this feature list to a user, you should also assign the ObjectGroups-View feature list.

Workaround: - the Events-Clear_Acknowledge feature list does not contain all the required features. It will not allow the user to open the Event Browser.

Therefore, when assigning this feature list to a user, you should also assign the Events-View feature list.

CSCds29000

Problem: CEMF not detecting Ostore presence during startup

Symptom: Starting Cisco EMF correctly reports that ObjectStore cannot be started if it's not installed. However, there is a delay in the message being displayed.

Conditions: ObjectStore is not installed as part of Cisco EMF, or is installed but subsequently removed. Attempting to start Cisco EMF will then correctly fail, but there may be a delay in the appropriate error message being displayed.

Workaround: If starting Cisco EMF (by "cemf start") appears to fail to complete, run

ps -ef | grep ODI

to determine of ObjectStore is running. If not, ObjectStore should be re-installed, the machine rebooted, and Cisco EMD restarted.

CSCds29121

Problem: filter editor stores selections after deselecting items-misleadin

Several applications in Cisco EMF allow a query to be edited: for example, the Event Browser, the Object Group Manager and the Event Groups application.

If the user selects an item in any tab of the query editor and then attempts to deselect this item, then the query believes it has been selected.

Workaround: The workaround is to re-edit the query after such an operation has been performed, to explicitly remove it, for example, using the "Object class" tab to add a class, and then immediately removing the class, having not saved the query in between, will cause the class to remain selected in the query. To remove it, the user would re-open the query editor and simply remove the class and save the query.

CSCds30827

Problem: Removing final n.p. from trig.cond. resets rather than stops it

Editing a thresholding regime in the Thresholder Application ( available by selecting 'Thresholds' from the Cisco EMF Launch Pad). When you have a thresholding regime set up with thresholds, and you edit the threshold to remove a notification profile, the expected behavior is that, if there are any running notification profiles, these are stopped, i.e. reset actions do not occur.

However, if you only have one notification profile associated with the threshold and you remove it, then any running notification profiles are reset, i.e. reset actions do occur.

Workaround: The workaround is not to remove all notification profiles from a threshold, or if you need to, then you can disregard the reset action.

CSCds30862

Problem: Possible core dump when an event group is deleted (CEMF-3.1-D9)

Opening an Event Browser from the Event Group Application (available by selecting 'Event Grps' from the Cisco EMF Launch Pad ). If the user has two Event Group Dialogs open and the user selects to delete an Event Group from one of them, he will be prompted for confirmation of this action. If the user has not yet opened the Event Browser within the CEMF user session and attempts to open one on this Event Group from the second Event Group Dialog and then immediately confirms to delete it in the first then the Event Group application may exit.

Workaround: The workaround is to avoid opening an Event Browser as the Event Group is being deleted.

CSCds30953

Problem: Event Browser clear button toggles incorrectly

Workaround: There is currently no workaround.

CSCds31860

Problem: HierarchyTreePolicy::onSelected is called extra times (3.1-D9)

Some applications in Cisco EMF allow objects to be selected from a hierarchy.

If the CAPS LOCK or NUM LOCK keys are active while these features are being used, unexpected results can occur when objects are selected when they are already highlighted.

Workaround: The workaround is to ensure that these keys are not active while the hierarchy feature is being used.

CSCds32031

Problem: Event Details screen (notifApp) displays Warning ! (3.1-D6)

Creating/Editing a notification profile in the Notification Profiles Application ( available by selecting 'Notify' from the Cisco EMD Launch Pad ). When a user sets up a notification to raise an event, there is a list of the possible severities. Instead of displaying 'Warning', this list currently displays 'Warning !'.

Workaround: The workaround is to ignore what is displayed as it will raise a Warning event, as expected.

CSCds33040

Problem: User with viewer view/edit can DELETE objects?

Workaround: There is currently no workaround.

CSCds33999

Problem: Access Manager Admin user locked out when permissions are RW only

Using the AccessManager Application ( available from launching 'Access' from the Cisco EMF Launch Pad )

If the admin user is logged in and he changes the permissions of the Access Specs named "All_Standard_Features" and "Full_User_Access_Control" from Read-Write-Admin to Read-Write then the admin user loses all admin permissions.

Workaround: The workaround is that if the admin user does this, then they can be restored by utilising the partitioningTool.

CSCds34006

Problem: User can DELETE objects without having DEPLOYMENT rights?

The Viewer application available from launching 'Viewer' from the Cisco EMF Launch Pad

If a user has Read/Write access to the Launch Pad and Viewer-Edit Feature Lists, then he can effectively delete CEMF objects by using the 'Remove Parent Relationship' menu. This is different from the Deployment features but will currently have the same effect.

Workaround: The workaround is simply to be aware that this is the case and perhaps to give the user access to the Viewer-View feature list if the user should only have view access.

CSCds34013

Problem: Access Specification Editor doesn't save Object Groups

Workaround: There is currently no workaround.

CSCds34058

Problem: cemf session launches the login dialog even if the system is stop

When attempting to log in to CEMF, if the CEMF system had not been started then the user will be shown the log in screen but when they enter their user name and password then this screen will stay open and the Launch Pad will not open.

Workaround: The workaround is to ensure that the system is running before attempting to create a session.

CSCds34885

Problem: Viewer Smartie goes GREY after rename/reparent functions.

Workaround: There is currently no workaround.

CSCds35021

Problem: Coredump in OG Manager when you use mouse as in CSCds35004!

Workaround: There is currently no workaround.

CSCds35081

Problem: Event Browser menu sensitivity disabled for object based queries

Workaround: There is currently no workaround.

CSCds35838

Problem: Event Browser displays No Description Available by default.

Workaround: There is currently no workaround.

CSCds35846

Problem: Expanding Physical view creates different OGM queries?

Workaround: There is currently no workaround.

CSCds35889

Problem: Core Dumps in Object Groups when an object is pasted in another

Workaround: There is currently no workaround.

CSCds35928

Problem: Admin User with full Access rights cant change User passwords?

Workaround: There is currently no workaround.

CSCds36821

Problem: No message to user that acking alarm does not work during backup

Workaround: There is currently no workaround.

CSCds36923

Problem: Access Man GUI presents options to user that don't get applied?

Workaround: There is currently no workaround.

CSCds38488

Problem: Pop up window is hidden behind launchpad during login

Workaround: There is currently no workaround.

CSCds40792

Problem: Auto update in event browser not performing correctly

Workaround: There is currently no workaround.

CSCds40809

Problem: Clear Correlation uses User instead of network in clearing method

Workaround: There is currently no workaround.

CSCds38881

Problem: Query Editor does not save query in Object Group manager

Workaround: There is currently no workaround.

CSCds38909

Problem: Query Editor can not update the query in Object Groups

Workaround: There is currently no workaround.

CSCds38978

Problem: QueryEditor Deactivate all function doesnt work in ObjectGroups

Workaround: There is currently no workaround.

CSCds39023

Problem: Core Dumps when an invalid date is entered in ScheduleDialog

Workaround: There is currently no workaround.

CSCds39797

Problem: Core Dumps in EventBrowsers QueryEditor when date is wrong

Workaround: There is currently no workaround.

CSCds41507

Problem: Services dont appear on objects consistently

Workaround: There is currently no workaround.

CSCat20773

Problem: No progress dialog in Event B when you launch it from object

Workaround: There is currently no workaround.

CSCds37936

Problem: OG partspec file has incorrect features for ObjectGroups-View

Workaround: There is currently no workaround.

CSCds38930

Problem: Event groups browser severity lost when full obj path displayed

Workaround: There is currently no workaround.

CSCds40690

Problem: Losing power to a CEMF Server can result in its databases holding inconsistent data. The resolution to this has to be in two parts.

Symptom: An object may fail to be deployed.

Conditions: Power is lost to a Cisco EMF server during deployment. After restarting the system and restarting deployment, a device may fail to be deployed.

Workaround: For a deployed Cisco EMF installation in a 24x7 environment, the machine should be fitted with a UPS.

Resolved Caveats

Resolved Between Cisco EMF v3.1 EFT and This Release

CSCat09325

AccessVision crashes when using keyboard to access menus

CSCat10080

deploymentWizard:- Problem error reporting when attrs fail

CSCat10469

Export to file appends to the end of an existing file

CSCat13050

Print selected alarms prints ALL alarms, not just the selection

CSCat14039 [CSCdp48700]

GUI selections all black

CSCat14290 CSCdp65809

Event Browser does not adequately show progress status

CSCat14767

Not allowed to discover over different ranges on same net

CSCat15055 (deployment) [CSCdp59255]

Intermittently asyncSnmpDataRepository core dumps

CSCat15314

Cannot launch Object Config or Perf Manager Dialogs using Exceed.

CSCat15403

Access Manager has many dbm strings missing

CSCat15496

Edit Map Service Available to Read-only user in case of EMs

CSCat15499

Failed to lock map : When no other session /client is editing the map

CSCat15759 [CSCdp92900]

Several operations block/slow down other operations on syt

CSCat15951 (deployment) [CSCdp82278]

NORMAL alarm does not clear itself in event browser

CSCat16452

Event Browser prepopulates with a potentially unuseful query

CSCat16575 [CSCdr08668]

With 300 plus objects deployed , system becomes very slow

CSCat16730 (deployment) [CSCdr11000]

objectGui dumps core and fails to come up.

CSCat16783

Policy memory management on the HierarchyTreeGadget class

CSCat16798

Problem: Upgrade unix EM produces 2 options for av install -r - DEP

Symptom: When trying to remove an Element Manager from the system, options to remove both the original version and the upgraded version will be selectable, though only the upgraded version is installed.

Conditions: During deinstallation of an upgraded Element Manager.

Workaround: Selecting either option for removal will successfully remove the Element Manager from the system.

CSCat16989 (deployment)

IANAifType-MIB.mib is out of date

CSCat17099 (deployment)

Alarm mapping is not stable

CSCat17197 [CSCdr21858]

The UI does not update correctly

CSCat17203 (deployment)

Updating Table Matrix attribs Scrambles

CSCat17224 (deployment)

Network Containment Pushed on snmpProxied

CSCat17277 [CSCdr23652]

Can still hack into AV with 3.0 patch 2 installed

CSCat17306 (deployment) [CSCdr24254]

AV groups all table attributes when doing set

CSCat17310

Dialogs display negative values for large numbers

CSCat17311

Performance Manager core dumps for large values

CSCat17314

Details of the Feature lists not displayed

CSCat17348 (deployment)

Problem with TNet reset Table

CSCat17405

Map Viewer dumps core

CSCat17480

GIFs on Chassis map "disappear"

CSCat17542

Usergroup editor shows access spec list twice after revert

CSCat17571 [CSCdr10310]

horizontal scroll bars for access specification editor are

CSCat17622

Event Browser: problem when steady stream of traps, & clearing them

CSCat17648 [CSCdp31614]

Discovery Interface dialog tab support does not work

CSCat17648 [CSCdp31614]

Discovery Interface dialog tab support does not work

CSCat17662 (deployment)

AV start/stop problem

CSCat17675

CEMF splash screen for 3.1 says 3.0

CSCat17681

User cannot change passwords: doesn't recognise old password

CSCat17682

Can't add map backgrounds to maps

CSCat17683

Event Browser display is incorrectly ordered after refresh

CSCat17747 [CSCdr36807]

sessionMgrServer eats all swap space and cores

CSCat17798

Usability: Event Browser query disappear from status after refresh

CSCat17928

Performance manager core dumps during refresh.

CSCat17802

Problem: Generic view should not be visible to users

Symptom: In some circumstances the genericObjects view may become visible to the user after a Cisco EMF 3.0.4 to Cisco EMF 3.1 migration.

Conditions: If a Cisco EMF 3.0.4 system which contained objects within the "genericObjects" view is migrated to Cisco EMF 3.1, then the "genericObjects" view will become visible in the 3.1 system.

Workaround: The genericObjects view is not required in 3.1, but remains after an upgrade from 3.0.4. If an EM does not need it, the EM can either set the view to be invisible or delete it.

CSCat18047 (development)

libavemprofile.so needs to be included in CEMF & patch releases

CSCat18166

Problem: [CSCdr38195] AV unable to handle bulk performance events.

Symptom: User receives a timeout error callback for "raiseEventsResult"

Conditions: Raising a large number (greater than 500) of events at once.

Workaround: Raise events in smaller numbers (500 or less).

CSCat18172

Can mouse double-clicking be modified within AV

CSCat18204

Problem Accessing Attribute History Server

CSCat18225 (development) [CSCdr50373]

Problem in invoking Attribute History Server APIs

CSCat18243

Unused legacy classes still compiled and linked into binary.

CSCat18311

Manager core dumps if Apply Profile selected with no profiles in system

CSCat18332 (development)

Perf poll task overridden with more that one object

CSCat18352

Print Events doesn't work in the Event Browser

CSCat18358

unable to save Perf Manager data to a file

CSCat18612 [CSCdr39598]

Simultaneous Auto-Discovery causes wrong parenting of object

CSCat18710 (deployment)

semantics change of clear correlation rule

CSCat18779 (development) [CSCdr57267]

coredump with big data in action result window

CSCat18799 (deployment) [CSCdp70442]

trapAlarmMapper dies dumping core

CSCat18948 (development)

Problem With setResult and vectors.

CSCat19010 [CSCdp82160]

Dialogs from client are dumping core

CSCat19162

WatchDog script incorrectly reports Sysmgr exited.

CSCat19169

Raising one alarm of severity warning causes objectGui core dump

CSCat19214

Not saving alarm clearing info

CSCat19236

Problem: Normal alarm has higher severity then Informational alarm

Symptom: If an object has active events of both 'informational' and 'normal' severity present against it, the object will appear in the Map Viewer application with normal severity instead of informational.

Condition: Normal severity is higher severity than informational, which results in them taking precedence in the viewer.

Workaround: This is intended behavior.

CSCat19293

rogue object is generated when a site is deployed through Maps then del.

CSCat19358 (deployment) [CSCdr70231]

Cannot delete many, many objects :RPC Error

CSCat19406

Viewer-Edit/View Featurelist Names list wrong features

CSCat19407

launchpad partspec file has no Read-Write InvocationMode

CSCat19439 (CSCat19870)

De-installation of EMs produced errors

CSCat19442

Performance Manager: Print Data does not use .ini printCommand

CSCat19526 (deployment)

Redeployed object no longer receives traps.

CSCat19546

Problem: Can install manager & client on same machine using ./cemfinstall -c

Symptom: It is possible to install a Cisco EMF client package onto a machine which has a Cisco EMF Management Server package installed. The user should not be given the option to install a client package on a Management Server.

Conditions: The Cisco EMF client is being installed via the command-line interface.

Workaround: There is currently no workaround.

CSCat19552

User Editor fails to add User to UserGroup through Select User Groups ta

CSCat19568

Problem: ObjectUtilsTestRig getObjectDetailsAsync core dumps.

Symptom: The developer tool "objectUtilsTestRig" malfunctions when the option "getObjectDetailsAsync" is used.

Conditions: Using the getObjectDetailsAsync option with objectUtilstestRig.

Workaround: The operation "getObjectDetails" option can be used instead.

CSCat19631

AHC has purge problems in object with 1000 attributes

CSCat19693

Object Group Editor hangs when duplicate Group name entered

CSCat19843 (deployment)

Naming problems

CSCat19746

Problem: The user has to exit the Cisco EMF session in order for the Map Viewer queries to show events.

During a multi-user test involving five users, one user was in a state where any Event Browser queries launched from the Map Viewer application did not return any events at all.

Workaround: The user should exit the Cisco EMF session and log back in. After this all Event Browser queries should return events as expected.

CSCat19845

Problem: [CSCdr74005] cemfinstall does not return error code when install fails

Symptom: The Cisco EMF install script does not return an error code if the installation of a package fails.

Conditions: The Cisco EMF is being installed and a package installation error occurs.

Workaround: The install script displays the message:

"ERROR: Installation failed, one or more packages failed to install correctly"

Users should rely on the echoed message, rather then the error code returned from the script, to determine if the package installed correctly.

CSCat19911

CorbaGatewayManager does not check username/password

CSCat19913

user can't change pswd after login

CSCat19924

Performance Mgr takes too long to display when there are many counters

CSCat19932

PerformanceMgr GUI missing datapoints

CSCat20114 (deployment) [CSCdr76957]

localDBServer crashed

CSCat20239 : [CSCds06303][CSCds06283]

Bugs in autodiscovery

CSCat20299

CGM:SCAL:Can get situation where prop is broken in the viewer

CSCat20304 [CSCdr85615]

Router fails to deploy in some configurations [BT]

CSCat20315 (development)

Non-Orbix IDL compiler name clashes.

CSCat20325 (deployment) [CSCdr85942]

CORBA Event Channels cores with OG Delete Event

CSCat20341

Map Viewer remains busy after saying 'No' to Remove Parent Relationship

CSCat20346

Problem: EM views not being updated on AV on EM upgrade

Symptom: If any attributes against a view object are modified in a subsequent version of an Element Manager, these modifications are not applied when an existing Element Manager installation is upgraded.

Conditions: Changing a view specification file to specify that a view changes from being invisible to visible will not make the view visible immediately after upgrade.

Workaround: This is an example of a change to the Element Manager's object model. Since all such changes are changes in the Element Manager and not to Cisco EMF, they should be done as part of the Element Manager migration. See Chapter 11 in "Cisco EMF SDK Controller Designer Developer's Guide, v1.3" for further details.

CSCat20348 (deployment) [CSCdr93232]

Action invocation broken completely

CSCat20370 (deployment) [CSCdr89851]

OG Mgr cores when retrieving details of OG with Null

CSCat20371 (deployment) [CSCdr85254]

OGs created via Deployment Interface not got correct attrs

CSCat20375 [CSCdr90072]

OG Mgr GUI cores when viewing OG with no Description attr

CSCat20375 CSCdr90072]

OG Mgr GUI cores when viewing OG with no Description attr

CSCat20376 (deployment) [CSCdr86031]

cemf install <option> script broken in this build

CSCat20378

Problem: [CSCdr88128] site objects are allowed to be deployed on network tree

Symptom: Objects of class site can be incorrectly deployed via the Corba Gateway.

Conditions: It is possible to incorrectly deploy an object of class site in the Network view through the Corba Gateway.

Workaround: CORBA clients should follow containment rules in the absence of platform validation.

CSCat20382

Problem: [CSCdr90139] Deletion does not fail if same OG exists in context twice

Symptom: A failure is not reported by the deployment process if the same Object Group is entered into a deletion context twice.

Conditions: When an Object Group is entered into a deletion context twice, the second attempt to delete the Object Group fails because the first occurrence of the Object Group in the deletion context will have removed the Object Group.

Workaround: There is currently no workaround.

CSCat20443

event browser totals often incorrect-normally when clearing events

CSCat20499 [CSCdr38175]

Event browser display is inconsistent/ very slow

CSCat20555 (deployment) [CSCdr94080]

corbaObjectGroup process restarts for large element requests

CSCat20576 (deployment) [CSCdr98540]

Creating OGs using sync calls fails to raise OGCreate event

CSCat20617 (deployment)

./cemf start runs checks in wrong order

CSCat20651

The Refresh menu in the browser does not work for a pers event group

CSCat20711

browser open on pers event group, event history not working correctly

CSCat20767

oidMapping files are installed as part of CEMF - oidMapping fails

CSCat20786 (deployment)

wrong iostream seek call used

CSCat20858

CEMF apps lock up on error

CSCat20868

Creating an access spec with ROor RW permissions isn't applied

CSCat20902

Problem: Incorrect restore script error message.

Symptom: Issuing a 'cemf restore' command without a specified date causes the following error messages to be displayed:

/usr/bin/dirname: gettext: not found ERROR: Failed to retrieve backup information.

vAn attempt is made to perform a database restore without specifying the date to restore. The following command is an example:

cemf restore -l /opt/Backup

Workaround: Ensure a valid date is specified with the -t option. For example:

cemf restore -l /opt/Backup -t 02-24-2000

CSCat20912 [CSCdr44623]

CEMF 3.1 Splash screen says 3.0

CSCat20928

Problem: [CSCdr55707] server specific scripts should not be allowed on client

Symptom: Cisco EMF Management Server specific options (reset, backup and restore) are available on client installations. The options perform no operation but should not be available for the user to select.

Conditions: The Cisco EMF Management options are being exercised on a client installation, and options which are server specific are available for selection (but not execution).

Workaround: There is currently no workaround.

CSCat20933

Problem: [CSCdr51717] purge criteria set by historyAdmin is overwritten by cemf

Symptom: Purge criteria set with the historyAdmin tool are reset after stopping and restarting Cisco EMF.

Conditions: After changing the purge criteria from their default values using the historyAdmin tool, the attributeHistoryServer is stopped and restarted either individually or as part of Cisco EMF.

Behavior of the attributeHistoryServer will then revert to the settings specified in its .ini file. Settings specified with the historyAdmin tool for the last session are not reused.

Workaround: config/init/attributeHistoryServer.ini should be amended to specify the new purge criteria. The attributeHistoryServer process should then be restarted by using:

sysmgrClient -k AttributeHistoryServer sysmgrClient -x AttributeHistoryServer

Alternatively, use the historyAdmin tool to set the purge criteria when Cisco EMF is restarted.

CSCat20934 (deployment) [CSCdr50806]

attributeHistoryServer exiting/restarting everyday due to ObjectStore exception

CSCat20988

Problem: [CSCdr43999] CEMF and Corba do not work if workstation is not in DNS

Symptom: Cisco EMF's CORBA Gateway will not start and the corbaGatewayManager process logs an "unexpected exception" message.

Conditions: The machine is not in the DNS.

Workaround: With Orbix 3.0.1 / CEMF 3.1 the client can change the following file after installation:

/Orbix/config/orbixnames3.cfg

by putting in the IP address of the machine in the line defining the IT_NAMES_SERVER_HOST, e.g. if it was

IT_NAMES_SERVER_HOST = "hostname";

change it to

IT_NAMES_SERVER_HOST = "1.1.1.1";

Where "hostname" and "1.1.1.1" should be substituted with hostname and the correct IP value respectively. To find the hostname run "hostname", then to check if the name is in DNS do "nslookup" with the argument being the result of "hostname". If it is not found this command will display an error.

The loopback IP address (127.0.0.1) may be used if the host IP address is unknown.

CSCat21002 : [CSCds06303]

Autodiscovery GUI does not report all obj cr

CSCat21044

Event Browser status bar shows wrong cardinality (0 of -1)

CSCat21046

Problem: The command "./cemf install -o -fullhelp" does not work correctly.

Symptom: The commands "cemf help full" and "cemf install -o fullhelp" do not work.

Conditions: When running "cemf help full" or "cemf install -o fullhelp" an error is returned.

Workaround: There is no workaround for command "cemf help full". However, standard help can be requested by running "cemf help".

CSCat21106

Event Details Dialog not displaying clearing method

CSCat21118

dbm entries produced by AVMT not backwards compatible

CSCat21193

Event browser throughput problems with >3 users

CSCds29889

OG Coredump when deleting objects from object groups

CSCds32070

Performance Manager Crashes

CSCds32243

timestamp missing from NbAsciiForwarder

CSCds32996

Comms ERRORs when executing many scripts or raising events

CSCds32017

Login password does not accept more than 31 characters

CSCds34086

deinstalling client tries to suspend alarm processing on client

CSCds36001

Event Browser is very slow while loading 1000 alarms

CSCds39769

Display Full Objectname menu option clears the severity info

Caveats Resolved By Cisco EMF v3.0 Patches Applied Between Cisco EMF v3.1 EFT and This Release

Bugs Fixed in CEMF 3.0 Patch 7

ATLuk20580

Under some circumstances, it was possible for there to be a long delay between performance data being gathered and being displayed on the Performance Manager. This has been fixed.

Bugs Fixed in CEMF 3.0 Patch 6

ATLuk19924

The Performance Manager took too long to display data when many attributes were being monitored. Performance issue has been addressed.

ATLuk19932

The Performance Manager would under certain specific circumstances not display some values. This has been fixed.

ATLuk19933

The Event Browser hung when new object classes were being created. This has been fixed.

ATLuk20304

Multiple IP interfaces configured on an ATM card that is installed on a router could not be auto discovered. This configuration caused auto discovery to fail with error "Deployment failed" logged to the discovery progress screen. This has been fixed.

ATLuk20582, ATLuk20583

When an attribute was selected within Performance Manager, data for a different attribute would be displayed. This has been fixed.

Bugs Fixed in CEMF 3.0 Patch 5

EM Deployment Affecting Bug Fixes

ATLuk12021

Reference to AV during installation of an EM ("Finding AV root dir") has been replaced by a reference to CEMF.

ATLuk12090

Restoration of databases can now only be performed by the root user.

ATLuk12456, ATLuk16214, ATLuk16410, ATLuk18131, ATLuk18536

Removed and reprioritised many incorrect logging statements.

ATLuk13429

If an object list in an EM dialog has more than one population source, then previously only the first was used to determine whether repopulation was required. This meant that changing the object selection sometimes did nothing.

ATLuk14753

The most common alarm queries are now more efficient.

ATLuk15094

When the Map View was first opened the objects on the map had no alarm status information. This has been fixed.

ATLuk15499

Closing a session with a map builder open would lock the map indefinitely. This has been fixed.

ATLuk15806, ATLuk18799 [CSCdp70442]

The trapAlarmMapper could randomly crash during system start-up or deployment. This has been fixed.

ATLuk15953

Repeated, rapid commissioning and decommissioning of an object would cause the controller to crash.

This has been fixed.

ATLuk16564, ATLuk16888 [CSCdr12657]

Under certain circumstances the Performance Manager would crash. This has been fixed.

ATLuk16710

Attempting to apply an invalid patch to the system (e.g. attempting to apply a CEMF 3.0.3 to a CEMF 3.0 installation) would fail as required. However, the message displayed to the user would indicate that the patch had been installed. This has been corrected.

ATLuk16715 [CSCdr08950]

The Event Browser would crash when a string translation failed. This has been corrected.

ATLuk16953

Support for Daylight Saving Time has been added to Performance Manager.

ATLuk17146, ATLuk17662

Stopping CEMF would occasionally result in the following message being displayed:

Sysmgr has exited!!

Killing all CEMF Manager processes.

kill -TERM -<pid>

This has been fixed.

ATLuk17172 [CSCdr17579]

The Event Browser would lose the user selections if a steady stream of events was being received, making it difficult to clear events. This has been fixed.

ATLuk17197 [CSCdr21858]

Sometimes when a string attribute had no value, EM dialogs could show the value for an object which was selected earlier. This has been fixed.

ATLuk17448

Backing up and restoring databases but no config files (i.e. when config/data/filesToBackup was empty) no longer results in an incorrect error message being displayed.

ATLuk17485 [CSCdr28336]

Pressing cancel on the alarm retrieval progress bar in the Event Browser caused the Browser to crash. This has been fixed.

ATLuk17486 [CSCdr28375]

When modifying severity information, rank, color, etc., the Viewer application could crash. This has been fixed.

ATLuk17644 [CSCdp29160]

The 'back' button in the Deployment Wizard does nothing, and has been removed to avoid confusion.

ATLuk17664

Performance Manager now supports integer values greater than 231.

ATLuk17751

Databases backed up on one machine can now be restored to a different machine. In addition, the name or IP address of a machine on which CEMF is installed can also be changed.

ATLuk18027, ATLuk18233

Different versions of the same patch (e.g. pre-releases v. final releases) now have unique PATCHIDs. This makes identifying the version of an installed patch easy.

ATLuk18188

When trying to display performance data the Performance Manager would report in the status bar "The values cannot be charted but will be available on the table tab". Data is now visible.

ATLuk18300

The order of columns within the Event Browser has been changed to Clear/Ack/Time/Severity/Object Name/Description

ATLuk18516

If the performance polling interval was less than the minimum (default 7 seconds), no green "started polling" indicator would be shown on the Performance Manager. This has been fixed.

ATLuk18680

CEMF now supports SNMPv3.

ATLuk18734

Sometimes alarm propagation would fail, but deleting and rediscovering the affected objects would correct it. This propagation bug has now been fixed.

ATLuk18762

After some object deletion situations, some object lists in an EM dialog would fail to re-populate even when the selection was changed. This has been fixed.

ATLuk18719

Closing the Map Builder occasionally caused it to crash. This has been fixed.

ATLuk18779 [CSCdr57267]

An action that returned a large amount of data (greater than 8Mb) would cause the controller to crash. The controller has been made more robust such that it now logs an error. As with all other IPC traffic in CEMF, 8Mb is the largest amount of data that can be passed between processes in one call.

ATLuk18794 [CSCdr52134]

The Event Browser would crash when the user tried to view event information that had been cleared by a user after the user was removed from the system. This has been fixed.

ATLuk18887

Displaying historical data on the Performance Manager is now quicker.

Bugs Fixed in CEMF 3.0 Patch 4

ATLuk09956

Initialising ObjectUtils with list of classes will make startup faster

ATLuk15951 [CSCdp82278]

NORMAL alarm does not clear itself in event browser

ATLuk17310

Dialogs display negative values for large numbers

ATLuk17311

Performance Manager core dumps for large values

ATLuk17480

GIFs on Chassis map "disappear"

ATLuk17797

Map subsystem is extremely slow for maps with 2000 objects

ATLuk18044

DeploymentWizard generates bogus containment

ATLuk18155

Start up time could be improved if DABS Configuration was more efficient

ATLuk18168

Map server takes ages to build transient map

ATLuk18170

Object Server class attributes need to be speeded up

ATLuk18179

Service manager is too slow at calculating available services.

ATLuk18181

Event Browser truncates object names

ATLuk18296

Event Browser must be refreshed to see any traps

ATLuk18368

Performance Manager: core dump on summary data display

Troubleshooting

Troubleshooting sections are provided in the Cisco EMF Installation and Administration Guide and the Cisco EMF User Guide.

The EMSBU Knowledge Base (formerly Atlantech Technologies Knowledge Base) is a source of additional technical information on Cisco EMF. Information is collated together as a result of responses to frequently asked questions and other common issues raised during the development of Cisco EMF-based Element Managers. The Knowledge Base also features guidelines and tips from EMSBU engineers and Engineering Services. New entries are added to the Knowledge Base regularly.

Documentation Updates

Installing Cisco EMF

During a Server installation you are asked to specify the directory where the runtime files for the Lochness IOS config files will be stored. The default directory is <CEMF_ROOT>/lochness/archive/configArchive. Type y, then press Enter to accept this default.

This feature gives freedom on where to put the archive, either locally on same machine, or on the NFS on a different machine, where any standard commercially available backup mechanism can be used to backup the archive. It also allows the user to dedicate a server to handling the archive using dedicated backup utilities. This is especially important for large managed network where the archive can become quite large, thus enhancing scalability.

The choice of directory depends on the needs of user, the size of network and number of devices managed by Cisco EMF, and the backup facilities the user wants to apply.

It also gives the choice to separate the archive locally from the management system, for example on a separate machine, in a separate room, at a separate locality.

Firewall Configurations

To manage or auto-discover networks, the following traffic must be allowed through any firewall between Cisco EMF and the agents:

1. SNMP traffic of protocol type UDP on Port 161 & 162

2. Telnet traffic of protocol type TCP on Port 23

3. tftp traffic of protocol type UDP on Port 69

4. icmp traffic of protocol type TCP and UDP on Port 7

TAC Support Tool

The script ./getDiagnostics is used to collect diagnostic information for use by the Cisco Technical Assistance Center (TAC). The procedure is described in the Cisco EMF Installation and Administration Guide, page 6-4. A cemf shell is required to perform this operation. After you change directory to the Cisco EMF bin directory <CEMF_ROOT>, you should get a cemf shell by typing ./cemf shell, then proceed to run the ./getDiagnostics script as described in Step 3.

Updating Server

A client installation communicates back to the Cisco EMF server when required to retrieve management information. You can point the client at a new server without having to deinstall the client.


Step 1 On the client installation on a separate machine, quit any running Cisco EMF Launchpad sessions.

Step 2 Login as superuser (su).

Step 3 Change directory to the Cisco EMF bin directory, type:

cd <CEMF_ROOT>/bin

Step 4 To stop Cisco EMF, type:

./cemf stop

where <CEMF_ROOT> is the directory where Cisco EMF is installed. The Cisco EMF processes stop.

If you attempt to run this command with Cisco EMF running, an error message is displayed.

Step 5 To update the Cisco EMF server, type:

./cemf updateServer

You see the following messages:

WARNING:This operation will change Server information held in the CEMF Client 
installation.

WARNING:For CEMF Client to function correctly, you must ensure that you provide a valid 
Server name.

Step 6 To change the server, type y, then press Enter.

Step 7 Enter, then confirm, the hostname of the new server.

Step 8 Enter, then confirm, the server host IP address.

Step 9 Type <CEMF_ROOT>/bin/cemf start. The Cisco EMF processes start. A message informs you when the startup is complete.


Errors

Upgrading Cisco EMF

In the Installation and Administration Guide, page 7-2, the commands given in Upgrading only Cisco EMF, Steps 4, 5 and 7, and Upgrading Cisco EMF and Updated Element Managers, Steps 4, 5 and 8 are for use with Cisco EMF v3.1 not Cisco EMF v3.0.x. If you are upgrading a Cisco EMF v3.0 system refer to Table 1 for the correct commands.

Table 1 cemf Commands

Cisco EMF v3.0 command
Cisco EMF v3.1 command

./cemf install -show

./cemf show

./cemf install -remove

./cemf remove

./cemf install -remove -o -upgrade

./cemf remove forupgrade


In the Installation and Administration Guide, page 7-4, the command given in Upgrading Cisco EMF and Updated Element Managers, Step 16 should be as follows:

./cemf start forupgrade

Omissions

In the Installation and Administration Guide, page 7-3, Upgrading only Cisco EMF, Step 14 states that Cisco EMF and the Element Managers can now be started. To do this, type ./cemf startupgrade

Related Documentation

Cisco Element Management Framework Installation and Administration Guide v3.1, 78-10792-01

Cisco Element Management Framework User Guide v3.1, 78-10791-01

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.



Note If you are a service provider, and have an SPTAC Contract ID number, contact the Service Provider Technical Assistance Center at 1-800-495-9121.


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.