Welcome to...
       
   A real-time session monitor for your firewall
Home Product News Features Download Buy FirePlotter Support Contact Us About Us
Online Help

FirePlotter is a powerful utility that lets you monitor the traffic is passing through your Cisco or FortiNet firewall. It enables you to see how many sessions, what type of sessions (email, web browsing, file transfer ... ), which direction (inbound or outbound) and how much bandwidth is being used by each (Kbits/sec). This information is displayed in real-time in both tabular and graphical format providing updated real-time snapshots of network availability.

Before searching this extensive help page it may be worth watching all of the 3 minute training video that sums up in seconds what it can take several minutes to read:


              

FirePlotter Training Video - 3 minutes




The FirePlotter Known Bugs page is worth checking if you are experiencing any difficulties: see: Known Bugs

FirePlotter Online Help is divided into the following sections:

   How to Quick Search this Online Help Page
   Quick Start Guide
   Upgrades
   Free Mode vs. Licensed Mode
   FirePlotter Controls & Views
   View Modes: Basic & Advanced
   Understanding Zoom In, Active Filters and Summary Filters
   How to "find" an IP address in FirePlotter
   Setting Up Your Cisco ASA/PIX Firewall for FirePlotter
   Setting Up Your FortiNet FortiGate Firewall for FirePlotter
   FirePlotter.ini
   FirePlotter Licensing
   Troubleshooting

   FirePlotter Error Messages (Help Codes)
   Further Help


Tip - How to Quick Search this Help Page

Did you know that in any web page (on all websites) you can press and hold down [CTRL-F] at any time and a Find Window like this will open?



You can use [CTRL-F] to search this Online Help page. Simply press [CTRL-F] and then type in the text you are searching for. Use the Previous and Next buttons to move through the page. Press the red X in top right of the Find Windows to close it.


Quick Start Guide

FirePlotter is easy to get going and use.

FirePlotter supports Microsoft Windows 2000/XP/2003/Vista.

FirePlotter supports all Cisco ASA/PIX Firewalls (v6.x, v7.23 and above (more >>) and 8.x) and FortiNet FortiGate Firewalls (v2.8 and v3.0).

FirePlotter uses a SSH (secure shell) or telnet session to the firewall to get the firewall's real-time session information. So all you need to do to get FirePlotter working is make sure you can connect and login to the firewall using SSH or telnet. If you don't already know how to do this then see the "Setting Up" sections (Cisco/FortiNet) below.

FirePlotter quickly answers questions like "Who is using my bandwidth?", "What is using my bandwidth?", Who is eating my bandwidth?" or "What is eating my bandwidth?".

To connect FirePlotter all you need is:

1) the IP address of the Cisco or FortiNet firewall
2) to be able to access the firewall using ssh or telnet protocol
3) working SSH or telnet login credentials with admin/enable rights*

*for FortiNet this must be the "admin" username.

Enter this data into FirePlotter fields at the top and press Connect and you are away into the wonderful world of finally seeing what is really happening on your internet connection(s)!

We generally recommend using SSH rather than telnet to connect FirePlotter to your firewall. This is because SSH provides a secure encrypted connection, this means that your firewall session data that is transmitted between the firewall and FirePlotter is not able to be sniffed/hacked. Also, if you are connecting to a Cisco ASA or PIX firewall , SSH is better optimised for performance on these platforms than telnet.

Upgrades

Tip - If you are upgrading your version of FirePlotter, please remember to backup your C:\Program Files\FirePlotter\FirePlotter.ini file if you've changed it, as it gets overwritten by the upgrade process. There may be differences in the format of FirePlotter.ini between released versions of FirePlotter. So you may need to re-create your FirePlotter settings in FirePlotter.ini after an upgrade.

Free Mode vs. Licensed Mode

FirePlotter can be run in Free Mode or (paid for) Licensed mode - see the differences between the two here: Free vs. Licensed Mode - Comparison Chart

FirePlotter Controls & Views


The FirePlotter windows can be divided into 5 sections: Menu Bar Connection Bar, Session Tables Section, Graphical Bandwidth Plotting Section, Control Bar Section and Status Bar:

Menu

Connection


Session Tables










Graphical Bandwidth Plotting

Control

Status
 

Menu Bar

The File Menu provides options to "Open fireplotter.ini" (see FirePlotter.ini) and the "Exit" the application. The "View", "Mode" (View Mode) menu option can be used to toggled between "Basic" and "Advanced" View Modes (see View Modes: Basic & Advanced). The Help Menu options are: "Online Help" (taking you to this web page), "Check for Updates Online" (taking you to a web page to check you have the latest version of FirePlotter) and "About FirePlotter" (see FirePlotter Licensing).

Connection Bar

Here you can select Cisco ASA/PIX or FortiNet FortiGate firewall type, Connection Type (Telnet), enter the IP address or DNS name (e.g. 192.168.1.1 or firewall.test.com) and telnet login credentials for the firewall to be monitored.



Session Tables Section

The traffic monitored by FirePlotter is divided into Inbound and Outbound. Inbound traffic is defined as sessions that is initiated from outside of the firewall passing inside. Outbound traffic is defined as any sessions that are initiated from the inside of the firewall passing to the outside. Until FirePlotter is developed to differentiate between all possible firewall interfaces, any DMZ ports on a firewall are considered as "inside". So sessions passing from DMZ(s) to Outside is considered as Outbound sessions and vice verse.

Once FirePlotter is gathering real-time data you can double click in the Session Table Section on any of the Direction, Source IP, Source Port, Destination IP, Service /Destination IP, IP Protocol Fields, Sessions fields to zoom into specific real-time session information. So if you double click on a line in the Source IP address column with single IP address being displayed, you will drill down into all the sessions related to that IP address. Or if you click on a line in the Service/Destination Port column where it says HTTP (80) is being displayed you will drill down into all HTTP traffic passing through the firewall.

Tip - once you have drilled down, you may choose to activate a Summary Filter - for example by Service/Destination - see Control Bar

Tip - You can also click on any of the column headings to re-order into ascending order the whole session list by the data in that column.

Tip - To reset back to the "Default view" - right-mouse click anywhere in the Session Table and select "default view"

Tip - you can see what filters are active as you drill down by viewing the left portion of Status Bar at the bottom of the FirePlotter screen.

The default view summarises the sessions by Inbound and Outbound sessions, and then by Service/Destination IP.

Where Source IP field or Destination IP fields shows "..." then this indicates multiple addresses and may be double clicked on to get more information on what those IP addresses are.

Where possible FirePlotter will resolve IP addresses to Fully Qualified Domain Names (FQDNs) or NetBIOS Names (optional). When an IP address is displayed in brackets e.g. (192.168.1.1) - this indicates that FirePlotter is still attempting to resolve a name to the IP address. See FirePlotter.ini for how to set name resolution options.

Note that FirePlotter suppresses monitoring of its own SSH or telnet traffic on the session tables or graphing of traffic.

Also please note for Cisco ASA/PIX users: Cisco do not provide session data in PIX 6.x for connections directly to the PIX interfaces. This means that management connections such as  SSH or HTTPS are not displayed. This also means that VPN connections terminated at the PIX are not reported. However, in PIX 7.x this session data is provide and so FirePlotter can display bandwidth usage and session data for all connections terminated at the PIX interfaces (SSH, HTTPS, VPN etc).

Graphical Bandwidth Plotting Section

The graphical section displays Inbound and Outbound Bandwidth Usage in KBits/Second over time by Service/Destination Port. The colours of services are set in the FirePlotter.ini file. For example: Email (SMTP) traffic is red; Web Browsing (HTTP) is green; Secure HTTP (HTTPS) is gold; FTP is brown.

FirePlotter's Graphical Bandwidth Plotting as well as graphing the total bandwidth for the 8 configurable key protocols (Ping, FTP, SMTP, DNS, HTTP, POP3, HTTPS & RDP) is also continually ensuring the protocol consuming the most bandwidth is always graphed with a Trace line.  The Trace line is often not visible on the graphs as the protocol consuming the most bandwidth is usually one of the 8 key protocols which are already graphed. On occasions where a non key protocol is consuming the most bandwidth then the Trace line appears and the associated protocol entries in the Session Tables are highlighted with the same colour.  The Trace line protocol can change second by second as different applications consume for available bandwidth.  The default Trace colour is a pale blue and when it appears on the Graphical Bandwidth Plotting is a slightly thinner line than the key protocols.



Control Bar

In the Control Bar there is Summary drop down menu, providing the options to filter the selected real-time session data by: No summary, Source IP, Destination IP, Service/Destination Port, IP Protocol and Direction. Also here is the option to return to the Default view, change the refresh interval to 1,5,10,15, or 30 seconds and to Pause, Play and Refresh Now the real-time monitoring.

For Online Help  - press Help.

To exit FirePlotter - press Exit.



Status Bar

From left to right the first part of the Status Section indicates the Active Filters currently applied to the session table view where D = Direction, SIP = Source IP Address, DIP = Destination IP Address, S/DP = Service /Destination Port Number, and IPP = IP Protocol. For more information on Active Filters see  Session Table above. The View Mode setting of Basic or Advanced is next (see View Modes: Basic & Advanced). The next section indicates when the when the next update of session data will start and indicates on first connection how many blocks of data are being downloaded to get all the session data from the firewall, from then on it indicates a estimate in percentage (%) of sessions data to be downloaded. The next section displays total number of sessions at each refresh. The rightmost section displays the current time.

Tip - You can use the Windows XP/Vista key combination of [Ctrl+Alt+PrtScn] to copy a screenshot of the ‘active’ window (in this case the FirePlotter application) to the clipboard at anytime. You can then paste this image into any other application of your choice.

View Modes: Basic & Advanced

Basic Mode lists only the key services (e.g. HTTP, SMTP etc) and Advanced Mode shows all services passing through the firewall.

In the licensed version of FirePlotter there is the option to switch between Basic and Advanced View Mode
via the View Menu. An unlicensed "Watch Only" mode FirePlotter will only run in Basic View Mode.

By default, Basic Mode will only monitor the services listed in the [Ports] section of the fireplotter.ini file (see FirePlotter.ini) e.g. HTTP, FTP, SMTP... This means that if a service/destination port is not configured in fireplotter.ini, then it will not show in FirePlotter Session Table or Graphical Bandwidth Plotting that is running in Basic View Mode. The only way to monitor service/destination ports that have not been configured in fireplotter.ini is to switch to Advanced View Mode.

In Advanced View Mode FirePlotter will show all service/destination ports.

Understanding Zoom In, Active Filters and Summary Filters

OK, Lets go through the many filtering views that FirePlotter gives you. When you first load FirePlotter it extracts the session table from your firewall and automatically displays the session table summarising by Service/Destination Port (as indicated at the bottom of the screen) and sorted by the ‘Direction’ and then ‘In Bytes/s’ columns. Notice that the Sessions column shows how many SMTP or HTTP sessions are passing through the firewall - something like this:

As an aside, notice, that if you click on the word Sessions at the top of the Session column (or any of the column titles) FirePlotter will re-order the session table display in descending value order. like this:

Now lets turn off the Summary filter by changing the Summary filter setting at the bottom of the screen.  Notice you will now get a long list of all the sessions going through the firewall, one line per session (notice scroll bar on top right), and Summary Filter is set to No Summary (notice the session column again, now 1 session per line) - something like this:

OK, so now let's switch back to Summary Filter by Destination/Service Port. Now you can see that Sessions are summarised by Service again. Now lets zoom into a particular internal IP address. We know it is internal as we are selecting from an Outbound Sessions, so the source IP will be an internal device. Let's select 192.168.68.14 and double click on that...

Now because we clicked on 192.168.68.14 with Service/Destination Port of HTTP (Port 80), we now see all HTTP sessions relating to this device. Notice what the active filters are displaying in the Status Bar at the bottom of the screen, and notice that Summary Filter has switched to No Summary.

 

Once you have taken that in, then we can zoom in to see all the traffic (not just HTTP) that this device is sending through the firewall by double clicking in 192.168.68.14 again (highlighted above) - but this time we are not in a summary mode so now we get:

So to tidy up a bit we could turn on Summary Filter by Service Destination and we would get this, a nice summary of what just this device is doing:

Then we can click on the Default View Button to take us back to the starting point and explore other sessions in a similar manner. It's easy to understand and use the Zoom In mode and to read the Active Filter status and use the Summary Filter. Really Easy!



  How to "find" an IP address in FirePlotter

One thing you can do to find an IP address really easily right now is: From the Default screen first press Pause to stop it updating - so you can see the snapshot of all the sessions. Then change the drop down at the bottom left to Summarise By: Source IP. Then click the top of the Source IP address column to re-order the column by IP address in ascending order. You can then scroll down to the address you want, then double click to Zoom in to the specific IP address you want to. Once zoomed in - you might want to re-enable the Summary By Service/Destination Port if there are lots of connections. You can also re-enable Play so you can see in real-time what that IP address is doing.

Setting Up Your Cisco ASA/PIX Firewall for FirePlotter

For SSH connections:

If you wish to allow FirePlotter to make a SSH connection to a Cisco ASA/PIX, you need to configure your ASA/PIX for SecureShell  (SSH) connections.

More information on configuring SSH on a Cisco Firewall click see:

Configuring PIX 6.x to Accept SSH Connections
Configuring ASA/PIX 7.x and above to Accept SSH Connections

More information on configuring SSH on a Cisco Firewall is available here from Cisco:
http://www.cisco.com/en/US/docs/security/asa/asa81/command/ref/s8.html#wp1210645

Once ssh is configured on you Cisco ASA/PIX you can test SSH from the PC your are using for FirePlotter. You will need to connect to the firewall using a SSH utility like PuTTY. See http://www.putty.org/

For Telnet connections:

If you wish to allow FirePlotter to telnet to a Cisco ASA/PIX, you need to configure which hosts are allowed in. To allow a single host to telnet in via the inside interface:

telnet 10.1.1.100 255.255.255.255 inside

To allow any PC on subnet 10.1.1.0 /24 to telnet in via the inside interface:

telnet 10.1.1.0 255.255.255.0 inside

More information on configuring telnet on a Cisco Firewall is available here from Cisco:
 http://www.cisco.com/en/US/docs/security/asa/asa81/command/ref/t.html#wp1467794

Once telnet is configured you can test telnet from the PC you are using for FirePlotter. You'll need to connect to the firewall using the Microsoft Windows Telnet client (standard in Windows/2000/XP, but see Installing Telnet in Windows Vista to get this working for Vista) 

To test the telnet connection, open an MS-DOS box type "telnet x.x.x.x" where is the IP address of the interface and press enter. You will then be prompted for login. Enter credentials to login.  You should see a screen that looks like:

User Access Verification 

Password:

Type help or '?' for a list of available commands.

firewall> enable

Password: *********

firewall#

Note: you may need to enter into FirePlotter Enable Username (optional), Enable Password, Telnet Username, Telnet Password - depending upon how your Cisco Firewall is configured. If during Telnet testing you are not prompted for Username then leave the FirePlotter Username field(s) blank.

Note: if you are connecting FirePlotter to a Cisco ASA/PIX firewall via a VPN, you will need to have the "management-access outside" command set, in order for you to access the internal interface telnet IP address from the outside.

Note: if you are using Cisco FWSM (Firewall Service Module) in a Cisco Switch (in this example a Cisco 6513), then here are some tips on how to set-up telnet access. These tips assume you have access to the switch console port and login/enable credentials:

1) Ensure config tells Cisco 6513 switch which vlans to allocate to the fwsm via switch console port using show config :

firewall multiple-vlan-interfaces
firewall module 7 vlan-group 1
firewall vlan-group 1 5,50-52,110,120,130,140,150,210,220,330,340,350


2) Issue commands to get into fwsm console configured as above:

• Cisco IOS software
Router# session slot 7 processor 1
• Catalyst operating system software
Console> (enable) session 7

then login

3) Check/Use commands associated with the fwsm:

firewall transparent
nameif vlan5 outside security0
nameif vlan50 inside security100


as you can see the same as ASA/PIX except using the vlans allocated from the switch

ip address allocated to this context for management or traffic initiated from the context e.g. logs(FWSM calls the Virtual firewalls 'contexts'):

ip address 10.1.1.250 255.255.255.0 standby 10.1.1.2 (there may not be a standby if you only have one fwsm)

4) Setup telnet access to the inside interface (to edit fwsm config use Conf t to edit & CTRL-Z to exit & wr mem to Save):

telnet 10.1.1.0 255.255.255.0 inside

5) Assuming coming from VLAN 50, Telnet to 10.1.1.250 and login!

Note: FirePlotter is a powerful real-time tool that can be used to augment Netflow analysis products.

Setting Up Your FortiNet FortiGate Firewall for FirePlotter

Configuring your FortiNet Firewall to talk to FirePlotter is very easy.

Note: it is a "feature" of FortiNet FortiGate firewalls that only the "admin" user login will provide session table information that FirePlotter needs.

For SSH connections:

To setup the FortiGate for SSH, using the web GUI login to your FortiGate with admin credentials, then go to System, Network and Edit the interface then select the SSH and ping tick boxes and click OK. Make a note of the IP address of the interface.

Once SSH is configured on you FortiGate you can test SSH from the PC your are using for FirePlotter. You will need to connect to the firewall using SSH utility like PuTTY. See http://www.putty.org/

For Telnet connections:

To setup the FortiGate for telnet, using the web GUI login to your FortiGate with admin credentials, then go to System, Network and Edit the interface then select the telnet and ping tick boxes and click OK. Make a note of the IP address of the internal interface.

Note: FirePlotter usually will be used to talk to the the Internal interface of your firewall, but it can be any interface, although if it is internet facing interface you may not want to activate telnet for security reasons. 

Then test you can reach the firewall from this PC by running a ping test. This is done by opening a MS-DOS box on your PC (by clicking Start, Run and entering "cmd" and pressing enter for Windows 2000/XP, or by pressing the Windows Start button and typing "cmd" in the field that says Start Search. in Windows Vista.

Then type ping x.x.x.x where is the IP address of the interface you activated for ping and telnet. If you get a response like:

Reply from 192.168.1.1: bytes=32 time=1ms TTL=255

...then you are ready to test the telnet connection.

If you get:

Request timed out.

...then you need to ensure that the PC you are planning on using for FirePlotter is correctly configured to access the firewall. Check IP address, subnet, and default gateway. Further debugging of this problem is beyond the scope of this document. 

To test the telnet connection from the PC you are using for FirePlotter you must connect to the firewall using the Microsoft Windows Telnet client (standard in Windows/2000/XP, but see Installing Telnet in Windows Vista to get this working for Vista) 

To test the telnet connection, in the same MS-DOS box that you used for the ping test, type "telnet x.x.x.x" where is the IP address of the interface you activated ping and telnet on and press enter. You will then be prompted for login. Enter admin credentials to confirm that they work. You can expect to see something like this:

FG-1000A-GISS-FD login: admin

Password: ********

Welcome ! 

FG-1000A-GISS-FD #

If your login works, then you are now ready to use FirePlotter.

Note: If you would like to set-up a username and password on your FortiGate for a user that can only use FirePlotter, restricting access to that capability only (no configuration changes allowed) then: on a FortiGate running v3.00 MR5 and above you can create an System, Admin, Access Profile with Access Control as "Maintenance" with  "Read-Write" only, and all others set all to "None". Then apply that access profile to a new administrator username and password created in System Admin, Administrators. Then that username and password can be used for FirePlotter only.

FirePlotter.ini

FirePlotter is installed by default in c:\Program Files\FirePlotter. In the install directory you can find the fireplotter.ini file that gives you the opportunity to customise FirePlotter. The fireplotter.ini file can be edited via the Menu Bar option: "File", "Open fireplotter.ini".

By reading the in-file documentation you can see how to set up automatic login by setting the IP, and login details in the [Connection] Section. Also there is the ExternalInterfaces setting to set for FortiGates which interface is outside/internet facing interface (thus determining how FirePlotter shows In-bound & Out-bound sessions.  The Default is ‘wan1, wan2, external and port2’ so if for example your internet side interface is Port1 on your FortiGate, just set ‘ExternalInterfaces=port1’ in [Connection] section. This setting is not required for Cisco Firewalls.

In the [Display] section you can set the default refresh interval and whether name resolution uses Reverse DNS, NetBIOS or Firewall Configuration* (*Cisco only) - for more information on this see DNS or NetBIOS names not resolving?

Also there is the opportunity to customise the text that FirePlotter displays in the Service/Destination Port column by modifying or adding to the [Ports] Section.

In the [Protocols] section there is the opportunity to do the same for the IP Protocol column.

In the [Colours] section there is the possibility to customise FirePlotter to display colours of your choice for the Service/Destination Port. The choice of colours are displayed both in the session list and the graphs.

 Colour choices are to be found here: www.fireplotter.com/doc/FirePlotterColours.htm

Default fireplotter.ini file:

; FirePlotter.ini
; FirePlotter.ini
; Documented for version 1.4

; ***** Please note:
; * Subsequent FirePlotter upgrades may overwrite this INI file so maintain regular backups
; * FirePlotter must be restarted for changes to INI to be used
; * These parameters are only used with a licensed copy of FirePlotter

[Connection]

; Firewall= Firewall type (ASA/PIX, FortiGate). Default ASA/PIX
; IP= Firewall IP address
; Port= TCP port for connection i.e 22 (SSH), 23 (Telnet) or something else. Defaults 22 (ssh)
; Protocol= Protocol for connection i.e. ssh or telnet. Default ssh

; CiscoSSHUsername= Cisco SSH username
; CiscoSSHPassword= Cisco SSH password
; CiscoTelnetUsername= Cisco telnet username
; CiscoTelnetPassword= Cisco telnet password
; CiscoEnableLoginName= Cisco enable login name
; CiscoEnablePassword= Cisco enable password

; FGTLoginName= FortiGate login name
; FGTPassword= FortiGate login password

; SocketTimeout=5 where 2x value is time to waiting for Connect, 1x value is time to wait for authentication, 8x value is time to wait for session block to transfer.  Default 5 seconds.

; Auto-Connect=true True: connect to firewall with ini parameters without waiting for Connect button
; False: need to press Connect button to connect with .ini parameters
; Default false

; BasicViewMode=false False: FirePlotter shows all service/destination ports.
; True: FirePlotter shows those service/destination ports listed in the [Colours] section below
Default true

; ExternalInterfaces=wan1 Sets which interface is “outside, internet facing” on a FortiGate only. Not required for Cisco firewalls
Default ASA/PIX ethernet0, FortiGate WAN1, WAN2 and Port1


;Firewall=ASA/PIX
;IP=
;CiscoSSHUsername=
;CiscoSSHPassword=
;CiscoTelnetUsername=
;CiscoTelnetPassword=
;CiscoEnableLoginName=
;CiscoEnablePassword=
;FGTLoginName=
;FGTPassword=
;Auto-Connect=true


[Display]

; Refresh=5 Screen refresh interval in seconds (1, 5, 10, 15 & 30)

; DNS=6 IP to name lookup (BINARY logic): 1=NetBIOS and Internet reverse DNS, 2=Internet reverse DNS only, 4=firewall configuration (Cisco only)
e.g. dns=6 means 2 (Internet reverse DNS) + 4 (firewall configuration)
;DNS=6

[Ports]

; <port no>=<text> Association of text to destination port numbers

8=Ping Req (8),Ping
20=FTP Data (20),File Transfer (FTP)
21=FTP Cmd (21),File Transfer (FTP)
22=SSH (22)
23=Telnet (23),Telnet
25=SMTP (25),Email (SMTP)
42=WINS (42)
53=DNS (53),Domain Name Service (DNS)
67=DHCP (67)
69=TFTP (69)
80=HTTP (80),Web Browsing (HTTP)
88=Kerberos (88)
110=POP3 (110),Email (POP3)
119=NNTP (119)
123=NTP (123)
135=MS-RPC (135)
137=NB-NS (137)
138=NB-DGM (138)
139=NB-SSN (139)
143=IMAP (143)
161=SNMP (161),Network Management (SNMP)
162=SNMPTrap (162)
397=MPTN (397)
389=LDAP (389)
443=HTTPS (443),Secure Web Browsing (HTTPS)
445=MS-DS (445)
449=ASSrvMap (449)
500=ISAKMP (500)
514=SysLog (514)
554=RTSP (554)
691=ExchRout (691)
740=NETCP (740)
989=FTPS Data (989)
990=FTPS Cmd (990)
995=POP3S (995)
1100=Double-Take (1100)
1433=SQL (1433)
1494=ICA (1494)
1604=ICABrowser (1604)
1723=PPTP (1723)
1800=ANSYS-LM (1800)
1812=RADIUS (1812)
1863=MSNP (1863)
3389=RDP (3389),Remote Desktop (RDP)
4500=IPSec NAT-T (4500)
4899=RAdmin (4899)
5566=IP Phone (5566)
6002=x11 (6002)
8194=Bloomberg (8194)
8888=FDN (8888)


[Protocols]

; <protocol no>=<text> Association of text to IP protocol numbers

MaxProtocolScan=47

1=ICMP (1)
2=IGMP (2)
6=TCP (6)
17=UDP (17)
47=GRE/PPTP (47)
50=ESP (50)
89=OSPF (89)


[Colours]

; <port>,<IP protocol>=<colour name> see www.fireplotter.com/doc/FirePlotterColours.htm
; Coloured protocol list below is used when BasicViewMode=true (default)

0,0=Cyan
8,1=LightSalmon
21,6=Burlywood
25,6=Tomato
53,17=LightSkyBlue
80,6=SpringGreen
110,6=LightPink
443,6=Gold
3389,6=yellowgreen

FirePlotter Licensing

Once FirePlotter is running, to see your current licensing status for FirePlotter, go to the Menu Bar and select "Help", "About FirePlotter" to see a screen similar to the following:

FirePlotter can be downloaded and used right away, without any licensing being applied, in "Watch only" mode with the powerful Summary, Sort, Filter Advanced View Mode, and Zoom features disabled. "Watch only" mode does provide an excellent overview of your firewalls sessions and bandwidth usage in real-time. We do recommend that you request a 14-day license so you can experience FirePlotter with Summary, Sort, Filter and Zoom features enabled.

See Free vs. Licensed Mode Comparison Chart for more information


Concurrent Usage

A purchased License includes a concurrent usage count which limits the total number of copies of FirePlotter allowed to be installed within an organisation.
 
Example: one concurrent licensed copy means only one machine can have FirePlotter installed.

To see the FirePlotter End User License Agreement (EULA) - please click here 


FirePlotter Licensing Classes

FirePlotter Class 1 license for SMB Firewall - 1 Year

With this FirePlotter license (Class 1) a single user can connect FirePlotter to any single Cisco PIX 501, 506E, or ASA 5505 or FortiGate 50 through to 100A models.

FirePlotter Class 2 license for Enterprise Firewall - 1 Year

With this FirePlotter license (includes Class 1 & 2) a single user can connect FirePlotter to any single Class 1 firewall, or any single Cisco PIX 515/515E/520, or ASA 5510/5520 or FortiGate 200 through to 400A models.

FirePlotter Class 3 license for High End Firewall - 1 Year

With this FirePlotter license (includes Class 1,2 & 3) a single user can connect FirePlotter to any single Class  1 & 2 firewall or to any single Cisco PIX 525/525E, 535 or ASA 5530/40/50, FWSM or FortiGate 500 models upwards.

For information on how to view your current FirePlotter licence class - see FirePlotter Licensing

See Buy FirePlotter for pricing.


Troubleshooting

TCP/IP Connection to host <IP address> failed (Check IP address and Telnet enabled) - Error Message?
Username/Password Error - Error Message?
Why are options disabled or greyed out?
DNS or NetBIOS names not resolving?
Why does FirePlotter cause my ASA/PIX firewall to run at 99% CPU utilization?
Why does FirePlotter run slow and put my PC at 99% utilization?
Why does FirePlotter generate queries to outside hosts on UDP port 137?
Suspicious traffic from a device/PC?
Installing Telnet in Windows Vista?
What permanent files does FirePlotter install and use and where are they?
Why can I not see connections "to" my Cisco Firewall e.g. my SSH or VPN sessions?

FirePlotter does not show any inbound stats on my Cisco Firewall?
FirePlotter does not show any data from my FortiGate Firewall?
How do I reset FirePlotter windows size and position?
Does FirePlotter work on an Apple Mac?
FirePlotter Error Messages
FirePlotter Other Messages
Which Cisco ASA/PIX models are supported by FirePlotter?
Which FortiNet FortiGate models are supported by FirePlotter?
Further Help

 

TCP/IP Connection to host <IP address> failed (Check IP address and Telnet enabled) - Error Message

If FirePlotter cannot make a connection to your firewall once the Connect button has been pushed, then this error is displayed:

To test the telnet connection, open an MS-DOS box (Start, Run, and type cmd [Enter]) and in the MS-DOS windows type "telnet x.x.x.x" where is the IP address of the interface you activated ping and telnet on and press enter. You will then be prompted for login. Enter admin credentials to confirm that they work. If you are running Microsoft Vista and do not have telnet installed see Installing Telnet in Windows Vista.

If they do, then you are now ready to use FirePlotter. If not then see  Setting Up Your Cisco ASA/PIX Firewall for FirePlotter or Setting Up Your FortiNet FortiGate Firewall for FirePlotter.

Username/Password Error - Error Message?

If FirePlotter is not provided with correct login credentials for then this error message will be displayed. Check you have typed the correct telnet login (and for Cisco "enable") credentials. Also check Caps Lock is not active on your keyboard! If necessary use telnet to test the login credentials by opening an MS-DOS box (Start, Run, and type cmd [Enter]) and in the MS-DOS windows type "telnet x.x.x.x" where is the IP address of the interface you activated ping and telnet on and press enter. You will then be prompted for login. Enter admin credentials to confirm that they work. If you are running Microsoft Vista and do not have telnet installed see Installing Telnet in Windows Vista.

Why are options disabled or greyed out?

If you do not have a license for FirePlotter then it defaults to Free Mode (Watch Only) which only enables real-time monitoring and disables (amongst other features) the ability to Zoom into session details.

If you haven't already, you can request your FREE 14-day FirePlotter License here: Request 14-Day License to evaluate fully functional FirePlotter.

So, for example, the Zoom feature in "Licensed" or "Evaluation" mode means you can drill down into a "..." entry in a session table entry to get more information about which IP addresses are creating sessions.

Other features such as Summary Options, Default View, Refresh now, Refresh Interval, Pause, Play, FirePlotter.ini settings, Right Mouse Click and other capabilities are all enabled in "Licensed" or "Evaluation" mode.

See Free vs. Licensed Mode Comparison Chart or FirePlotter Licensing for more information.

DNS or NetBIOS names not resolving?

Wherever possible FirePlotter will resolve IP addresses to Fully Qualified Domain Names (FQDNs) or NetBIOS Names. When an IP address is displayed in brackets e.g. (192.168.1.1) - this indicates that FirePlotter is still attempting to resolve a name to the IP address.

Check your fireplotter.ini file settings:

[Display]

; DNS=6 IP to name lookup (BINARY logic): where 1=NetBIOS and Internet reverse DNS, 2=Internet reverse DNS only, 4=firewall configuration (Cisco only)
e.g. dns=6 means 2 (Internet reverse DNS) + 4 (firewall configuration)

DNS:

Ensure DNS Server are configured and reachable by your FirePlotter PC. In MS-DOS box type "ipconfig /all". Check DNS Servers are set - if not, configure via Network Settings. If set, check DNS Server addresses are ping-able.

NetBIOS:

You can test an individual PC NetBIOS name lookup by using in MS-DOS window the “nbtstat –a x.x.x.x” command on the FirePlotter PC where x.x.x.x is the IP address of the PC you want a name for. Sometimes PCs with firewalls, or multiple IP addresses do not respond to the query.

You could edit your host file on the FirePlotter PC (C:\Windows\System32\drivers\etc\Hosts) to resolve IP addresses to a names you want to set, or you can configure your DNS server to set the names.

Note: When NetBIOS name resolution is turned on, FirePlotter attempts to resolve *ALL* IP addresses this way. This means that
NetBIOS (UDP/137) lookups are sent to IP addresses outside of your firewall. We would recommend a firewall policy rule that blocks/denies UDP Port 137 from your internal network to the internet, to prevent these packets going out to the internet.

Why does FirePlotter cause my ASA/PIX firewall to run at 99% CPU utilization?

If you are running ASA/PIX version 7 then you will need to upgrade to version 7.23 to avoid this problem. There is a bug in ASA/PIX version 7.22 that causes the firewall to run to 99% CPU utilization when a telnet (or SSH) session requests large quantities of data (which it does frequently). More >>

Why does FirePlotter run slow and put my PC at 99% utilization?

A limitation of the current FirePlotter design results in slow performance if the session count exceeds 2000 concurrent sessions. New algorithms planned are expected to increase this performance substantially.

Why does FirePlotter generate queries to outside hosts on UDP port 137?

FirePlotter performs a rDNS and NetBIOS (UDP/137) lookup of the IP addresses, some of which will be to outside hosts. If the IP addresses are resolvable (nameable) then they are displayed alongside the individual IP address in the Source IP and Destination IP columns of the Session Table. See Session Table Section for more information.

Note: When NetBIOS name resolution is turned on, FirePlotter attempts to resolve ALL IP addresses this way. This means that NetBIOS (UDP/137) lookups are sent to IP addresses outside of your firewall. We would recommend a firewall policy rule that blocks/denies UDP Port 137 from your internal network to the internet.

Suspicious traffic from a device/PC?

On the PC with the suspicious application, use "netstat -o -a" to find the process ID of the application generating the traffic (check source port), and then use Task Manager to find that Process ID (In Task Manager go to View, select Columns to ensure PID is selected and so displayed).

Installing Telnet in Windows Vista?

To install telnet in Windows Vista go to Start, Control Panel, Programs, Program and Features, Turn Windows features on or off (left side of screen), tick Telnet Client and then press OK.

What permanent files does FirePlotter install and use and where are they?

All the following FirePlotter files (permanent and temporary) will be created in the FirePlotter programme directory (e.g. c:\Program Files\FirePlotter) when running WindowsXP/2000.

In Windows Vista the permanent files are installed in c:\Program Files\FirePlotter, whilst the temporary files are in c:\Users\[username]\AppData\Local\VirtualStore\Program Files\FirePlotter

These files are installed in the during installation:

FirePlotter.exe [Main application]
FirePlotter.ini [Configuration parameters]
License.rtf [End User license agreement]
FirePlotter.lnk [Windows shortcut to FirePlotter website home page]
FirePlotterBuy.lnk [Windows shortcut to FirePlotter website product purchase page]
FirePlotterOnlineHelp.lnk [Windows shortcut to FirePlotter website online help page]

FirePlotter license, if purchased is placed in Programme Directory:
 
fireplotter.lic [FirePlotter license file]

Log files are created and updated each time FirePlotter is run:

FPlog.txt Records FirePlotter initialisation and operational information

Temporary files created as part of FirePlotter's normal operation for Cisco and FortiGate firewalls. The FirePlotter Process ID is used in the file name to allow multiple concurrent copies of FilePlotter to be running on the same machine if the necessary "Concurrent" license has been purchased.
Cisco:
<ProcessID>PIXVersion.txt System information i.e. Model, serial number etc
<ProcessID>PIXConfig.txt Configuration information
<ProcessID>PIXConnection.txt Session/Connection table
FortiGate:
<ProcessID>UnitSystem.txt System information i.e. Model, serial number etc
<ProcessID>UnitInterface.txt Interface list i.e. what network connections the firewall has
<ProcessID>UnitTTL.txt Non default Time-To-Live values
<ProcessID>UnitSession.txt Session/Connection table

Why can I not see connections "to" my Cisco Firewall e.g. my SSH or VPN sessions?

Cisco does not provide session data about sessions directly connected to Cisco ASA/PIX interfaces. This includes protocols such as: Telnet, SSH, SNMP, ping, IPSEC VPN, ISAKMP, NAT-T and HTTPS. Note that FirePlotter will display the traffic that passes *through* the VPN.

FirePlotter does not show any inbound stats on my Cisco Firewall?

When FirePlotter gets session data from a Cisco firewall, the displayed statistics are related to the "direction of initiation". So a session that is outbound initiated (inside to out), for example, a session visiting a website, and that session then downloads a file using HTTP, that session download will then be displayed in FirePlotter as outbound HTTP byte counts. The data is displayed in this way as this is how Cisco chooses to provide it. So it follows then that inbound stats will only show if sessions have been initiated from the outside in.

FirePlotter does not show any data from my FortiGate Firewall?

If FirePlotter has successfully connected and authenticated to a FortiGate firewall, sometimes the credentials that have been used to login do not have sufficient rights to access the session data needed for FirePlotter to work. Note that the default admin account always does have sufficient rights for FirePlotter to operate correctly.

If you would like to set-up a username and password on your FortiGate for a user that can only use FirePlotter, restricting access to that capability only (no configuration changes allowed) then:

1) On a FortiGate running v3.00 MR5 and above you can create an System, Admin, Access Profile with Access Control as "Maintenance" with  "Read-Write" only, and all others set all to "None".
 
2) Then apply that access profile to a new administrator username and password created in System Admin, Administrators.

3) Then that username and password can be used for FirePlotter only.

How do I reset FirePlotter windows size and position?

If run into windows resize problem then using regedit.exe delete:

 HKEY_CURRENT_USER\Software\GISS-UK.com\FirePlotter\FP-WindowPosition.

Does FirePlotter work on an Apple Mac?

Yes - FirePlotter will work on an iMac running Parallels with Microsoft Vista and XP

 

FirePlotter Error Messages (Help Codes)

Help Code: 0x1011 - Establishment of Connection Error

This error occurs if FirePlotter cannot connect to the firewall or if too many login attempt failures (incorrect credentials) have caused the firewall to refuse connections.

Check you can ping the firewall and that a telnet/SSH connection is available. See Setting Up Your Cisco ASA/PIX Firewall for FirePlotter or Setting Up Your FortiNet FortiGate Firewall for FirePlotter for further help.


Help Code: 0x1021 - FortiGate Telnet Authentication Failure Error

This error occurs if FirePlotter fails to authenticate to a FortiGate Firewall.

Check you are using/typing the correct login credentials. See Setting Up Your FortiNet FortiGate Firewall for FirePlotter for further help.


Help Code: 0x1022 - FortiGate Connection Lost Error

This error occurs if FirePlotter loses connection with a FortiGate firewall it has already successfully connected to.

A documented parameter in FirePlotter.ini file may fix timeout problems on a poor quality connection. The default timeout is 5 seconds. This can be adjusted by adding “SocketTimeout=<timeout>” to the [Connection] section of FirePlotter.ini.

Help Code: 0x1031 - Cisco Connection Lost Error

This error occurs if FirePlotter loses connection with a Cisco firewall it has already successfully connected to.

An undocumented parameter in FirepLotter.ini file may fix timeout problems on a poor quality connection. The default timeout is 200 hundredths of a seconds (2 seconds). This can be adjusted by adding “SocketTimeout=<timeout>” to the [Connection] section of FirePlotter.ini.


Help Code: 0x1032 - Cisco Telnet Authentication Failure Error

This error occurs if FirePlotter fails to authenticate to a Cisco Firewall.
 
Check you are using/typing the correct login credentials. See Setting Up Your Cisco ASA/PIX Firewall for FirePlotter for further help.


Help Code: 0x1033 - Cisco Enable Authentication Failure Error

This error occurs if FirePlotter fails to switch to 'enable' mode on a Cisco Firewall.
 
Check you are using/typing the correct 'enable' credentials. See Setting Up Your Cisco ASA/PIX Firewall for FirePlotter for further help.

Help Code: 0x1035 - SSH Authentication Failure Error

This error occurs if FirePlotter fails to authenticate to a Firewall.

Check you are using/typing the correct login credentials. See Setting Up SSH on Your Firewall for FirePlotter for further help.

Help Code: 0x1036 - Critical file is missing - program aborted

This error occurs if a critical file is missing from the installation.

Please re-install FirePlotter remembering to backup your FirePlotter.ini if any user modifications have been made.

FirePlotter Other Messages

This version of FirePlotter.EXE has intentionally expired. Please download the latest version from www.fireplotter.com

Each version of the Fireplotter.EXE program is timed to expire 1 year from the date it was created. This way we can ensure users always have the best version of FirePlotter available. If you see this message this does not affect your annual FirePlotter licensing. All you need to is download and install the latest version of FirePlotter from our website. 

Which Cisco ASA/PIX models are supported by FirePlotter?

The following Cisco ASA/PIX models are supported:

PIX-501
PIX-506
PIX-506E
PIX-510
PIX-515
PIX-515E
PIX-520
PIX-525
PIX-535
ASA-5505
ASA-5510
ASA-5520
ASA-5530
ASA-5540
ASA-5560
FWSM Firewall Version 3.1(7)
FWSM Firewall Version 3.1(8)

Which FortiNet FortiGate models are supported by FirePlotter?

The following FortiNet FortiGate models are supported:

FG-30B/FortiGate-30B
FG-50A/FortiGate-50A
FG-50B/FortiGate-50B
FW-50B/FortiWiFi-50B
FG-60/FortiGate-60
FG-60B/FortiGate-60B
FW-60/FortiWifi-60
FW-60A/FortiWiFi-60A
FW-60AM/FortiWiFi-60A
FW-60B/FortiWiFi-60B
FG-100/FortiGate-100
FG-100A/FortiGate-100
FG-100C/FortiGate-100C
FG-200/FortiGate-200
FG-200A/FortiGate-200A
FG-200A-HD/FortiGate-200A-HD
FG-224B/FortiGate-224B
FG-300/FortiGate-300
FG-300A/FortiGate-300A
FG-300A-HD/FortiGate-300A-HD
FG-310B/FortiGate-310B
FG-400/FortiGate-400
FG-400A/FortiGate-400A
FG-400A-HD/FortiGate-400A-HD
FG-500A/FortiGate-500A
FG-500A-HD/FortiGate-500A-HD
FG-620/FortiGate-620
FG-800/FortiGate-800
FG-800F/FortiGate-800F
FG-1000/FortiGate-1000
FG-1000A/FortiGate-1000A
FG-1000A-LENC/FortiGate-1000A-LENC
FG-1000AFA2/FortiGate-1000AFA2
FG-3000/FortiGate-3000
FG-3016B/FortiGate-3016B
FG-3600/FortiGate-3600
FG-3600LX2/FortiGate-3600LX2
FG-3600LX4/FortiGate-3600LX4
FG-3600A/FortiGate-3600A
FG-3810A-E4/FortiGate-3810A-E4
FG-5001/FortiGate-5001
FG-5001FA2/FortiGate-5001FA2
FG-5002FA2/FortiGate-5002FA2
FG-5002FBb2/FortiGate-5002FB2
FG-5005FA2/FortiGate-5005FA2

Further Help

If you have a support question that has not been answered by this document then please email us with the Subject header starting with SUPPORT:

To assist in resolving any technical issues, please include the following information in your email*: 

1) A description of the problem, if possible including screenshot of problem.

2) The PC Operating System (Vista, XP, 2003, W2K etc) you are running?

3) Make, Model and Firmware/OS Version of firewall?

4) The version of FirePlotter you are running? (in Help, About)

5) Are your using SSH or Telnet?

6) Is FirePlotter local to the firewall or being used over a remote link/VPN?

7) Detailed logging data for the problem. Please edit your C:\Program Files\FirePlotter\FirePlotter.ini file, and in the [Connections] section add the line "LogLevel=255" and save the file.

Then re-create the problem, press Pause between a refresh cycles and then please attach to your email to us a (zipped) copy of all the *.txt files in the c:\Program Files\FirePlotter or c:\Users\[username]\AppData\Local\VirtualStore\Program Files\FirePlotter (Vista)*.

Please note LogLevel=255 significantly reduces FirePlotter performance, so we recommend the line is removed once the technical issue is resolved.

8) What is a typical number of sessions that pass through the firewall?

 *Any confidential information (e.g. IP addresses) use Search & Replace to change to X.

If you have an upgrade question that has not been answered by this document then please email us with the Subject header starting with UPGRADE:

If you have an enhancement request that is not been identified in our FirePlotter Roadmap, then please email us with the Subject header starting with ROADMAP: If you want to recommend a number of enhancements you would like to see - then please prioritise your list so we will know which is most important to you.

 

© 2000-2007 GISS (UK) Ltd