Manual Index
|
1. Installing VisualLookout 2. Running VisualLookout 3. Configuration |
4. Agent Connection 5. AutoSentry 6. Map View |
7. AutoContact 8. AutoAlert 9. History/Search | 10. Interface Data |
1. Installing VisualLookout
NOTE: This documentation is for VisualLookout, VisualLookout Express and VisualLookout Personal Edition. Features not available in VisualLookout Express or VisualLookout Personal Edition are clearly marked as [NX] or [NP].
First, make sure that you meet the minimum
requirements for your platform, including the proper Java VM.
Then install VisualLookout :
Windows: The download
EXE is the install program for VisualLookout. Just run this program after
downloading it.
Unix: VisualLookout is not available for Unix
Windows:
Go to Start / Programs / VisualLookout and click on VisualLookout.
If this is a trial license you will then see the 'run as trial' dialog box,
click the
'run trial' button. The following hot-links window (fig 2.1) will appear.
This is the
VisualLookout main application window. It is a single window, which can present
a number of views depending on the users requirements. The initial view is the
hot-link view which notifies the user of any product update information such as
a problem fix release. The "view" menu option in the top right corner of the
dialog presents the available views (see Fig 2.11 below).
AutoSentry
Provides a
central view of activity from all connections that are required to be
monitored.
AutoContact
Provides a
central view of all connections made to all monitored systems.
AutoAlert
New in
version 2 this allows you to trigger alarms when certain events occur such
as a connection from an undesirable country
Agent
List
A list view
of all connections whether running or not
<connection
name>
A line
appears for each connection that is running
From the Agent
List view the user can initiate a number of actions to specific listed
connections by left clicking on the line item in the agent list to highlight the
line and then right mouse click to see a menu of available choices. See Fig 2.12
below. Note: VisualLookout Express and VisualLookout Personal Edition is
for home consumers and does not support multiple agents.
Add new
Agent [NX,NP]
Defines a
new connection to monitor a server
Run
Starts an
agent connection (must be in stopped or not running status to be enabled)
Stop
Stops a
running agent (must be in running status to be enabled)
Goto
Changes the
dialog view to that agents view (must be in running status to be enabled)
Delete
Remove an
agent connection (will automatically stop the agent if running)
Edit/Test
connection
Checks that
the connection parameters to the server are working
Cancel
Closes the
menu
VisualLookout
comes preconfigured to run a localhost connection, i.e. it will monitor the
system on which it is installed. By default the service is initially in a "not
running" state. The configuration of VisualLookout to add another connection or
use the AutoSentry and AutoAlert features is a simple process as outlined below.
Adding a Host IP/Domain: VisualLookout Express and
VisualLookout Personal Edition are pre-configured and do not need a host
IP/Domain to be added. To monitor an IP/Domain using
VisualLookout choose the FILE menu option and select the ADD NEW
AGENT option. This will then present the add agent dialog box (fig 3.1).
Note the user may add as many monitoring agents as permitted by the license
purchased.
Each field has help text that
appears in the panel below the buttons. For clarity these fields are also
explained below. Agent name or IP address:
Enter here either the IP address or the
domain name of the system you want VisualLookout to monitor. For example
www.mysystem.com or 192.168.0.1. If you wish to monitor the system upon
which VisualLookout is installed simply use the name 'localhost'. Note: the
system must be able to support SNMP for VisualLookout to monitor it. In the case
of 'localhost' (i.e. the system where VisualLookout is running) if no SNMP is
present it will automatically give you the option to start an SNMP agent. For
remote systems the user must ensure that SNMP is running. Community Password:
The Community Password, sometimes referred to as the community name, is the
password that allows access to the system to be monitored. Without a valid
Community Password VisualLookout will be unable to collect any data from the
system. Note, the community password is a special password for SNMP and is not
tied to any user password. The default on most SNMP devices is 'public'. If you
do not know your community name then try the 'public' community name first. If
the 'public' name works it is advisable to have this changed to something more
secure. SNMP Port:
The SNMP Port is normally set to 161 although the system administrator can
change this. If you do not know the SNMP port and VisualLookout is unable to
collect any data please contact your system administrator for the correct port
number. Timeout:
The timeout option is the total wait time allowed in milliseconds for
VisualLookout to collect data. Every 1000 milliseconds is a second so the
example above has a 10 second timeout. If VisualLookout is unable to collect the
data before 10 seconds has passed VisualLookout will give up and try again
immediately if the 'Retry' (see below) option is set or at the next
collection interval 'Seconds between requests' (see below). Retry:
This number is a count and represents the number
of times VisualLookout can retry after a failure to collect data. The retry
option instructs VisualLookout to immediately retry any failed request because
the timeout time has been exceeded. It is advisable not to set this value too
high if at all especially if the 'Seconds between requests' (see below)
is small. Seconds between requests:
This number is in seconds and
represents the time between VisualLookout data collection requests. If
collecting from a remote system it is advisable to set this option to a value
that makes sense for your connection speed. The example above is 5 seconds. AutoRun:
The AutoRun check box defines whether
VisualLookout requires the user to initiate the run request or if VisualLookout
can initiate the running of the collection agent. Test:
Clicking this button validates the connection request immediately and
reports any errors to the user. Reset: Clicking this
button resets all the values in the dialog box. Cancel: Clicking this
button aborts the update and closes the dialog box. OK: Clicking this button
validates the request and adds the agent details to VisualLookout. An Agent Connection may be modified by the
user to either Stop, Start, Delete or Edit an existing Agent Connection. The
documentation in this section documents the process of modifying an agent
connection using the Agent List window, however, the same options are also
available in the Agent Connection window. The Agent List window lists all
defined connections and therefore has the advantage of allowing the user to
modify many connections in a single view. The modify agent options are as follow: To stop a connection that is in "running state" (indicated in
the agents panel, see Fig 4.1.1 below) do the following:
To delete a current defined connection: To edit/test an existing connection:
2. Running VisualLookout
![]()

Fig 2.1

Fig 2.11
The user can select the view directly from the menu selection list (see table
below) or alternatively the user may click the VCR styled arrow buttons which
move the view through the list in a forward or backward direction.
[NX]
[NX]
[NX]
[NX,NP]

Fig 2.12
[NX,NP]
[NX,NP]
3. VisualLookout Configuration [NX, NP]
![]()

Fig3.1
4. Modifying an Agent Connection [NX, NP]
![]()
VisualLookout Express and VisualLookout Personal Edition are
pre-configured and do not need an agent to be configured.Stop a Connection

Fig 4.1.1
Delete a Connection

Fig 4.1.2
Edit/Test a Connection

Fig 4.1.3
To test the connection just click the test button to start a connection test. See the test results in Fig 4.1.4 below.

Fig 4.1.4
5. AutoSentry

AutoSentry is the VisualLookout monitoring and logging list panel. The user can select any connection IP/Domain address or Port from an agent window to be added to the AutoSentry window. Any item listed in the AutoSentry window is continuously monitored to provide the user with details such as the number of current connections, the overall total connections since VisualLookout started and the total time connected. For ease of monitoring all agent information is centralized and appears in a single global AutoSentry window (see fig 5.1 below).

Fig 5.1
To add agent data to the AutoSentry window perform the following steps:
- Highlight the agent from the agent window list (see fig 5.1.1 below).
- Right mouse click and select either 'add port to sentry' or 'add address to sentry'. The Port option will add the port number for monitoring and logging. This means that any connection to the selected port will be recorded. The Address option adds the IP Address for monitoring and logging. This means that every time this IP address connects the connection times will be recorded.

Fig 5.1.1
6. Map View for a Connection

VisualLookout provides any connection 2 digit ISO standard country code on the connection report entry line see Fig 5.1.2 below. As it is not always apparent which country is represented by the ISO code the user may select a map view by left mouse clicking on the inbound connection in the Agent connection view and then right mouse click to select 'map n.n.n.n' from the context menu displayed (See Fig 5.1.2 below).

Fig 5.1.2
7. AutoContact List [NX]

The Contact List View is the list of all visitors that have contacted the monitored system. Every IP that connects gets looked up by VisualLookout and recorded in the Contact List View. See Fig 6.1 below:

Fig 6.1
If the VisualLookout user wishes to track and further identify a Visitor to the system being monitored he may use the optional VisualRoute utility. VisualRoute allows the user to trace to the exact location of any visitor to the monitored system and plots the location on a world map. VisualRoute provides a wide range of additional data including the route taken to reach the user the final location and the WHOIS information to further identify the domain/IP address owner. See Fig 6.2 below.

Fig 6.2
8. AutoAlert [NX]

AutoAlert is the VisualLookout automated alarming system that can initiate emails and other actions depending on security definitions. The user can select an event from any running Agent to trigger an Alert. The user may also select a global option to convert all the entries in the AutoSentry view directly into AutoAlert. When this option is used all items listed in the AutoSentry view is added as an Alert but the action settings are set to none. The user must edit the automatically added entries to configure the actions desired. These consist of, send an email, display a window popup, send SNMP trap, or run an application. See Fig 7.1 and 7.2 below:

Fig 7.1
The process to configure an Alert is as follows:
- Select "View Menu" - > "AutoAlert"
- Right mouse click anywhere under the title bar and select "Add new alert" (see fig 7.1 above)
- When the Edit Alert dialog appears select and enter a port number, an IP address or a Country Code in the Agent edit field
- Select the action type of Popup Window, Send mail, SNMP Trap, or Run application
- Complete the remaining edit fields with valid data for the action type selected. See fig 7.2 below for an example
- Click OK

Fig7.2
9. History/Search [NX]

The History and Search feature in VisualLookout captures the connectivity information into an internal database and allows the user to search for details on an historical basis. The user can select any connection on which to search if multiple connections exist. See Fig 8.1 below:

Fig8.1
The Database Search dialog is composed of three (3) views: the database overview in the upper left, the search parameters in the upper right, and the agent view in the lower portion. The database overview contains a drop-down list box with all of the agents available in the logs\Connections directory. Additional directories can be copied from other machines for viewing. Periodically, and whenever the database is updated, a scan of the latest sample available is performed. There are four (4) buttons in this view.
- <Agent> button toggles between the agent view and the help message view
- <Reset> button is used to clear cached data when walking through agent data
- <Fetch> button is used to start/resume a search through the currently selected database
- <Close> button can be used to exit the database search dialog
The search view is used to select the search parameters and starting time. The top portion of the view consists of the three (3) selection criteria. Each selection contains the search value and an On/Off checkbox. The middle portion of the view is the current starting time for the next search. The four (4) buttons in the bottom portion are used to set the search time. The buttons can be used to increase and decrease the next search time. Clicking on the left half of a button decreases the time by the respective amount. Clicking on the right half increases the time.
Once a search has located a match on the selection parameters and time, the agent/help view of the dialog will change to the agent view. This view is identical to the agent view in the VisualLookout main window. The agent context menu options, via a right mouse click, are available in the database search dialog. For example, the menu option, run, will cause the agent to replay the database from the selected time. The replay rate is set by the interval menu option. See fig 8.2 below.

Fig 8.2
10. Interface Data 
Network interface data is reported in real-time, displayed at the bottom of each
agent view, providing the transfer speed, both sent and received, and the length
of the output queue for each active agent (see Fig 10.1 below).

Fig10.1 - Interface Data View
The data is sampled at intervals of 15 seconds or the agent's interval, whichever is larger. The display consists of a drop-down menu of all the available interfaces and the latest speed data, containing:
1. 'advertised' speed of the interface, such as '57 KB/s', which is the speed
of the interface as provided to the system.
2. utilization of the interface, which is the percentage of the 'advertised'
speed that was actually used during the latest interval. The utilization can
legitimately be less than the 'advertised' speed.
3. actual input speed
4. actual output speed
5. output queue length
For additional information regarding VisualLookout interface data, please see our FAQ page.
