Run this Knowledge Script on a proxy Windows agent to remotely monitor the health of UNIX agents. This script performs the following tasks:
Checks the availability of a managed UNIX computer by first sending an ICMP Echo request to the managed UNIX computer. If the remote computer does not respond, this script sends an ICMP Echo request to the managed UNIX computer’s default router and raises an event.
Monitors the health of the UNIX agent by checking a time stamp value created by the UNIX agent. Normally, the UNIX agent creates a time stamp value every 90 seconds. If the age of the time stamp value exceeds the threshold, this script raises an event and restarts the UNIX agent.
Use this script to validate the health of the UNIX agent on a scheduled basis or for diagnostic purposes (for example, if there are gaps in data collection). This script can detect a problem with a remote agent and reliably notify the AppManager administrator.
The remote UNIX computer to be monitored must be accessible through the network from the computer where the proxy Windows agent is installed. To use this script to monitor more than one remote managed UNIX computer, all the computers you want must be accessible using the same root user account information.
NOTE:If you specify an incorrect password for the root account when running this script with Secure Shell (SSH) as the connection method to the remote UNIX or Linux computer, the script raises an event that incorrectly states that the login attempt was successful. If you see an event message similar to the event message below, you must update the job properties to specify the correct root password and start the job:
Output: Permission denied at /usr/netiq/UnixAgent/bin/UnixAgentHealthProxy.pl More Info: "SSH login OK to <machine> with root Using SSH/SFTP combination."
A managed UNIX computer where the AppManager UNIX agent is installed. The UNIX agent must be configured to run as the root user account.
The default interval for this script is Every 10 minutes.
To avoid raising false events, do not configure this script to run more frequently than the UNIX agent updates its time stamp. Ideally, the interval should be more than four minutes.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|---|---|
|
Event Notification |
|
|
Raise event if age of timestamp exceeds threshold? |
Select Yes to raise an event if the age of the time stamp exceeds the threshold you set. The default is Yes. |
|
Threshold - Maximum age of timestamp |
Specify the maximum age a time stamp can attain before an event is raised. The minimum threshold is 3 minutes and the maximum threshold is 99999 minutes. The default is 9 minutes. |
|
Event severity when age of timestamp exceeds threshold |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which the age of the time stamp exceeds the threshold. The default is 8. |
|
Remote Host Connection |
|
|
UNIX computers to monitor |
Specify the IP addresses of the remote UNIX computers you want to monitor, separating the addresses with commas and no spaces. |
|
Password for root user account |
Specify the root user account password that the proxy agent computer must use to connect to the remote UNIX computer. This is a mandatory field. |
|
Connection Transport |
Specify the connection mode between the proxy agent computer and the monitored UNIX computer:
This script can use either the Secure Shell (SSH) program with root password authentication or Telnet to make a secure connection to the remote UNIX or Linux computer. If you choose to use Telnet, you must supply a non-root user account name and password. NOTE:Telnet and FTP send your user name, password, and other information across the network in cleartext, making it easy for others to read this data. |
|
Telnet non-root user account |
Provide the Telnet non-root user account if you are using Telnet to connect to the monitored UNIX computer. Leave this parameter value blank if you are using SSH to connect to the monitored UNIX computer. |
|
Telnet non-root user password |
Provide the Telnet non-root user password if you are using Telnet to connect to the monitored UNIX computer. Leave this parameter value blank if you are using SSH to connect to the monitored UNIX computer. |
|
Restart UNIX agent if age of timestamp exceeds threshold? |
Set to y to restart the UNIX agent if the age of the time stamp exceeds the threshold you set. The default is y. |