Updating the design of an enabled agent

Design update helps preserve agents in a database whose design is being updated.

In pre-8.0 releases of Domino® , when a design update for enabled agents occurred, the agents were disabled and stopped running. This occurred because there was no mechanism to update the agent's design and retain the original signature of the agent. In Domino 8, design update can update many enabled agents without disabling the agents.

In Domino 8 and greater, design update preserves the identify of the agent owner in the "On Behalf" field and re-signs the agent with the server ID. The agent's enabled status is preserved only if the original agent owner has the rights to run agents and if the agent is scheduled to run on the server on which the design update is performed. The server has explicit rights to run agents only on itself. If the agent's enabled status cannot be preserved, the design update is performed and a warning message is generated and sent to the server console as well as to the Domino Domain Manager.

Note: This topic describes behavior that occurs only when using the Convert or Design tasks in Domino Administrator to update the design of a database or databases. Selecting either File > Application > Replace Designor File > Application > Refresh Design in Notes® does not preserve the enablement status of agents already in the design.

For more information about using the Run on behalf of setting, see the IBM® Domino Designer 9.0.1 Social Edition Help.

You may see the warning messages shown in the following examples depending on who signs the agent.

In this example, the agent was signed by the server, ServerA/DomainA, which did not have rights to run agents on the server Test/Acme. Design update updated the agent design, leaving the agent disabled.

Warning generated on server TEST/ACME:

Designer: Agent 'OutOfOffice' in 'mail\rooks.nsf' disabled during Design Update from template 'mail8.ntf'. Agent signer 'ServerA/DomainA.: Users without rights to sign 'On Behalf' agents can only run agents on their own behalf.

In this example, the agent was specified to run on -any server-; therefore, its enabled state could not be preserved because it could not be signed with the server ID Test/DomainB ID. If the agent was signed with Test/DomainB ID, the agent would not run on any server other than Test/DomainB, which was not the intention of the agent designer. Design update updated the design of the agent, leaving it disabled.

Warning message generated on server Test/DomainB:

Designer: Agent 'LotusInboxCleanup' in 'AdminSurvey2007.nsf' disabled during Design Update from template 'mail8.ntf'. Agent signer 'Lotus Notes Template Development/Lotus Notes'.: Enabled status can be preserved only on the server where the agent is scheduled to run or, for mail agents, on the home mail server. Enabled status cannot be preserved if '-Any server-' is specified for the agent.