Not Another Port Scanner
User's Manual
(Please Note that this version of the Help
lacks some content, and proper layout. If
you want to view a more "user-friendly",
complete manual view the PDF version.)
Naps was created by Nicholas Merizzi, Matthew Picheca, Paul Paszynski, and Tim Tisdall as their final year project in the computer science program at McMaster University in 2003-2004. W.F.S Poehlman was the faculty advisor for the project.
Clicking on the Add Node button in the taskbar will bring up the
window shown below. You can enter the IP of a machine you want
to monitor or you can enter a range of IPs. (i.e. 1.2.3.4-6 will add
the nodes 1.2.3.4,1.2.3.5,12.3.6). If you check off the "priority" box,
by clicking on it, then you will be notified by email when something
important happens to the machines you entered.
Quick Reference: Deleting Nodes
Clicking on the Delete Node button in the taskbar, will bring up the window shown below. You can select the IPs of the machines you wish to stop monitoring on the left and then click the blue arrow to move them to the right. When you click "Delete" then all the nodes listed on the right will be removed.
Node has been added to the screen but no
information has been retrieved yet.
The
node is not responding to ping.
The
node is responding to ping, but doesn't
have an SNMP agent running.
The node is responding to both pings
and to SNMP request.
NAPS was designed entirely in Java and can operate on any machine running Sun OS, Linux, Windows (9X, 2000, NT, or XP). Also, in order for the program to work properly the user running the program must have sufficient access to be able to run the "ping" command. You can test if you meet this requirement by going to the command line and typing "ping 127.0.0.1". If the message returned indicates that you don't have access to ping then NAPS will not work properly for you. Talk to your system administrator to gain access to the ping command if you do not already have it.
If you do not already have the Java Virtual
Machine then you may
install Java 1.4.2 which is found on the CD (it should be clearly indicated
as to which file that is). Alternatively, you may download the latest
version
of Java from http://java.sun.com with your web
browser. As mentioned in the requirements, you must have access to
certain commands. If you don't have access to ping then it's most likely
due to security policies that are in effect on your computer that can only be
changed by the system administrator.
The installation of NAPS is fairly simple because the program
is packaged
into a JAR file. Simply copy the NAPS directory off the CD to where you'd
like to run the program. Make sure that after copying the files you change
the
permission on all the files in the directory and the directory itself so that it
is not
read-only (i.e has write access on). The reason for this is that NAPS will
create
log files and save network mappings to that directory.
To run the program in Windows, most systems will be setup
after installing
JVM to allow you to double-click on the "NAPS.jar" file to execute the program.
Alternatively, you can run the program from the command line by first making the
NAPS directory the current directory and typing "java -jar NAPS.jar". If
you're
running Sun OS, or Linux you must type that in at the command prompt to execute
the program.
To monitor a machine over the network, you first need to add it to the main
window with the Add Node window. To bring up this window, you can either
click the Add node button, press CTRL-A on the keyboard or select
add node from the "Monitoring Menu Item".
Now that you have the window open, you can
begin to add nodes by
entering their IP addresses. When you've entered the IP address that you
wish to be added, click the OK button. Additionally, if you'd like the
information logged in a special log file then you can check off the priority
box before click "ok".
As well as simply entering a single IP
address in the add node window,
you can also enter a range of IP address. To enter a range, you specify
the first 3 octets of the IP address explicitly and then you may enter a
hyphenated number range as the last byte. For example, lets say you'd
like to add all of the computers in your local area network and you know
that that computers range from 192.168.0.100 to 192.168.0.150. To
enter all the computers between those two ranges you would enter
192.168.0.100-150 in the add node window. Please note that the
last byte of the IP address is the only one that you're allowed to specify
a range on.
If you click on the delete node icon, press CTRL-D, or select Delete Node from the monitoring menu item, you'll see a window similar to the one below.
When you first bring up the window, you'll
see a list of all the nodes currently
added on the left and another similar field to the right that says "empty".
You
delete nodes by selecting on the nodes you wish to delete on the left side
and then clicking the blue arrow to move them into the field titled "nodes to be
deleted". If you accidentally add a node to the right box that you don't
want to
delete, simply click on the it and click on the red arrow to move it back to the
left box. When you've finished moving modes into their appropriate boxes
click
Delete to commit your changes.
When selecting items in the boxes, you can do
it multiple ways. If you'd
like to select multiple items in the list you can hold down the CTRL key and
click on each of the items you wish to select. Also, if you wish to select
a
range of nodes, you click on the first node in the range, hold down shift, and
then click on the last item in the list that you want. When you use the
shift
method of selection all the file between both that you clicked on will be
selected.
1. New Mapping: Clears all the nodes in the
current window so you
can start with a new blank screen
2. Open Mapping: Brings up an open file
dialog window so you
can select a saved mapping and load it into the main window.
3. Save Mapping As: Brings up a save file
dialog and allows you
to type in a file name to save this mapping.
4. Save Mapping: Will save to the current
file, or if there is none
then will bring up a save file dialogue so you may type in a file name.
5. Preferences: Brings up the preferences window
6. Find Node: Brings up a dialog that will
allow you to search
for an IP in the current mapping and then highlight the node if
found.
7. Exit: Exits the program
1. Toolbar: Toggles the toolbar
2. Status Bar: Toggles the status bar on and off
3. Change Look & Feel: Allows you to alter
the current
look of NAPS by selecting an alternate application skin.
1. Ping Node: Brings up a dialog to allow you
to ping
any IP or hostname address. The address does not need to
be on the current mapping.
2. MIB Browser: Brings up the MIB Browser window.
1. Add Node: Brings up the Add Node Dialog to
allow you to add a new node to the mapping.
2. Delete Node: Brings up the Delete Node
dialog
which allows you to delete any nodes in the current
mapping.
3. Stop Monitoring: This tells NAPS that you
want to
stop all monitoring of the nodes. In other words, NAPS
will stop getting SNMP information and stop pinging
nodes and no new information will appear in NAPS.
1. Status Log: Brings up a window showing the
contents of
the status log. This window is updated as new
information is found.
2. Network Alert Log: Similar to the status
log, but
only gives information on nodes marked as "priority".
3. Trap Alert Log: Lists all the SNMP traps
captured
from nodes added to NAPS.
1. Help Index: Brings up the help window which
contains
information on how to use NAPS.
2. About: gives information on the creators
of NAPS. To
close this window, simply click on it.
The node information window provides detailed information on
that
particular node. A few facts should be mentioned regarding this window.
A node may appear to go up and down if the response time to pinging varies
between less than 1 second and greater than 1 second. This is due to the
fact
that the ping gives up waiting for a response 1 second.
If a machine is not responding to ping then it is automatically assumed that
the machine will also not respond to SNMP requests. If you know
specifically
that a machine that is shown as "Down" is actually connected and will respond
to SNMP, then you can get the SNMP information through the MIB browser
(if you click on the MIB browser button then you will see the MIB Browser
with this machine's address already entered).
When selecting Ping a Node from the tools menu you will be shown
a dialog box where you can enter a machine address. Unlike the Add Node
window, you can enter either the IP address or the machine's Hostname. When
you click on the Ping Node button on the left of the window, the program
will try to ping that machine to see if it's responding. The result of the
ping will
be shown just below the text field where you entered the machine's name (IP or
hostname). If you see a checkmark then that machine has responded,
on the other hand if you see a red 'X' then the machine is not
responding
to ICMP packets.
The MIB Browser window is probably the most complicated to
use
window in the NAPS program.
For most casual users of NAPS
you will not need to use this window, but more
advanced users will
find it useful to get additional information the Node Info window
doesn't
provide. Also, the MIB
browser will also allow you to
set values if you have authorization (ie you have
set the "Community"
field to a community that has permission to write values on this particular
machine).
