User Tools

Site Tools


devel:database

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
devel:database [2009/09/17 13:24]
morten
devel:database [2012/05/07 11:22] (current)
morten fix url
Line 61: Line 61:
 ip              IP address of the netbox ip              IP address of the netbox
 roomid ​         room the box is placed in roomid ​         room the box is placed in
 +deviceid ​       the device this is (foreign key to device)
 typeid ​         sysobjectid of the box typeid ​         sysobjectid of the box
 sysname ​        name of the box, based on fully qualified dns name with fall back to IP address. sysname ​        name of the box, based on fully qualified dns name with fall back to IP address.
Line 75: Line 76:
 upsince ​        the timestamp when the box was last booted. Data is taken from mibII system.uptime upsince ​        the timestamp when the box was last booted. Data is taken from mibII system.uptime
 uptodate ​       whether gDD has done OID classification uptodate ​       whether gDD has done OID classification
 +discovered ​     timestamp when the box was first discovered by NAV
 </​code>​ </​code>​
  
Line 100: Line 102:
 <​code>​ <​code>​
 deviceid ​       primary key deviceid ​       primary key
-productid ​      ​product the device is of (if this info is maintained) 
 serial ​         serial number serial ​         serial number
 hw_ver ​         hardware version hw_ver ​         hardware version
 fw_ver ​         firmware version fw_ver ​         firmware version
 sw_ver ​         software version sw_ver ​         software version
-auto            whether this device is discovered automatically by gDD or not+auto            whether this device is discovered automatically by ipdevpoll ​or not
 discovered ​     when the device was first discovered by NAV. discovered ​     when the device was first discovered by NAV.
 active ​         whether the device should be in operation (not just ordered) active ​         whether the device should be in operation (not just ordered)
-deviceorderid ​  the order (if any) the device is part of 
 </​code>​ </​code>​
  
Line 126: Line 126:
 up              whether the module is up and running (as detected by moduleMon. modeleMon is a plugin to gDD) up              whether the module is up and running (as detected by moduleMon. modeleMon is a plugin to gDD)
 downsince ​      since when the module has been down downsince ​      since when the module has been down
 +name            Modules aren't necessarily identified using integers (as in module.module),​ so we add names in v3.6
 </​code>​ </​code>​
  
Line 175: Line 176:
 parent ​         parent organization,​ if any parent ​         parent organization,​ if any
 descr           ​further description descr           ​further description
 +contact ​        ​contact info
 opt1            additional info opt1            additional info
 opt2            " opt2            "
Line 228: Line 230:
 tftp            whether the type supports tftp storage tftp            whether the type supports tftp storage
 </​code>​ </​code>​
 +
 +==== vendor ====
 +
 +The vendor table defines vendors. A type is of a vendor. ​
 +
 +<​code>​
 +vendorid ​       table identifier, also the name of the vendor.
 +</​code>​
 +
  
 ===== The OID database ===== ===== The OID database =====
  
 This [[http://​domen.uninett.no/​~faltin/​nav/​navdb/​netbox_related.png|diagram]] shows OID database (and more). This [[http://​domen.uninett.no/​~faltin/​nav/​navdb/​netbox_related.png|diagram]] shows OID database (and more).
 +
 +The role of the OID database has changed with NAV 3.6. ipdevpoll (that replaces getDeviceData) does not depend
 +on the OID database. Cricket still does and getBoksMacs still uses the oid database to figure out device
 +capabilities. ​
  
 ==== snmpoid ==== ==== snmpoid ====
Line 310: Line 325:
 netboxid ​        the netbox the rrd file has statistics for netboxid ​        the netbox the rrd file has statistics for
 key              if relevant, which part of the netbox the rrd file has statistics for, i.e.  key              if relevant, which part of the netbox the rrd file has statistics for, i.e. 
-                 which table; service / swport or gwport +                 which table; service / interface 
-value            i.e. which serviceid / swportid / gwportid+value            i.e. which serviceid / interfaceid
 </​code>​ </​code>​
  
Line 323: Line 338:
 rrd_fileid ​      the rrd file the data source is within rrd_fileid ​      the rrd file the data source is within
 name             name of the source (ds0,​ds1,​RESPONSE TIME etc) name             name of the source (ds0,​ds1,​RESPONSE TIME etc)
-descr            ​further description+descr            ​type of datasource, i.e. ifInOctets, ifInErrors, cpu5min, etc
 dstype ​          type (DERIVE / GAUGE) dstype ​          type (DERIVE / GAUGE)
 units            units used on y-axis (seconds, bytes, etc) units            units used on y-axis (seconds, bytes, etc)
Line 336: Line 351:
 </​code>​ </​code>​
  
-===== Tables used by Device Management ===== 
  
-This [[http://​domen.uninett.no/​~faltin/​nav/​navdb/​netbox_related.png|diagram]] shows tables for Device Management (and more). 
  
-==== product ​====+===== Router related topology tables =====
  
-The product table is used be Device Management to register products.  +Diagram 2 shows the relations between the topology related tables:
-Not compulsory. ​ A product has a product number and is of a vendor.+
  
-<​code>​ +{{devel:​db:​topology.png?​600|}} ​
-productid ​      ​primary key +
-productno ​      ​product identifier, i.e. "​WS-X4148-RJ"​ +
-descr           ​further descr, i.e. "48 ports 10/​100BaseTX (RJ45)"​ +
-vendorid ​       Vendor of the product +
-</​code>​+
  
-==== deviceorder ​====+==== interface ​====
  
-The devicerorder ​table is used by Device Management to place orders.  +New table in v3.6. General interface table, combines the old gwport and swport in one.  
-Not compulsary. An order consists ​of a set of devices ​(on or more) +In cases where attribute starts with if* it is the exact equivalent ​of the IF-MIB ​(RFC 1229instance.
-of a certain product.+
  
 +<​code>​
 +interfaceid ​       primary key
 +netboxid ​          ​netbox the interface belongs to 
 +moduleid ​          ​module the interace is on (if found)
 +ifindex ​           ifindex of the router port
 +ifname ​            ​interface name
 +ifdescr ​           interface ​
 +iftype ​            
 +speed              ​
 +ifphysaddress ​     ​
 +ifadminstatus ​     ​
 +ifoperstatus ​      
 +iflastchange ​      
 +ifconnectorpresent  ​
 +ifpromiscuousmode  ​
 +ifalias ​    
 +baseport ​          port number (integer) if appliqable ???
 +media             
 +vlan               
 +trunk             
 +duplex ​        
 +to_netboxid ​       the netbox the interface connects to (if any)
 +to_interfaceid ​    the interface this interface connects to (if any)
  
-<​code>​ 
-deviceorderid ​  ​primary key 
-registered ​     time stamp when the order is registered in NAV 
-ordered ​        date the order is made in NAV.  
-arrived ​        time stamp when the order has arrived 
-username ​       NAV user placing the order 
-orgid           ​organization placing the order 
-retailer ​       retailer where the order is placed 
-ordernumber ​    ​ordernumber used internally or by retailer 
-comment ​        ​further comments made regarding the order 
-productid ​      ​product that is ordered 
-updatedby ​      ??? 
-lastupdated ​    ??? 
-  
-note: the amount is not registered in device order, but if the amount ​ 
-i.e. is 5, then 5 device order events are posted on the eventq (I think...). 
 </​code>​ </​code>​
  
-==== vendor ​====+==== rproto_attr ​==== 
 + 
 +New table in v3.6. General table for routing protocol metrics. Relates to intervace table. ​
  
-The vendor table defines vendors. A type is of a vendor. ​ 
-A product is of a vendor. 
  
 <​code>​ <​code>​
-vendorid ​       table identifier, also the name of the vendor.+id            primary key 
 +interfaceid ​  which interface this is (foreign key)  
 +protoname ​    ​protocol ​name, i.e. ospf, isis, etc 
 +metric ​       metric value
 </​code>​ </​code>​
  
- 
-===== Router related topology tables ===== 
- 
-Diagram 2 shows the relations between the topology related tables: 
- 
-{{devel:​db:​topology.png?​600|}} ​ 
  
 ==== gwport ==== ==== gwport ====
Line 422: Line 432:
  
 <​code>​ <​code>​
-gwportid ​       ​router port in question+interfaceid ​    ​interface (router portin question
 prefixid ​       prefix in question prefixid ​       prefix in question
 gwip            ip address defines on the router port gwip            ip address defines on the router port
Line 537: Line 547:
 <​code>​ <​code>​
 swportvlanid ​   table primary key  swportvlanid ​   table primary key 
-swportid ​       switch port id (foreign key ref to swport ​table)+interfaceid ​    ​interface ​id (foreign key ref to interface ​table, i.e. which switch port is this)
 vlanid ​         vlan id (foreign key ref to vlan table, not an actual vlan number) vlanid ​         vlan id (foreign key ref to vlan table, not an actual vlan number)
 direction ​      ​Direction of the link, seen from the root of the topology (the vlan's router). direction ​      ​Direction of the link, seen from the root of the topology (the vlan's router).
-                '​o'​ = '​Up',​ '​n'​ = '​Down',​ '​x'​ = ???+                '​o'​ = '​Up',​ '​n'​ = 'Down', '​b'​ = '​Blocked', '​x'​ = Unknown
 </​code>​ </​code>​
  
Line 555: Line 565:
  
 <​code>​ <​code>​
-swportid ​       ​switch trunk port in question+interfaceid ​    switch trunk port in question ​(foreign key to the interface table)
 hexstring ​      ​hexstring that defines the allowed vlans for the trunk hexstring ​      ​hexstring that defines the allowed vlans for the trunk
 </​code>​ </​code>​
Line 564: Line 574:
  
 <​code>​ <​code>​
-swportid ​       ​switch port in question+interfaceid ​    switch port in question ​(foreign key to interface table)
 vlan            vlan value vlan            vlan value
 </​code>​ </​code>​
Line 579: Line 589:
 ifindex ​        ​ifindex on the switch ifindex ​        ​ifindex on the switch
 to_netboxid ​    ​candidate next hop netbox to_netboxid ​    ​candidate next hop netbox
-to_swportid ​    candidate next hop switch port+to_interfaceid  ​candidate next hop switch port (foreign key to interface table)
 misscnt ​        see misscnt in the cam table below. Same thing. misscnt ​        see misscnt in the cam table below. Same thing.
 </​code>​ </​code>​
Line 641: Line 651:
 <​code>​ <​code>​
 patchid ​        ​primary key patchid ​        ​primary key
-swportid ​       ​reference to the swport the cross connect is connected to+interfaceid ​    reference to the swport the cross connect is connected to (foreign key to interface table)
 cablingid ​      ​reference to the jakc the cross connect is connected to cablingid ​      ​reference to the jakc the cross connect is connected to
 split           If a split cable is used in the jack end, specify type and leaf. split           If a split cable is used in the jack end, specify type and leaf.
Line 659: Line 669:
 Different subsystem (specified in source) post events on the event queue. Different subsystem (specified in source) post events on the event queue.
 Normally event engine is the target and will take the event off the event Normally event engine is the target and will take the event off the event
-queue and process itgetDeviceData ​are in some cases the target.+queue and process it (getDeviceData ​was in some cases the target, not anymore).
  
 <​code>​ <​code>​
Line 748: Line 758:
 </​code>​ </​code>​
  
-==== alertmsg ​====+==== alertqmsg ​====
  
 Event engine will, based on alertmsg.conf,​ preformat the alarm messages, Event engine will, based on alertmsg.conf,​ preformat the alarm messages,
 one message for each configured alert channel (email, sms), one message for one message for each configured alert channel (email, sms), one message for
-each configured language. The data are stored in the alertmsg ​table.+each configured language. The data are stored in the alertqmsg ​table.
  
 <​code>​ <​code>​
Line 818: Line 828:
 </​code>​ </​code>​
  
-==== alertengine ==== 
  
-Used by alert engine to keep track of processed alerts. 
- 
-<​code>​ 
-lastalertqid ​   value of the last alertqid that alert engine has processed. 
-</​code>​ 
  
 ===== Messages ===== ===== Messages =====
Line 917: Line 921:
  
  
-===== Traffic map ===== 
- 
-The traffic map (vlanplot) uses three tables to store values on positioning of 
-routers in the graph and on the use of containers. ​ 
-This [[http://​domen.uninett.no/​~faltin/​nav/​navdb/​trafficmap.png|diagram]] shows the releations between the 
-traffic map tables. ​ 
- 
-Also, see more documentation on the TrafficMap. 
- 
-==== vp_netbox_xy ==== 
- 
-The table is used for positioning nodes (routers) on the traffic map. 
-A netbox may be positioned in more than one container (because we show the 
-other side of the link, the netboxes themself always only belong to one container). 
- 
-<​code>​ 
-vp_netbox_xyid ​       primary key 
-pnetboxid ​            the netboxid of this box (router) ​     
-x                     the X coordinate ​                   ​ 
-y                     the Y coordinate ​     
-vp_netbox_grp_infoid ​ reference to the container this node belongs to. 
-</​code>​ 
- 
-==== vp_netbox_grp_info ==== 
- 
-The table keeps information on all containers used by the traffic map. 
-Editing containers is done in Edit Database. 
- 
-<​code>​ 
-vp_netbox_grp_infoid ​ primary key 
-name                  name of the container. The top container is named _Top. 
-hideicons ​            ​boolean. The value has different meanings, see the TrafficMap wiki page. 
-iconname ​             if a name is given and an equivalent icon is placed in the vlanPlot/​icons ​ 
-                      directory this will be used. 
-x                     the X coordinate of the container placement on _Top. 
-y                     the Y coordinate of the container placement on _Top. 
-</​code>​ 
- 
-==== vp_netbox_grp ==== 
- 
-The table maps netboxes to containers. This information is maintained by Edit Database. 
- 
-<​code>​ 
-vp_netbox_grp_infoid ​ the container 
-pnetboxid ​            the netboxid of this box (router) 
-</​code>​ 
  
  
Line 1005: Line 963:
  
 ==== identity ==== ==== identity ====
 +
 +:!: Not up to date!
  
 <​code>​ <​code>​
Line 1011: Line 971:
 blocked_status ​       boolean blocked_status ​       boolean
 blocked_reasonid ​     reason of the block, reference to the blocked_reason table blocked_reasonid ​     reason of the block, reference to the blocked_reason table
-swportid ​             reference to the switch port found in the manage.swport ​table.+swportid ​             reference to the switch port found in the interface ​table.
                       We find sysname,​ip,​module and port from this                       We find sysname,​ip,​module and port from this
 swsysname ​            ​current sysname of switch, kept for consistency check swsysname ​            ​current sysname of switch, kept for consistency check
Line 1082: Line 1042:
 version...). ​ version...). ​
  
-See [[http://metanav.uninett.no/​static/​reports/​NAVMore.pdf|NAVMore report ch 2.4]] (in Norwegian) for a further explaination of+See [[http://nav.uninett.no/​static/​reports/​NAVMore.pdf|NAVMore report ch 2.4]] (in Norwegian) for a further explaination of
 the NAV Cisco syslog analyzer tool. The chapter also includes a database figure, almost uptodate; the system table no longer exists and there is a newpriority reference from message to priority. For an explanation of the front-end tool, see [[..sysloganalyzer|here]]. the NAV Cisco syslog analyzer tool. The chapter also includes a database figure, almost uptodate; the system table no longer exists and there is a newpriority reference from message to priority. For an explanation of the front-end tool, see [[..sysloganalyzer|here]].
  
devel/database.1253193858.txt.gz · Last modified: 2009/09/17 13:24 by morten