IBM Tivoli Monitoring Agent for Lotus Domino 6.2.1-TIV-ITM_DOM-FP0002

Download Description

(C) Copyright International Business Machines Corporation 2016.
All rights reserved.

Component: IBM(R) Tivoli(R) Composite Application Manager Agent for Lotus Domino,
Version 6.2.1.2

Component ID: 5724B98D0

Fix Pack: 0002, 6.2.1-TIV-ITM_DOM-FP0002

Date: Sept 14, 2016

Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Copyright and trademark information
10.0 Notices

1.0 General description
=======================
This fix provides a common installer for IBM(R) Tivoli(R) Composite Application
Manager Agent for Lotus Domino on all the supported platforms.


2.0 Problems fixed
==================
The following problems are addressed by this fix.

2.1 APARs
---------
None.

2.2 Defects:
------------
None.


2.3 Enhancements:
-----------------
The self-describing agent capability is now added to the Lotus Domino agent
V 6.2.1 Fix Pack 2. With the self-describing agent capability, new or updated
IBM Tivoli Monitoring agents using IBM Tivoli Monitoring V6.2.3 or later can become
operational after installation without having to perform additional product support
installation steps.

2.4 Superseded fixes:
---------------------
6.2.1-TIV-ITM_DOM-FP0001

2.5 APARS and defects included from superseded fixes
----------------------------------------------------
APAR: IV70952
Abstract: ON ZLINUX64 PLATFORM,IF THE GSK IS UPGRADED TO VERSION 8,AGENT
CAN NOT BE STARTED.
Additional Information:
When the OS agent v630 is installed it upgrades GSKit to version 8,
With this GSKit version agent fails to start with following error,
"error while loading shared libraries: libgsk7iccs_64.so: cannot open
shared object file: No such file or directory"

APAR: IV72476
Abstract: ON ZLINUX64 PLATFORM, DOMINO AGENT DEPENDS ON AX LS3246, BUT THE
ARCHCODE IS NOT SUPPORTED FROM ITM630
Additional Information:
When OS agent v630 is installed, ax component gets installed under
ls3266 arch code. But, as Domino agent is installed under ls3246 arch code;
it still depends on ax ls3246.To resolve this, Domino agent should be
Installed for ls3266

3.0 Architecture and prerequisites
==================================
This fix is a full fresh install image. It is supported on the following
operating systems.

- AIX 7.1 (64-bit)
- AIX 6.1 (64-bit)
- AIX 5.3 (32 and 64-bit)
- Red Hat Enterprise Linux (RHEL) Server 7 x86-64
- Red Hat Enterprise Linux (RHEL) Server 7 System z 64-bit
- Red Hat Enterprise Linux (RHEL) 6.0 AS/ES x86-32
- Red Hat Enterprise Linux (RHEL) 6.0 AS/ES x86-64
- Red Hat Enterprise Linux (RHEL) 6.0 AS System z 64-bit
- Red Hat Enterprise Linux (RHEL) 5.0 AS/ES x86-32
- Red Hat Enterprise Linux (RHEL) 5.0 AS/ES x86-64
- Red Hat Enterprise Linux (RHEL) 5.0 AS System z 64-bit
- SuSE Linux (SLES) 12.0 Enterprise Server x86-64
- SuSE Linux (SLES) 11.0 Enterprise Server System z 64-bit
- SuSE Linux (SLES) 11.0 Enterprise Server x86-32
- SuSE Linux (SLES) 11.0 Enterprise Server x86-64
- SuSE Linux (SLES) 10.0 Enterprise Server x86-32
- SuSE Linux (SLES) 10.0 Enterprise Server x86-64
- SuSE Linux (SLES) 10.0 Enterprise Server System z 64-bit
- Windows Server 2012 R2 Standard Edition x86-64
- Windows Server 2012 Standard Edition x86-64
- Windows Server 2012 R2 Datacenter Edition x86-64
- Windows Server 2012 Datacenter Edition x86-64
- Windows Server 2008 R2 Enterprise Edition x86-64
- Windows Server 2008 R2 Standard Edition x86-64
- Windows Server 2008 Enterprise Edition x86-32
- Windows Server 2008 Enterprise Edition x86-64
- Windows Server 2003 Enterprise Edition x86-32
- Windows Server 2003 Enterprise Edition x86-64
- Solaris 10 SPARC 32
- Solaris 10 SPARC 64

The following link is for the Tivoli operating system and application
support matrix. Please refer to this matrix for the latest
certification information.

http://www.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html

3.1 Prerequisites for this fix
-------------------------------
The prerequisite level for this fix is as follows:
- Lotus Domino 8.5 or later

4.0 Image directory contents
============================
This fix image contains the following files:
- 6.2.1-TIV-ITM_DOM-FP0002.README - This README file
- 6.2.1-TIV-ITM_DOM-FP0002.tar.gz - Fix archive .tar format

Note: The .tar and .zip files are identical in content. Use the .tar
file if you are working in a UNIX(R) environment; use the .zip file if
you are working in a Windows(R) environment.

The fix archive file contains the following components:
- ITCAM Agent for Lotus Domino
- Tivoli Enterprise Portal Browser Client support for Domino Agent
- Tivoli Enterprise Portal Server support for Domino Agent
- Tivoli Enterprise Monitoring Server support for Domino Agent


5.0 Installation instructions
=============================
This is a full installation image for Domino Agent

5.1 Before installing the fix
-----------------------------
- The prerequisites listed under section 3.1 entitled 'Prerequisites
for this fix' must be installed before this fix can be installed.

- For the purpose of this README, the symbol <CANDLEHOME> is the
IBM Tivoli Monitoring installation directory. The default value
for CANDLEHOME is '/opt/IBM/ITM' on UNIX systems and 'C:\IBM\ITM'
on Windows systems.

- Before installing this fix on UNIX systems, set the environment
variable CANDLEHOME to the IBM Tivoli Monitoring installation
directory.

For example:
> CANDLEHOME=/opt/IBM/ITM
> export CANDLEHOME

5.2 Local agent installation
----------------------------
1. Transfer the appropriate archive file
6.2.1-TIV-ITM_DOM-FP0002.tar.gz (on Linux or UNIX) and
6.2.1-TIV-ITM_DOM-FP0002.zip (on Windows system) to a temporary directory
on the system where the agent code is to be installed.

2. Expand the archive file using the "tar" command on UNIX systems
or an extract utility on Windows systems.This step creates a
directory structure that contains fixes for all of the supported
platforms.

3. Follow the instructions in the ITCAM for Apps 7.2.1.2 User Guide to install the agent.

4. To configure the Domino agent, follow the instructions in ITCAM for Apps 7.2.1.2 User Guide.


5.3 Remote agent installation
-----------------------------
1. Transfer the appropriate archive file
(6.2.1-TIV-ITM_DOM-FP0002.tar.gz or .zip) to a temporary directory
on the IBM Tivoli Enterprise Monitoring Server system.
For the purpose of this README, the symbol <TEMP> represents the
fully qualified path to this directory.
Note: On Windows, this includes the drive letter.

2. Expand the archive file using the tar command on UNIX systems or
an unzip utility on Windows systems. This creates a directory
structure that contains fixes for all of the supported platforms.

3. To add the agent fix bundles into the remote deploy depot, use the
tacmd addBundles command found in $CANDLEHOME/bin on UNIX systems
or in %CANDLE_HOME%\bin on Windows systems. For more information
on the tacmd addBundles command, see Appendix A. Commands
reference in the IBM Tivoli Monitoring Administrator's Guide.

On UNIX systems,
if the fix was expanded to <TEMP>/6.2.1-TIV-ITM_DOM-FP0002:
For Unix or Linux deployment
> $CANDLEHOME/bin/tacmd addBundles -t gb -i <TEMP>/6.2.1-TIV-ITM_DOM-FP0002/unix
For Windows deployment
> $CANDLEHOME/bin/tacmd addBundles -t gb -i <TEMP>/6.2.1-TIV-ITM_DOM-FP0002/Windows/Deploy


On a Windows system,
if the fix was expanded to <TEMP>/6.2.1-TIV-ITM_DOM-FP0002:
For Unix or Linux deployment
> %CANDLE_HOME%\bin\tacmd addBundles -t gb -i <TEMP>\6.2.1-TIV-ITM_DOM-FP0002\unix
For Windows deployment
> %CANDLE_HOME%\bin\tacmd addBundles -t gb -i <TEMP>\6.2.1-TIV-ITM_DOM-FP0002\Windows\Deploy

where:
-t specifies the product code or codes of the products to add.
The Domino agent product code is gb.
-i is the directory that contains the deployment bundles to be
added to the depot.

4. You can deploy the agent through the portal or command line.

Deploy Option 1. Deploy through the portal
--------------------------------------

Follow the instructions below to deploy the agent through the
portal client.

a. Open the Tivoli Enterprise Portal.
b. In the Navigation tree, navigate to the computer where you want
to deploy the agent.
c. Right-click the computer and click Add Managed System.
d. Select the agent that you want to deploy and click OK.
e. Complete the configuration fields required for the agent. For
information about these fields, refer to Agent installation and configuration
section for Lotus Domino Agent in ITCAM for Apps 7.2.1.2 User Guide.
f. Click Finish.
g. If the computer where you are deploying the agent already has a
version of that agent installed, you can stop the deployment, add
a new instance of the agent, if possible, or reconfigure the
existing agent.

A message tells you when the deployment finishes successfully.

Deploy Option 2. Deploy through the command line
--------------------------------------------
To login to the Tivoli Enterprise Monitoring Server, and deploy
the fix to the appropriate nodes where the agent is running, use
the following tacmd commands. For more information on the
tacmd login and addSystem commands, see Appendix A. Commands
reference in the IBM Tivoli Monitoring Administrator's Guide.

On a UNIX system:
> $CANDLEHOME/bin/tacmd login -s <server>
-u <itmuser>
-p <password>

> $CANDLEHOME/bin/tacmd listSystems

The output shows the Managed System Name for the OS agent on the
remote system to be updated. Use this value as the target of the
tacmd addSystem command.

> $CANDLEHOME/bin/tacmd addSystem -t gb
-n <Managed system name>
-p config.KGB_CHECK_DB_EXCLUDE_PATH=<value>
config.KGB_CHECK_DB_INCLUDE_PATH=<value>
config.KGB_CHECK_DB_INTERVAL=<value>
config.KGB_CHECK_DB_VIEW_CONFIG_FILE=<value>
config.KGB_IWHOSTNAME=<value>
config.KGB_IWPORT=<value>
config.KGB_LOGERROR=<value>
config.KGB_LOGFILE=<value>
config.KGB_LOG_EXCLUDE=<value>
config.KGB_LOG_INCLUDE=<value>
config.KGB_NOTESINIPATH=<value>
config.KGB_SERVER=<value>
INSTANCE=<instance name>

where:
-p specifies one or more configuration properties that identify
configuration properties of the new system and their values.
Each property corresponds to a configuration parameter on the
GUI configuration panel or the console configuration wizard.
The following list is the mapping list:

KGB_CHECK_DB_EXCLUDE_PATH : The databases or database directories to exclude
KGB_CHECK_DB_INCLUDE_PATH : The databases or database directories to check
KGB_CHECK_DB_INTERVAL : The interval to check database
KGB_CHECK_DB_VIEW_CONFIG_FILE: The configuration file to define which views
of a database to check
KGB_IWHOSTNAME : Local hostname or IP address for Intelliwatch Events
KGB_IWPORT : Local port for Intelliwatch Events
KGB_LOGERROR : Log file errors to search for
KGB_LOGFILE : Monitored Domino Server Log File
KGB_LOG_EXCLUDE : Semicolon separated database replication strings to
exclude
KGB_LOG_INCLUDE : Semicolon separated database replication strings to
include
KGB_NOTESINIPATH : Full path to the local notes.ini file
KGB_SERVER : Monitored Domino Server Name
INSTANCE : The agent instance name

To specify a value for each property,refer to Agent installation and configuration
section for Lotus Domino Agent in ITCAM for Apps 7.2.1.2 User Guide.

On a Windows system:
> %CANDLE_HOME%\bin\tacmd login -s <server>
-u <itmuser>
-p <password>

> %CANDLE_HOME%\bin\tacmd listSystems

The output shows the Managed System Name for the OS agent on the
remote system to be updated. Use this value as the target of the
tacmd addSystem command.

> %CANDLE_HOME%\bin\tacmd addSystem -t gb
-n <Managed system name>
-p config.KGB_CHECK_DB_EXCLUDE_PATH=<value>
config.KGB_CHECK_DB_INCLUDE_PATH=<value>
config.KGB_CHECK_DB_INTERVAL=<value>
config.KGB_CHECK_DB_VIEW_CONFIG_FILE=<value>
config.KGB_IWHOSTNAME=<value>
config.KGB_IWPORT=<value>
config.KGB_LOGERROR=<value>
config.KGB_LOGFILE=<value>
config.KGB_LOG_EXCLUDE=<value>
config.KGB_LOG_INCLUDE=<value>
config.KGB_NOTESINIPATH=<value>
config.KGB_SERVER=<value>
INSTANCE=<instance name>

where:
-p specifies one or more configuration properties that identify
configuration properties of the new system and their values.
Each property corresponds to a configuration parameter on the
GUI configuration panel or the console configuration wizard.
The following list is the mapping list:

KGB_CHECK_DB_EXCLUDE_PATH : The databases or database directories to exclude
KGB_CHECK_DB_INCLUDE_PATH : The databases or database directories to check
KGB_CHECK_DB_INTERVAL : The interval to check database
KGB_CHECK_DB_VIEW_CONFIG_FILE: The configuration file to define which views
of a database to check
KGB_IWHOSTNAME : Local hostname or IP address for Intelliwatch Events
KGB_IWPORT : Local port for Intelliwatch Events
KGB_LOGERROR : Log file errors to search for
KGB_LOGFILE : Monitored Domino Server Log File
KGB_LOG_EXCLUDE : Semicolon separated database replication strings to
exclude
KGB_LOG_INCLUDE : Semicolon separated database replication strings to
include
KGB_NOTESINIPATH : Full path to the local notes.ini file
KGB_SERVER : Monitored Domino Server Name
INSTANCE : The agent instance name

To specify a value for each property, refer to Agent installation and configuration
section for Lotus Domino Agent in ITCAM for Apps 7.2.1.2 User Guide.

5.4 Agent support files installation
------------------------
To install support files for the Domino agent,please refer ITCAM for Apps 7.2.1.2 User Guide.

6.0 Additional installation information
========================================
None.

7.0 Known problems and workarounds
==================================
None.

8.0 Additional product information
==================================
None.

9.0 Copyright and trademark information
==================================
A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.


10.0 Notices
=======

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some jurisdictions do not allow disclaimer of express or implied
warranties in certain transactions, therefore, this statement may not
apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

Other company, product, or service names may be trademarks or service
marks of others.

Third-Party License Terms and Conditions, Notices and Information
-----------------------------------------------------------------
The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to
certain software code. The relevant terms and conditions, notices and
other information are provided or referenced below. Please note that
any non-English version of the licenses below is unofficial and is
provided to you for your convenience only. The English version of the
licenses below, provided as part of the English version of this file,
is the official version.

Notwithstanding the terms and conditions of any other agreement you
may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified below
are "Excluded Components" and are subject to the following terms and
conditions:

- the Excluded Components are provided on an "AS IS" basis
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE
AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with respect
to the Excluded Components.