Updating the design of an enabled agent
Design update helps preserve agents in a database whosedesign is being updated.
In pre-8.0 releases ofDomino® ,when a design update for enabled agents occurred, the agents weredisabled and stopped running. This occurred because there was no mechanismto update the agent's design and retain the original signature ofthe agent. InDomino® 8, designupdate can update many enabled agents without disabling the agents.
InDomino® 8 and greater,design update preserves the identify of the agent owner in the "OnBehalf" field and re-signs the agent with the server ID. The agent'senabled status is preserved only if the original agent owner has therights to run agents and if the agent is scheduled to run on the serveron which the design update is performed. The server has explicit rightsto run agents only on itself. If the agent's enabled status cannotbe preserved, the design update is performed and a warning messageis generated and sent to the server console as well as to theDomino® Domain Manager.
For more information about using the Run on behalf of setting,see theHCLDomino® DesignerHelp.
You may see the warning messages shown in the following examplesdepending 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. Designupdate 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.
Inthis example, the agent was specified to run on -any server-; therefore,its enabled state could not be preserved because it could not be signedwith the server ID Test/DomainB ID. If the agent was signed with Test/DomainBID, the agent would not run on any server other than Test/DomainB,which was not the intention of the agent designer. Design update updatedthe design of the agent, leaving it disabled.
Warning messagegenerated 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.