IBM Tivoli Netcool/Impact V6.1.0 Fix Pack 4(6.1.0-TIV-NCI-FP0004)

Installation Instructions

============================
3.0 Installation information
============================

3.1 Dependencies

IBM Tivoli Netcool/Impact version 6.1.0

This Fix Pack is applied to Tivoli Netcool/Impact 6.1.0 Server and 6.1.0 GUI
Server.

This Fix Pack can also be installed on top of Fix Pack 1, 2 or 3.

3.2 Prerequisites

Tivoli Integrated Portal 2.2.0.17 (TIP FP 2.2.0.17) or higher certified
versions of TIP must be installed after installing this fix pack.

If the Impact server and GUI server are installed on different systems,
the TIP FP needs to be installed only on the GUI server.

If TIP FP 2.2.0.17 is installed on the GUI Server which is on a separate
system, the eWAS on the Impact Server system must be upgraded to eWAS
7.0 Fix Pack 39.

Please note that eWAS AppServer and eWAS SDK 7.0 Fix Pack 39 addresses
various security related issues.

If the Impact Server and TIP are on the same system, the TIP Server
and the Impact server must be stopped prior to installing the TIP FP.


To download TIP FP 2.2.0.17 go to:

http://www.ibm.com/support/fixcentral/swg/selectFixes?
parent=ibm~Tivoli&product=ibm/Tivoli/Tivoli+Integrated+Portal
&release=2.2.0.17&platform=All&function=all


3.3 Special considerations

To apply this Fix Pack you will need 1700 Mb of free disk space.

1. Backup the current server using the command:
nci_export <serverInstanceName> <absolute path directory>

For example:
Non-Windows Operating System:
$NCHOME/impact/bin/nci_export NCI /tmp/exports/NCI_exports

Windows Operating System:
%NCHOME%\impact\bin\nci_export NCI C:\tmp\exports\NCI_exports

2. Backup the current jar file:
Non-Windows Operating System:
cp $NCHOME/impact/lib/nci<date><current-buildlevel>.jar $NCHOME/impact/tmp/

Windows Operating System:
copy %NCHOME%\impact\lib\nci<date><current-buildlevel>.jar %NCHOME%\impact\tmp\

3. Server Name
If the Impact instance name contains a dash ("-"), then the upgrade will
fail to upgrade Impact 6.1.0 to FP4. For example: If the instance name is
"NCI-1", then the upgrade will fail. If the instance name is "NCI_1", then
the upgrade will succeed.

4. You will be prompted during the installation to specify a backup
directory name. The installer backs up DE at this location.

NOTE: Please ensure this backup directory exists with write permission before launching the installer.

5. This Fix Pack does not back up the entire Impact application. It only
backs up the files that it has updated or replaced. A backup copy of the
original files is located at [InstallDirectory]/tipv2/logs/impact/maintenance/backup/6.1.0.0/FP0004


3.4 Superceded Fixes

6.1.0-TIV-NCI-FP0003 is superceded by this Fix Pack.
6.1.0-TIV-NCI-FP0002 is superceded by this Fix Pack.
6.1.0-TIV-NCI-FP0001 is superceded by this Fix Pack.


3.5 Extracting Fix Pack files

NOTE: Do not extract the files to a directory name containing
embedded spaces

3.5.1 Extracting on Linux, Solaris, and AIX platforms
1. Copy the 6.1.0-TIV-NCI-FP0004-<ARCH>.tar file to your system.
2. Unpack the file using this command:
* tar -xvf 6.1.0-TIV-NCI-FP0004-<ARCH>.tar

3.5.2 Extracting on Windows platforms to your system
1. Copy the 6.1.0-TIV-NCI-FP0004-windows.zip
2. Extract the contents of the file to a selected directory.

3.5.3 Fix pack directories

When you extract the file, this directory is created:

Impact Impact Server and GUI server updates


3.6 Installation in Cluster Environment
Please follow the instructions in the Netcool/Impact 6.1.0 administration guide
for setting up a server cluster.
http://www-01.ibm.com/support/knowledgecenter/SSSHYH_6.1.0/com.ibm.netcoolimpact.doc6.1/AdministrationGuide.pdf

3.7 Installation of the Fix Pack

[Fix Pack] Refers to the directory where you extracted the fix pack
files from the zip/tar file.

Attention: Install the fix pack with the same user that was used to
install Impact 6.1.0 GA

NOTE: If using the DE BACKUP default option, this Fix Pack installation
package needs to be on temporary directory does not contain
embedded spaces on its name. However; the DE Backup itself can
contain embedded spaces on its directory name.


Installing without a backup:

If you prefer to backup DE with your own procedures, you can
run the install with the following parameter:

-DNO_BACKUP=true

If you choose this method, you must backup DE
before you install. Restore the original system using
your backup or restore procedures or utilities.

The DE Database and its programs are located under the user's home
directory under ".acsi*" on Unix and under the following directory
on Windows: "C:\Program Files\ibm\Common\acsi"

Follow this procedure to install the fix pack:
1. Before installing the fix pack all Impact processes must be running.
2. Change to the [Fix Pack]/Impact directory where the you
extracted the files.
3. Run the installation using one the following commands:
* setupwin.exe - Windows.
* setup<ARCH>.bin - other operating systems.

Installation command options:

GUI mode
No options, for example:

Windows: setupwin.exe

Or

Unix: ./setup<ARCH>.bin

Console mode
Use the -i console option. For example:

Windows: setupwin.exe -i console

or

Unix: ./setup<ARCH>.bin -i console

Silent Mode
a. Copy installSilent_responseFP.txt from the Impact directory of the
extracted fix pack file to a location it can be edited (/tmp).
b. Update the file to match your environment
c. Run:

UNIX: setup<ARCH>.bin -f /tmp/installSilent_responseFP.txt

or

Windows: setupwin.exe -f C:\tmp\installSilent_responseFP.txt
Note: The response file needs to have a fully qualified path.
Note: before you do the upgrade, please backup impact data


3.8 Uninstalling the Fix Pack

Before uninstalling the fix pack all Impact processes must be
running.

Attention: Uninstall the fix pack with the same user that was used to
install Impact 6.1.0 GA.

Follow this procedure to uninstall the fix pack:
1. Change to the directory:
<installDir>/impact/_uninst/Impact_FP4
2. Run the uninstallation using one the following commands:
* uninstall.exe - Windows.
* uninstall - other operating systems.

Uninstallation command options:

GUI mode
No options, for example:

Windows: uninstall.exe

Or

Unix: ./uninstall

Console mode
Use the -i console option. For example:

Windows: uninstall.exe -i console

or

Unix: ./uninstall -i console

Silent Mode
a. If silent mode was used for the installation, the
uninstallation defaults to a silent uninstallation and
you must supply a response file or the uninstallation
fails.
b. Locate the uninstallSilent_responseFP.txt
file is located under the following directory:

<installDir>/impact/_uninst/Impact_FP4

c. Update the file uninstallSilent_responseFP.txt to match
your environment
d. Run:
UNIX: ./uninstall -f uninstallSilent_responseFP.txt
or
Windows: uninstall.exe -f uninstallSilent_responseFP.txt


3.9 Recovering from a failed fix pack installation

If the installation fails, attempt an uninstallion in which case, it reverts to the
previous version. If there is no uninstallation file in the _uninst/Impact_FP4 directory,
nothing is installed and you can delete the Impact_FP4 directory and
reinstall.

3.10 Policies overwritten by this Fix Pack

When applying Test Fixes and Interim Fixes/Fix Packs to an existing system, the policies
provided by IBM may be overwritten with newer versions to fix issues. If these policies
contain custom changes, you will need to update these newer files with the custom changes.

In this Fix Pack, the following policies have been overwritten:
*_DiscreteOidSetTest.ipl
*_DiscreteOidTest.ipl
*_EIC_utils.ipl
*_Import.ipl
*_MWM.ipl
*_MigrateMWMWindows.ipl
*_PackedOidSetTest.ipl
*_PackedOidTest.ipl
*_Opview_Add1TWin.ipl
*_Opview_EIC_confSubmit.ipl
*_Opview_EIC_requestHandler.ipl
*_Opview_onetwins.ipl
*_Opview_openwins.ipl
*_Opview_rdomwins.ipl
*_Opview_rdowwins.ipl
*_Opview_rwdomwins.ipl
*_SerialRollover.ipl
*_SNMPGetActionTest.ipl
*_SNMPGetNextActionTest.ipl
*_SNMPSetActionTest.ipl
*_SNMPTableSetTest.ipl
*_SNMPTableTest.ipl
*_SNMPTrapActionTest.ipl
*_UTIL.ipl
*_XINY_DataType_PurgeData.ipl

Backups of the original files can be found under
[InstallDirectory]/tipv2/logs/impact/maintenance/backup/6.1.0.0/FP0004/policy.

==========================
Additional information
==========================

Please refer to Tivoli Netcool/Impact 6.1.0 Documentation for additional information

There is no new additional information with this Fix Pack