You are here: VisualRoute » Support » Manual » Advanced Features









Advanced Features

Overview

This section provides details about using advanced features that are available in some VisualRoute editions. Please consult the program help for your product for more information on specific features supported.

VisualRoute Server  

VisualRoute Business Edition and Server, Server Pro and Server NOC Edition can be configured to run as a (web) server, providing visual trace route capabilities to anyone with a Java-enabled web browser. This is how our Live Demo works. This is very useful when:

  • You want to provide the VisualRoute service to your clients.
  • You may not want to install VisualRoute on lots of client machines. Installing it on one server and granting access to people allows you to control access.
  • Your company has a very strict firewall that blocks any traces, so how do you diagnose network connectivity problems? Install VisualRoute on a server outside the firewall and grant access to people in the company.
  • You want to provide visual trace route capabilities to your entire company.

 

Note: VisualRoute Server acts as its own Web server, and does not require IIS, Apache or any 3rd party Web server application to function.

To enable VisualRoute Server, go to Tools | VisualRoute Server... in the application menu and you will see a status dialog window that looks like figure 14.1. There are some specific configuration or usage options for VisualRoute Business Edition. See the Additional Server Notes section for more information on configuring VisualRoute Server to run within your environment.


Fig 14.1: VisualRoute Server Status Dialog

Just press the 'Start' button to start the Server component of VisualRoute. Users can now use a Java-enabled web browser to connect to the VisualRoute Server and perform visual traceroutes (simply supply them with the IP address the server is running on.)

TIP: Once the VisualRoute Server is running, click on the Test... button to automatically launch a browser connecting to the server GUI (see figure 14.2 below). This will confirm that the server is configured and running on the desired IP address and port. You may configure the page that is displayed for a custom look and feel.

 


Fig 14.2: VisualRoute Server Browser GUI

For Server Standard, Server Pro and Serer NOC Edition users the start up GUI is slightly different than the other editions. See below:

1 - This indicates the type of license you have currently. If no license key has been entered simply click the 'Enter Key' link to register your key.

2 - Unlike the Business Edition the 'Server Options' link is at the bottom of the GUI as opposed to a menu link. The server options are explained below.

3 - To stop and start link is used to stop and start the server engine.

4 - To view the server running click the link denoted by the number 4 in the image above.

5 - A list of helpful links to help setup and run the VisualRoute server.

For server side help click here

Preferences / Server Administration Tab

When you press the 'Preferences...' button in the 'VisualRoute Server ()' dialog (Fig 14.1), the VisualRoute Server Preferences dialog will open as shown in figure 14.3:


Fig 14.3: VisualRoute Server General Preferences Dialog

The VisualRoute Server Preference options are:

IP Address - Allows you to configure VisualRoute Server to run under any/all IP address on the machine, or only on the specified IP Address, which is very useful when VisualRoute Server must coexist with IIS on the same machine (see the related note at the end of this section). Users will then point their browser to the IP address value to access the VisualRoute Server.

Port - The port number that the server will use. To change the port, enter in a new number and press Enter. You will need to change the port number if you install VisualRoute Server on a server that already has a web server service running on the default port. Users will then point their browser to the IP address:port value specifed to access the VisualRoute Server.

Maximum Users - The maximum numbers of users that can perform a VisualRoute trace concurrently. To change this setting, enter in a new number and press Enter. The maximum number is actaually controlled by your license limit; this option allows you to specify something less than the limit.

Access Control List - By default, the server grants full access to anyone who can connect to the machine/port. The Access Control List allows you to fine-tune access based upon a list of 'access verb and CIDR address'. This 'Access Control List' is processed in-order (top to bottom) and the first entry to match the client's IP address is the access entry that is used. If no entry in this list matches, then access is denied. The access verbs are:

 

To add an entry to the Access Control List simply click the 'Add' button and you will be presented with the dialog box below (Fig 14.4).

deny   - denies all access
trace   - allow trace only back to originating IP address
full   - allows full access to all features
super   - full access, even past max users


Fig 14.4: Add ACL Item Dialog Box


So, as an example, if you wanted to grant full access to everyone in your company, but no one else, you would delete the default 'full - 0.0.0.0/0' entry, select the 'full' verb, enter in the CIDR for your company and press 'Add to List'.

Preferences / Server Security Tab

The Server Security tab looks like figure 14.5:


Fig 14.5: VisualRoute Server Security Preferences Dialog

Server Security - These options control whether users can trace to private IP addresses, whether the client's IP address is used in the trace, whether port probes can be conducted, and the number of traces users may perform. This option also supports the use of a username/password control for web access to admin objects.

Restrict Applet Hosting by Domain - Allows you to control the domains that can host the VisualRoute applet from your VisualRoute Server. This option is used to prevent unauthorized use of your VisualRoute server by other sites that attempt to access the VisualRoute applet and service via the Java codebase attribute. Please note that you must list all URL domains that are authorized to access your VisualRoute Server. For example, for http://visualroute.visualware.com, both visualroute.visualware.com and 205.234.111.204 would be added to the list.

Preferences / Mapping / GUI Tab

The Mapping/GUI tab looks like figure 14.6:




Fig 14.6: VisualRoute Server Mapping Preferences Dialog

The GUI options allows you to adjust the look and feel of the applet within the web interface. You can set options such as zoom levels on the map and simplified controls as well as whcih map to use in the applet.

Preferences / Business Edition Tab

The Business Edition tab looks like figure 14.7. Preferences available through this tab are only available in VisualRoute Business Edition.



Fig 14.7: VisualRoute Server Business Edition Tab

This dialog allows you to set the username and password for the browser applet. Users wanting access to the server via the browser interface must enter the username and password specified. The lower half of the dialog displays the IP address and machine name of any connected user. The 'Disconnect' button can be used to force the user to be disconnected from the browser applet.

Additional Server Notes

The following options allow you to customize VisualRoute Server to work within your environment.

NT/Win2000/XP Service: To run VisualRoute Server as a Windows NT/2000 service, just follow these steps:

  1. Run VisualRoute Server to configure and verify that it runs properly; Exit VisualRoute
  2. In a DOS prompt window, change to the VisualRoute install directory and press Enter. For example,

    Type CD \Program Files\VisualRoute and press Enter

  3. Type "VisualRoute -install" and press Enter
  4. Run the Services Manager (Control Panel) and start the "VisualRoute" service.

Similarly, to uninstall the service, follow steps 2 and 3 above, substituting "VisualRoute -uninstall" for "VisualRoute -install".

When installing VisualRoute as a service you may come across the "java.net.BindException: Address in Use" error. This indicates that another server is awaiting incoming connections on the port that has been selected (default 80). Simply change the port for VisualRoute or the conflicting application to resolve the problem.

VisualRoute is now installed by default as 'interact with desktop' when it's being installed as a service.


Customizing the Server Web Page: When a client connects to the server, they get a web page that is automatically generated by VisualRoute. To create your own custom web page, create an HTML document that contains this HTML code:

<applet code="VisualRouteApplet.class" width=600 height=1024>
Java support required!
</applet>

Then place this new HTML document into the VisualRoute "www" directory under the name "index.html". This new index.html will then be used when the client connects to the server.


Placing the VisualRoute applet on your corporate web server: If you want to integrate the VisualRoute Server applet into your corporate web server, you must use HTML code that looks like:

<applet codebase="http://www.your-vr-server.com" height="550" width="600" code="VRApplet" archive="vr.jar">
Java support required!
</applet>

Where http://www.your-vr-server.com is the URL to your VisualRoute Server (that is running and working). So, your corporate web server contains an HTML web page with the HTML code above and it points to your working VisualRoute Server (via codebase) so that traces can be performed. Please note that simply viewing the "www" folder files through your corporate web server will not work.


Starting a Traceroute Automatically: To start an automatic trace to a domain or IP address with VisualRoute Server, add '?go=www.host.com' or '?go=IP Address" onto the URL in your browser. For example:

http://your-vr-server.com/?go=www.visualware.com

will automatically launch VisualRoute Server and run a traceroute to 'www.visualware.com'.

This allows for great flexibility in creating custom Web pages with traceroute capabilities. For instance, the following input box is simple to include in html, and allows you to input a domain/IP directly, which will launch VisualRoute Server and run a trace to that domain. As VisualRoute Server may also be embedded in html code, it is easy to create a customized look and feel for your site while providing the traceroute functionality via an HTML form like:

<form action="http://your-vr-server.com/" method=get>
Host:
<input name=go size=25>
<input name=submit type=submit value="VisualRoute Trace!">
</form>

 

Coexisting with IIS: Want IIS to use port 80 on one IP address and VisualRoute Server to use port 80 on a different IP address, but on the same physical machine? This works, but IIS has the nasty tendency to grab up all IP addresses on a machine, even if IIS is not configured to use all IP addresses. This prevents any other application from using port 80 on a free IP address. Microsoft Tech Note Q238131 has details on how to fix IIS. However, also make sure that you have no services set to use IP address "All Unassigned", otherwise IIS will still grab all IP addresses. Instead, make sure that you specify the IP Addresses that you want IIS to use for each type of service (HTTP, FTP, etc).

 

Preventing traces to Secure IP Addresses: To prevent a VisualRoute trace to a particular IP address (or range of IP addresses), edit the .\data\user\secure.txt text file (a file you must create). Each line in this file is "cidr-address,x". For example, here is an example secure.txt file that secures two IP ranges:

198.242.57/24,x
201.109/16,x

If there is an attempt to trace directly to any secure IP in this list, it will be treated like a DNS error (does not exist). If the IP address shows up in a trace, it will be replaced by the 'x' in the line definition.

Ping Grapher

Ping Grapher is NOT available in VisualRoute Personal Edition. Ping Grapher offers the ability to measure a network device's latency continuously at specified intervals. Ping Grapher Server is available in the Business and Support editions only and allows for Ping Grapher functionality from the VisualRoute Server browser.


To access this feature, choose where you wish to trace from (no. 1), enter the desired IP address in the 'Address' text box (no. 2) and select the Ping Grapher icon (no. 3) from the menu bar. Alternately, open a new Ping Grapher tab by selecting 'New Plot' from the 'File' menu and then follow the previous instructions.


Fig 16.1: Ping Grapher Icon

The Ping Grapher report will display in a tab as illustrated below in figure 16.2:


Fig 16.2: Ping Grapher Dialog

Latency to the requested device will be diplayed (in msec) across the graph. Packet loss is indicated by vertical red bars. To view the specific data sampled for any time interval, simply click on the plot and hold the mouse while dragging across the graph.

The bottom half of the Ping Grapher tab displays several options. If you have used Ping Grapher to measure the same domain/IP address before, use the first drop down selector (shown in figure 16.3) to select an historic data interval or create a new live plot. The second drop down selector defines the ping interval (also shown in figure 16.3) to be used. Valid selections are 5, 10, 20, 30, or 60 seconds.


Fig 16.3: Ping Grapher Options


Fig 16.4: Ping Grapher Options, Continued

As data gradually builds up, it will fill the entire plot area and will automatically scroll rightwards as new data is made available. To stop Ping Grapher, click on the 'Stop Plotting' button under the Options window. Change the zoom level displayed in the graph using the Zoom controls located at the right side of the Ping Grapher Options window. Both of these options are shown in figure 16.4.

Continuous Trace

An advanced feature in all editions except VisualRoute Personal Edition is the ability to continuously conduct a trace route to a specified address. This allows you to monitor for performance degradation that may occur over long periods of time.

The green recycling icon to the left of the Analysis text (Fig 17.1) opens the 'Traceroute Auto-Update Preferences' dialog shown in figure 17.2.


Fig 17.1: Continuous Trace feature

Traceroutes can be run continuously by selecting the first option, 'Update traceroute continuously' and also checking the 'Use this setting for all future traceroutes' box to set the selected preference as the default for all traces. When a trace route is performed with the continuous option turned on, the trace will start again as soon as it has finished and will update every hop along the way. This feature allows you to continuously monitor an IP/URL.


Fig 17.2: Traceroute Auto-Update Preferences dialog

Traceroute History

An advanced feature in all editions except VisualRoute Personal Edition is the ability to save trace route analysis in a history file. This allows you to reference previous traces to aid in the analysis of ongoing problems or to identify changes in service levels.

History files are automatically created each time a trace is run. To access a history file, simply select File | Open Traceroute... from the menu (see figure 18.1). This will open the Load Traceroute dialog box as shown in figure 18.2. The historical traceroute results will be opened as a seperate tab in the main VisualRoute GUI.


Fig 18.1: Open Traceroute... dialog box


Fig 18.2: Load Traceroutes selection dialog box

Comparing Traceroutes

An advanced feature in VisualRoute Business Edition, Support Edition, Professional Support Edition and Server Edition is the ability to compare two traceroutes side by side. This allows you to compare things like average response time and packet loss between two different times.

To compare traceroutes go to the File menu and choose Compare Traceroutes... to open the Compare Traceroutes dialog box (Fig 19.1).


Fig 19.1: Compare Traceroutes selection dialog box

From this dialog, choose the two traceroutes to be compared. First choose the trace name from the drop down menus. In this example the same destination host is being used (i.e., www.visualware.com). Then choose the trace times to be used in the comparison. In this example, traces from two different timestamps on the same day are used. Once the traceroutes have been selected, click the 'OK' button. The traceroute results will appear as shown below in figure 19.2:


Fig 19.2: Comparing Traceroutes window

The two traceroutes appear side by side with a special analysis detail in the Analysis window at the top of the VisualRoute GUI. Hop deviations appear in red as shown in the above image. Node names and network names do not appear in a comparison, however this information can be displayed for a single traceroute by going to the File menu and choosing Open Traceroute (see the Traceroute History section for more detail) to view the historical trace data.

 

Custom Traceroute Maps

A typical Trace Route Map section looks like figure 20.1. For more information on how to interpret map results, please see the section on Trace Route Maps.


Fig 20.1: Trace Route Map

 

Adding a Custom Map to VisualRoute    

An advanced feature available in the Business Edition, Support Edition, Professional Support Edition and Server Edition is the ability to add a custom made map to use for traceroutes.

 

Custom IP-to-location maps within VisualRoute can be of several types. For example, custom geography-based maps can provide a more detailed map of your specific country or even province(s) within a country such as a US state. Maps can also be diagram-based to represent, for example, a corporate private network.

For geography based maps the user can define the latitude/longitude parameters that define the boundaries so VisualRoute can plot the geo-locations accurately. For diagram based maps VisualRoute provides the means for the user to easily define where on the map IP addresses exist so when a trace is done across a business private network VisualRoute will accurately find the various routers, server and other device symbols.

In addition to latitude and longitude coordinates for geography maps and IP locations for diagram maps, VisualRoute allows users to define a zoom range (from <1:1 to >1:1). This is useful if you want to build a network map that covers a number of global network locations. Zooming then allows you to focus on the final destination with a good level of detail. This obviously allows you to map the starting network detail and the ending network detail in a single diagram map.

VisualRoute allows the user to make use of the custom maps in a number of valuable ways:

Automated Map : In automated mode VisualRoute will select the map dynamically based on the final location. So for example, if the final location is the datacenter in Chicago VisualRoute will select the datacenter map the represents the Chicago network. Obviously a user diagram map can contain multiple locations and the zoom option makes this easy to view.

Default Map : In default mode VisualRoute will always use the map set as the default map. On first install this is set to the VisualRoute World map but the user can elect to change this to another user defined map/diagram. In all traces the default map is shown when a trace starts and will remain in view until an automated map for the destination is found.

Manual: Manual map selection is available anytime regardless of the other map selection options. A user can manually select another map after a trace has completed. As an example a user can trace to the Sydney datacenter and use the default world map to see the Internet routing between New York and Sydney. Then the user can switch maps to the Sydney corporate network map (or may be an Australia/Sydney only map) to examine the destination network in much greater detail. In fact the user may switch between several detailed maps.

To add a custom map to VisualRoute you can either go to the 'Maps' menu and click 'Add Map...' or you can use the shortcut; Ctrl-Shift-M. This will open the dialog box below in figure 20.2:


Fig 20.2: Add Maps dialog box

The first section of the dialog box is to enter a name for the map you are adding. This will be used to reference your map when using it in VisualRoute. Next is to add the map itself; to do this click the 'Select' button which lets you browse your machine for the map you want to add.

The second section has two options, the first option is for when your map is another world map. You need to select this option if you are providing a world map onto which any latitude/longitude may be plotted. If you are offering for example a building plan, uncheck this box and only prespecified IP's/locations will be plotted. The second option is whether you want your map to be zoomable, with this option checked you will be asked to choose the zoom levels you want to allow, 1.0 being the normal zoom.

Selecting a Map     

Once you have added your map the next task is to implement the map into VisualRoute, to do this you can either go to the Maps menu and click on Select Map or you can use the shortcut; Ctrl-M. You will see a dialog box like the on below in figure 20.3:

Edit Map
Fig 20.3: Select Map dialog box

The select map is as simple as it looks. By clicking on the drop down menu you will see your custom map in the list, select it then click ok to use it with your next trace. If you want your new map to be used for every trace without having to keep selecting it then check the 'Set as Default' option in the Select Map dialog box. If you want to edit your map you can click the 'Edit Map' button when your custom map is selected in the drop down menu. This will take you to the 'Add Map' dialog box where you can make the changes you want.

Adding Addresses to a Custom Map     

Now you have created your custom map and added it to VisualRoute you will need to set specified IP's to different locations on your custom map (this is only needed if you have NOT checked the 'This is a map of the world' option in the Add Maps dialog box). To do this you need to go to the Maps menu and click 'Add Addresses to Map...'. This will bring up the dialog box below in figure 20.4:

Edit Rule New Rule
Fig 20.4: Add Map Points Dialog Box

The first thing you have to do when adding points to a custom map is to choose the custom map you want to add points to. To do this simply select the map you want from the drop down list. Note if you have not added a map this dialog box will be non functional as you cannot add points to the default VisualRoute map. Once you have chosen your map it will appear in the image space at the bottom of the dialog box. The next section requires you to add your points; to do this you need to click the 'New Rule' button which will launch the dialog box below in figure 20.5 (the same dialog appears when you want to edit a rule):

Click 'Ok' to return to the 'Add Map Points' dialog box
Fig 20.5: Add Map Point Dialog Box

First of all, you need to specify an IP (the type of valid entrys are shown in the example in the image). Simply type the IP address you want into the 'Enter IP address range' and then you need to specify where this IP should reside on your custom map. To do this simply use your cursor to click the map in the correct place. Notice that the coordinates will now appear in the 'x' and 'y' text boxes just above the map. If you want to set a location for every IP address not specified then enter the IP address 0.0.0.0/0 then choose a location on the map. Once you are done specifying an IP address then click 'Ok' to return to the 'Add Map Points' dialog box where you can add, remove or edit more rules.

Using a custom map when using VisualRoute may look something like the image below in figure 20.6. You can see which machines a trace goes through in a network situation and when it leaves the network through the router etc.


Fig 20.6: Custom Map Trace

 

  Copyright © 1997-2006 Visualware Inc. · All Rights Reserved