Difference between revisions of "Build a virtual appliance 0.6"

From Archivematica
Jump to navigation Jump to search
(Created page with '==Building Archivematica== first check out the source <pre><code> </code></pre>')
 
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
==Building Archivematica==
+
[[Main Page]] > [[Development]] > Build a virtual appliance
−
first check out the source
+
 
−
<pre><code> </code></pre>
+
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

Latest revision as of 11:39, 8 October 2010

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[edit]

  • 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[edit]

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[edit]

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[edit]

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 ica-atom
sudo mysqladmin create dcb
sudo mysqladmin create dashboard
sudo chmod 444 ~/.config/xfce4/panel/*
sudo chmod 444 ~/.config/xfce4/panel

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[edit]

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: 

kvm-img convert -f qcow2 -O raw disk0.qcow2 archivematica.raw

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

Retrieved from "https://wiki.archivematica.org/index.php?title=Build_a_virtual_appliance_0.6&oldid=2703"