How to Start troubleshooting Lotus Notes Agent problems
First, when troubleshooting Lotus Notes Agent problems, it’s best to start with a good understanding of how agents and the Agent Manager work. So let’s begin by reviewing how agents are invoked in detail below.
On the server, agents can be invoked by:
- The Agent Manager, a server task that controls scheduled agents
- These include agents that run on a schedule specified by the user or that are scheduled when an event occurs (such as new mail or new document creation).
- The HTTP task, running agents invoked via a Web browser
- The router, running agents executed as part of mail delivery (“before new mail arrives” agent trigger)
- The RunOnServer method, included in the code of the agent running on the client
- The server console command “Tell amgr run” (This is a Notes/Domino 6 only command.)
On the client, agents can be invoked as:
- Interactive agents invoked by the Notes client, as a result of a user action (menu pick or button click)
- Locally scheduled agents invoked by the Client TaskLoader, running scheduled agents on the client using an embedded version of the Agent Manageror the Agent Manager task running locally on the client.
If your agent won’t run, the first thing you need to do is learn more about the nature of the problem. Start by looking at the Agent Log. The Agent Log shows you the last time the agent executed and whether or not it completed its execution. Domino Designer includes Agent Test, an expert system that helps you diagnose common mistakes in agent security and scheduling. Agent Test is a handy tool, providing diagnostic messages that help you adjust agent settings as necessary.
In Domino Designer, we updated Agent Test to work with the Notes/Domino security model. If you are using the Notes client to look at an agent on a Domino server, Agent Test will automatically switch to the security model. To run Agent Test, open Domino Designer and go to the Agents view in your database, highlight the agent to test, and then select Agent – Test.
Viewed 397 times by 125 viewers
