Installing a GUI and worker server

You install Netcool Configuration Manager either on a single server, or on several servers in a distributed architecture. The installation of a GUI and worker server can be part of a stand-alone installation on a single server, or it can be the first step in the installation of a distributed architecture on several servers.

Before you begin

Ensure you have completed all required prerequisite tasks, such as the installation of either an Oracle or a DB2 database.

Gather all the required information, such as hostnames and passwords.
Important: Quit all programs before continuing with this installation.

If performing a stand-alone installation of Netcool Configuration Manager, that is, not integrated with Network Manager, ensure you have fulfilled the requirements for Tivoli Common Reporting, if you would like to use its functionality.

If you are installing ITNCM Reports on the same server as the GUI and worker server, you must install a second instance of DASH. (You only need one instance of WebSphere, however).

If you are preparing to perform an integrated installation, ensure you have consulted the integration topics before proceeding.

Perform the following checks before installation:
Defining sufficient memory (or IBMShared) space
There can be issues installing Netcool Configuration Manager if there is not enough available memory or IBMShared space.
This problem can be eliminated by allocating more IBMShared space.
Setting sufficient Oracle process limits
There may be issues with Oracle responsiveness if there is not a sufficient amount of processes running.
The Oracle process limit must be at least 55 processes per worker server that will be deployed.
Synchronizing server timings
It is a requirement that all servers must have their times synced to within 10 seconds of each other for correct operation.
Each server can be synced by setting up the NTP protocol.
Increasing WebSphere Application Server memory on Linux
Note: Applies only to a scenario where a GUI server or Tivoli Common Reporting is being installed onto a Linux platform.
When installing a Netcool Configuration Manager GUI server or Tivoli Common Reporting onto a Linux platform, set nproc to a value of 131072 to safely account for all the forked threads within processes that could be created.
For more information, see the following technote: http://www-01.ibm.com/support/docview.wss?uid=swg21648497
Attention: When using the IBM Installation Manager to install zLinux, you may receive a number of warnings. Ignore these and proceed with the installation.

About this task

This task describes the installation of a GUI and worker server with the following variations:
  • Installation on either AIX or Linux platforms.
  • Configuration of a previously installed Oracle or DB2 database.
  • Enablement of the compliance core server (required if stand-alone).
  • Optional selection of the current server as the main IDT presentation server (required if stand-alone).
  • Optional loading of the database schema.
  • The steps for starting Installation Manager differ depending on the user mode in which it was installed. The steps for installing with the Installation Manager console are common to all user modes and operating systems. Take note of the following information about permissions on the supported operating systems:
    • Installation Manager takes account of your current umask settings when it sets the permissions mode of the files and directories that it installs.
    • If you use Administrator mode or Nonadministrator mode and your umask is 0, Installation Manager uses a umask of 22.
    • If you use Group mode, Installation Manager ignores any group bits that are set and uses a umask of 2 if the resulting value is 0.
Tip: It is recommended to use Install Manager Group Mode for installation.
Respond to each Installation configuration option to ensure it matches your pre-defined Installation Information Checklist.

Procedure

  1. Change to the /eclipse subdirectory of the Installation Manager Group installation directory and use the following command to start Installation Manager, as the icosuser user:
    ./IBMIM

    To record the installation steps in a response file for use with silent installations on other computers, use the '-record response_file' option. For example:
    IBMIM -record C:\response_files\install_1.xml
  2. Configure Installation Manager to download package repositories from IBM Passport Advantage:
    1. From the main menu, choose File > Preferences.
      You can set preferences for proxy servers in IBM Installation Manager. Proxy servers enable connections to remote servers from behind a firewall.
    2. In the Preferences window, expand the Internet node and select one of the following options:
      FTP Proxy
      Select this option to specify a SOCKS proxy host address and a SOCKS proxy port number.
      HTTP Proxy
      Select this option to enable an HTTP or SOCKS proxy.
    3. Select Enable proxy server.
    4. In the Preferences window, select the Passport Advantage panel.
    5. Select Connect to Passport Advantage.
    6. Click Apply, and then click OK.
  3. In the main Installation Manager window, click Install, and then follow the installation wizard instructions to complete the installation.
    Enter your IBM ID, user name and password if prompted.

    Select from the following installable packages, as required.
    Option Description
    Package Description
    IBM WebSphere Application Server WebSphere® Application Server component on which Jazz for Service Management is based. Required only for a new installation of Jazz for Service Management.
    Jazz for Service Management extension for IBM WebSphere 8.5 Required only for a new installation of Jazz for Service Management.
    Note: You must select v8.5 of Jazz for Service Management extension for IBM WebSphere.
    IBM Dashboard Application Services Hub Required only for a new installation of Jazz for Service Management.
    Network Manager 4.2 Required only if you want to install an integrated system.
    Network Configuration Manager V6.4.2.0 Required
    Reporting Services environment Required only if you need the reporting functions that are included in Jazz for Service Management.
    After you select the packages, the wizard prompts you for some of the following information:
    • Read and accept the license agreement.
    • Specify an Installation Manager shared directory, or accept the default directory.
    • Specify an installation directory for the product, or accept the default directory.
    • For Server Installation Type, select Presentation Server and Worker Server.
      Note: If you require ITNCM Reports, install this option after you have completed the Netcool Configuration Manager installation.
      Remember: If you are installing ITNCM Reports on the same server as the GUI and worker server, you must install a second instance of DASH.
    • Provide information about the Netcool Configuration Manager database, specific configuration information, and the required Jazz for Service Management properties.
    • Complete the Installation.

Results

The IBM Installation Manager installs Netcool Configuration Manager.

What to do next

If this installation of a GUI and worker server completes a stand-alone installation on a single server, you install the drivers and OOBC software next, as well as (optionally) ITNCM reports.

After that, you perform a number of post-installation procedures, such as safeguarding the keystore and increasing the Java Heap size.

If this installation was the first step in the installation of a distributed architecture on several servers, you install the worker servers next.

To access the Help documentation (or 'User Assistance'), you must modify the system property ITNCM Help URL:
  1. Select Systems Manager on the navigation tree.
  2. Click Tools > System Properties.
  3. Select ITNCM Help URL, and update the host and port number to the DASH installation.