Installing the DASH components

For integrated scenarios, Netcool Configuration Manager provides the following DASH components: The Activity Viewer, the DASH wizards, and the Netcool Configuration Manager thick-client launch portal.

Before you begin

From Version 6.4.2 onwards, Netcool Configuration Manager reporting is no longer installed as part of the DASH components installation, but rather as part of the Netcool Configuration Manager main installation.
Important: Before installing the DASH components, install Netcool Configuration Manager using the 'Integrated' option.

About this task

Restriction: The Netcool Configuration Manager DASH components must be installed as the same user who installed Network Manager.

Procedure

  1. Log onto the DASH server.
  2. Change to the /eclipse subdirectory of the Installation Manager Group installation directory and use the following command to start Installation Manager:
    ./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
  3. 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.
  4. In the main Installation Manager window, click Install, select IBM Dashboard Applications for ITNCM, and then follow the installation wizard instructions to complete the installation.
  5. Accept the license agreement, select an installation directory, and supply the following details:
    Netcool Configuration Manager database details
    Sid/service name/database name(db2)
    Database hostname
    Port
    Username
    Password
    DASH administrative credentials
    DASH administrator username (default is smadmin)
    DASH administrator password
    Network Manager administrative credentials
    Default is itnmadmin (or the DASH superuser, who must have the 'ncw_admin' role in DASH
    Password
    Netcool Configuration Manager presentation server
    Connection details to the Netcool Configuration Manager Presentation server
    A skip validation option should the Presentation server be unavailable
    Tivoli Common Reporting server
    Connection details to the Tivoli Common Reporting server
    A skip validation option should the Tivoli Common Reporting server be unavailable
  6. Complete the installation.

Example

Tip: Best practice recommendation: You can generate a response file through Installation Manager, as in the following example:
<?xml version='1.0' encoding='UTF-8'?>
<agent-input>
  <variables>
    <variable name='sharedLocation' value='/opt/IBM/IMShared'/>
  </variables>
  <server>
    <repository location='/opt/IBM/IM/output'/>
  </server>
  <profile id='IBM Netcool GUI Components' installLocation='/opt/IBM/netcool/gui'>
    <data key='eclipseLocation' value='/opt/IBM/netcool/gui'/>
    <data key='user.import.profile' value='false'/>
		<!--Update OS to aix for AIX-->
    <data key='cic.selector.os' value='linux'/>
		<!--Update architecture to ppc64 for AIX-->
    <data key='cic.selector.arch' value='x86_64'/>
    <data key='cic.selector.ws' value='gtk'/>
    <data key='user.org.apache.ant.classpath' value='/root/IBM/InstallationManager_Group/eclipse/plugins/
org.apache.ant_1.8.3.v201301120609/lib/ant.jar'/>
    <data key='user.org.apache.ant.launcher.classpath' value='/root/IBM/InstallationManager_Group/eclipse/
plugins/org.apache.ant_1.8.3.v201301120609/lib/ant-launcher.jar'/>
    <data key='cic.selector.nl' value='en'/>
    <data key='user.DashHomeDir' value='/opt/IBM/JazzSM/ui'/>
    <data key='user.WasHomeDir' value='/opt/IBM/WebSphere/AppServer'/>
    <data key='user.DashHomeUserID' value='smadmin'/>
    <data key='user.DashHomeContextRoot' value='/ibm/console'/>
    <data key='user.DashHomeWasCell' value='JazzSMNode01Cell'/>
    <data key='user.DashHomeWasNode' value='JazzSMNode01'/>
    <data key='user.DashHomeWasServerName' value='server1'/>
    <data key='user.SaasEnabled' value=''/>
    <data key='user.JAZZSM_HOME,com.ibm.tivoli.netcool.itnm.gui' value='/opt/IBM/JazzSM'/>
    <data key='user.WAS_SERVER_NAME,com.ibm.tivoli.netcool.itnm.gui' value='server1'/>
    <data key='user.WAS_PROFILE_PATH,com.ibm.tivoli.netcool.itnm.gui' value='/opt/IBM/JazzSM/profile'/>
    <data key='user.WAS_USER_NAME,com.ibm.tivoli.netcool.itnm.gui' value='smadmin'/>
    <data key='user.itnm.ObjectServerUsername,com.ibm.tivoli.netcool.itnm.gui' value='root'/>
    <data key='user.itnm.ObjectServer.skip.validation,com.ibm.tivoli.netcool.itnm.gui' value='false'/>
    <data key='user.itnm.ObjectServerHostname,com.ibm.tivoli.netcool.itnm.gui' value='NMGUIServerLocation'/>
    <data key='user.itnm.ObjectServerName,com.ibm.tivoli.netcool.itnm.gui' value='NCOMS'/>
    <data key='user.itnm.ObjectServer.create.instance,com.ibm.tivoli.netcool.itnm.gui' value='false'/>
    <data key='user.itnm.ObjectServerMainPort,com.ibm.tivoli.netcool.itnm.gui' value='4105'/>
    <data key='user.itnm.database.server.type,com.ibm.tivoli.netcool.itnm.gui' value='db2'/>
    <data key='user.itnm.database.skip.validation,com.ibm.tivoli.netcool.itnm.gui' value='false'/>
    <data key='user.itnm.database.name,com.ibm.tivoli.netcool.itnm.gui' value='NCIM'/>
    <data key='user.itnm.database.hostname,com.ibm.tivoli.netcool.itnm.gui' value='DatabaseServerLocation'/>
    <data key='user.itnm.database.username,com.ibm.tivoli.netcool.itnm.gui' value='db2inst1'/>
    <data key='user.itnm.database.create.tables,com.ibm.tivoli.netcool.itnm.gui' value='false'/>
    <data key='user.itnm.database.tables.prefix,com.ibm.tivoli.netcool.itnm.gui' value=''/>
    <data key='user.itnm.database.port,com.ibm.tivoli.netcool.itnm.gui' value='50001'/>
    <data key='user.WAS_USER_NAME' value='smadmin'/>
    <data key='user.itnm.ObjectServerItnmAdminUsername,com.ibm.tivoli.netcool.itnm.gui' value='itnmadmin'/>
    <data key='user.itnm.ObjectServerItnmAdminUsername' value='itnmadmin'/>
    <data key='user.itncm.database.port' value='1521'/>
    <data key='user.itncm.database.schema' value='itncm'/>
    <data key='user.itncm.database.type' value='ORACLE_12'/>
    <data key='user.itncm.database.username' value='DBUSER'/>
    <data key='user.itncm.database.hostname' value='DatabaseServerLocation'/>
    <data key='user.itncm.pres.server.port' value='16311'/>
    <data key='user.itncm.pres.server.hostname' value='PresentationServerLocation'/>
    <data key='user.itncm.pres.server.skip.conn.check' value='true'/>
    <data key='user.itncm.pres.server.scheme' value='https'/>
    <data key='user.itncm.reports.path' value='/tarf/servlet/dispatch'/>
    <data key='user.itncm.reports.skip.conn.check' value='true'/>
    <data key='user.itncm.reports.port' value='16311'/>
    <data key='user.itncm.reports.hostname' value='TCRServerLocation'/>
    <data key='user.itncm.reports.scheme' value='https'/>
    <data key='user.WAS_PASSWORD,com.ibm.tivoli.netcool.itnm.gui' value=''/>
    <data key='user.itnm.ObjectServerItnmUserPassword,com.ibm.tivoli.netcool.itnm.gui' value=''/>
    <data key='user.WAS_PASSWORD' value=''/>
    <data key='user.itnm.ObjectServerItnmUserPassword' value=''/>
    <data key='user.itncm.database.password' value=''/>
  </profile>
  <install modify='false'>
    <!-- IBM Dashboard Applications for ITNCM 6.4.2 -->
    <offering profile='IBM Netcool GUI Components' id='com.ibm.tivoli.netcool.itncm.ui.dash' version='6.4.2.20160202_1049' 
features='main.feature.activityviewer,main.feature.wizard' installFixes='none'/>
  </install>
  <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='${sharedLocation}'/>
  <preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
  <preference name='com.ibm.cic.common.core.preferences.readTimeout' value='45'/>
  <preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
  <preference name='offering.service.repositories.areUsed' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
  <preference name='http.ntlm.auth.kind' value='NTLM'/>
  <preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
  <preference name='PassportAdvantageIsEnabled' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
  <preference name='com.ibm.cic.agent.ui.displayInternalVersion' value='false'/>
  <preference name='com.ibm.cic.common.sharedUI.showErrorLog' value='true'/>
  <preference name='com.ibm.cic.common.sharedUI.showWarningLog' value='true'/>
  <preference name='com.ibm.cic.common.sharedUI.showNoteLog' value='true'/>
</agent-input>

What to do next

Before you can access the Netcool Configuration Manager DASH components, you must set up the Netcool Configuration Manager DASH users and provide them with appropriate access permission.

Once users have been set up, you access the Netcool Configuration Manager DASH components, that is, the Activity Viewer, the DASH wizards, and the thick-client launch portal in the following ways:
  • You launch the stand-alone Netcool Configuration Manager UIs (sometimes referred to as the thick-client UIs), from the DASH thick-client launch portal.
  • You access the Activity Viewer, the DASH wizards, and a subset of reports in context from Network Manager and Tivoli Netcool/OMNIbus.
  • You access the complete reports using the DASH Tivoli Common Reporting GUI.