Configuring a port monitor

This section describes how to add a monitor for monitoring TCP/IP-based servers, Telnet servers, and SSH, protocols.

To add a monitor

1. Access the Port Monitor (INET_Portmon_Top) menu command.
    The application class menu is displayed.
2. Select Knowledge Module Commands > Add Monitor from the menu.
    The Add Monitor: Step 1 dialog box appears.
3. Select the session type to monitor: 
   • TCP/IP-based session (excluding Telnet) see Monitoring standard deviation parameters)
   • Telnet session - see Portmon telnet example)
   • SSH session
4. Click Next.
    The Add Monitor: Step 2 dialog box appears.
5. Monitor name: Type a name for the new monitor that you want to create. Enter only alpha-numeric characters.
6. Host: Type the computer name or IP address.
7. Port: Type the port number of the host name you want to monitor. You can choose between 1 and 65535. If you selected the Telnet session option, the default value is 23. If you selected the SSH session option, the default value is 22.
8. Perform one of the following:
   1. If you selected TCP/IP-based session (excluding Telnet) in step 3, continue to step 9.
   2. If you selected Telnet session in step 3, enter the username and password. Re-enter the password for verification.

   3. If you selected SSH session in step 3, enter the username and password. Re-enter the password for verification.

      Note

      You can add IPv4 or IPv6 hosts for TCP/IP, Telnet, and SSH sessions. The IP version is detected automatically for Port monitoring.

      Note

      In BMC ProactiveNet Operations Console up to version 9.0, IPv4 and IPv6 hosts are monitored. If the host is an IPv4 host, the device name and IP address are displayed in the tool tip. If the host is an IPv6 host, only IP address is displayed in the tool tip.

9. Use the Timeout slide to select the number of seconds until the session timeout. This timeout is applied as the timeout value for each read and write operation you define in step n. The default is 30 seconds.
10. Perform the following if you selected either TCP/IP-based session (excluding Telnet) or Telnet session in step 3. If you selected SSH session in  step 3, go to step 11.
    • Define a session by selecting one of the following:
      • Select Define the session on screen and click Next.
        
        The Add Monitor: Step 3 (File) dialog box appears.
      • Select Define the session with a file and click Next.
        
        The Add Monitor: Step 3 (File) dialog box appears.
    • Type the full path name to the file, or click Browse to manually locate the file. Go to step 11.
    • For this monitor, select one of the following operations and enter the required expressions:
      • Write - send some data
      • Write line - send some data followed by carriage return - line feed (CR-LF)
      • Read - read data on the channel
      • For Read operations, leave this field blank.
      • Read until - read until a specific set of characters is found
      • Ensure the Read until operation contains an argument.
        
        You can enter up to 10 such expressions. If you need more than 10 expressions, press Cancel and define your operations in a file instead.
11. Perform the following if you selected SSH session in step 3.

    • In the SSH Command set configuration, enter SSH commands. You can also enter multiple SSH commands separated by a semicolon.

      Note

      Interactive SSH commands and commands that depend on the console graphics (for example top and ping) should not be used. Only SSH one-liners should be entered.

12. Click Next.
     The Add Monitor: Step 4 dialog box appears. Entering data in this dialog box is optional. If you do not want to enter data in this dialog box, go to step 18.
13. (Optional) Enter the expression you want to look for using one of the following methods:
    • For a single line expression, enter the content in the Single Line Content Expression field.
    • For a larger expression, enter the full path to a file containing the contents to be checked in the Multiple Line Expression field.
14. Select the Evaluate Unix-style regular expressions check box to include Unix-style regular expressions inside the content expression you specified in either single-line or multi-line.
     If both content expression areas are filled in, the multiple-line expression is used.
15. Select the Case Sensitive Match check box if you want to check for case sensitive matches.
16. Select whether the data read from the monitored port should or should not match your content expression.
17. Use the pull-down menu to indicate whether the application should alarm if the contents match or do not match the content expression.
18. Click Finish.