Hello again. Now that we have mastered the use of the Blue Medora Agent for Remote SSL Certificates, let’s take a look at installing and configuring the Blue Medora Agent for Ping Probe. The installation will look very similar to that of the Remote SSL agent. So if you have already followed me through the previous blogs, this should be a breeze.
– Mike Major
Agent Installation
- Verify Application Support has been loaded into all the TEMs, TEPS, and TEPD components in your environment that the Ping Probe monitoring data will flow through.
- A previously installed IBM ITM agent is required. In our example, ITM Windows Operating System agent v6.2 FP1+ is pre-installed to C:\IBM\ITM.
- Ensure an IBM JRE 1.5 is installed on the system, a JAVA_HOME is set for that JRE, and that the JRE’s bin directory has been added to the PATH.
From the installation media, select the appropriate installer. Since we will be installing on a Windows platform (Windows Server 2003 in our case), run the setupwin32.exe executable.
Note: Installation on a Linux machine is essentially the exact same. Just make sure to double check your install paths.

The first screen appears to tell you that you are about to install the Blue Medora Agent for Ping Probe. Click Next:

Accept the License Agreement and click Next:

Enter the location of your existing Agent installation (CANDLEHOME) and click Next:

Select “Perform a local install of the solution on this machine” and click Next.
Note: This screen is a bit confusing in that it indicates that it is going to add application support. When installing on a non TEMS/TEPS/TEPD server, the “Perform a local install of the solution on this machine” equates to “Install just the monitoring agent”.

Select “Ping Probe” and click Next:

This screen summarizes the actions that will be taken by the installer. Click Next:

If all went well, you will get a successful installation message. Click Finish.

Installation is complete. To confirm that the base Ping Probe Agent has been installed on the system click the Manage Tivoli Monitoring Services icon. It may be on your desktop or you may need to navigate to Start –> All Programs –> IBM Tivoli Monitoring folder to find it.
If installation was successful, you will see a Monitoring Agent for Ping Probe Template as one of the items listed under Service/Application.

Alternate Installation Method: TEP based Remote Deploy
If you’ve previously added the Ping Probe agent to a TEMS Depot, you can remotely install the agent instead of performing a local installation. To perform a remote installation, navigate to the server node you want to deploy the Agent to (in our case server tw3g10 ), right-click the node and select “Add Managed System”:

Select the Agent you want to remote deploy. We want to deploy the Ping Probe agent so select “Monitoring Agent for Ping Probe” and click OK:

Now, you will be shown the same ITM configuration screen as in the next section. The only difference here is that you need to specify the instance name.
Agent ITM Configuration: Windows
Next we are going to create an agent instance. Double click on “Monitoring Agent for Ping Probe” and you will be prompted to enter a unique instance name. This should be a descriptive name that helps you identify the agent instance when viewed in the TEP and elsewhere. Enter your instance name and click OK:
Note: The Blue Medora Agent for Ping Probe is a multi-instance agent. Many administrators may find it helpful to create separate instances for their on site servers and their off site servers, or any other logical divide.

The following screen is where the Ping Probe basic configuration is entered. Enter the information and click Next.
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Instance Name |
Stark |
The name of the Instance as it is seen in the TEP. This should already be filled in with the instance name you chose in the last step. |
| Logging Level |
Warn |
Logging Level of the Agent. WARN is the default which we’ve selected. Use DEBUG if you are having issues. |
| Data Collection Interval |
1 |
This is the interval in which the data will be collected. In our lab environment, we’ve elected to use 1 minute. |
Below is a screenshot of the configuration panel from our example Agent Instance:

The next screen is where you can enter some global timeout values. Enter the information and click OK
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Global Ping Timeout |
3000 |
A timeout value (ms) that will be used if a specific timeout value for a host isn’t defined on the next screen. It is basically a ‘default’ timeout value. |
| Slow Response Threshold |
60 |
The response time (ms) that you consider to be slow. For variety in the results, we’ve chosen 60ms. |
| Retry Attempts |
2 |
The amount of times the agent will retry a host before declaring a timeout. |
| Maximum Concurrent Pings |
10 |
The amount of hosts the agent will attempt to ping concurrently. |

The next screen asks for an optional host file. This option is very handy when you have a large number of hosts to monitor. We will cover this file in a later section and skip it for now. Click Next:

The next screen is where you enter the hosts you want to monitor. Enter the information for these hosts and click OK
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Hostname |
smtp.gmail.com |
The hostname of the host you would like to monitor. |
| Timeout |
1000 |
An optional timeout value for this host. This will override the global timeout value. |
| Alias |
Blue Medora Website |
This is an optional descriptive alias for the host. If no alias is entered, a default value of the hostname will be used (e.g. www.bluemedora.com). |

You will be returned to the Manage Tivoli Enterprise Monitoring Services screen. To start the Agent instance, right click the agent instance and select Start.
Agent ITM Configuration: Linux
Let’s create an agent instance on Linux. First, you will need to run the itmcmd command that is located in the CANDLEHOME/bin/ directory (in our case /opt/IBM/ITM/bin/):
./itmcmd config -A {product code}
Where {product code} is the product code for the agent (xf for the Blue Medora Agent for Ping Probe).
Now you will be asked to enter a unique instance name. This should be a descriptive name that helps you identify the agent instance when viewed in the TEP and elsewhere. Enter your instance name:
Agent configuration started...
Enter instance name (default is: ): Stark
You will be asked if you’d like to edit the “Monitoring Agent for Ping Probe” settings. Choose “1″ or just hit enter to use the default:
Edit "Monitoring Agent for Ping Probe" settings? [ 1=Yes, 2=No ] (default is: 1): 1
Now you will be asked if you’d like to edit the “Basic Configuration” settings. Choose “1″ for yes and enter the information.
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Logging Level |
Warn |
Logging Level of the Agent. WARN is the default which we’ve selected. Use DEBUG if you are having issues. |
| Data Collection Interval |
1 |
This is the interval in which the data will be collected. In our lab environment, we’ve elected to use 1 minute. |
Edit 'Basic Configuration' settings? [ 1=Yes, 2=No ] (default is: 1): 1
Logging Level of the agent [ 1=Debug, 2=Info, 3=Warn, 4=Error, 5=Fatal ] (default is: 3): 3
Data collection interval (in minutes) (default is: 1440): 1
We’re asked if we’d like to edit “Optional Global Ping Values” settings. Choose “1″ for yes and enter the information.
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Global Ping Timeout |
3000 |
A timeout value (ms) that will be used if a specific timeout value for a host isn’t defined on the next screen. It is basically a ‘default’ timeout value. |
| Slow Response Threshold |
60 |
The response time (ms) that you consider to be slow. For variety in the results, we’ve chosen 60ms. |
| Retry Attempts |
2 |
The amount of times the agent will retry a host before declaring a timeout. |
| Maximum Concurrent Pings |
10 |
The amount of hosts the agent will attempt to ping concurrently. |
Edit 'Global Ping Values' settings? [ 1=Yes, 2=No ] (default is: 1): 1
Global ping timeout value (default is: 3000): 3000
Slow response threshold (default is: 1000): 60
Retry Attempts (default is: 2): 2
Maximum Concurrent Pings (default is: 10): 10
We’re asked if we’d like to edit “Optional Ping Probe Host File” settings. Again, we will cover the optional host file below. Choose “2″ for no right now:
Edit 'Optional Ping Probe Host File' settings? [ 1=Yes, 2=No ] (default is: 1): 2
We’re asked if we’d like to edit “Hosts to Ping” settings. Choose “1″ for yes. We can now add, edit or delete hosts we’d like to monitor. Enter all hosts you’d like to monitor.
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Hostname |
smtp.gmail.com |
The hostname of the host you would like to monitor. |
| Timeout |
1000 |
An optional timeout value for this host. This will override the global timeout value. |
| Alias |
Blue Medora Website |
This is an optional descriptive alias for the host. If no alias is entered, a default value of the hostname will be used (e.g. www.bluemedora.com). |
Edit 'Hosts to Ping' settings? [ 1=Yes, 2=No ] (default is: 1): 1
No 'Hosts to Ping' settings available?
Edit 'Hosts to Ping' settings, [1=Add, 2=Edit, 3=Del, 4=Next, 5=Exit] (default is: 4): 1
Hostname (default is: ): www.bluemedora.com
Timeout (default is: ):
Alias (default is: ): Blue Medora Website
'Hosts to Ping' settings: Hostname=www.bluemedora.com
Edit 'Hosts to Ping' settings, [1=Add, 2=Edit, 3=Del, 4=Next, 5=Exit] (default is: 4): 5
When asked if this agent will connect to a TEMS, choose “1″ for yes and enter the hostname for your ITM server. Then enter your network protocol information:
Will this agent connect to a TEMS? [1=YES, 2=NO] (Default is: 1): 1
TEMS Host Name (Default is: tr4g10): tw3g10
Network Protocol [ip, sna, ip.pipe or ip.spipe] (Default is: ip.pipe):
Now choose the next protocol number from one of these:
- ip
- sna
- ip.spipe
- 0 for none
Network Protocol 2 (Default is: 0):
IP.PIPE Port Number (Default is: 1918):
Enter name of KDC_PARTITION (Default is: null):
Configure connection for a secondary TEMS? [1=YES, 2=NO] (Default is: 2):
Enter Optional Primary Network Name or 0 for "none" (Default is: 0):
Agent configuration completed...
Your configuration is now complete! Start the agent instance by using the following command:
./itmcmd agent -o {instance name} start {product code}
Where {instance name} is the instance name you entered and {product code} is the product code for the instance (e.g. xf for the Blue Medora Agent for Ping Probe).
Agent Host File Configuration
To configure an agent using the optional host file, you first need enter the host information into a CSV file. An example file is provided with the agent, so you can simply open that and plug away.
Note: You should rename this file. If you update the agent, the default file will be overwritten if it is not renamed.
A brief description of each field and the data we entered for our example follows:
| Config Option |
Example Value |
Description |
| Hostname |
smtp.gmail.com |
The hostname of the host you would like to monitor. |
| Timeout |
1000 |
An optional timeout value for this host. This will override the global timeout value. |
| Alias |
Blue Medora Website |
This is an optional descriptive alias for the host. If no alias is entered, a default value of the hostname will be used (e.g. www.bluemedora.com). |
Below is the file we used in our example:
After completing the host file, simply create a new instance by following the steps in the appropriate section above for your platform. When prompted for the host file, enter the fully qualified path for the file you just created. You do not have to enter any hosts directly into the ITM configuration (but you may do so if you desire).
Conclusion
Congratulations! You’ve successfully installed the Blue Medora Agent for Ping Probe. In the next blog post, we will use the agent to solve real problems that often come up in an enterprise.
If you have any questions regarding this post, the Ping Probe Agent or anything else related to Blue Medora ITM Agents, feel free to drop me a line directly at: mike.major@bluemedora.com