Cisco Cisco Workload Automation 6.3 Installation Guide
136
Installing Agents
Troubleshooting Agent Issues
To troubleshoot a Unix agent that fails to start or hangs
1.
Check the IP of the agent server and how it is configured.
2.
Run ifconfig.
3.
Compare the system IP returned from ifconfig to the system's IP defined in the file /etc/hosts.
4.
If there’s a mismatch, you need to fix it so that the IP addresses match.
Verifying the Version of the Agent
When consulting with Technical Services about a problem with an agent, one of the most basic pieces of information
they need is which version of the agent is being used.
they need is which version of the agent is being used.
To verify the version of the agent:
1.
From the Navigator pane of the client, choose Administration > Connections to display the Connections pane.
2.
In the various connections listed in the pane, locate the agent with the problem.
3.
Look in the Version column of that agent to see the version of the agent being used.
Configuring Diagnostics for a Windows Agent
To run diagnostics for the Windows agent:
1.
Login to the agent console as an authorized user.
2.
Using Service Manager, select the Agent that you wish to use diagnose.
3.
Add the following string to the end of the Path: field.
Debug=high
4.
Click OK at bottom of panel and respond yes to the "Would you like to restart the service?” pop-up.
To stop diagnostics, close the agent application window and restart the agent from the Service Control Manager.
Configuring Diagnostics for a Unix Agent
The first line of every Unix agent shell script must adhere to standard Unix scripting guidelines and refer to a shell; for
example, #!/bin/sh. For more information, refer to your Unix system documentation or consult your System Administrator.
example, #!/bin/sh. For more information, refer to your Unix system documentation or consult your System Administrator.
To turn on diagnostic logging:
1.
On the agent machine type the following command to stop the agent:
./tagent <agent name> stop
2.
Go to the /bin directory and locate the tagent.ini file for the desired agent.
3.
Inside the tagent.ini
file, under the port setting, type the following:
ovb=Tidaldebug
4.
Save the file and its changes.
5.
Start the agent:
./tagent <agent name> start