File:SelectSystem.png

2010-06-01T18:44:16Z

Austin:

ICA-AtoM virtual appliance

2009-12-20T01:06:30Z

Austin:

ICA-Atom VE is distributed as a [http://en.wikipedia.org/wiki/Virtual_appliance virtual appliance].

This allows it to be run on almost any workstation or server hardware without compromising the host machine's operating system or application software. At the same time, the virtual appliance is able to interact with any number of networked and/or external storage devices to allow for the flexible implementation of an archival storage and backup strategy.

*See the [http://ica-atom.org/docs/index.php?title=Main_Page ICA-Atom] Documentation page for instructions on how to use the virtual appliance.

=Minimum hardware requirements=

*Processor: Intel core 2 or AMD Opteron
*Memory: 256MB for the virtual appliance ('guest') operating system, i.e: if the 'host' operating system has 2GB available, 256MB needs to allocated to the 'guest'. Depending on the operating system, machines with less than 1.5GB total memory will likely have trouble running Archivematica. Note that the default allocation setting in Archivematica is 256MB; however, the more that is allocated the better the system will run. The setting can be changed once Archivematica is running.
*Hard Drive space: a minimum of 1GB to test the system on a small scale (i.e. use the available test files or import a small set of test files); 5GB or more for larger implementations

=Instructions for using the vmserver image=

==Install Sun Virtual Box==

*There are VirtualBox versions available for every major operating system.
**Download and install Sun VirtualBox: [http://www.virtualbox.org/wiki/Downloads http://www.virtualbox.org/wiki/Downloads].

==Download ICA-Atom vmserver ==

*Download ICA-Atom vmserver: [http://ica-atom.org/VEbuilds/ica-atom-vmserver-2009-12-09.tgz ica-atom-vmserver-2009-12-09.tgz] ([http://ica-atom.org/VEbuilds/md5sum.list md5])
*Unzip the ICA-atom-vmserver file. This should result in the following two files appearing in an ubuntu-vmserver folder:
**ubuntu.vmx
**disk0.vmdk

==Setup ICA-Atom in VirtualBox==
===Add vmserver image to VirtualBox===
*Open the Sun VirtualBox virtual machine.
*Click New
[[File:0-new.png]]

*Click Next
[[File:1-Start-vmserver-setup.png]]

*Enter a Name eg 'ICA-Atom'
*Set OS type as operating system 'Linux' version 'Ubuntu'
*Click Next
[[File:2-set-name-vmserver-setup.png]]

*Set Base Memory Size to '256MB'
*Click Next
[[File:3-set-mem-vmserver.png]]

*Select Use Existing Hard Disk
[[File:4-use-existing.png]]

*Click Folder/Arrow icon for Virtual Media Manager
[[File:5-click-folder-icon.png]]

*Click Add
[[File:6-virtual-media-manger-add.png]]

*Browse to location of disk0.vmdk and Click select/Open (ubuntu-vmserver folder)
*Highlight newly added disk and click select
[[File:7-select-disk.png]]

*Click Next
[[File:8-finish-add-vmserver.png]]

*Review Selections, click Finish
[[File:9-finish.png]]

*fin! ICA-Atom should be Visible on the left hand side of VirtualBox

===VirtualBox Networking===
====Host-Only Adapter====
*Right Click ICA-Atom in VirtualBox
*Choose Settings
[[File:0-settings.png]]

*Select Network
[[File:2-selectnetwork.png]]

*Choose 'Host-Only Adapter' in 'Attached to' drop down
[[File:3-select-host-only.png]]

*Click OK
[[File:5-click.OK.png]]

===Start The Machine===
*Click Start
[[File:0-start.png]]

*Wait for Boot to complete
[[File:1-complete-boot.png]]

*The ICA-Atom installer should be available here [http://192.168.56.101/ http://192.168.56.101/]
[[File:3-ica-atom.png]]

*To complete your ICA-Atom installation Please refer to these instructions: [http://qubit-toolkit.org/wiki/index.php?title=Installation Qubit Installation]
*Congratulations, you have a running copy of ICA-Atom! See the [[User_manual]] for instructions on how to use the software.

===Turn off virtual machine===
*At the end of your session, turn off the VirtualBox virtual machine by going to Machine > Close > and selecting one of the three shutdown options. It is best to choose either "Save the machine state" or "Send the shutdown signal". This is from the VirtualBox help manual:

<blockquote>3.4.3. Saving the state of the machine</blockquote>

<blockquote>When you click on the "Close" button of your virtual machine window (at the top right of the window, just like you would close any other window on your system) (or press the Host key together with "Q"), VirtualBox asks you whether you want to "save" or "power off" the VM.</blockquote>

<blockquote>The difference between these three options is crucial. They mean:</blockquote>

<blockquote>Save the machine state: With this option, VirtualBox "freezes" the virtual machine by completely saving its state to your local disk. When you later resume the VM (by again clicking the "Start" button in the VirtualBox main window), you will find that the VM continues exactly where it was left off. All your programs will still be open, and your computer resumes operation.</blockquote>

<blockquote>Saving the state of a virtual machine is thus in some ways similar to suspending a laptop computer (e.g. by closing its lid).</blockquote>

<blockquote>Send the shutdown signal. This will send an ACPI shutdown signal to the virtual machine, which has the same effect as if you had pressed the power button on a real computer. So long as a fairly modern operating system is installed and running in the VM, this should trigger a proper shutdown mechanism in the VM.</blockquote>

<blockquote>Power off the machine: With this option, VirtualBox also stops running the virtual machine, but without saving its state.</blockquote>

<blockquote>This is equivalent to pulling the power plug on a real computer without shutting it down properly. If you start the machine again after powering it off, your operating system will have to reboot completely and may begin a lengthy check of its (virtual) system disks.</blockquote>

<blockquote>As a result, this should not normally be done, since it can potentially cause data loss or an inconsistent state of the guest system on disk.</blockquote>

<blockquote>The "Discard" button in the main VirtualBox window discards a virtual machine's saved state. This has the same effect as powering it off, and the same warnings apply.</blockquote>

=Instructions for using the KVM image=

==Install KVM==
*There are KVM is apart of the Linux Kernal, check with your distribution for installation methods.
===For Ubuntu/Debian===
*Run the following to check if your processor supports KVM (if nothing is printed you can not use KVM)
<pre>$ egrep '(vmx|svm)' --color=always /proc/cpuinfo</pre>

*Install KVM
<pre>$ sudo aptitude install kvm </pre>

==Download ICA-Atom kvm ==

*Download ICA-Atom kvm: [http://ica-atom.org/VEbuilds/ica-atom-kvm-2009-12-09.tgz ica-atom-kvm-2009-12-09.tgz] ([http://ica-atom.org/VEbuilds/md5sum.list md5])
*Unzip the ICA-atom-kvm file. This should result in the following two files appearing in an ubuntu-kvm folder:
**disk0.qcow2
**run.sh < this file can be modified to preserve settings

==Run ICA-Atom in KVM==
*change directory to the location of KVM image,

<pre>$ cd /path/to/image/ubuntu-kvm/</pre>

*start kvm ica-atom instance (-m sets the memory in MB in this case 256MB, -redir tells the host machine to direct port 8000 to 80 on the guest instance)

<pre>$ sudo kvm -m 256 -redir tcp:8000::80 disk0.qcow2</pre>

*wait until the machine is completely booted (you will see Ubuntu shell login)

*ica-atom is now reachable at http://localhost:8000

ICA-AtoM virtual appliance

2009-12-20T01:02:44Z

Austin:

2009-12-20T00:16:10Z

Austin:

File:1-complete-boot.png

2009-12-20T00:15:35Z

Austin:

File:0-start.png

2009-12-20T00:15:11Z

Austin:

Download demo VE

2009-12-19T23:56:06Z

Austin: moved Download demo VE to Download VE

#REDIRECT [[Download VE]]

ICA-AtoM virtual appliance

2009-12-19T23:56:06Z

Austin: moved Download demo VE to Download VE

=Instructions for using the vmserver image=

==Install Sun Virtual Box==

*There are VirtualBox versions available for every major operating system.
**Download and install Sun VirtualBox: [http://dlc.sun.com/virtualbox/vboxdownload.html http://dlc.sun.com/virtualbox/vboxdownload.html].

==Download ICA-Atom vmserver ==

*Download ICA-Atom vmserver: [http://ica-atom.org/VEbuilds/ica-atom-vmserver-2009-12-09.tgz ica-atom-vmserver-2009-12-09.tgz]
*Unzip the ICA-atom-vmserver file. This should result in the following two files appearing in an ubuntu-vmserver folder:
**ubuntu.vmx
**disk0.vmdk

==Setup ICA-Atom in VirtualBox==
===Add vmserver image to VirtualBox===
*Open the Sun VirtualBox virtual machine.
*Click New
[[File:0-new.png]]

*Click Next
[[File:1-Start-vmserver-setup.png]]

*Enter a Name eg 'ICA-Atom'
*Set OS type as operating system 'Linux' version 'Ubuntu'
*Click Next
[[File:2-set-name-vmserver-setup.png]]

*Set Base Memory Size to '256MB'
*Click Next
[[File:3-set-mem-vmserver.png]]

*Select Use Existing Hard Disk
[[File:4-use-existing.png]]

*Click Folder/Arrow icon for Virtual Media Manager
[[File:5-click-folder-icon.png]]

*Click Add
[[File:6-virtual-media-manger-add.png]]

*Browse to location of disk0.vmdk and Click select/Open (ubuntu-vmserver folder)
*Highlight newly added disk and click select
[[File:7-select-disk.png]]

*Click Next
[[File:8-finish-add-vmserver.png]]

*Review Selections, click Finish
[[File:9-finish.png]]

*fin! ICA-Atom should be Visible on the left hand side of VirtualBox

===VirtualBox Networking===
====Host-Only Adapter====
*Right Click ICA-Atom in VirtualBox
*Choose Settings
[[File:0-settings.png]]

*Select Network
[[File:2-selectnetwork.png]]

*Choose 'Host-Only Adapter' in 'Attached to' drop down
[[File:3-select-host-only.png]]

*Click OK
[[File:5-click.OK.png]]

===Start The Machine===
*Click Start

*Wait for Boot to complete

*login as user demo with password demo

**You may have to log in using the user name ''demo'' and the password ''demo''.
**If your mouse pointer does not appear to be working in the virtual machine, click the letter f while holding down the right-hand control button. Do the same thing to switch back to using your mouse pointer outside the virtual box.
*Congratulations, you have a running copy of Archivematica! See [[Documentation]] for instructions on how to use the software.

===Turn off virtual machine===
*At the end of your session, turn off the VirtualBox virtual machine by going to Machine > Close > and selecting one of the three shutdown options. It is best to choose either "Save the machine state" or "Send the shutdown signal". This is from the VirtualBox help manual:

<blockquote>3.4.3. Saving the state of the machine</blockquote>

<blockquote>When you click on the "Close" button of your virtual machine window (at the top right of the window, just like you would close any other window on your system) (or press the Host key together with "Q"), VirtualBox asks you whether you want to "save" or "power off" the VM.</blockquote>

<blockquote>The difference between these three options is crucial. They mean:</blockquote>

<blockquote>Save the machine state: With this option, VirtualBox "freezes" the virtual machine by completely saving its state to your local disk. When you later resume the VM (by again clicking the "Start" button in the VirtualBox main window), you will find that the VM continues exactly where it was left off. All your programs will still be open, and your computer resumes operation.</blockquote>

<blockquote>Saving the state of a virtual machine is thus in some ways similar to suspending a laptop computer (e.g. by closing its lid).</blockquote>

<blockquote>Send the shutdown signal. This will send an ACPI shutdown signal to the virtual machine, which has the same effect as if you had pressed the power button on a real computer. So long as a fairly modern operating system is installed and running in the VM, this should trigger a proper shutdown mechanism in the VM.</blockquote>

<blockquote>Power off the machine: With this option, VirtualBox also stops running the virtual machine, but without saving its state.</blockquote>

<blockquote>This is equivalent to pulling the power plug on a real computer without shutting it down properly. If you start the machine again after powering it off, your operating system will have to reboot completely and may begin a lengthy check of its (virtual) system disks.</blockquote>

<blockquote>As a result, this should not normally be done, since it can potentially cause data loss or an inconsistent state of the guest system on disk.</blockquote>

<blockquote>The "Discard" button in the main VirtualBox window discards a virtual machine's saved state. This has the same effect as powering it off, and the same warnings apply.</blockquote>

ICA-AtoM virtual appliance

2009-12-19T23:47:14Z

2009-10-22T23:24:37Z

Austin:

[[wikipedia:Virtual appliance]]

http://ica-atom.org/dailyVEbuilds/

http://www.mediawiki.org/wiki/Software_appliances

http://codex.gallery2.org/Gallery:Appliance

<pre>
(03:28:31 PM) jack.bates: hoi Austin - i wanna give the ica-atom virtual appliance a try - where do i start?
(03:29:08 PM) Austin: what kind of host system are you using?
(03:29:18 PM) jack.bates: debian
(03:29:37 PM) Austin: processor type? core 2? or similar?
(03:29:53 PM) jack.bates: eeepc
(03:30:01 PM) Austin: ok, you can use qemu
(03:30:16 PM) Austin: with the kvm image
(03:30:24 PM) jack.bates: cool
(03:30:27 PM) ***jack.bates downloads
(03:30:45 PM) jack.bates: how do i run the image?
(03:34:11 PM) Austin: sudo qemu -m 256 -drive file=disk0.qcow2 -redir tcp:8000::80
(03:34:15 PM) Austin: or/
(03:35:06 PM) Austin: sudo qemu -m 256 -redir tcp:8000::80 disk0.qcow2
(03:35:55 PM) jack.bates: cool - thanks!
(03:36:16 PM) Austin: I havnt actually tested under qemu.. but Im pretty sure the commands are identical to kvm
(03:36:24 PM) jack.bates: ok
(03:36:54 PM) jack.bates: what should i download at home - host os is debian, processor is core 2?
(03:37:50 PM) Austin: kvm image as well..
(03:38:03 PM) Austin: s/kvm/qemu/g with the above instructions
(03:38:36 PM) jack.bates: sweet, thanks
(03:39:39 PM) jack.bates: how about on the windows machine in the office?
(03:40:39 PM) Austin: the vmserver version with virtualbox
(03:40:57 PM) jack.bates: cool
(03:47:36 PM) Austin: I just tested in qemu the first time I tried to boot I got this error https://bugs.launchpad.net/ubuntu/+source/linux/+bug/283489
(03:48:59 PM) Austin: but.. on boot you can escape into grub.. and add a noapic option..
(03:49:28 PM) Austin: jack.bates something like >> kernel /boot/vmlinuz-2.6.12-10-686 root=/dev/hda2 ro quiet splash noapic
(03:49:46 PM) jack.bates: awesome - /me tries
</pre>

=== KVM (Linux) ===
See: [http://www.linux-kvm.org/page/HOWTO KVM HowTos], for information on running KVM on your host machine.

'''From the command line''':

1. Change directory to the location of KVM image
<pre>cd /path/to/image/ubuntu-kvm/</pre>

2. start kvm ica-atom instance (-m sets the memory in MB in this case 256MB, -redir tells the host machine to direct port 8000 to 80 on the guest instance)
<pre>sudo kvm -m 256 -redir tcp:8000::80 disk0.qcow2</pre>

3. wait until the machine is completely booted(you will see ubuntu shell login)

4. ica-atom is now reachable at http://localhost:8000

=== VirtualBox (Windows/OSX/Linux/Sun) ===

# Click ''New''
# Select ''Operating System'' '''Linux'''
# Select ''Version'' '''Ubuntu'''
# Click ''Use existing hard disk''
# Click folder icon to browse hard disks
# Click ''Add'' to add new hard disk
# Select downloaded virtual appliance
# Click ''Select''
# Click ''Finish''

To access ICA-AtoM from the host operating system,

# Select new appliance
# Click ''Settings''
# Click ''Network''
# Select ''Attached to'' '''Host-only Adapter'''
# Click OK

=== Xen (Linux/FreeBSD) ===
See: [http://wiki.xensource.com/xenwiki/HowTos Xen HowTos], for information on running Xen on your host machine.

=== VMware (Windows/OSX/Linux) ===
...Please pardon our dust...