Differences

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

--- subnetsandvlans [2007/06/08 08:26] – markup syntax cleanup morten
+++ subnetsandvlans [2011/04/08 13:58] (current) – [Syntax] faltin
@@ Line 1: / Line 1: @@
-====== Vlan attributes ======
+====== Network descriptions ======
+This document discusses natural attributes that describe a subnet (or vlan) and introduces [[subnetsandvlans#guide_lines_for_configuring_router_interface_descriptions|NAV's guidelines]] for router interface descriptions.
+===== Vlan attributes =====
 The NAV database models subnets and vlans as they are set up in the production network. A vlan defines a broadcast domain that may consist of zero, one or more IP subnets, one being the most "normal" case. zero subnets means that this is a private network (i.e. a sunray vlan). By using secondary IP addresses (Cisco terminology) it is also possible to have more than one IP subnet running on the same broadcast domain (vlan). Since vlan is the common denominator we will refer to vlans, not subnets, in the following.
@@ Line 13: / Line 17: @@
 ^ Further description  | Any further comments you may want to use to describe the vlan.  |
-Please note that the vlan information is **not** compulsory in NAV. There are a number of advantages to having this information, however, the most vital components of NAV will operate fine without.
+Please note that the vlan information is **not** compulsory in NAV. There are a number of advantages of having this information, however, the most vital components of NAV will operate fine without.
-There are two subsystems in NAV that can fill in vlan information: the background process getDeviceData and the tool editDatabase. getDeviceData will attempt as far as possible to automatically fill in this information. This is easily achieved if you are using the NAV guidelines for configuring router interface descriptions (again - not a requirement - anyway - more below).
+There are two subsystems in NAV that can fill in vlan information: the background process [[backendprocesses#ipdevpoll|ipdevpoll]] and the [[seedessentials|tool seedDatabase]]. ipdevpoll will attempt as far as possible to automatically fill in this information. This is easily achieved if you are using the NAV guidelines for configuring router interface descriptions (again - not a requirement - anyway - more below).
-editDatabase lets you complete missing information after getDeviceData has done its job.
+:!: [[seedessentials#vlan|the Edit Vlan component of SeedDatabase]] lets you complete missing information after ipdevpoll has done its job. To be precise you can manually edit the organization, usage and vlan values.
-====== Network types ======
+===== Network types =====
 As mentioned, a network type seeks to give information on the topology of the vlan in question. This is useful for informational purposes, but it is also used directly in the traffic map tool. On the top level the
@@ Line 45: / Line 49: @@
-====== Guide lines for configuring router interface descriptions ======
+===== Guide lines for configuring router interface descriptions =====
-NAV has defined guide lines for configuring router interface descriptions (use the description-command in interface config mode on a cisco router). You may follow these guide lines if you like, getDeviceData will then take advantage of this and have an easy task filling in vlan attributes.
+NAV has defined guide lines for configuring router interface descriptions (use the description-command in interface config mode on a cisco router). You may follow these guide lines if you like, ipdevpoll will then take advantage of this and have an easy task filling in vlan attributes.
-The description setting also serves as a sensible documentation in the configs of your running routers.
+The description setting also serves as a sensible documentation in the configurations of your running routers.
-===== Syntax =====
+==== Syntax ====
   * The guide line defines up to 5 elements.
@@ Line 77: / Line 81: @@
 ^ $comment   | Any further (unstructured) description you may want to add (btw: also a way of distinguishing two math-staff-subnets from one another).                              |
 ^ $vlan      | The vlan number for this broadcast domain. Please note: This information may be derived from the interface name itself, if this is a virtual interface or it may be derived from the connected switch, using CDP. It may also be added (or changed) in editDatabase.                                    |
-^ $to_router | The router that this routerinterface is connected to. Please note: This information is easily derived automatically by getDeviceData and is thus superficial.             |
+^ $to_router | The router that this router interface is connected to. Please note: This information is easily derived automatically by ipdevpoll and is thus superficial.             |
 ^ $to_org    | The organizational unit that this external link is peering with.                      |