Build a virtual appliance 0.6

From Archivematica
Revision as of 17:15, 29 April 2010 by Austin (talk | contribs)
Jump to navigation Jump to search

Main Page > Development > Build a virtual appliance


Below are instructions for building your own Archivematica virtual appliance. This allows you to create intermediate or branch releases to test and use your own modifications.


Requirements

  • Ubuntu server 9.10
  • vmbuilder requires KVM which requires a virt compatible processor however, you do not need virt support for vmbuilder
  • At least 2GB of ram

Software Requirements

subversion (SVN)

sudo apt-get install subversion

vmbuilder

sudo apt-get install ubuntu-vm-builder

A local apt-proxy. We recomend apt-cacher-ng.

sudo aptitude install apt-cacher-ng
sudo gedit /etc/apt-cacher-ng/acng.conf

change the port.. whatever its set to..(3142 defuault) to 9999 Restart the service for changes to take effect.

sudo /etc/init.d/apt-cacher-ng restart

Pre Build

1. check out the source

svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica-read-only

2. Modify archivematica-read-only/trunk/archivematica.cfg to resemble your file system IE:

 execscript = /home/demo/trunk/archivematica.sh 

should be

 execscript = /home/yourhomefolder/archivematica-read-only/trunk/archivematica.sh 

3. Build archivematica for your hosts virtualization platform. All the following commands will build the same virtual machine.. each for a different platform

sudo vmbuilder vmserver ubuntu -c archivematica.cfg
sudo vmbuilder xen ubuntu -c archivematica.cfg
sudo vmbuilder kvm ubuntu -c archivematica.cfg

Post Build

1. boot your virtual machine. For KVM its under ubuntu-kvm, for other examples please see Virtual_appliance_instructions.

kvm -m 528 -smp 1 -drive file=disk0.qcow2 

2. From inside the machine open a terminal and run the following (password is demo)

incrontab /etc/incron.tab
sudo mysqladmin create qubit

3. Open firefox and navigate to http://localhost, go through the qubit installer for the database settings all defaults will work.

4. Aside from some icon placement you now have a fully functional version of archivematica!