Difference between revisions of "Build a virtual appliance 0.6"
| (23 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | [[Main Page]] > [[Development]] > Build a virtual appliance | |
| − | + | ||
| − | *Ubuntu | + | 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 | *vmbuilder requires KVM which requires a virt compatible processor however, you do not need virt support for vmbuilder | ||
*At least 2GB of ram | *At least 2GB of ram | ||
| − | ===Pre Build | + | ==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 | 1. check out the source | ||
<pre>svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica-read-only</pre> | <pre>svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica-read-only</pre> | ||
| Line 21: | Line 42: | ||
</pre> | </pre> | ||
| − | + | ==Post Build== | |
1. boot your virtual machine. For KVM its under ubuntu-kvm, for other examples please see [[Virtual_appliance_instructions]]. | 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> | <pre>kvm -m 528 -smp 1 -drive file=disk0.qcow2 </pre> | ||
| Line 27: | Line 48: | ||
2. From inside the machine open a terminal and run the following (password is demo) | 2. From inside the machine open a terminal and run the following (password is demo) | ||
<pre> | <pre> | ||
| − | |||
incrontab /etc/incron.tab | incrontab /etc/incron.tab | ||
| − | mysqladmin create | + | 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> | </pre> | ||
| Line 35: | Line 59: | ||
4. Aside from some icon placement you now have a fully functional version of archivematica! | 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 12: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