|
The following help information provides simple
"Quick Start" instructions
that show you how you can use the hIOmon
Presentation Client to quickly get started using the hIOmon
File I/O
Performance Monitor. Please refer to the hIOmon User Guide
for a full explanation of the hIOmon
Presentation Client along with detailed descriptions of the
various displays, control commands and other advanced facilities supported by the hIOmon
Presentation Client.
For a brief "big picture" overview of hIOmon, please see the
hIOmon "Big Picture" page and the
"Major How-To's" chapter within the hIOmon User
Guide
document. Also see the "GettingStarted"
FAQs for Quick-Start steps that can be used with the hIOmon
WMI Browser and the hIOmon
"Automated Monitoring Configuration Setup Script".
Getting
Started using the hIOmon Presentation Client
The hIOmon Presentation Client "Tool Tip" feature can
also be used to get a brief help description for most of the options and display
menu items noted below; see the hIOmon Presentation Client "Tool Tips"
Help menu item (select the "Help -> Info -> Tool Tips" menu item from the
initial hIOmon Presentation Client display window) for more information about
the "Tool Tip" feature.
IMPORTANT NOTE: Once you have
successfully completed installation of the hIOmon software (please refer to "question
2" within the "Installation FAQs" or to the "Installation
Process" section of the hIOmon User Guide for more information),
you can perform the following basic steps to start using hIOmon. These steps show you how to start hIOmon file I/O monitoring and then display "real-time" file
I/O operation performance information for a particular set of files that you select; they
assume that you are starting the hIOmon Presentation Client for the first
time after the installation of the hIOmon software and that the hIOmon
Presentation Client, hIOmon Manager, and hIOmon I/O Monitor are all running upon
the same computer:
Step 1: Start the hIOmon Presentation
Client
Use the hIOmon Presentation
Client shortcut (i.e., the "Programs -> hIOmon -> Presentation Client" menu shortcut
accessible through the Windows® desktop "Start" button) to start the hIOmon Presentation Client program. You can also
simply double-click on the "hIOmonPC.jar" file (located within the
directory where the hIOmon software was installed) to start the hIOmon
Presentation Client program. (We assume that if you are reading this help
information as a result of the hIOmon Presentation Client "Help -> Info
-> Getting Started" menu selection,
then you have already successfully started the hIOmon Presentation Client).
NOTE: The hIOmon
Presentation Client is a Java application and requires that version 1.4.2 (or
higher) of the Java Runtime Environment (JRE) Java Virtual Machine (JVM)
be installed for the supported Windows® operating systems. If the required JRE version or higher is not currently installed upon the computer that you intend to run
the hIOmon Presentation Client, then the required JRE version must first be
obtained and installed before running the hIOmon Presentation Client. The
latest JRE version can be downloaded from the Sun Java web site.
When the hIOmon Presentation Client is first started after the
installation of the hIOmon software, the "Presentation Client Configuration
Initialization" process (as described in the hIOmon User Guide
) will be performed by the hIOmon Presentation Client.
As a result of the "Presentation Client Configuration Initialization" process,
the hIOmon Presentation Client will automatically connect to the hIOmon
Manager upon the same computer where the hIOmon Presentation Client is running.
Please see the hIOmon
Presentation Client FAQs if you encounter any
errors trying to start the Presentation Client.
Step 2: Select the particular files that are to be monitored
Select the
"Edit -> Filters" menu item from the main hIOmon Presentation
Client display window. Files that are to be monitored by hIOmon are identified through the
use of a "Filter Selection".
A "Filter Selection" consists
of one or more file (or path) names representing the files that are to be monitored (or
specifically excluded from being monitored) by the hIOmon I/O Monitor software
component. Each of the
individual file (or path) names is considered to be a
"filter". That is, each file (or path) name represents a filter
in that the hIOmon I/O Monitor will match the name against the file I/O
operations it observes to determine whether or not the I/O operation is to be
monitored (i.e., whether or not I/O performance information is to be collected
for the I/O operation, and if so, the type of performance information that is to
be collected). An asterisk ("*") can be used as a wildcard
character in your specification of the file (or path) name (that is, "filter"). Be sure
that the associated device letter is entered as well. Several examples are shown below:
|
Filter Examples: |
|
|
|
C:\Program Files\*
|
|
C:\Program
Files\myProgram.exe |
|
C:\junk.* |
|
D:\*
|
The "SampleAutoCfgInitFilters" Filter Selection is provided as part of
the installation of the hIOmon software. When
the hIOmon Presentation Client is first started after the installation of
the hIOmon software and you retrieve a Filter Selection (normally the "SampleAutoCfgInitFilters" Filter Selection) for display
by using the
Filter Selection
"Get" menu option, the hIOmon Presentation Client will automatically apply
the filter settings specified within the Filter Selection to all drives
currently accessible by the local host.
So first select the "SampleAutoCfgInitFilters" Filter Selection in the
drop-down box near the top of the "Edit -> Filters" menu display,
and then click on the "Get" button located near the top of the menu
display. The display will then show the filters associated with the
updated "SampleAutoCfgInitFilters" Filter Selection.
You can add a new filter to the Filter Selection by clicking on the
"Add" button
near the bottom of the menu display. Doing
so will pop up another window in which you can specify the particular file name
(or path) to be monitored (or excluded from being monitored). Since the selected hIOmon Manager
is running upon the "local host" (that is, both the hIOmon Presentation Client and the selected
hIOmon Manager are running upon the same computer), a "Local Host" button will appear which will
allow you to specify the particular file name by means of a standard file/directory list dialogue
box.
After you have added a new filter to the Filter Selection, click on the various check boxes and
the "Include" or "Exclude" buttons. These check boxes
and buttons are used to specify the type and level of detail that you want
collected for the selected filter. Files that represent "exclusion" values are highlighted in BOLD
within the Filter Selection display.
You can change the file/path name
associated with a particular filter by clicking on the "Rename" button (or
make a copy of a specific filter and its associated Filter Options by clicking
on the "Copy" button), both of which are located near the bottom of the menu
display. To remove a filter from the Filter Selection, simply select the
respective filter within the Filter Selection display box and click
the "Remove" button located near the bottom of the menu display.
NOTE: Please be sure to remove any filters that represent CD, DVD or floppy-device lettered
drive paths (otherwise you will encounter an error message when the hIOmon
I/O Monitor tries to "Load" the filters; see "Load Filter Selection" in the
hIOmon User Guide for more information).
Be sure to click on either the "Trace
Records" and/or the "File I/O Summary" options as
regards the type of I/O operation information to be collected by the hIOmon I/O Monitor (otherwise,
no
I/O operation information
will be collected by the hIOmon I/O Monitor for the respective filter). If you choose the
"File I/O Summary" option, be sure to click the "Options/Alerts" button (which is located to the right of
the "File I/O Summary" option) and select the particular type of summary information that you want collected
for the respective filter; also make sure that you click on the "Apply" button at the bottom of the
"Options/Alerts" menu displays so that your File I/O Summary options/alerts are actually included as part of
the selected filter.
After you have added your filters and are satisfied with your new "Filter Selection", click on the "Save" button near the top
of the "Edit -> Filters" menu display. This will cause the selected Filter Selection to be saved at the selected hIOmon
Manager; you can then subsequently retrieve this Filter Selection from the respective hIOmon Manager through
use of the "Get" button (which is next to the "Save" button near the top of the menu
display).
If you want your new "Filter Selection" to be the ‘default’ Filter
Selection, be sure to click the "Make Default" button
(near the top of the "Edit -> Filters" menu display) after you have
saved the Filter Selection; see ‘Default
Filter Selection’ in the hIOmon User Guide for more information about the default
Filter Selection. (Basically, the "default" Filter Selection is
automatically loaded into the hIOmon I/O Monitor when the hIOmon Manager
"AutoStart" option is
enabled to automatically activate file I/O operation monitoring by the hIOmon I/O
Monitor when the hIOmon Manager is started).
Finally click on the "Load" button at the
top of the menu display. This will notify the
selected hIOmon Manager that it is to pass the selected Filter Selection down to its associated hIOmon I/O
Monitor. Consequently, the selected Filter Selection will be used by the hIOmon I/O Monitor when file
I/O monitoring is activated within the hIOmon I/O Monitor.
As a result of the Installation
Default Settings
(see the hIOmon User Guide for more information
), the hIOmon Manager will normally have automatically activated the
collection of file I/O operation performance information by the hIOmon I/O Monitor
when the hIOmon Manager is started. If
you need to manually activate the collection of I/O operation performance
information by the hIOmon I/O Monitor, select the hIOmon Presentation Client
"Actions -> Start/Stop Monitor" menu item. Click
on the "Start" button located to the right of the "current I/O
Data collection" status field (which indicates whether or not the hIOmon
I/O Monitor is enabled to actually monitor and collect file I/O operation
performance information based upon the loaded Filter Selection).
NOTE: The Filter Selection that is currently loaded within the
selected hIOmon I/O Monitor is shown in BOLD within the Filter
Selection drop-down box located near the top of the menu display. Also
please note that, depending upon the number and type of files selected to be
monitored (along with the actual amount of associated file I/O activity), the
quantity of I/O trace information collected by
the hIOmon I/O Monitor can become quite large (and so overwhelm the ability of
the hIOmon Presentation Client to display so much I/O trace
information in the "real-time" display mode). Accordingly, we
advise that you use discretion when enabling the "Trace Records"
filter option and that you (at least initially) limit its use to a small
number of files that are not highly accessed. (The more advanced
features of hIOmon, such as the support for "replay" mode and the ability to
configure hIOmon I/O Monitor memory usage, do allow you to completely capture,
if necessary, the entire I/O trace information for highly
accessed files).
Step 3: Display the file I/O operation performance information collected by the hIOmon
I/O Monitor
Select the "View -> RealTime I/O" menu item from the main
hIOmon Presentation Client display window. You can further select either (or both) the "File I/O
Operation Trace" option (to display the collected I/O trace information,
if any, for the individual I/O operations associated with the selected files) or the
"File I/O Performance Summary" option (for a higher-level summary
of the selected file I/O activity, with the type of summary information
dependent upon the particular File I/O Summary Options/Alerts that were
previously specified for the selected Filter Selection).
The "File I/O Operation
Trace" display shows the collected I/O trace information within a tabular format. You can customize this
table by clicking on the "Table Options" button.
To start the selected hIOmon Manager's retrieval of the collected file I/O
operation performance information from its associated hIOmon I/O Monitor, you must click
on the "Start" button at the bottom of either the "File I/O
Operation Trace" or the "File I/O Performance Summary" menu
display. This will cause the selected hIOmon Manager to transfer the
file I/O operation performance information from the hIOmon I/O Monitor to the hIOmon
Presentation Client. You can at any time stop this retrieval of
"real-time" file I/O operation performance information from the hIOmon I/O
Monitor by clicking on the "Stop" button at the bottom of the menu
display. Note, however, that this only stops the retrieval process; the
hIOmon I/O Monitor will continue to monitor for I/O operations to the selected
files and collect the associated performance information (use the
"Actions -> Start/Stop Monitor" menu to explicitly stop this data
collection activity by the hIOmon I/O Monitor).
NOTE: The
"I/O Trace" information for the individual file I/O operations is available for
display only if you selected the "Trace Records" option for the
Filter Selection filter as described in step 2 above; similarly, the
summarized file I/O
operation performance information is available for display only if you selected
the "File I/O Summary" option for the Filter Selection filter as
described in step 2 above.
That's it. Getting started with hIOmon to view the
"real-time" performance information for selected file I/O operations
is as easy as:
-
Starting the hIOmon Presentation Client;
-
Selecting the particular file I/O operation activities/metrics of
interest and starting their collection;
-
Viewing the corresponding file I/O performance information in the format that
you like.
Once again, please refer to the hIOmon User
Guide for further
explanation of the Quick Start steps described above.
|
