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 12:58]
norangshol [Brief user guide]
netmap [2012/09/18 11:08]
bredal [Netmap - the network weather map]
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 12: Line 15:
    * Filtering of netboxes based on categories. These categories are set from the categories you have in the database. ​    * Filtering of netboxes based on categories. These categories are set from the categories you have in the database. ​
    * Filtering orphans (netboxes not linking to anything) ​    * Filtering orphans (netboxes not linking to anything) ​
-   ​* ​* Note: elink is a fictive category, and Netmap itself detects where the elink should be based on NAV's known topology.  +     * Note: elink is a fictive category, and Netmap itself detects where the elink should be based on NAV's known topology.  
-   * * Note2: can't save metadata / positions of elink nodes, since there is no relation to them as it is a fictive node. +     ​* Note2: can't save metadata / positions of elink nodes, since there is no relation to them as it is a fictive node. 
    * Searching. One can search after netboxes based on sysname    * Searching. One can search after netboxes based on sysname
    * Option to pause the layout engine to preserve cpu-load. This should not be needed as the layout engine should stabilize the graph rather quickly in a newer browser and modern PC. In case your living in the past, there'​s an option to pause it ;-)    * Option to pause the layout engine to preserve cpu-load. This should not be needed as the layout engine should stabilize the graph rather quickly in a newer browser and modern PC. In case your living in the past, there'​s an option to pause it ;-)
Line 21: Line 24:
    * Fix or unfix all node positions. (this is position metadata that is saved to a view)    * Fix or unfix all node positions. (this is position metadata that is saved to a view)
    * Views    * Views
-   ​* ​* User specific views and possibility to share em among other users +     * User specific views and possibility to share em among other users 
-   * * Delete your own views +     ​* Delete your own views 
-   * * Update current view +     ​* Update current view 
-   * * Create new view from selected view (incase you want a modify a view that isn't yours) +     ​* Create new view from selected view (incase you want a modify a view that isn't yours) 
-   * * Select a favorite view +     ​* Select a favorite view 
-   * * Administrator can set a global favorite view for users who does not have an favorite view selected.+     ​* Administrator can set a global favorite view for users who does not have an favorite view selected.
    * Different info templates for selected netbox or selected link.     * Different info templates for selected netbox or selected link. 
    * Traffic gradient popup (will be nice when RRD/traffic load is refreshed every x min.     * Traffic gradient popup (will be nice when RRD/traffic load is refreshed every x min. 
Line 34: Line 37:
 NOTE: Icons for the following categories are included GSW, GW, OTHER, SRV, SW, WLAN, EDGE and the fictive category ELINK. If you have other categories, put an icon with the category name in  NOTE: Icons for the following categories are included GSW, GW, OTHER, SRV, SW, WLAN, EDGE and the fictive category ELINK. If you have other categories, put an icon with the category name in 
 $NAV_ROOT/​share/​htdocs/​images/​netmap/​ in the png format. Note: use lower case filename of the category name.  $NAV_ROOT/​share/​htdocs/​images/​netmap/​ in the png format. Note: use lower case filename of the category name. 
- 
  
 ===== Brief user guide===== ===== Brief user guide=====
Line 93: Line 95:
 === 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, 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
  
 == Mouseover options == == Mouseover options ==
Line 155: Line 157:
 ===== Troubleshooting ===== ===== Troubleshooting =====
 1. Rendering is horrible slow 1. Rendering is horrible slow
-This kind of problem can be two things (or both). ​Either cpu-bound problems, ​or gpu-bound problemsThe CPU-part is hard to combat except with filtering out more devices. The GPU-bound problems can cause massive cpu-load also though (fallback to software-rendering). For these kind of problems try various combinations of http://​java.sun.com/​j2se/​1.5.0/​docs/​guide/​2d/​flags.html in the java-plugin control-panel (under Runtime-settings).+This kind of problem can be two things (or both). ​Using an old outdated browser with poor javascript performance ​or having a old computer(the layout algorithm is quite CPU intensive). 
 +Chrome ​is known to have the best javascript engine, so we recommend the use of chrome webbrowser
  
  
netmap.txt · Last modified: 2012/09/18 12:56 by bredal