Default directory structure

Use this information to understand the Network Manager directory structure.

Top level directory structure

Within the directory that Network Manager is installed into, the netcool subdirectory is created. The netcool directory in turn contains the following subdirectories:

  • core: contains configuration files for the Network Manager back-end processes.
  • gui: contains configuration files for GUI processes:
    • omnibus_gui: If present, contains Tivoli Netcool/OMNIbus Web GUI files.
    • precision_gui: contains Network Manager GUI files.

For information about the installation directories for Tivoli Netcool/OMNIbus and Tivoli Netcool/OMNIbus Web GUI, refer to the Tivoli Netcool/OMNIbus Knowledge Center.

Directories used by the installer

The installer installs files in NCHOME, and in other directories, depending on the operating system being installed on and the user performing the installation. The following table lists the extra directories used by the installer.
Note: From version 4.2 onwards, NCHOME is installation_directory/netcool/core; for example, opt/ibm/netcool/core.
Table 1. Directories used by the installer
Installation Directories used for installation files

UNIX operating systems, root user

 /usr/ibm/common/acsi
/var/ibm/common/acsi

UNIX operating systems, non-root user

 ~/.acsi_$HOSTNAME
~/tivoli
~/.cit (that is, in the user's home directory)

Contents of the netcool directory

The following table describes the contents of the netcool/core directory. All paths are shown relative to NCHOME. In this table, arch denotes an operating system directory. The name of this directory varies according to the operating system on which the software is installed:

  • Linux® – linux2x86
  • AIX® – aix5
  • zLinux - linux2s390

If you have installed other IBM Tivoli products, such as IBM Tivoli Business Service Manager, on the same server as Network Manager, there might be extra directories and files present. See the documentation for any other products you have installed for more information on their directories and files.

Table 2. Directories in NCHOME
Directory Description
bin Contains wrapper scripts that set the environment and execute/run the binary files for product or components supplied with Network Manager.
etc Contains configuration files for products or components supplied with Network Manager.
etc/precision Configuration files for all the Network Manager components.
license Contains the text of the product license agreement in various languages.
log Contains log files.
log/install Contains log files for the installation.
log/precision Contains log files created by Network Manager processes.
omnibus If present, contains IBM Tivoli Netcool/OMNIbus files.
platform/arch Contains the Java™ Development Kit (JDK) and Java Runtime Environment (JRE) files.
Note: Dashboard Application Services Hub uses the WebSphere® Application Server JRE.
precision Contains files for Network Manager. See later in this topic.
probes Contains files for the Probe for IBM Tivoli Netcool/OMNIbus, the nco_p_ncpmonitor process.
properties Contains files used by the installation process. You should not need to alter the contents of this directory.
var Contains persistent application data.
var/install Contains database files for the installation process.
var/precision Used by the ncp_store process to hold cached information that can be used to restore the databases should a process terminate unexpectedly.

Contents of the precision directory

The following table describes the contents of the NCHOME/precision directory. All paths are shown relative to NCHOME/precision.

In this table, arch denotes an operating system directory. The name of this directory varies according to the operating system on which the software is installed:

  • Linux – linux2x86
  • AIX – aix5
  • zLinux - linux2s390
Note: NCHOME/precision is the path set by default for PRECISION_HOME and ITNMHOME.
Table 3. Directories in NCHOME/precision
Directory Description

adapters/ncp_dla

 Contains files for the library adapter used for integration with products such as IBM Tivoli Application Dependency Discovery Manager.
aoc Contains the Active Object Class (AOC) files used by the dynamic class management and distribution system, CLASS.
bin Contains wrapper scripts for all executable files. The executable files are held at the following location:platform/arch/bin
collectors/perlCollectors Contains files for Element Management System integrations.
contrib Contains unsupported utilities for managing Network Manager. Also used by the Netcool® for Asset Management solution to contain example SQL*Plus reports.
cshrc Only on UNIX operating systems. Used for setting up the environment for your C shell.
disco Contains files used by DISCO. Contains the agent definition files, discovery agents, finder, helper files, and the stitchers.
embeddedDb Contains files for dNCIM.
eventGateway Contains stitchers for event gateway and RCA.
integration Contains files for component GUI integration.
install Contains files used by the installation process.
java_api Contains the JAVA API for developing Java applications that integrate with Network Manager components.
mibs Contains Management Information Base (MIB) files.
PD Any core files generated by Network Manager are written into subdirectories of the PD directory. The core files can be used to help diagnose the cause of a problem.
perl Contains perl files used in Network Manager.
platform/arch Contains subdirectories particular to the operating system on which you installed Network Manager.
platform/arch/bin

Contains executable files for the Network Manager components. The files are appended to your PATH environment.

Wrapper scripts for all of these executable files are held in the following location: NCHOME/precision/bin.
platform/arch/jre Contains the JAVA Run-Time Environment used by Network Manager.
platform/arch/lib Contains the object libraries used by all Network Manager components.
platform/java/lib

The Monitor Configuration GUI installation.

The User Configuration Tool installation.
products Contains GUI files for integrated products.
profile Only on UNIX operating systems. Used for setting up the environment for your Bash shell.
profiles Contains GUI-related files.
Note: All Network Manager-specific files previously located in TIPHOME/profiles are now located in ITNMHOME/profiles.
scripts Contains scripts supplied with the Network Manager products. It is advisable to keep any user-defined scripts in this directory so that they can easily be managed.
storm Contains Apache Storm scripts.
system Contains files for product operation.
systemApps Contains files for Web applications.