Installing the product in silent mode

Silent installation requires an XML response file that defines the installation configuration. Silent mode is useful if you want identical installation configurations on multiple workstations.

Before you begin

Set the necessary user permissions for your intended installation directories. See the IBM Installation Manager overview, and the information under 'About this task'.

Close and stop all system processes before beginning silent installation. This includes all monitoring software, databases, and third party packages.

Performing the installation requires full administrative access to the entire system. Full system authorization to read, write, add, and delete all system files and applications must be established before beginning the installation.

Perform the following checks before installation:
Defining sufficient memory (or SWAP) space
There can be issues installing Netcool Configuration Manager if there is not enough available memory or SWAP space. This problem can be eliminated by doing one of the following:
  • Allocate more SWAP space.
  • Separate SWAP and /tmp.
  • Allocate more space to /tmp.
Setting sufficient Oracle process limits (for Oracle database use only)
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

About this task

The steps for starting Installation Manager differ depending on the user mode in which it was installed.

The Installation Manager console installation steps 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.
  • Run one of the following installations without actually installing the product, and record the installation settings:
    GUI installation
    For example:
    IBMIM -record /home/icosuser/response_files/Presentation_Worker.xml 
    -skipInstall /tmp/skipInstall
    Console installation
    Follow the steps in Installing in console mode and generate a silent Install file instead of installing the product.
The response file includes the location of the repository from which the installation package is obtained.
  • You can specify a local or remote repository.
  • You can have Installation Manager download the package from IBM Passport Advantage.
Tip: Response Files are not transferable across different platforms. For example, a response file generated on a Linux machine can not be used on an AIX machine.
Attention: When using the IBM Installation Manager to install zLinux, you may receive a number of warnings. Ignore these and proceed with the installation.

Procedure

  1. Record the response file or files.
  2. Read the license.txt license agreement file, which you can find in the installation package (in /native/license_version.zip).
  3. Start the silent installation using the following command, as the icosuser user:
    ./imcl -input response_file -silent -acceptlicense [-log full_path_to_log_file]
    Where response_file is the directory path to the response file that you recorded in step one, and full_path_to_log_file is the location in which the installation log is created.

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='/home/icosuser/IBM/IMShared'/>
  </variables>
  <server>
    <repository location='/home/icosuser/repo'/>
  </server>
  <profile id='Netcool Configuration Manager' installLocation='/opt/IBM/tivoli/netcool/ncm'>
    <data key='eclipseLocation' value='/opt/IBM/tivoli/netcool/ncm'/>
    <data key='user.import.profile' value='false'/>
	<!--Update architecture to linux for RHEl and SUSE-->
    <data key='cic.selector.os' value='aix'/>
    <!--Updae architecture to x86_64 for RHEl and SUSE-->
	<data key='cic.selector.arch' value='ppc64'/>
    <data key='cic.selector.ws' value='gtk'/>
    <data key='cic.selector.nl' value='en'/>
    <data key='user.tcr.was.user.name' value='smadmin'/>
    <data key='user.tcr.was.user.password' value=''/>
    <data key='user.tmp.tcr.was.password' value=''/>
    <data key='user.itncm.reports.update' value='false'/>
    <data key='user.tmp.ins.loc' value=''/>
    <data key='user.tcr.jazz.home' value=''/>
    <data key='user.tcr.was.profile.path' value=''/>
    <data key='user.tcr.was.server.name' value=''/>
    <data key='user.itncm.jdbc.type' value='oracle12'/>
    <data key='user.itncm.jdbc.driver' value='oracle.jdbc.driver.OracleDriver'/>
    <data key='user.itncm.jdbc.url' value='jdbc:oracle:thin:@ServerLocation:1521/itncm'/>
    <data key='user.itncm.jdbc.credentials.password' value=''/>
    <data key='user.itncm.jdbc.schema.name' value='itncm'/>
    <data key='user.itncm.jdbc.credentials.user' value='DBUSER'/>
    <data key='user.itncm.jdbc.host' value='ServerLocation'/>
    <data key='user.itncm.jdbc.port' value='1521'/>
    <data key='user.itncm.jdbc.type.prop' value='oracle'/>
    <data key='user.itncm.user.operator.password' value=''/>
	<!--Set to false for a worker Installation-->
    <data key='user.itncm.gui.active' value='true'/>
    <data key='user.temp.confirm.itnm.pass' value=''/>
    <data key='user.itncm.ftp.credentials.password' value=''/>
    <data key='user.itncm.ftp.host' value='localhost'/>
    <data key='user.itncm.pbcm.log.error.port' value='8112'/>
    <data key='user.itncm.log.port' value='8102'/>
    <data key='user.itncm.ftp.dir' value='/home/icosftp'/>
    <data key='user.itncm.pbcm.log.listen.port' value='8114'/>
    <data key='user.itncm.pbcm.admin.port' value='8110'/>
    <data key='user.itncm.nmentitymapping.port' value='16311'/>
    <data key='user.temp.confirm.ftp.pass' value='icosftp'/>
	<!--Update to WORKER,TRUE,FALSE,DUAL for a worker server-->
    <data key='user.itncm.server.platform.config' value='PRESENTATION,TRUE,FALSE,DUAL'/>
    <data key='user.itncm.root.realm' value='ITNCM'/>
    <data key='user.itncm.log.listen.port' value='8103'/>
    <data key='user.itncm.pbcm.active' value='true'/>
    <data key='user.itncm.user.observer.password' value=''/>
    <data key='user.itncm.user.administrator.password' value=''/>
    <data key='user.itncm.admin.port' value='8101'/>
    <data key='user.itncm.idt.main.server' value='true'/>
    <data key='user.core.smtp.server' value='localhost'/>
    <data key='user.itncm.job.type' value='update'/>
    <data key='user.itncm.nmentitymapping.hostname' value='localhost'/>
    <data key='user.itncm.ftp.credentials.user' value='icosftp'/>
    <data key='user.itncm.nmentitymapping.nm.password' value=''/>
    <data key='user.itncm.pbcm.log.test.port' value='8115'/>
    <data key='user.itncm.main.install.dir' value='/opt/IBM/tivoli/netcool/ncm'/>
    <data key='user.itncm.pbcm.log.debug.port' value='8111'/>
    <data key='user.itncm.nmentitymapping.nm.importrealm' value='ITNCM/@DOMAINNAME'/>
    <data key='user.itncm.worker.linked.rg' value='false'/>
    <data key='user.itncm.admin.manager.server.name' value='instanceName'/>
    <data key='user.itncm.nmentitymapping.base.url' value=''/>
    <data key='user.itncm.pbcm.log.info.port' value='8113'/>
    <data key='user.itncm.worker.active' value='true'/>
    <data key='user.itncm.integrated' value='false'/>
    <data key='user.itncm.idt.port' value='8104'/>
    <data key='user.itncm.nmentitymapping.nm.user' value='itnmadmin'/>
    <data key='user.itncm.server.was.node' value='JazzSMNode01'/>
    <data key='user.was.server.name' value='server1'/>
    <data key='user.was.profile.path' value='/opt/IBM/JazzSM/profile'/>
    <data key='user.was.appserver.dir' value='/opt/IBM/WebSphere/AppServer'/>
    <data key='user.itncm.server.ssl.port' value='16311'/>
    <data key='user.itncm.server.was.cell' value='JazzSMNode01Cell'/>
    <data key='user.was.user.password' value=''/>
    <data key='user.was.user.name' value='smadmin'/>
    <data key='user.tmp.was.password' value=''/>
    <data key='user.itncm.server.http.port' value='16310'/>
    <data key='user.jazz.home' value='/opt/IBM/JazzSM'/>
    <data key='user.was.profile.name' value='JazzSMProfile'/>
  </profile>
  <install modify='false'>
    <!-- Netcool Configuration Manager 6.4.2.0  update features to Jre for a worker server-->
    <offering profile='Netcool Configuration Manager_1' id='com.ibm.tivoli.itncm.configurationmanager.server' 
version='6.4.2.20160202_1049' features='liberty' 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='false'/>
  <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

Next, you perform a number of post-installation procedures. For example, if you did not set the key='user.itncm.jdbc.schema.initialload' property value of the response file to true, you must manually load the schema before you can start Netcool Configuration Manager.
Warning: In an upgrade scenario, or if additional presentation servers are being installed, you may need to manually change this value to false.
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.