Session "High Water Mark" Tracking in Verastream Host Integrator

Verastream Host Integrator (VHI) can be configured to report the peak number of concurrent sessions that have been in use. By understanding your session server peak usage, you can optimize session pool configuration, load distribution across multiple servers, and product licensing. This technical note describes how to obtain this data in email notification, SNMP, or logging.

Note the following:

• Data is available in a daily informational message for email, SNMP, or logging. The message is generated around midnight each day.
• The message includes peak "active" concurrent sessions used by clients, and peak "total" concurrent sessions connected to the host (including initialized idle sessions in session pools).
• The peak values are tracked since the session server was started. The values are reset when the session server service is restarted. For historical peak data over time, you should retain the daily messages.

Email Notification

You can configure Host Integrator to send a nightly email message. Example:

Follow the configuration steps for your product version.

Version 7.0 or Higher

To configure email notification in version 7.0 or higher:

1. Open Administrative Console from the installed shortcut (Start > All Programs > Attachmate Verastream > Host Integrator > Administrative Console).
2. Connect to your management server with administrative credentials ("admin" user with password set during installation, or user in the Administrator security profile).
3. If the Session Server Explorer pane is not visible, click Perspective > Host Integrator > Session Servers.
4. Under Installation > Servers, right-click your server and Properties.
5. In the Properties dialog, in the left category tree, open Notifications > E-mail Settings.
6. In the right pane, select Enable Email Notification and configure the other options for email address(es), your email server, etc. For more information, see http://docs2.attachmate.com/verastream/vhi/7.6/en/topic/com.attachmate.vhi.vmc.help.online/tasks/vhi_mc_config_email.xhtml.

7. Click Apply to save changes.
8. Click Test Message and verify successful receipt of the test notification message. (Its format is similar to the example above, except the Text line reports This message is the result of an email test.)
9. In the left category tree, click Messages.
10. In the message group tree, open All Messages > Info/warning messages and select "0143 - LogPeakSessionCount." (Refer to Figure 1 below.)
11. Under Notification Settings, enable the "Send email notification" option.
12. Click OK.

Tip: To also generate immediate notification when maximum concurrent session limits are exceeded (which produces errors for attempted client connections), you can enable notification for the following additional Server Management errors: 2892, 2894, 2898, and 2643.

Version 6.6

To configure email notification in version 6.6:

1. Open the Administrative WebStation console.

2. Log on to the Administrative WebStation using an Administrator profile.
3. In the top navigation bar, click Config.Mode.
4. In the left navigation tree, click Servers > [your server] > Server Configuration > Email Configuration > Email Notification.
5. In the right pane, select Enable Email Notification and configure the other options for email addresses, your email server, etc. For more information, refer to the help documentation.

6. Click Save (or Submit and Save).
7. Click Test Message and verify successful receipt of the test notification message. (Its format is similar to the example above, except the Text line reports This message is the result of an email test.)
8. In the left navigation tree, click Servers > [your server] > Server Configuration > Email Configuration > Email Messages > Info/warning messages. (Refer to Figure 2 below.)
9. In the right pane, scroll down and enable Log Message ID 143, as shown in Figure 2 below.
10. Scroll up and click Save (or Submit and Save).

Tip: To also generate immediate notification when maximum concurrent session limits are exceeded (which produces errors for attempted client connections), you can enable notification for the following additional Server management errors: 2892, 2894, 2898, and 2643.

SNMP

You can configure your SNMP network management station to use the VHI MIB for monitoring, or configure the session server to send an SNMP Trap to the management station for specific messages.

Session Server Log

The session server can be configured to Log All Messages (and optionally also add the messages to the operating system log). You can later query the log for message ID 143. For more information on session server logging, see KB 7021303.

Note: When logging all messages, the increased disk write activity may impact performance in environments with heavy client load.

Legacy KB ID

This article was originally published as Attachmate Technical Note 10111.