IBM Support

DB2 monitoring agent does not start with the instance user

Troubleshooting


Problem

ITCAM monitoring agent for DB2 fails to start as DB2 instance user.

Symptom

DB2 monitoring agent instance is configured to monitor db2inst1. Execute following command to start the agent:

su - db2inst1 -c "/opt/IBM/ITM/bin/itmcmd agent -o db2inst1 start ud"

Run following command to display running agents.

/opt/IBM/ITM/bin/cinfo -r

The output does not list the DB2 agent instance.

Cause

DB2 instance user does not have required permission to the files in ITM home directory.
For example, tivoli:staff user owns the ITM directory. All agents in the ITM home are started by the 'tivoli' user. The DB2 agent is started as 'db2inst1' user, which does not have permission to the files to start successfully.

Environment

UNIX, LINUX

Resolving The Problem

To resolve the issue, use secureMain tool to grant permission to a common user group as described below.

For example, assume that the ITM home directory is owned by 'tivoli' user and that DB2 agent needs to start as 'db2inst1' user.

1) Create an operating system user group, for example, 'itmgrp'. Add 'db2inst1' and 'tivoli' users to this group.

2) Run following command to grant access to the common user group:
ITM_HOME/bin/secureMain -g itmgrp lock

Note: this command is known to take a long time (up to one hour) to complete in some environments.

3) Start the DB2 monitoring agent as the DB2 instance user. The agent should start successfully.

[{"Product":{"code":"SS3JRN","label":"Tivoli Composite Application Manager for Applications"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ITCAM Agent for DB2 - 5724B96DO","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"7.1.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21681951