NeDi Help

Topology Map

## Introduction

This module was intended for documentation purposes, even though it features interactive handling now. Refreshing every 10 minutes it can also be used to observe traffic, errors, broadcasts, discards, cpu usage or temperature of devices.

It requires the php-gd extension and “proper” SNMP location formatting on your devices as described on the NeDi homepage (you can still draw flat maps, if that's not the case).

Maps are written on a per user basis to html/log (make sure it's writable by the webserver). Upon accessing this module an existing map will be displayed (no interactive features), without any adjustment of the input form.

Graphs are only drawn in PNG and only for the 1st time the map is generated, because they'll be deleted afterwards. This may be a problem, if you wish to save the picture (screenshot always works, though). Alternatively SVG or even interactive json maps (devices in flat map type only) can be created. The node you click on moves to the center and the whole map adjusts itself around it. The source of the map can be used in other applications as well.

## Usage

- Geo type relies on information and maps you've edited with Loced (not google maps).
- PNG generates truecolor, 8bit 256 color images respectively, which can be included in the combination report.
- SVG is used for vector drawings, which can be imported by other applications. You probably want to use "shapes" instead of "icons" then...
- Hover over the input fields and icons to get hints.
- If you enable dynamic-edit (far right walk-icon above "Execute"), the map will be redrawn with any input and fields are disabled if they're of no use with the current settings. This works best if the browser supports HTML5 properly.
- Google Map support will be considered at a later stage...

## Details

The map is drawn based on your snmp location strings and those parameters:

- Image Size and depth of the canvas
- General Map location, rotation and level to be drawn
- Layout
  - Link: Type of links and distance of info-labels to the link-ends
  - Point: Points are arranged in a circle (e.g. cities in the repsective regional circle). The more links such a point has, the heavier (W) it gets and the greater the pull towards the center of the circle. (L) Defines length of the links at regional level and (F) the factor as the map drawing descends into city respectively building level.
  - Floor: Padding (P) sets the size and (C) the number of columns of building boxes on device level maps. @ Let's you rotate building circles to fine-tune the map.
- Info Interface, IP Addresses or Location information are enabled for display
- Filter Use regexps to filter on location, device types (e.g. to draw core networks), vlans or networks (ip/mask)
- Draw Choose between PNG (required for RRDs on the links) or SVG (vector drawing)

A geo map will try to find the best suited background image automatically. E.g. the regional one, if you're only drawing one region and you've copied a map-\.png into html/log.

Assuming you've edited this region with Loced before, it'll now use the city coordinates, you've entered to locate the city icons with the region. If you draw at building level, they'll simply be arranged around the city coordinates using circle mode and above parameters.