This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
navappliance [2012/12/05 08:25] morten clean up page and add link to latest appliance version |
navappliance [2018/12/11 07:44] (current) morten https |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== A NAV virtual appliance ====== | + | ====== NAV Virtual Appliances ===== |
- | We've created a virtual appliance in OVF format for those who want to get quickly started with NAV. | + | 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. | + | Most popular virtualization environments can import this appliance (Though you may need to use VMWare's OVFTool to import it properly into VMWare). |
- | The appliance runs 64-bit Debian GNU/Linux 6 (a.k.a. Squeeze), with NAV installed from the packages available at http://pkg-nav.alioth.debian.org/. This also means that NAV is easily upgradeable using Debian's //aptitude// or //apt-get// tools. | + | 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 [[nav_on_debian]]). This also means that NAV is easily upgradeable using Debian's //aptitude// or //apt-get// tools. |
===== Download ===== | ===== Download ===== | ||
- | [[https://eske.labs.uninett.no/public.php?service=files&dir=/mvold/files/nav-appliances|Download the appliance from eske]] (UNINETT's cloud storage "Dropbox clone") | + | [[https://nav.uninett.no/static/appliance|NAV virtual appliance downloads]] |
+ | Stable releases are found in the //stable// directory, beta testing releases in the //beta// directory. Kinda obvious, isn't it? ;-) | ||
===== What the local admin needs to do after starting the appliance ===== | ===== What the local admin needs to do after starting the appliance ===== | ||
- | * log in as 'root' and change the root-password (passwd) | + | * log in as 'root' and change the root password from ''navrocks'' to something else (using passwd) |
* add a decent email-address to forward root's email to in ///etc/aliases// | * add a decent email-address to forward root's email to in ///etc/aliases// | ||
* fix the network-configuration (/etc/network/interfaces) and restart network with **/etc/init.d/network restart** | * fix the network-configuration (/etc/network/interfaces) and restart network with **/etc/init.d/network restart** | ||
* add networks that shall be allowed to talk to the appliance in ///etc/hosts.allow// (both clients to the NAV webinterface and network equipment that send SNMP traps) | * add networks that shall be allowed to talk to the appliance in ///etc/hosts.allow// (both clients to the NAV webinterface and network equipment that send SNMP traps) | ||
* also fix hostname/domainname in the following files: ///etc/hosts//, ///etc/resolv.conf//, ///etc/mailname// and ///etc/exim4/update-exim4.conf.conf// | * also fix hostname/domainname in the following files: ///etc/hosts//, ///etc/resolv.conf//, ///etc/mailname// and ///etc/exim4/update-exim4.conf.conf// | ||
- | |||
- | ===== How the virtual appliance was created ===== | ||
- | |||
- | A virtual machine was created on a VMware ESX server with 512MB RAM and 4GB of disk. Choises made during installation of Debian GNU/Linux 4.0 (aka. etch): | ||
- | |||
- | * American English as language | ||
- | * using LVM on the disk to ease the expand-process | ||
- | * all files in one large partition | ||
- | |||
- | After a normal installation, the following changes are made: | ||
- | |||
- | * the user added at install-time was removed | ||
- | * so was the root-alias in ///etc/aliases// pointing to that user | ||
- | * backport.org- and pkg-nav.alioth.debian.org-mirrors added to /etc/apt/sources.list | ||
- | * installed open-vm-tools (from backports.org) and ran the commands **module-assistant prepare open-vm** and **module-assistant auto-install open-vm** to build the opem-vm-modules | ||
- | * installed openssh-server | ||
- | * added 'ALL: 127.0.0.1' to /etc/hosts.allow and 'ALL: ALL' to /etc/hosts.deny | ||
- | * installed nav (aptitude install --without-recommends nav) and answered yes to all question | ||
- | * followed /usr/share/doc/nav/README.Debian | ||
- | * poweroff the machine and take a snapshot | ||
- | * Remove the network configuration in /etc/network/interfaces. | ||
- | * Change the temporary root-password to an empty one in /etc/shadow (and remove /etc/shadow-). | ||
- | * Adjust hostname in the following files: /etc/hosts, /etc/mailname and /etc/exim4/update-exim4.conf | ||
- | * Power off the virtual machine and export as appliance. | ||
- | |||
- | |||
- | |||
- | ===== Todo ===== | ||
- | |||
- | * document how to make the appliance send emails | ||
===== Links ===== | ===== Links ===== | ||
- | * OVF - [[http://en.wikipedia.org/wiki/Open_Virtual_Machine_Format]] | + | * OVF - [[https://en.wikipedia.org/wiki/Open_Virtual_Machine_Format]] |
- | * NAV - [[http://nav.uninett.no/]] | + | * VMWare OVFTool - [[http://www.vmware.com/support/developer/ovf/]] |
+ | * NAV - [[https://nav.uninett.no/]] | ||
* Debian GNU/Linux - [[http://www.debian.org/]] | * Debian GNU/Linux - [[http://www.debian.org/]] | ||
+ | * NAV virtual appliance source code: [[https://github.com/Uninett/navappliance]] |