User Tools

Site Tools


netmap

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
netmap [2012/09/17 13:04]
norangshol [Netmap - the network weather map]
netmap [2012/09/18 12:09]
bredal [Left navigation bar]
Line 4: Line 4:
  
 Netmap is based on the [[http://​d3js.org|D3JS]] library, and uses its [[https://​github.com/​mbostock/​d3/​wiki/​Force-Layout|ForceBasedLayout-engine]] for finding the optimal graphical layout for the network topology. Netmap should work in all new common browsers that support SVG (IE9 and newer), Firefox (3.5 (really recommend a newer version, as the firefox javascript engine is having performance issues) and up), Chrome (auto updates, testing with Chromium in Debian Squeeze at least). Opera has some issues that we will look into later.  ​ Netmap is based on the [[http://​d3js.org|D3JS]] library, and uses its [[https://​github.com/​mbostock/​d3/​wiki/​Force-Layout|ForceBasedLayout-engine]] for finding the optimal graphical layout for the network topology. Netmap should work in all new common browsers that support SVG (IE9 and newer), Firefox (3.5 (really recommend a newer version, as the firefox javascript engine is having performance issues) and up), Chrome (auto updates, testing with Chromium in Debian Squeeze at least). Opera has some issues that we will look into later.  ​
 +
 +===== Features =====
 +
  
 Netmap has these features (in no particular order): Netmap has these features (in no particular order):
Line 37: Line 40:
 ===== Brief user guide===== ===== Brief user guide=====
  
-The netmap is available from the toolbox. Clicking it will redirect you to the javascript netmap application. +The netmap is available from the toolbox.
- +
-The page starts with loading the javascript application (big loading spinner, keeps spinning until it has loaded its required resources. This will go for the next times you visit netmap, as the resources will then be cached in your browser.). +
-The spinner will decrease in size when the javascript application is loaded and it starts "​running the application"​ and continue to load the network topology information.  +
- +
-The first thing you'll see is that the navigation menu on the left side is loaded, and soon after the network topology graph pops up. Depending on your loading a view with fixed nodes or not, the layout algorithm will do it's work and position nodes as good as making the nodes not collide.  +
- +
-Your presented with two navigation bars, one on each side of your screen that you can toggle by clicking the "<<"​ or ">>"​ links. You can toggle fullscreen with CTRL+SHIFT+F which toggles both sidebars and NAV's footer and header.  +
-In the center your presented with the network topology map it self.  +
- +
-The load colors on edges represent load based on the link's capacity, and the link's weight represents a few static categories of link speeds. (0-100, 100-512,​512-2048,​2048-4096,>​4096 Mbit/s) +
-Using the traffic gradient popup can help you tell the load % without having to click on a link to read it's traffic data+
  
 +Netmap consists of two navigation bars, one on each side of the screen, and the map itself. The navigation bars can be toggled by clicking the "<<"​ or ">>"​ links. ​ You can toggle fullscreen with CTRL+SHIFT+F.
  
 +The load colors((Click "Show gradient"​ to get an overview of what the colors indicate)) on edges represent traffic load based on the link's capacity, and the link's thickness represents the link speed. ​
 ==== Map ==== ==== Map ====
  
-Nodes and be drag and dropped and positioned to your liking. ​When view is saved, it will save current ​zoom/scale, position of the map, active network topology layer, categories (orphan filter) as meta data to it's view. +  * Nodes can be positioned to your liking ​by clicking and dragging it. 
-Nodes get fixed and auto selected automagically after a drag and drop. In the netbox view you have an option to easily uncheck it again if you want to+  * To view information about node or a linkjust click on it
 +  * You may zoom the map by using the scroll-wheel on your mouse.
  
  
 ==== Left navigation bar ==== ==== Left navigation bar ====
  
-Starting on the left navigation bar, your presented with a:+The left navigation bar has options for filtering and controlling the behaviour of the map.
  
 +=== Searchbox ===
  
 +This searches for the name of a netbox and centers the map on it. If the search hits several netboxes the map will center on the first.
  
-=== Searchbox ​===+=== Zoom to extent ​===
  
-Type in part of the sysname of the box your looking for, it run loop thru it dataset and stop on the first match it hits and fetch it's graph position and translate the node to be centered in the graph. At the moment the search is quite simple, but in the _future_ it will have support for finding the bounding box for all matches and translate the bounding box to it's view port and set correct zoom level. ​Zoom to extent will try it's best to position ​the bounding box for the whole graph in the center of the view port and scale out so you can see it. A tip is to just click it a few times so it gets it right ;-) (or wait for the layout algorithm to finish) ​+Zoom to extent will try to position the whole graph in the center of the view port and scale out so you can see it.
  
 === Layer box === === Layer box ===
  
-Radio button to toggle which network topology view you want to view, either ​layer 2 or layer 3.  +Toggle if you want to see layer 2 or layer 3 topology (([[http://​en.wikipedia.org/​wiki/​OSI_model|OSI model]])).
-Shouldn'​t require any further explanation,​ if you need .. look into the [[http://​en.wikipedia.org/​wiki/​OSI_model|OSI model]]. ​+
  
 === Categories === === Categories ===
  
-You can run filters on the loaded network topology graph, pr. default the GSW,​GW,​SW,​OTHER,​WLAN,​SRV,​ and EDGE categories ​are selected on by default. Here you can deactivate active filters, and nodes of the deactivated filters will disappear. You can toggle this filters back and forth without having to reload the network topology graph, it will only '​bounce'​ the layout algorithm ​to make sure the nodes aren't colliding+Choose what categories ​of netboxes ​you want to see.
  
-== Filter options ​, orphans ​==+=== Filter options ​===
  
-As you play around with filters, or NAV '​topology analyzer'​ ([[http://​nav.uninett.no/​backendprocesses#​ipdevpoll|ipdevpoll]] / [[http://​nav.uninett.no/​backendprocesses#​topology|topology]]) there is certain ​to render single instance ​nodes which is nodes who has no relations ​to any other nodes in the current state of active filters.  ​Here you have the option to disable or enable em.  +  * **Filter orphans**Uncheck this to hide nodes with no links to other nodes. 
- +  * **Mark by position**: Mark nodes that are located in the same room or location. This is shown by drawing a red circle around the nodes who are related to the selected node. 
-=== Mark by position ​=== +  * **Pause force algorithm**: Pause the layout algorithm by clicking the button. A green icon indicates active algorithm, a red an inactive ​algorithm. ​Resume ​it by drag and dropping a node, unfix a node, unfix all nodes or clicking the button again. 
- +  * **Fix or unfix all nodes**: Set all nodes to fixed or unfixed. Fixed nodes will not move when running the algoritm.
-Option to mark other related ​nodes that are either ​located in the same room or location. This is shown by drawing a red circle around the nodes who are related to the selected node.  +
- +
-=== Pause force algorithm ​=== +
- +
-If your on either running a old version of Firefox (known to have poor javascript performance in our experience) or equipped with a «bad computer from the past»you have option to pause the layout ​algorithm ​here +
- +
-You can resume ​it by drag and dropping a node, unfix a node, unfix all nodes etc+
  
 === UI options === === UI options ===
  
-  * Show topology errors, option to render network topology errors like a link between two netboxes who doesn'​t run on the same interface speed which might cause network congestion etc +  ​* **Show topology errors**: for instance mark links with differing speed set on the netbox inerfaces 
- +  * **Mouseover options**: Enable or disable auto selection ​when hovering a link or node. This can also be toggled with the keyboard shortcuts «n» or «l» (lowercase of L). 
-== Mouseover options ​== +
- +
-Enable or disable auto clicking of a node when simply ​hovering a link or node. This can also be toggled with the keyboard shortcuts «n» or «l» (lowercase of L). +
  
 === Traffic gradient === === Traffic gradient ===
  
-A button to open the traffic load scale used in netmap in a popup. ​ +Open the traffic load scale used in netmap in a popup. ​
- +
 ==== Right navigation bar ==== ==== Right navigation bar ====
  
netmap.txt · Last modified: 2012/09/18 12:56 by bredal