Drivers 20 installation

Use this information to understand Netcool Configuration Manager Drivers 20 installation, specifically the file name, download location, part number, and where to go for detailed driver installation instructions.

Downloading the drivers

Download ITNCM Device Support - Drivers 20 from IBM Passport Advantage. You can log into your Passport Advantage (PPA) account at the following URL:

http://www.ibm.com/software/passportadvantage

The following tables provide the media available with the Drivers 20 release. Once logged into your PPA account search for the appropriate part number.

Note: These packages contain all new and enhanced drivers released specifically for Drivers 20.

Table 1. Drivers 20 installation files
Package file name	Part number	Details
ITNCMStandardBasic.tar	CN86ZEN	IBM Netcool Configuration Manager Drivers 20 Standard Basic Device Full Installer v6.4 multiplatform English
ITNCMStandard.tar	CN86XEN	IBM Netcool Configuration Manager Drivers 20 Standard Device Full Installer v6.4 multiplatform English
ITNCMSmartModelBasic.tar	CN870EN	IBM Netcool Configuration Manager Drivers 18 SmartModel Basic Device Full Installer v6.4 multiplatform English
ITNCMSmartModelCisco.tar	CN871EN	IBM Netcool Configuration Manager Drivers 20 SmartModel Cisco Device Full Installer v6.4 multiplatform English
ITNCMSmartModelJuniper.tar	CN84BEN	IBM Netcool Configuration Manager Drivers 20 SmartModel Juniper Device Full Installer v6.4 multiplatform English
ITNCMSmartModelOther.tar	CN84SEN	IBM Netcool Configuration Manager Drivers 20 SmartModel Other Device Full Installer v6.4 multiplatform English
ITNCMSmartModelArchive.tar	CN868EN	IBM Netcool Configuration Manager Drivers 20 SmartModel Archive Device Full Installer v6.4 multiplatform English
ITNCMSmartModelBasicDefinitions.bin	CIH6WEN	ITNCM Compliance Definitions for SmartModel Basic Devices for 6.2/6.3
ITNCMSmartModelArchiveDefinitions.bin	CN869EN	ITNCM Compliance Definitions for SmartModel Archive Devices for 6.2/6.3
ITNCMSmartModelCiscoDefinitions.bin	CN872EN	ITNCM Compliance Definitions for SmartModel Cisco Devices for 6.2/6.3
ITNCMSmartModelJuniperDefinitions.bin	CN84CEN	ITNCM Compliance Definitions for SmartModel Juniper Devices for 6.2/6.3
ITNCMSmartModelOtherDefinitions.bin	CN84TEN	ITNCM Compliance Definitions for SmartModel Other Devices for 6.2/6.3
ITNCMSmartModelComplexDefinitions.bin	CN86CEN	ITNCM Compliance Definitions for SmartModel Complex Devices for 6.2/6.3
ITNCMSmartModelComplex.tar	CN86BEN	IBM Netcool Configuration Manager Drivers 20 SmartModel Complex Device v6.4 Full Installer multiplatform English
ITNCM_Autodiscovery.tar	CN86YEN	Autodiscovery Driver

Installing Drivers 20

Compared to Drivers 19, there are a number of additional installation steps necessary for Drivers 20.

The installers and installation steps required for Drivers 20 vary by the version of Netcool Configuration Manager installed and on the deployment type, and are described here.

Note: A new version of Autodiscovery is now bundled and installed with all Drivers 20 Standard and SmartModel master and individual installers.

Table 2. Installers required by version and deployment type
Deployment type	6.4.x or later	6.3.0.6 or earlier
Combined presentation / worker	Drivers 20 Standard or SmartModel Installer(s)	Drivers 20 Standard or SmartModel Installer(s) NCM Interim Fix ID ITNCM_6.3.0.6-D20
Standalone worker	Drivers 20 Standard or SmartModel Installer(s)	Drivers 20 Standard or SmartModel Installer(s) NCM Interim Fix ID ITNCM_6.3.0.6-D20
Combined presentation / worker & linked worker server	Drivers 20 Standard or SmartModel Installer(s) Drivers 20 Autodiscovery Installer	Drivers 20 Standard or SmartModel Installer(s) Drivers 20 Autodiscovery Installer NCM Interim Fix ID ITNCM_6.3.0.6-D20
Standalone drivers installation	Drivers 20 Standard or SmartModel Installer(s) Drivers 20 Autodiscovery Installer	Not applicable to 6.3.0.6 and earlier versions of NCM.

Installation of Drivers 20 on a Combined NCM Presentation/Worker: To install Drivers 20 on a Combined NCM Presentation/Worker server, the relevent Standard or SmartModel master or individual installers need to be executed on the Combined NCM Presentation/Worker server as described in the NCM installation guide.; In addition, where Drivers 20 is being installed on NCM 6.3.0.6 or earlier, NCM Interim Fix ID ITNCM_6.3.0.6-D20 also needs to be installed.
Installation of Drivers 20 on a Standalone NCM Worker Server: To install Drivers 20 on a Standalone NCM Worker server, the relevent Standard or SmartModel master or individual installers need to be executed on the Standalone NCM Worker server as described in the NCM installation guide.; In addition, where Drivers 20 is being installed on NCM 6.3.0.6 or earlier, NCM Interim Fix ID ITNCM_6.3.0.6-D20 also needs to be installed.
Installation of Drivers 20 on a Combined NCM Presentation/Worker & Linked Worker Server: To install Drivers 20 on a Combined NCM Presentation/Worker & Linked Worker server, the relevent Standard or SmartModel master or individual installers need to be executed on the Combined NCM Presentation/Worker server as described in the NCM installation guide.; The Drivers 20 Autodiscovery installer also needs to be executed on each of the Linked Worker servers that link to the Combined NCM Presentation/Worker server. Instructions for Autodiscovery installation can be found in the NCM installation guide.; In addition, where Drivers 20 is being installed on NCM 6.3.0.6 or earlier, NCM Interim Fix ID ITNCM_6.3.0.6-D20 also needs to be installed on the Combined NCM Presentation/Worker server and on each Linked Worker server.
Standalone Drivers 20 Installation: Where Drivers 20 is installed as a fresh standalone drivers installation (also known as a centralised drivers installation), or atop an existing standalone drivers installation, the Drivers 20 Autodiscovery installer needs to be executed on each of the NCM instances that utilise the standalone drivers installation. Instructions for Autodiscovery installation can be found in the NCM installation guide.; Standalone drivers installations cannot be utilised by NCM 6.3.0.6 or earlier.
Upgrade of NCM after installation of Drivers 20: All Drivers 20 Standard and SmartModel master and individual installers bundle and install a new version of Autodiscovery which is necessary for Drivers 20 to function correctly.; However, all versions of NCM up to and including V6.4.2 bundle and install a legacy version of Autodiscovery that is not compatible with Drivers 20.; Therefore, following installation of Drivers 20, any subsequent upgrades of NCM up to and including V6.4.2 will require that Drivers 20 Autodiscovery be re-installed on any upgraded NCM instance.

Installation scripts changes to startup scripts.

When Autodiscovery is installed, or one of the new D20 drivers are installed, changes are made to the .../ncm/bin/itncm.sh file to take advantage of using individual classpath files for each driver and autodiscovery.

autodiscovery-bootstrap.jar is installed in ../ncm/autodiscovery/lib. The following changes are made to ../ncm/itncm.sh

   #esac
#   liblist=`ls -1 $INSTALL_DIR/autodiscovery/lib`
#   for lib in $liblist
#   do
#      CLASSPATH=$CLASSPATH:$INSTALL_DIR/autodiscovery/lib/$lib
#   done
   CLASSPATH=$CLASSPATH:$INSTALL_DIR/autodiscovery/lib/autodiscovery-bootstrap.jar

Tip: Logging data for the installation is located in ../ncm/drivers/autodiscovery/logs, and autodiscovery is backed up to ../ncm/autodiscovery_backup.

Steps to be taken for customers using custom RADs

It should be noted that a number of RAD and Device Scripts have been changed in Drivers 20 and that if you have tailored any of the default RAD and Device Scripts on the affected drivers previously that you will need to reapply your changes after installing Drivers 20. If you have custom RADs for any drivers, replace the existing RAD with the new RAD and re-implement the custom modifications or compare the new RAD with the existing RAD and make the needed changes.

UOWs may fail due to out of memory errors on Juniper devices

Due to the large size of the Juniper drivers, device imports and other UOWs may fail due to out of memory errors, which can be seen in the UOW logs. It is recommended that customers using Juniper drivers increase their client and server memory settings. The following list identifies the settings to specify for the system properties associated with client memory, driver memory, and schema scale factor.

Important: The Memory Manager - Memory Reserved For Drivers and Memory Manager - Schema Scale Factor system properties are not normally to be modified except under the direction of IBM Support. However, to avoid the out of memory errors on Juniper devices it is necessary to configure these properties as described here.

Minimum Client Memory: Set this system property to the value 512m (512 MB)
Maximum Client Memory: Set this system property to the value 1024m (1024 MB)
Memory Manager - Memory Reserved For Drivers: Set this system property to 1024m (1024 MB)
Memory Manager - Schema Scale Factor: Set this system property to the value 2.8 (2.8 MB)

For instructions on modifying the Minimum Client Memory, Maximum Client Memory, and other system properties, see http://www-01.ibm.com/support/knowledgecenter/SS7UH9_6.4.1/ncm/wip/adm/task/ncm_adm_sys_modifyingsysprops.html.

Note: After modifying the previously listed system properties, exit the System Properties window and exit the GUI. Then, reopen the GUI and reopen the System Properties window. The modified values should now be available.

To modify the settings for the server memory parameters, follow the steps in Increasing the Java Heap size

Installing Drivers 19

For information on installing Drivers 19 and earlier, refer to the following resources located on the Knowledge Center:

See the 'Installing drivers' section in the Netcool Configuration Manager information center:
http://www-01.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/install/concept/ncm_ins_driverinstalloverview.dita

Installing the auto-discovery driver

ZIP utility is needed on servers when installing the D20 driver to backup the old autodiscovery in zip. Otherwise errors will occur during backup and autodiscovery will not install correctly during D20 installation on AIX servers, as ZIP is not supplied as standard with AIX installations.

For information on installing the auto-discovery feature, refer to one of the following resources located on the Information Center:

See the 'Installing auto-discovery' section in the Netcool Configuration Manager information center:
http://www-01.ibm.com/support/knowledgecenter/SS7UH9_6.4.2/ncm/wip/install/concept/ncm_ins_installingautodisco.html