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 9 (Stretch)

sudo apt-get install -y apt-transport-https ca-certificates dirmngr
sudo apt-key adv --keyserver keys.gnupg.net --recv-key CE8E05E8
sudo /bin/sh -c "echo 'deb https://nav.uninett.no/debian stretch nav' > /etc/apt/sources.list.d/nav.list"
sudo /bin/sh -c "cat >  /etc/apt/preferences.d/nav.pref" <<EOF
# Give packages from nav.uninett.no higher priority, at your own risk
Package: *
Pin: origin nav.uninett.no
Pin-Priority: 600
EOF
sudo apt-get update

To install NAV, you can now just run:

sudo apt-get install nav

On trusting the NAV APT repository

There are several software packages that NAV depend on, which are not provided by Debian 9, or are provided in newer versions that are backwards-incompatible (such as Django and related software). The APT repository at nav.uninett.no provides these packages in the required versions, but since some of the packages are available in newer versions from Debian Stretch, you will experience problems with having apt installing all the correct dependecies.

This is the reason for the apt-pinning rule in the above recipe. It will ensure that packages provided by nav.uninett.no will be preferred over newer versions from Debian.

By doing this, you will lose the benefits of Debian security patches to these packages, and you may have issues installing other Debian packages that depend on python-django. Proceeed at your own risk.

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