This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
navappliance-recipe [2012/12/05 08:28] morten created |
navappliance-recipe [2018/12/11 07:42] morten removed |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== NAV virtual appliance recipe ====== | ====== NAV virtual appliance recipe ====== | ||
- | This is the original recipe used by Morten Werner Forsbring to create the first [[navappliance|NAV virtual appliance]]. | + | Building the appliance used to be a fully manual process. We now automate it using Veewee and Vagrant. The build scripts serve as documentation on how to build it. See the [[https://github.com/UNINETT/nav|Veewee templates directory in the source code]]. |
- | + | ||
- | ===== 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 | + | |
+ | Using NAV with Vagrant is also documented in [[https://nav.uninett.no/doc/hacking/index.html|NAV's hacking documentation]]. |