|
|
|
Verastream Host Integrator Server Logging
Technical Note 40032
Last Reviewed 23-Feb-2007
Applies To
Verastream Host Integrator version 5.0 or higher
Summary
Technical Note 40032
Last Reviewed 23-Feb-2007
Applies To
Verastream Host Integrator version 5.0 or higher
Summary
This technical note discusses how to configure and use Verastream Host Integrator (VHI) Session Server and AADS logging.
This technical note is organized into the following sections:
About VHI Logging
VHI logging is useful for temporarily troubleshooting or gathering usage statistics if the alternative recommended options are not available or applicable:
- For troubleshooting host application or modeling issues, model debug messages (in version 6.0 or higher) is recommended. To configure server recording of model debug messages, see Technical Note 10066. To use recorded files, see Technical Note 10065.
- For gathering VHI server usage statistics, SNMP (Simple Network Management Protocol) is recommended. For more information on using SNMP, see Technical Note 40011.
Configuring the Session Server to log all messages can have a high impact on server performance (CPU time and disk space). Thus, the above alternatives are recommended when practical.
Enabling VHI Logging
Follow the steps below to set up logging.
- Open the Administrative WebStation console.
Local Windows installation: Use the Administrative WebStation shortcut installed in the Start programs folder.
Local UNIX installation: Use a web browser to open <vhi>/bin/VHI_Administrative_WebStation_Login.html where <vhi> represents your Verastream Host Integrator installation directory.
Remote system: In a web browser, open http://<hostname>:9642/apptrieve where <hostname> represents the system running the Verastream Host Integrator Administrative WebStation service.
- Log on to the Administrative WebStation using an Administrator profile.
- On the top navigation bar, click Config.Mode.
- On the left navigation tree,
- to configure Session Server logging, click Host Integrator Setup > Servers > [your server] > Server Configuration > Logging Options.
- to configure AADS logging, click Host Integrator Setup > Directory Services, and Directory Log or Authentication Log.
- From the Default Log Level list, specify which event messages to add to log files. Log Errors is the default. Log All Messages will record all informational messages, warnings, and errors.
Note: Log All Messages has an impact on server performance. You may want to select a reduced logging level for improved performance on heavily loaded servers.
- In the Log Storage Directory field, enter the location where the log file should be saved. By default, this is a subdirectory in your VHI installation directory.
- Enable System Logging if you also want the messages to be sent to the operating system log (Windows event log, or UNIX/Linux syslog daemon; see also Operating System Logs section below).
- Click Save (or Submit and Save).
Note: The VHI Log Manager service must be installed and running on the same system(s) as Session Server and/or AADS components. (In a Session Server load balancing configuration or AADS failover configuration, Log Manager runs on each system.) For more information on starting VHI services, see Technical Note 10004.
After you have captured the desired problem or traffic, repeat the steps above to reset the Default Log Level to its original value.
Providing Logs to Technical Support
If you are asked to provide log files to Technical Support, please upload or send the message.dat file from the appropriate directory. Default locations are as follows:
Session Server log: <vhi>/etc/logs/server
Authentication log: <vhi>/etc/aads/aalog
Directory Services log: <vhi>/etc/aads/dslog
Authentication log: <vhi>/etc/aads/aalog
Directory Services log: <vhi>/etc/aads/dslog
It is recommended you zip (compress) log files before attaching to a service request update at http://mysupport.attachmate.com/, uploading at http://upload.attachmate.com/, or sending as an e-mail attachment.
Viewing Logged Messages
Once you have captured a log file, use one of the following methods to filter and view the log.
Standalone Log Viewer
The standalone Log Viewer is a Java application that uses SQL-type queries to open the VHI log, obtain log information, and format the data in a user-friendly way.
The standalone Log Viewer (version 5.0 or higher) can be accessed from the Start programs shortcut installed on Windows, or by running <vhi>/bin/logview on UNIX/Linux.
Use the log viewer utility to connect to VHI Log Manager and run a query for the desired messages. For example, to get a report on the number of sessions started, enter the following query:
select * from messages where msgid=3For further details on running the standalone log viewer and using SQL queries, see the Log Viewer's online help available at http://www.attachmate.com/docs/verastream/vhi/6.5/help/loghelp/logviewer.html.
Log Export Utility
The logexport command line utility allows extracting messages suitable for parsing or importing into third-party applications. Similar to the standalone Log Viewer, logexport accepts SQL query syntax. For more information, see the logexport online help available at http://www.attachmate.com/docs/verastream/vhi/6.5/help/loghelp/logexport.html.
Administrative WebStation Log Viewer
To view the VHI server log information, using the Administrative WebStation View Log feature, follow the steps below.
Note: The standalone Log Viewer (described above) is more robust than the Administrative WebStation Log Viewer.
- Open the Administrative WebStation console.
Local Windows installation: Use the Administrative WebStation shortcut installed in the Start programs folder.
Local UNIX installation: Use a web browser to open <vhi>/bin/VHI_Administrative_WebStation_Login.html where <vhi> represents your Verastream Host Integrator installation directory.
Remote system: In a web browser, open http://<hostname>:9642/apptrieve where <hostname> represents the system running the Verastream Host Integrator Administrative WebStation service.
- Log into the Administrative WebStation.
- In the left navigation tree,
- For the Session Server log, click Host Integrator Setup > Servers > [your server name].
- For the AADS logs, click Host Integrator Setup > Directory Services > Directory Log or Authentication Log.
- Above the left navigation tree, click the View Log button.
The Log Viewer opens with the Options panel displayed. Use the Options panel to specify the filter criteria for the records you wish to view, and click View at the bottom of the panel to display the results of your query.
For example, in a Session Server log, to see how many clients connected during the test period, select message ID 3 or 7 and view the log.
Log messages are shown in reverse chronological order, with most recent messages at the top of the log.
For more information on using the Administrative WebStation Log Viewer, refer to the online help available at http://www.attachmate.com/docs/verastream/vhi/6.5/help/server/LogViewer.html.
Operating System Logs
If you enabled System Logging (in step 7 of Enabling VHI Logging), you can use a utility to view the operating system log:
Windows: Control Panel > Administrative Tools > Event Viewer > Application Log
Sun Solaris: /var/adm/messages
Red Hat Linux: /var/log/messages
IBM AIX: log location configured in /etc/syslog.conf (e.g., *.debug or daemon.error line)
Third-party utility: syslog-monitoring package such as NetIQ AppManager, NetIQ Security Manager, or BMC PATROL (BMC Performance Manager)
Above references to third-party vendors or products are informational only and should not be construed as certification, endorsement, or recommendation by Attachmate.
