Tivoli Netcool Support's Guide to A Command Line Installation of Web GUI 8.1 by Jim Hutchinson Document release: 2.0

Transcription

1 Tivoli Netcool Support's Guide to A Command Line Installation of Web GUI 8.1 by Jim Hutchinson Document release: 2.0

2 Table of Contents 1Introduction Overview Packages...3 2Example Installation Create an installation user Install the Installation Manager Unpack the installation packages Run the Prerequisite checker Record the installation response file Check the response file Install WAS, JazzSM and DASH Install Web GUI Configure Web GUI Web GUI Fix Pack installation...8 3Example response file...9 IBM Copyright

3 1 Introduction 1.1 Overview The requirement for a GUI installation is on the WAS application for which the only option, for a command line installation is using the response file method. Products do provide template response files that can be edited, but it is easier to create a custom response file using the IBMIM tool on a donor system. Then use this response file to install WAS, JazzSM and DASH. Web GUI can also be installed at this time, but given the WEB GUI fix pack needs to be installed via the command interface, and the length of time a complete installation takes, it makes sense to install the products in phases, in case there are any unforeseen installation issues. Example Method Create a response file on a donor system Unpack the installation packages to a temporary directory tree Install the Installation Manager Install WAS, JazzSM and DASH using a response file Install Web GUI using imcl Install latest fix pack using imcl Example Environment Red Hat Linux Netcool/OMNIbus Web GUI 8.1 IBMÂ Installation Manager Jazz for Service Management extension for IBM WebSphere IBM WebSphere Application Server IBM WebSphere SDK Java Technology Edition (Optional) IBM Dashboard Application Services Hub IBM Tivoli Netcool/OMNIbus Web GUI Netcool/OMNIbus 8.1 IBM Copyright

4 1.2 Packages Required packages IBM Tivoli Netcool OMNIbus WebGUI Linux 64bit Multilingual (CN8HGML) [ 654MB / 18 Dec 2015 ] IBM WebSphere Application Server V for Jazz for Service Management Linux Multilingual (CNC1ZML) [ 1,461MB / 15 Jun 2016 ] Jazz for Service Management for Linux Multilingual (Launchpad, PRS, Jazz Repository, TDI) (CNC1PML) [ 1,264MB / 15 Jun 2016 ] Latest Installation manager suitable for Netcool/OMNIbus from fix central Latest Web GUI fix pack from the support's download pages Example packages IBMIM & imcl agent.installer.linux.gtk.x86_64_ _1611.zip Jazz for Service Management JAZZ_FOR_SM_ _FOR_LNX.zip Webshpere Application Server for JazzSM WAS_V _FOR_JSM_FOR_LINUX_ML.zip Netcool/OMNIbus Web GUI OMNIbus-v WebGUI.linux64.zip Netcool/OMNIbus Web GUI 8.1 fix pack 8 OMNIbus-v8.1.0-WebGUI-FP8-IM-linux64-UpdatePack.zip IBM Copyright

5 2 Example Installation The following is an example installation performed in the example environment using the packages listed previously. 2.1 Create an installation user Add an entry for the installation user in the /etc/passwd file webgui81::811:333:webguiuser:/opt/webgui81:/bin/csh Create the users directory as root mkdir /opt/webgui81 chown webgui81 /opt/webgui81 chgrp ncoadmin /opt/webgui Install the Installation Manager Unpack and install the Installation Manager package using the userinstc script. cd /opt/downloads mkdir tmp mkdir tmp/im cd tmp/im unzip../../agent.installer.linux.gtk.x86_64_ _1611.zip./userinstc -acceptlicense 2.3 Unpack the installation packages Create temporary directorys to hold the unzipped packages and unpack the packages ready for installation via the repository system. The paths to these directories is best kept consistent between the donor and target systems, but may be different, provided the path is updated in the response file prior to installation on the donor system. cd /opt/downloads/tmp mkdir WAS_8559 JAZZSM_1130 WEBGUI_814 cd WAS_8559 unzip../../was_v _for_jsm_for_linux_ml.zip cd../jazzsm_1130 unzip../../jazz_for_sm_ _for_lnx.zip cd../webgui_814 unzip../../omnibus-v webgui.linux64.zip IBM Copyright

6 2.4 Run the Prerequisite checker Support's Guide to a CLI Installation of Web GUI 8.1 Run the prerequisite checker on the systems before attempting to perform any installation, and check the details for any installation issues. Update the script to use the bourne shell cd /opt/downloads/tmp/jazzsm_1130 vi PrereqScanner/prereq_checker.sh #! /bin/sh Run the checker for JazzSM & DASH setenv JazzSM_FreshInstall True PrereqScanner/prereq_checker.sh DSH Run the check for Web GUI PrereqScanner/prereq_checker.sh NOW 2.5 Record the installation response file Record a response file using the same directory structure on a donor system with a display where IBMIM will run. Create the same user and unpacked packages structure on a donor system so that the response file can be used on the target system unedited. The donor system only needs to pass the prerequisite checker and contain the unpacked packages, as the recording of the installation response file does not install any packages. In the example given, the response file is recorded to /tmp along with installation details, /tmp/my_webgui_skip_install. To re-run the installation remove or rename both files. ~/IBM/InstallationManager/eclipse/IBMIM -record /tmp/my_webgui_install.xml -skipinstall /tmp/my_webgui_skip_install Set repositories File->Preferences->repositories Prevent searching Use the 'Add repository' option to add the three installation repositories 1. WAS_ JAZZSM_ WEBGUI_814 For the example WAS, JazzSM & DASH Install select 1. IBM WAS 2. IBM WAS SDK Java 3. JazzSM IBM WebSphere IBM DASH Set the installation paths and ports as required Set the smadmin users password and validate it Continue installation and click Finish to close the GUI IBM Copyright

7 2.6 Check the response file Check the response file was created as required and update any paths, if the donor systems repositories have different paths. <variables> <variable name='sharedlocation' value='/opt/webgui81/ibm/imshared'/> </variables> <server> <repository location='/opt/downloads/webgui/tmp/was_8559/wasrepository/disk1'/> <repository location='/opt/downloads/webgui/tmp/jazzsm_1130/jazzsmrepository/disk1'/> <repository location='/opt/downloads/webgui/tmp/webgui_814/omnibuswebguirepository'/> </server> <profile id='ibm WebSphere Application Server V8.5' installlocation='/opt/webgui81/ibm/websphere/appserver'> <data key='cic.selector.arch' value='x86'/> </profile> 2.7 Install WAS, JazzSM and DASH Use the imcl command on the target system to install the packages as defined in the response file. Copy the response file to the target system and run the imcl command as the installation user. There should be no issues, provided the prerequisite checker confirmed the packages can be installed and that the packages match the ones from the donor system. ~/IBM/InstallationManager/eclipse/tools/imcl -input /tmp/my_webgui_install.xml -silent -acceptlicense -log /tmp/my_webgui_install_1.log... Completed successfully Check the installation was successful ~/IBM/InstallationManager/eclipse/tools/imcl listinstalledpackages -features -long awk -F\: '{ print $3,$4}' IBMÂ Installation Manager Jazz for Service Management extension for IBM WebSphere IBM WebSphere Application Server IBM WebSphere SDK Java Technology Edition (Optional) IBM Dashboard Application Services Hub Login to WAS using a supported browser as smadmin to check the installation: Remember to logout IBM Copyright

8 2.8 Install Web GUI Use the imcl tool to install Web GUI ~/IBM/InstallationManager/eclipse/tools/imcl -c Check the installation preferences and remove the WAS & JazzSM repositories Set the Web GUI installation location to the webgui81 users tree M change location /opt/webgui81/ibm/netcool/gui Set the WAS servers smadmin password to netcool, if netcool was the chosen smadmin password Complete the installation settings as required Completed Successfully Check Web GUI was installed successfully ~/IBM/InstallationManager/eclipse/tools/imcl listinstalledpackages -features -long awk -F\: '{ print $3,$4}' IBMÂ Installation Manager Jazz for Service Management extension for IBM WebSphere IBM WebSphere Application Server IBM WebSphere SDK Java Technology Edition (Optional) IBM Dashboard Application Services Hub IBM Tivoli Netcool/OMNIbus Web GUI Configure Web GUI Before applying the Web GUI fix pack create a Web GUI administration user and set the datasources as required. Login via browser as smadmin Start the Websphere Application Server console Create a user called webguiadmin Exit the WAS console Give the webguiadmin user all of the user roles Check the Object Server details from $NCHOME/etc/omni.dat Login as the user webguiadmin Check Web GUI version and system information details Set Datasources as required via Datasources tab Logout of Web GUI before continuing IBM Copyright

9 2.10 Web GUI Fix Pack installation Unpack the fix pack package into a temporary directory and use the imcl tool to define the fix pack repository. Remember to remove any old repositories and that the fix pack installation is an UPDATE to an existing inistallation when making the installation selection. Unpack the fix pack zip file cd /opt/downloads/tmp mkdir FP8 cd FP8 unzip../../omnibus-v8.1.0-webgui-fp8-im-linux64-updatepack.zip Run the command line installer ~/IBM/InstallationManager/eclipse/tools/imcl -c Remove the Web GUI repository Add the fix pack 8 repository 1. [X] /opt/downloads/webgui/tmp/fp8/omnibuswebguirepository/composite Apply and return to main menu Update the existing Web GUI installation =====> IBM Installation Manager 2. Update - Find and install updates and fixes to installed software packages Update packages: 1-. [X] IBM Tivoli Netcool/OMNIbus Web GUI [X] Version Set smadmin password for WAS 5. Edit the password Check the target directory details before applying the update Completed successfully Check the installation using imcl IBMÂ Installation Manager Jazz for Service Management extension for IBM WebSphere IBM WebSphere Application Server IBM WebSphere SDK Java Technology Edition (Optional) IBM Dashboard Application Services Hub IBM Tivoli Netcool/OMNIbus Web GUI Login via a supported browser as webguiadmin and check the version details IBM Copyright

10 3 Example response file <?xml version='1.0' encoding='utf-8'?> <agent-input> <variables> <variable name='sharedlocation' value='/opt/webgui81/ibm/imshared'/> </variables> <server> <repository location='/opt/downloads/webgui/tmp/was_8559/wasrepository/disk1'/> <repository location='/opt/downloads/webgui/tmp/jazzsm_1130/jazzsmrepository/disk1'/> <repository location='/opt/downloads/webgui/tmp/webgui_814/omnibuswebguirepository'/> </server> <profile id='ibm WebSphere Application Server V8.5' installlocation='/opt/webgui81/ibm/websphere/appserver'> <data key='cic.selector.arch' value='x86'/> </profile> <install> <!-- IBM WebSphere Application Server > <offering profile='ibm WebSphere Application Server V8.5' id='com.ibm.websphere.base.v85' version=' _0435' features='core.feature,ejbdeploy,thinclient,embeddablecontainer,com.ibm.sdk.6_64bit'/> <!-- IBM WebSphere SDK Java Technology Edition (Optional) > <offering profile='ibm WebSphere Application Server V8.5' id='com.ibm.websphere.ibmjava.v70' version=' _1826' features='com.ibm.sdk.7'/> <!-- Jazz for Service Management extension for IBM WebSphere > <offering profile='ibm WebSphere Application Server V8.5' id='com.ibm.tivoli.tacct.psc.install.was85.extension' version=' ' features='main.feature'/> </install> <profile id='core services in Jazz for Service Management' installlocation='/opt/webgui81/ibm/jazzsm'> <data key='cic.selector.arch' value='x86_64'/> <data key='user.bootstrap_address' value='19312'/> <data key='user.csiv2_ssl_mutualauth_listener_address' value='19322'/> <data key='user.soap_connector_address' value='19313'/> <data key='user.csiv2_ssl_serverauth_listener_address' value='19323'/> <data key='user.dcs_unicast_address' value='19318'/> <data key='user.ipc_connector_address' value='19314'/> <data key='user.orb_listener_address' value='19320'/> <data key='user.wc_defaulthost_secure' value='19311'/> <data key='user.rest_notification_port' value='19324'/> <data key='user.wc_defaulthost' value='19310'/> <data key='user.wc_adminhost_secure' value='19316'/> <data key='user.sas_ssl_serverauth_listener_address' value='19321'/> <data key='user.wc_adminhost' value='19315'/> <data key='user.tip_context_root' value='/ibm/console'/> <data key='user.was_home' value='/opt/webgui81/ibm/websphere/appserver'/> <data key='user.create_new_was_profile' value='true'/> <data key='user.was_profile_path' value='/opt/webgui81/ibm/jazzsm/profile'/> <data key='user.was_profile_name' value='jazzsmprofile'/> <data key='user.was_host_name' value='jmw2k8r2.sbank.uk.ibm.com'/> <data key='user.was_server_name' value='server1'/> <data key='user.was_node' value='jazzsmnode01'/> <data key='user.was_user_name' value='smadmin'/> <data key='user.was_password' value='mkzgom+ucqpj8e5dvuk8dw=='/> <data key='user.was_cell' value='jazzsmnode01cell'/> </profile> <install> <!-- IBM Dashboard Application Services Hub > <offering profile='core services in Jazz for Service Management' id='com.ibm.tivoli.tacct.psc.tip.install' version=' ' features='com.ibm.tivoli.tacct.psc.install.server.feature.tip.install,com.ibm.tivoli.tacct.psc.install.server.fe ature.tip.config'/> </install> <preference name='com.ibm.cic.common.core.preferences.eclipsecache' value='${sharedlocation}'/> <preference name='offering.service.repositories.areused' value='false'/> </agent-input> IBM Copyright