Build a virtual appliance 0.7 - Revision history

Joseph: /* Post Build */

2010-11-24T19:09:09Z

Post Build

Joseph at 17:54, 8 October 2010

2010-10-08T17:54:51Z

Joseph: Starting 0.7 build documentation based off of 0.6 documentation.

2010-10-08T17:40:20Z

Starting 0.7 build documentation based off of 0.6 documentation.

New page

[[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 10.04
*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)
<pre>sudo apt-get install subversion
</pre>

vmbuilder
<pre>sudo apt-get install ubuntu-vm-builder
</pre>

A local apt-proxy. We recomend apt-cacher-ng.
<pre>sudo aptitude install apt-cacher-ng
sudo gedit /etc/apt-cacher-ng/acng.conf
</pre>
change the port.. whatever its set to..(3142 defuault) to 9999
Restart the service for changes to take effect.
<pre>sudo /etc/init.d/apt-cacher-ng restart
</pre>

==Pre Build==
1. check out the source
<pre>svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica-read-only</pre>

2. Modify archivematica-read-only/trunk/archivematica.cfg to resemble your file system IE:
<pre> execscript = /home/demo/trunk/archivematica.sh </pre>
should be
<pre> execscript = /home/yourhomefolder/archivematica-read-only/trunk/archivematica.sh </pre>

3. Build archivematica for your hosts virtualization platform. All the following commands will build the same virtual machine.. each for a different platform
<pre>
sudo vmbuilder vmserver ubuntu -c archivematica.cfg
sudo vmbuilder xen ubuntu -c archivematica.cfg
sudo vmbuilder kvm ubuntu -c archivematica.cfg
</pre>

==Post Build==
1. boot your virtual machine. For KVM its under ubuntu-kvm, for other examples please see [[Virtual_appliance_instructions]].
<pre>kvm -m 528 -smp 1 -drive file=disk0.qcow2 </pre>

2. From inside the machine open a terminal and run the following (password is demo)
<pre>
incrontab /etc/incron.tab
sudo mysqladmin create ica-atom
sudo mysqladmin create dcb
sudo mysqladmin create dashboard
sudo chmod 444 .config/xfce4/panel/*
sudo chmod 444 .config/xfce4/panel
</pre>

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!

==Create a .raw file==
1. A raw file can be used to run the virtual appliance directly from a USB key or to install it directly on dedicated hardware without a virtualization layer.

2. after running vmbuilder you will be left with a qcow2 image. Run the following command:
<pre>kvm-img convert -f qcow2 -O raw disk0.qcow2 archivematica.raw</pre>

3. See [[Build a Live USB disk]] for instructions on using the .raw file to create a bootable USB key version of Archivematica

@@ Line 50: / Line 50: @@
 . Open firefox and navigate to http://localhost, go through the qubit installer for the database settings all defaults will work.
-. Aside from some icon placement you now have a fully functional version of archivematica!
+. Add the cron job to delay the unquarantine for the desired amount of time in minutes. Replace the '1' with the desired quarantine time in minutes.
 ==Create a .raw file==

@@ Line 30: / Line 30: @@
 <pre>svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica-read-only</pre>
-. Modify archivematica-read-only/trunk/archivematica.cfg to resemble your file system  IE:
+. Run the build script:
-<pre> execscript = /home/demo/trunk/archivematica.sh </pre>
+This script will set the vmbuilder execscript to archivematica.sh and create the selected type VM.
-should be
+Note the rootSize is the size of the vm disk to build in MB.
-<pre> execscript = /home/yourhomefolder/archivematica-read-only/trunk/archivematica.sh </pre>
+<pre>
+cd archivematica-read-only
 </pre>
@@ Line 46: / Line 41: @@
 <pre>kvm -m 528 -smp 1 -drive file=disk0.qcow2 </pre>
-. From inside the machine open a terminal and run the following (password is demo)
+. From inside the machine open a terminal and run the post build script:
 <pre>
-incrontab /etc/incron.tab
+cd ~/postBuildScripts
-sudo mysqladmin create ica-atom
+./postBuildRun.sh
 </pre>