Drivers 18 installation

Use this information to understand Netcool Configuration Manager Drivers 18 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 18 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 18 release. Once logged into your PPA account search for the appropriate part number.

Note: These packages contain all device drivers from the Drivers 17 release, as well as all new and enhanced drivers released specifically for Drivers 18.

Table 1. Drivers 18 installation files
Package file name	Part number	Details
ITNCMStandard.tar	CIR1JEN	IBM Netcool Configuration Manager Drivers 18 Standard Device Full Installer v6.4 multiplatform English
ITNCMStandardBasic.tar	CIR1LEN	IBM Netcool Configuration Manager Drivers 18 Standard Basic Device Full Installer v6.4 multiplatform English
ITNCMSmartModelBasic.tar	CIR1MEN	IBM Netcool Configuration Manager Drivers 18 SmartModel Basic Device Full Installer v6.4 multiplatform English
ITNCMSmartModel.tar	CIR1NEN	IBM Netcool Configuration Manager Drivers 18 SmartModel Device v6.4 Full Installer multiplatform English
ITNCMSmartModelComplex.tar	CIR1XEN	IBM Netcool Configuration Manager Drivers 18 SmartModel Complex Device v6.4 Full Installer multiplatform English
ITNCMSmartModelDefinitions.bin	CIR1PEN	ITNCM Compliance Definitions for SmartModel Devices for 6.2/6.3
ITNCMSmartModelComplexDefinitions.bin	CIR1YEN	ITNCM Compliance Definitions for SmartModel Complex Devices for 6.2/6.3
ITNCM_Autodiscovery.tar	CIR1KEN	Autodiscovery Driver

Installing the drivers

For information on installing drivers, refer to one of the following resources located on the Information Center:

See the 'Installing drivers' section in 'Chapter 2. Installing' of the IBM Tivoli Netcool Configuration Manager Installation and Configuration Guide:
https://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.0/ncm_pdf_ins_master_64.pdf
See the 'Installing drivers' section in the Netcool Configuration Manager information center:
https://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.0/ncm/wip/relnotes/ncm_driversrn_drv18_pdfch2.html

Attention: To prevent corrupt driver installation in the case of Netcool Configuration Manager not having been stopped before starting driver installation, do not attempt to restart or stop Netcool Configuration Manager until the drivers installation has completed.

Installing the auto-discovery driver

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 'Chapter 2. Installing' of the IBM Tivoli Netcool Configuration Manager Installation and Configuration Guide:
https://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.0/ncm_pdf_ins_master_64.pdf
See the 'Installing auto-discovery' section in the Netcool Configuration Manager information center:
https://www.ibm.com/support/knowledgecenter/SS7UH9_6.4.0/ncm/wip/install/concept/ncm_ins_installingautodisco.html

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.

Note: The descriptions for the Memory Manager - Memory Reserved For Drivers and Memory Manager - Schema Scale Factor system properties in the documentation indicate that these properties are for IBM Tivoli Use Only. However, to avoid the out of memory errors on Juniper devices it is necessary to supply the values in the following list for these system properties.

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)

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 these steps:

Note: If you have a distributed setup, you will need to modify the server memory settings on each server.

Stop Netcool Configuration Manager by running the itncm.sh script as follows:
1. Access the directory containing the installer. The default location is /opt/IBM/tivoli/netcool/ncm/bin.
2. Within this directory, execute the itncm.sh script and specify the stop option as follows:
```
./itncm.sh stop
```
Locate the setEnv.sh script in the following directory on each server:
/opt/IBM/tivoli/netcool/ncm/bin/utils/support
Create a backup copy of the setEnv.sh script. For example:
```
cp setEnv.sh setEnv.sh.backup
```
Using your favorite text editor, open the setEnv.sh script for editing. For example:
```
vi setEnv.sh
```

Modify the server memory parameters in setEnv.sh to match the following:

#!/bin/sh

WEBSPHERE_INITIALHEAP_SIZE=256
export WEBSPHERE_INITIALHEAP_SIZE

WEBSPHERE_MAXIMUMHEAP_SIZE=2036
export WEBSPHERE_MAXIMUMHEAP_SIZE

WEBSPHERE_MAXPERM_SIZE=256m
export WEBSPHERE_MAXPERM_SIZE

WORKER_MEM_ARGS="-Xms512m -Xmx2036m -XX:MaxPermSize=128m"
export WORKER_MEM_ARGS

IDT_MEM_ARGS="-Xms512m -Xmx1024m -XX:MaxPermSize=128m"
export IDT_MEM_ARGS

LANG=en_US.UTF-8
export LANG
#LD_LIBRARY_PATH=
#export LD_LIBRARY_PATH

Note: The LD_LIBRARY_PATH parameter should be set and uncommented only when using the Oracle Instant Client with Netcool Configuration Manager.

Save your edits and then exit the editor.
Run the setWSMem.sh script from the same directory: /opt/IBM/tivoli/netcool/ncm/bin/utils/support.
Restart Netcool Configuration Manager by running the itncm.sh script as follows:
1. Access the directory containing the installer. The default location is /opt/IBM/tivoli/netcool/ncm/bin.
2. Within this directory, execute the itncm.sh script and specify the start option as follows:
```
./itncm.sh start
```