Domino Agent 6.21 IF0004 fails to start kgbclient process on Windows platform with Domino Server 6.5/7

Technote (troubleshooting)


Problem(Abstract)

Domino Agent 6.21 IF0004 fails to start kgbclient_<instance_name> process on Windows platform with Domino server 6.5/7, when Domino Server runs in regular application mode. Domino Agent does not report data, server status shows "Starting and Initializing" in TEP.

Symptom

The kgbstart_<instance_name>.log file shows:


<date and time> : System directory: "C:\WINDOWS"\system32
<date and time> : kgbstart.bat calling for instance <instance_name>

...

<date and time> : Start waiting server lauched
<date and time> : Find the file pid.nbf
<date and time> : Binary? 0
<date and time> : Checking KGBAGENT_<instance_name>.EXE running
<date and time> : result:1
<date and time> : RETRY 0 not found 0 RESULT
<date and time> : Checking KGBAGENT_<instance_name>.EXE running
<date and time> : result:1

...
<date and time> : RETRY 424 not found 0 RESULT
<date and time> : Checking KGBAGENT_<instance_name>.EXE running
<date and time> : result:1

...


Cause

This problem is caused by Domino Server defect. Domino Agent runs in Windows service mode. If Domino Server runs in regular application mode, Domino Server and Domino Agent run in different modes. When Domino Agent calls Domino API NotesInitExtended, it has problem to update pid.nbf, where all Domino relative processes' running information should be recorded.

Domino Agent checks if Domino Server is active through pid.nbf before starting kgbclient process. If Domino Server runs in regular application mode, the pid.nbf file is overwritten after Domino Agent calls Notes API NotesInitExtended, the running information of all Domino Server' processes are lost from pid.nbf. When Domino Agent restarts, it will not be able to find Domino Server process running information from pid.nbf, and will not start kgbclient process.


Environment

Domino Agent: 6.21 IF0004

Domino Server: 6.5/7

Platform: Windows


Resolving the problem

There are 3 options:


Option 1) Domino Server prior to 7.0.4
Start Domino Server in Windows service mode by choosing "Start Domino as a Windows Service" in starting dialog. If the starting dialog isn't shown, you can start it in the "control panel----------->Administrative tools------>Services------------>Lotus Domino Server".

Option 2) Upgrade to Domino Server 7.0.4
Add line "DEBUG_GLOBAL_NAMESPACE_ENABLE=1" into notes.ini and restart the Domino Server, and this problem can be resolved.

Option 3) Upgrade to Domino Server 8
This problem does not happen on Domino Server 8.

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Monitoring for Messaging and Collaboration
ITM Agent Lotus Domino V6

Software version:

6.2.1

Operating system(s):

Windows

Reference #:

1589748

Modified date:

2014-03-03

Translate my page

Machine Translation

Content navigation