Agents run on agent servers. When you install and start Web Studio, the default agent server is created by the portal. All agents run on the default agent server unless you assign them to a different agent server.
Every onepage deployed WAR file (the portal) has an agent server thread running when it starts up. If you set up a cluster of onepage Web applications and want an agent to run on only one of the server machines (for example, maybe the database connection or file system only exist on one machine), then you can assign that server an ID in the global.properties.xml portal configuration file. When you restart the server and Web Studio, the portal creates the agent server reference, which a user can then select for a specific agent.
You can also create the agent server reference using the following procedure. When you want the agent server to run, you must take the assigned ID and set it in global.properties.xml on the machine that would host the agent server; for example:
<Property name="AgentServerID" value="211" description="Default Agent Server ID" menugroup="10"/>
Creating new agent servers
Select Automate | Servers.
Select the New icon from the toolbar. You see the Agent Server Editor.
Complete these fields:
Name – the program fills in this field after you save the new agent server and enter the name.
ID – the agent server ID is a sequential number maintained by the system. The default agent server has an ID of 1.
Description – enter a description of the agent server.
Status – select the agent server’s state —Ready, Stopped, Broken, or Deleted. Setting a server to a state other than Ready stops that agent server from retrieving agents to run. If an agent is assigned to an agent server with a state other than Ready, the agent does not run until the agent server state is reset to Ready.
Roles – select the available roles that can edit the agent server’s properties and view the agent server’s log and click Add. Click Add All to assign all available roles.
Click Save As to save the new agent server. A dialog box prompts you for the agent server’s name.
Enter a name for the agent server and click OK.
Click Close to exit the Agent Server Editor.
Copyright © 2004. Sybase Inc. All rights reserved. |
![]() |