4.8
Contents
NAV documentation
Getting help
First steps
Overview
What it is
What NAV does
A brief history of NAV
Installing NAV
Dependencies
Installing NAV
Getting started with NAV
Minimal configuration
Starting NAV
Logging in to the web interface
Seeding your database
Further reading
Getting organized
Organizing your seed data
Organizing your collected data
Troubleshooting topology problems in NAV
Overview
Physical topology
Migrating data from one NAV installation to another
What data should I migrate?
Migrating seed data
Migrating all or parts of the database
Migrating RRD data to Graphite (from NAV 3 to NAV 4)
TL;DR
Conversion
Limitations
The NAV API
About
Tokens
Browsing the API
FAQ
Is vendor X / device Y supported?
Why are there gaps in my graphs?
Why does NAV list my device’s uplink as
N/A
?
Why doesn’t device X show as down in the status page when I know it’s down?
A device is down, I see it on the status page, my profile should cover th event, but I am not alerted. Why?
Why is my Cisco switch’ syslog full of SNMP-3-AUTHFAIL messages for requests from my NAV server?
I added a new IP Device using SeedDB, but nothing happens. Why?
How do I make NAV send SMS alerts?
Reference material
Arnold
Cabling and Patch
Geomap
IPAM - IP Address Management
ipdevpoll
Configuring NAV for LDAP authentication
MailIn
navstats
PortAdmin
Radius
Setting up FreeRADIUS to log to NAV
smsd
snmptrapd
Backend processes in NAV
Network Administration Visualized release notes
NAV 4.8
NAV 4.7
NAV 4.6
NAV 4.5
NAV 4.4
NAV 4.3
NAV 4.2
NAV 4.1
NAV 4.0
NAV 3.15
NAV 3.14
NAV 3.13
NAV 3.12
NAV 3.11
NAV 3.10
NAV 3.9
NAV 3.8
Glossary
Hacking NAV
Hacker’s guide to NAV
Hacking with PyCharm
Virtual Machines and NAV
Using NAV with Docker for development
Javascript hacking
Checklist for releasing a new NAV version
Writing a new servicemon plugin
NAVbar search providers
Adding support for a new environment probe device to NAV
The NAV API
Page
NAV documentation contents
For developers
Indices, glossary and tables
NAV documentation »
NAV documentation contents
For developers
Indices, glossary and tables
NAV documentation »
Source
NAV documentation contents
¶
Overview
What it is
What NAV does
A brief history of NAV
Installing NAV
Dependencies
Build requirements
Runtime requirements
Recommended add-ons
Installing NAV
Initializing the database
Making the Python libraries available system-wide
Configuring Apache
Create users and groups
Integrating Graphite with NAV
Getting started with NAV
Minimal configuration
Starting NAV
Logging in to the web interface
Seeding your database
Adding your first device to NAV
Verifying that collection is working
Selecting a device category
Importing multiple devices in bulk
Further reading
Getting organized
Organizing your seed data
Organizing your collected data
VLANs and subnets
Network prefixes and scopes
Vendors and device types
Cabling and patching
Troubleshooting topology problems in NAV
Overview
Physical topology
Two connected devices aren’t seen as connected by NAV
How NAV builds physical topology information
Migrating data from one NAV installation to another
What data should I migrate?
Migrating seed data
Migrating all or parts of the database
Intro
Dumping
Restoring
Full migration to a test server
Migrating RRD data to Graphite (from NAV 3 to NAV 4)
TL;DR
Conversion
Runtime considerations
Converting while NAV 4 is running
Migrating between different platforms
Limitations
Data archives
Aggregation methods
Network interface counter discontinuities
Environmental sensor precision changes
The NAV API
About
Tokens
How to get a token
How to use the token
Browsing the API
Available endpoints
Paging
Searching and filtering
Using POST, PUT, PATCH and DELETE
A specific scenario
FAQ
Is vendor X / device Y supported?
Why are there gaps in my graphs?
Why does NAV list my device’s uplink as
N/A
?
Why doesn’t device X show as down in the status page when I know it’s down?
A device is down, I see it on the status page, my profile should cover th event, but I am not alerted. Why?
Why is my Cisco switch’ syslog full of SNMP-3-AUTHFAIL messages for requests from my NAV server?
I added a new IP Device using SeedDB, but nothing happens. Why?
How do I make NAV send SMS alerts?
Reference material
Arnold
Introduction
What does Arnold do?
Using Arnold
Using the scripts
Configuring Arnold
Logging
FAQ
Cabling and Patch
Concepts
Cabling
Patch
Port Details
Geomap
Technical documentation
IPAM - IP Address Management
Introduction
What can IPAM do?
Exploring your network
How to reserve prefixes
ipdevpoll
Usage
Configuring ipdevpoll
Multiprocess mode
Configuring NAV for LDAP authentication
Configurable options
How it works
Authenticating existing NAV accounts with LDAP
MailIn
Configuring MailIn
navstats
Introduction
Usage
Example
PortAdmin
Introduction
What can PortAdmin do?
What the interface tells you
How to use the interface
The Config File
More about voice VLANs
Radius
Files
About
Installation
Usage
Making Changes
Known Issues
TODO
Setting up FreeRADIUS to log to NAV
Installing the accounting module
Installing the error log module
Setting up deletion of old entries
Configuring NAV
smsd
Usage
Message queues
Dispatchers
Extending
snmptrapd
What is the SNMP trap daemon?
Usage
Logging
Configuration
Trap handlers
Backend processes in NAV
The nav command
Other processes
Network Administration Visualized release notes
NAV 4.8
Dependency changes
Other changes
News
NAV 4.7
Dependency changes
Support for monitoring BGP sessions
ipdevpoll multiprocess mode rewritten
Support for more infrastructure monitoring
Improved user interfaces for sensor/environment monitoring
Avoiding redundant SNMP polling for virtual device contexts
Changes to bulk import formats
Support for dashboard export/import
Audit logging
NAV 4.6
Dependency changes
IPAM (IP Address Management)
Static routes
Prefix information page and usage tags
Link aggregation support
Multi- and fullscreen dashboards
New dashboard widgets
Hierarchical locations
Business reports
Juniper EX switch series workaround
navuser command line
NAV 4.5
Dependency changes
Cabling and patches
navstats
API changes
NAV 4.4
Dependency changes
Interactive trend graphs
Slack dispatcher
Subnet matrix improvements
checkService.py has been renamed
NAV 4.3
Dependency changes
Data model changes (chassis, serial numbers, virtual devices, etc.)
The new chassisState family of alerts
Deleting out of service modules and chassis
Link, module and chassis status verification
NAV 4.2
Dependency changes
Rename some of your Whisper files to keep your statistics
Multicast listener stats from IGMP snooping
Graphite storage schema changes
Rewritten Status tool
Netmap redesign
SeedDB IP device form redesign
Custom attributes on IP devices and locations
New command line utilities
Files to remove
NAV 4.1
Dependency changes
Schema changes and hstore
Watchdog
New REST API
NAV 4.0
Dependency changes
Major changes to statistics collection
Migrating existing data
Files to remove
NAV 3.15
Dependency changes
Database schema changes
Configuration changes
mod_python vs. mod_wsgi
REST API
Write privileges for room image uploads
Files to remove
NAV 3.14
Dependency changes
Manual upgrade steps required
IPv6
Files to remove
NAV 3.13
Dependency changes
New eventengine
New alert message template system
VLANs
Arnold
Files to remove
NAV 3.12
Dependency changes
Cricket configuration
Room map
Toolbar search
Files to remove
NAV 3.11
Dependency changes
Topology source data
NAV 3.10
Cricket configuration changes
Topology detection
Link state monitoring
SNMP agent monitoring
Redundant power supply and fan state monitoring
IPv6 status monitoring
Files to remove
NAV 3.9
Dependency changes
NAV 3.8
Source code directory layout
Apache configuration
Database installation and migration
PortAdmin
Dependency changes
Glossary
For developers
¶
Hacking NAV
Hacker’s guide to NAV
Contributing to NAV
Directory layout
Development languages and frameworks
Coding style
Database
Version Control
Testing and Continuous Integration
Tips and tricks
Submitting patches
Hacking with PyCharm
Obtaining a copy of the open source license
Configuring PyCharm for use with NAV
Virtual Machines and NAV
Building a Docker image
Build a virtual appliance
Using NAV with Docker for development
Installing Docker
Building the Docker image
Using the container(s)
Javascript hacking
Avoiding caching
Javascript testing
Javascript hierarchy layout
Checklist for releasing a new NAV version
CI status check
Review milestone for next release on GitHub
Getting the code
Updating changelog and release notes
Rolling and uploading a new distribution tarball
Announcing the release
Writing a new servicemon plugin
A quick intro to the service monitor
The goal
Writing the plugin
In conclusion
NAVbar search providers
A simple implementation example
The SearchProvider base class
The SearchResult namedtuple
Adding support for a new environment probe device to NAV
The goal
Sensors in NAV
Course of action
Dumping the MIB
Examining the MIB
Writing a MibRetriever
The NAV API
About
Tokens
Browsing the API
Indices, glossary and tables
¶
Index
Module Index
Glossary