Drivers 19 installation

Use this information to understand Netcool Configuration Manager Drivers 19 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 19 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 19 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 19.

Table 1. Drivers 19 installation files
Package file name	Part number	Details
ITNCMStandardBasic.tar	CN15VEN	IBM Netcool Configuration Manager Drivers 19 Standard Basic Device Full Installer v6.4 multiplatform English
ITNCMStandard.tar	CN15TEN	IBM Netcool Configuration Manager Drivers 19 Standard Device Full Installer v6.4 multiplatform English
ITNCMSmartModel.tar	CN15XEN	IBM Netcool Configuration Manager Drivers 19 SmartModel Device v6.4 Full Installer multiplatform English
ITNCMSmartModelBasic.tar	CN15WEN	IBM Netcool Configuration Manager Drivers 18 SmartModel Basic Device Full Installer v6.4 multiplatform English
ITNCMSmartModelDefinitions.bin	CN15YEN	ITNCM Compliance Definitions for SmartModel Devices for 6.2/6.3
ITNCMSmartModelComplexDefinitions.bin	CN164EN	ITNCM Compliance Definitions for SmartModel Complex Devices for 6.2/6.3
ITNCMSmartModelComplex.tar	CN15SEN	IBM Netcool Configuration Manager Drivers 19 SmartModel Complex Device v6.4 Full Installer multiplatform English
ITNCM_Autodiscovery.tar	CN15UEN	Autodiscovery Driver

Installing the drivers

For information on installing drivers, 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.1/ncm/wip/install/concept/ncm_ins_driverinstalloverview.dita

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 the Netcool Configuration Manager information center:
http://www-01.ibm.com/support/knowledgecenter/SS7UH9_6.4.1/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.

Important: The descriptions for the Memory Manager - Memory Reserved For Drivers and Memory Manager - Schema Scale Factor system properties in http://www-01.ibm.com/support/knowledgecenter/SS7UH9_6.4.1/ncm/wip/adm/task/ncm_adm_sys_modifyingsysprops.html 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)

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 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 a 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
```