Installation instructions for Debian

Preparation

To ensure your can always get the latest NAV package directly from our package repository, you should:

  • Ensure HTTPS support for APT is installed on your system
  • Trust the GPG key we use to sign the package archive
  • Add our archive to your list of APT sources

Here's how to do it:

Debian 8 (Jessie)

sudo apt-get install -y apt-transport-https
sudo apt-key adv --keyserver keys.gnupg.net --recv-key CE8E05E8
sudo /bin/sh -c "echo 'deb https://nav.uninett.no/debian jessie nav' > /etc/apt/sources.list.d/nav.list"
sudo apt-get update

To install NAV, you can now just run:

sudo apt-get install nav

If you are upgrading from previous NAV versions on Jessie, you may have pulled our modifed graphite-web package (compatible with Django 1.4) from this repository. This package was, unfortunately, published with a version number that causes it to take precedence over Debian's official version (compatible with Django 1.7). We have tried to take steps to ensure this package will be thrown out and replaced with Debian's official version when upgrading NAV, but if this fails, you may have to replace it manually.

Further instructions

Please read the instructions in /usr/share/doc/nav/README.Debian to complete your configuration of NAV on Debian. You may then proceed to our getting started-guide.

If you need additional help in setting up and configuring Graphite on your NAV server, please refer to the wiki article graphite_on_debian.

Bugs

If you have problems with the package itself, please report them at https://github.com/uninett/nav-debian/issues. If you want to report bugs in NAV, you can do so at https://github.com/uninett/nav/issues.

Footnotes

The NAV Debian package used to be maintained by Morten Werner Forsbring at http://pkg-nav.alioth.debian.org/ - the package currently maintained by UNINETT is based on his work.

Installation instructions for Virtual Appliance

We've built virtual appliances in OVF format for those who want to get quickly started with NAV.
Most popular virtualization environments can import this appliance (Though you may need to use VMWare's OVFTool to import it properly into VMWare).

The appliances are usually built on 64-bit stable versions of Debian GNU/Linux, with NAV installed from the packages available at our APT repository (see the Debian section above). This also means that NAV is easily upgradeable using Debian's aptitude or apt-get tools.

Downloading the appliance files

NAV virtual appliance downloads

Stable releases are found in the stable/ directory, beta testing releases in the beta/ directory (duh!).

Configuration steps after booting the appliance

  • Log in as root and change the root password from navrocks to something else (using the passwd command)
  • Edit /etc/aliases to add a decent email address to forward root's email to. Then run the newaliases command.
  • Fix the network configuration (/etc/network/interfaces) and restart the networking service using /etc/init.d/networking restart
  • Add networks that shall be allowed to talk to the appliance in /etc/hosts.allow (both clients to the NAV web interface and network equipment that send SNMP traps)
  • Set a proper hostname/domain name in the following files: /etc/hosts, /etc/resolv.conf, /etc/mailname and /etc/exim4/update-exim4.conf.conf

Links