Known issues in previous versions

The following information describes known issues in previous versions.

For known issues in the latest version, see Known issues in Drivers 27.

Drivers 26

Import fails while using Drivers 26 drivers with NCM FP16, FP17, FP18 and FP19 with “java.lang.NoSuchMethodError” exception in worker log.

Cause

The root cause of this issue is due to a mismatch in versions of the sshd-common and sshd-core jar files.

Workaround

Copy the sshd-common-2.12.1.jar and sshd-core-2.12.1.jar files from the $NCM_INSTALL_DIR/drivers/lib_legacy directory to the $NCM_INSTALL_DIR/lib directory by using commands such as the following examples:
```
cp $NCM_INSTALL_DIR/drivers/lib_legacy/sshd-common-2.12.1.jar $NCM_INSTALL_DIR/lib
cp $NCM_INSTALL_DIR/drivers/lib_legacy/sshd-core-2.12.1.jar $NCM_INSTALL_DIR/lib
```
Note: Throughout these instructions, replace $NCM_INSTALL_DIR with the directory where Netcool Configuration Manager is installed, for example, /opt/IBM/tivoli/netcool/ncm.
Back up and edit the $NCM_INSTALL_DIR/bin/classpath and $NCM_INSTALL_DIR/bin/classpath-core files.

In both files, locate the following lines:

For Fix Pack 19:

CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-core-2.10.0.jar
CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-common-2.10.0.jar

For Fix Pack 18 and below:

CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-core-2.9.1.jar
CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-common-2.9.1.jar

Replace the above lines with the following:

CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-core-2.12.1.jar
CLASSPATH=${CLASSPATH}:$INSTALL_DIR/lib/sshd-common-2.12.1.jar

Save and close the files.
Restart Netcool Configuration Manager using the following command:
```
$NCM_INSTALL_DIR/bin/itncm.sh restart
```

Drivers 25

Import fails for drivers in Drivers 25 release when password prompt is not generic

Cause: Import and Device Discovery fails due to defect in code while handling non generic prompts.
Workaround: Use Auto discovery 6.5.0 (with the latest mapping XML files) and Drivers 24 drivers for the password prompt issue.

Note: The same issue is observed while discovering a device from Auto Discovery.

Import fails for certain Drivers in Drivers 25 with “SSH_OPEN_RESOURCE_SHORTAGE” error

Cause: Channels in code are not handled properly.
Workaround: Use Drivers 24 to avoid this issue.

Single Unit of Work for multiple devices of same driver import fails

Cause: Improper handling of static variables in code.
Workaround: Use Drivers 24 to avoid this issue.

More than 30 seconds delay in processing Unit Of Work

Cause: Waiting time/sleeping time is set to more than 30 seconds in the code.
Workaround: None

SmartModelUpgrade.sh -all script upgrading both Standard and Custom drivers along with SmartModel drivers

Workaround: Use the SmartModelUpgrade script with the -Universally Unique Identifier (UUID) to upgrade specific drivers.

Release drivers missing SmartModelUpgrade.sh, SmartModelUpgrade.jar and drivers_bulk_install.sh files

Cause: The Drivers installer does not contain SmartModelUpgrade.sh, SmartModelUpgrade.jar and drivers_bulk_install.sh files.
Workaround: This issue only affects new Netcool Configuration Manager installations. Copy the missing files from another installation if one exists, or install the latest driver, which copies those files automatically to the corresponding paths.

Harmless "Undetermined error" in drivers_bulk_install.sh

When using the drivers bulk installer utility drivers_bulk_install.sh, the script output shows that the result has one undetermined error: Unable to locate log file for analysis. This error can safely be ignored.

[IBMBNT Switch compass 7.5.x] Missing README for config changes only support via streaming during driver installation

Cause: The version of IBM-BNT device used in testing did not support FTP, so the only way to perform tasks was to set the streaming flags to true for both put and get.
Workaround: Set the streaming flags in the RAD to both true if not set already.

[error in logs] Error Invalid classpath entry "/opt/IBM/tivoli/netcool/ncm/drivers/lib_legacy/aspn-client-v1.jar" in classpath

Cause: On some releases the invalid classpath error shows up after startup. This is before any work is done. This error does not affect any drivers that are executed afterwards. Each driver will now load the needed classes from individual classpath files before running.
Workaround: No workaround is needed.

[Huawei DSLAM 56xx 8.x] Using streaming to fetch native configurations for the Huawei DSLAM 56xx 8.x device prevents configuration data from modeling

Cause: Line wrap occurs when the native configuration is streamed and wrapping lines do not model in XML correctly
Workaround: File transfer should be used to fetch the native configuration for the Huawei DSLAM device instead of streaming. This is configured in the default resource access document for the Huawei DSLAM driver. Streaming is configured as the default method to send changes to the device as it does not support file transfer as a mechanism to do so.

[Cisco ASR 1K] The user is not blocked from importing standard config into config editor in 6.3.0.6

Cause: Netcool Configuration Manager Version 6.3 fix pack 6 (or earlier) does not prevent the (ineffective) importation of standard configurations for Cisco ASR devices via the Configuration Editor.
Workaround: When using Netcool Configuration Manager Version 6.3 fix pack 6 (or earlier), do not import standard configurations for Cisco ASR devices via the Configuration Editor, as this will have no effect on the device configuration.

[Extreme Switch 48xx 15.x] Disaster Recovery

Issue: When a versioned configuration is submitted to an Extreme Switch 48xx 15.x via the Disaster Recovery functionality, the associated UOW is marked as successful, even though the configuration is not sent to the device.

Cause: Zero length binary data file is being transferred to the device
Workaround: Do not use Disaster Recovery to apply configurations to an Extreme Switch 48xx 15.x if there is a "Warning: No Binary data to apply" message in the UOW log.

[Extreme Switch 48xx 15.x] Native Diff displays incorrect changes

Cause: Performing diffing on two imported configurations through the Native Show Differences feature displays false output.
Workaround: Use the modeled difference feature instead.

[Extreme Switch 48xx 15.x] Multiple Config Compare

Cause: The stored configurations and running configurations for Extreme 48xx 15.x switches are in different formats, and therefore the 'show configuration' command can not be used to interpret these configurations.
Workaround: None; The comparing of running and stored configurations in Extreme 48xx 15.x switches is not supported by Netcool Configuration Manager.

[IBM-BNT Switch VFab 7.x] Custom Resource Icons

Cause: When an IBM-BNT VFab 7.x switch is imported, the icon displayed in Netcool Configuration Manager the network resource icon instead of the IBM-BNT icon
Workaround: None

Issue [IBM-BNT Switch VFab 7.x] Native Compare exception in Standard Mode

Cause: When you apply a native command set to an IBM-BNT VFab 7.xs switch, the UOW fails with an exception when the RAD flag 'Native Compare' has been set to TRUE.
Workaround: Deselect the check box for Native Compare on the configuration tab of the resource access document (RAD). This will prevent a native comparison from being carried out during a apply native commands set unit of work.; To see the changes applied to the native device configuration, select both configs in the Resource Browser's configuration tab, and choose Show Differences Native View from the right-click menu.

[Core] InvocationTargetException on saving a draft config

Cause: For devices with very large configurations the user may encounter an InvocationTargetException on attempting to save a new configuration draft due to WebSphere running out of memory.
Workaround: Increase the maximum heap size for the embedded WebSphere Application server to a sufficient size or perform housekeeping on the versioned configurations to reduce their number.

[Cisco 76xx] Setting allowed VLANs on trunk failure

Cause: If you want to add, remove, or modify a list of VLANs on a trunk, you have to issue 'add' or 'remove' commands. However these commands are not being substituted correctly when submitted to the device via a config change or restore operation.
Workaround: Use native commands for configuring VLANs on a trunk.

Deletion of undocumented command fails for modeled config changes and restore operations

Issue: Deletion of undocumented command fails for modeled config changes and restore operations.
Cause: For Junoscript based devices there is an issue with the XML generated when the user deletes srlg configuration data contained within the undocumented section of the routing-options config, and causes modeled config operation and restores to fail. This issue could occur with other undocumented commands also.
Workaround: Remove the undocumented command with correct Junoscript using a native command set.

[Cisco ASR 9k] Rollback and commit operations

Issue

Some configuration changes sent to the device, for example 'interface ATM 0/0/0/1', will receive an error message after applying a commit command.

The new configuration will be saved into the device running-configuration and will cause Disaster Recovery to fail.

The following is an example of a device error message:% Failed to commit one or more configuration items. Please issue 'show configuration failed' from this session to view the errors.

Cause

The device is processing the interface ATM0/0/0/2 type commands.

Workaround

You can address this issue in two steps:

First, ensure that the config is kept in good condition, and turn on rollback when making config changes.
Secondly, do not pick DR when submitting a versioned config.

This will allow Netcool Configuration Manager to calculate the differences and only send the commands needed to restore the device's config.

[Juniper QFabric] Modeled command sets unsuccessful on Juniper QFabric

Issue: Modeled command sets and configuration changes do not complete successfully on the Juniper QFabric.
Cause: Juniper identified an issue with Junoscript configuration change processing and a fix will be in an upcoming JUNOS software release.
Workaround: Use native command sets.

[Schema] Juniper ERX Config Submit Failure configuration||ip||vrf

Issue: The ip vrf commands are not completely supported by the translator. Any configuration with ip vrf commands will have issues with any changes made to these commands and they will not be correctly displayed in the config editor interface.
Workaround: None

[Nexus 1k] Native Command Set Line By Line Failure

Cause

Failures occur when attempting to stream line by line a native command set that contains a command to apply a MOTD Banner with multiple lines.

Workaround

To prevent these failures, the following new inline commands for native command sets are provided. The following commands apply only if Allow Line by Line for Native Command Set mode is true. If the Allow Line by Line for Native Command Set mode is not true, then Netcool Configuration Manager removes the commands.

Table 1. New inline commands for native command sets
Inline command	Description
`ITNCM-Sleep`	Allows Netcool Configuration Manager to sleep for the specified seconds before executing the next command in the list of native command sets. The following example specifies a value of 2000 Milliseconds, which means that Netcool Configuration Manager sleeps for two milliseconds before executing the next command in the list. `ITNCM-Sleep=2000`
`ITNCM-NoPrompt`	Sets it so that Netcool Configuration Manager waits for no prompt. You can specify one of the following values: `ITNCM-NoPrompt=true` — Netcool Configuration Manager waits for no prompt when executing commands in native command sets. `ITNCM-NoPrompt=false` — Netcool Configuration Manager waits for a prompt when executing commands in native command sets.
`ITNCM-ChangePrompt`	Changes the prompt that ITNCM is waiting for when executing commands in NCS. The following example changes the default prompt to `>` (right angle bracket). `ITNCM-ChangePrompt=>`
`ITNCM-ResetPrompt`	Resets the prompt to its default value. The default prompt is set in the device script using the `default.prompt=` `prompt`. For example, `default.prompt=#` specifies that the default prompt is `#` (pound sign). You can specify one of the following values: `ITNCM-ResetPrompt=true` — Netcool Configuration Manager resets the prompt to the default value specified in the device script. `ITNCM-ResetPrompt=false` — Netcool Configuration Manager does not reset the prompt to the default value specified in the device script.
`ITNCM-ChangeEndOfLine`	Changes the end of line value that follows each command. For example: `ITNCM-ChangeEndOfLine=\r\n` Other values are: `\r,\n,\m`.
`ITNCM-ResetEndOfLine`	Resets the end of line value back to the default value. The default value is `\n`. You can specify one of the following values: `ITNCM-ResetEndOfLine=true` — Netcool Configuration Manager resets the end of line value to the default value. `ITNCM-ResetEndOfLine=false` — Netcool Configuration Manager does not reset the end of line value to the default value.

Related information

For information on command sets, see http://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/condev/task/ncm_idt_idtcommandsets.html.

For information on the Allow Line by Line for Native Command Set mode, see http://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/adm/task/ncm_adm_devcom_editingradguiconfig.html

http://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/adm/task/ncm_adm_devcom_editingradguiconfig.html

[Nexus 1k] Multi-line MOTD Banner via FTP

Cause: When attempting to apply a multi-line MOTD Banner via FTP, only the first line will be applied to the configuration.
Workaround: This is expected behavior and is a limitation of the NX OS on this device.

Disaster Recovery is not supported on CISCO Nexus 1000v

Cause: The Disaster Recovery feature is not supported on the CISCO Nexus 1000v device.
Workaround: Follow the disaster recovery procedure from your vendor.

Avaya Switch Disaster Recovery issues

Cause

The Disaster Recovery feature will not work on the 48xx and 55xx devices running Netcool Configuration Manager 6.3.0.2 and earlier.

Workaround

Change the Config Data Type field in the RAD to the value CLIandBIN, and deselect the Reboot on Config Load check box. Once this is done import the device again.
Deselect the Streaming Put check box in the RAD.
In the device script, comment out the Ftp file section.
In the Submit Configuration Change window, submit the Versioned Config and select the Disaster Recovery; Use Raw CLI checkbox.
Select the Streaming Put check box in the RAD.

[Avaya 8xxx 7.x] Import of Versioned Config into Editor

Cause: The driver for Avaya Switch 8xxx 7.x does not properly import a versioned configuration into the GUI editor window by selecting file > import.
Workaround: To import a versioned configuration, select the device from the realm directory then select the Configurations tab. Choose the Versioned configuration to be imported, right click, and select Submit.

UOW fails for Report diffs = true on Avaya device

Cause: The diffs reported on the Avaya device using Report Diffs = true will only report against startup vs running configurations. If diffs are needed against a versioned configuration then use the work around.
Workaround: If diffs are needed against a versioned configuration then the work around is to use the Synchronize option in the Resource Browser after the initial imports to synchronize the configurations.
Related information: For information on Synchronizing configurations, see http://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/condev/task/ncm_condev_synchronizingconfigurations.html.

[Juniper routers and switches] Rollback should not be selected in UOWs

Issue: Rollback options should not be selected in Juniper router and switch UOWs, rollback is done automatically if UOW fails.
Cause: Juniper device scripts are setup to automatically rollback if UOW fails to avoid leaving the device in a bad state.
Workaround: Do not select rollback in UOWs for Juniper devices.