Virtual appliance instructions - Revision history

Hbecker: Make deprecation warning more visible.

2016-06-20T18:57:07Z

Make deprecation warning more visible.

Sromkey: Made link to newer install instructions more clear.

2016-05-15T21:54:39Z

Made link to newer install instructions more clear.

Courtney at 14:33, 16 September 2014

2014-09-16T14:33:24Z

Courtney at 18:11, 30 July 2013

2013-07-30T18:11:19Z

Courtney at 18:10, 30 July 2013

2013-07-30T18:10:15Z

Courtney: /* Start Archivematica virtual appliance */

2013-07-30T18:07:26Z

Start Archivematica virtual appliance

Courtney: /* Start Archivematica virtual appliance */

2013-07-30T18:06:47Z

Start Archivematica virtual appliance

Courtney at 17:25, 30 July 2013

2013-07-30T17:25:21Z

Courtney at 17:10, 30 July 2013

2013-07-30T17:10:02Z

Courtney: /* Start Archivematica virtual appliance */

2013-07-30T17:08:45Z

Start Archivematica virtual appliance

@@ Line 1: / Line 1: @@
 [[Main Page]] > Virtual appliance instructions
+{| class="wikitable" style="background-color:#ffcccc; font-size: 120%; font-weight: bold; " cellpadding="10"
-== Please note: Virtual appliance instructions were for last beta release: 0.10 - these notes are no longer supported. Instead please see: [[Getting started]] ==
+| Please note: Virtual appliance instructions were for last beta release: 0.10 - these notes are no longer supported. Instead please see: [[Getting started]]
 = Distribution as a Virtual Appliance =

@@ Line 1: / Line 1: @@
 [[Main Page]] > Virtual appliance instructions
---Virtual appliance instructions were for last beta release: 0.10 - these notes are no longer supported.--
 = Distribution as a Virtual Appliance =

← Older revision		Revision as of 14:33, 16 September 2014
Line 1:		Line 1:
	[[Main Page]] > Virtual appliance instructions		[[Main Page]] > Virtual appliance instructions

		+	--Virtual appliance instructions were for last beta release: 0.10 - these notes are no longer supported.--

	= Distribution as a Virtual Appliance =		= Distribution as a Virtual Appliance =

@@ Line 97: / Line 97: @@
 '''Important:'''</br> Archivematica may appear to crash when used as a virtual appliance. See Ubuntu login reset issue, below.
 </div>
 === Permissions ===

← Older revision		Revision as of 18:10, 30 July 2013
Line 112:		Line 112:
	At a minimum, your deposited files should have the following permissions in order to upload them to the dashboard through source directories in the administration tab: rw-rw---- or rwxrwx---		At a minimum, your deposited files should have the following permissions in order to upload them to the dashboard through source directories in the administration tab: rw-rw---- or rwxrwx---

−	~~===Using SFTP===~~
−
−	It's possible to use [http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol SSH File Transfer Protocol] (SFTP), through an [http://en.wikipedia.org/wiki/FTP_client FTP client] to upload your own content from your computer to the virtual desktop where Archivematica is running:
−
−	~~<ol>~~
−	~~<li> While in virtualbox right click the archivematica virtualmachine and click settings~~
−	~~<li> Click the 'Network' tab~~
−	~~<li> 'Adapter 1' should be set to NAT by default(this allows you to get to the internet), click on 'Adapter 2' tab~~
−	~~<li> Click enable adapter and set attached to 'host only adapter'~~
−	~~</br>~~
−	~~[[File:Selecting_host_only_adapter.png]]~~
−	~~</br>~~
−	~~<li> Power up the archivematica virtualmachine~~
−	~~<li> Once in the xubuntu interface goto Applications > Accessories > Terminal~~
−
−	~~<div class="note">~~
−	~~<strong>Having trouble locating the Applications menu?<strong></br>~~
−	You can find applications by clicking on the little blue logo in the top left-hand corner of the virtual desktop: [[File:applications_menu_icon.png]]. Alternately, you can access the terminal by simply right-clicking anywhere in the virtual desktop, and selecting "Open terminal here."
−	~~</div>~~
−
−	~~[[File:applications_accessories_terminal.png]]~~
−	~~</br>~~
−
−	~~<li> Type the following in terminal (the password is demo) - this will take a minute and requires internet~~
−	~~<pre>sudo aptitude install ssh </pre>~~
−
−	~~<div class="note"> <strong>Update packages?</strong></br>~~
−	~~If the terminal asks you to update and/or install new packages, do so. Hit "y" and return. </br>~~
−	~~[[File:package_updates.png]]</br>~~
−
−	~~</div>~~
−	~~</br>~~
−
−	~~<li> type "ifconfig" in the terminal. You should see an IP address like '192.168.56.101' (likely eth1 interface)~~
−	~~<pre>~~
−	~~$ ifconfig~~
−	~~eth1 Link encap:Ethernet HWaddr fe:54:00:9d:92:64~~
−	~~inet addr:192.168.56.101 Bcast:192.168.56.255 Mask:255.255.255.0~~
−	~~inet6 addr: fe80::1c6b:7bff:fe07:ddb6/64 Scope:Link~~
−	~~UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1~~
−	~~RX packets:24 errors:0 dropped:0 overruns:0 frame:0~~
−	~~TX packets:45 errors:0 dropped:0 overruns:0 carrier:0~~
−	~~collisions:0 txqueuelen:0~~
−	~~RX bytes:1400 (1.4 KB) TX bytes:5815 (5.8 KB)~~
−	~~</pre>~~
−
−	~~</br>~~
−	<li> From here, your machine should be connectable via SFTP. Download an SFTP client; a popular open-source option is [http://filezilla-project.org/ FileZilla], which works on Linux and Windows. If you are using Apple's OSX or higher, [http://cyberduck.ch/ Cyberduck] is reported to be a decent open-source SFTP client.
−
−	~~</br>~~
−	~~<div class="note"> <strong>SFTP 101: Whats am I setting up here?</strong></br>~~
−	[http://en.wikipedia.org/wiki/File_Transfer_Protocol File Transfer Protoco]l (FTP) "is a standard network protocol used to transfer files from one host or to another host over a TCP-based network, such as the Internet" (Wikipedia). In this case, you will be using SFTP to transfer your files, which is an FTP protocol that uses a [http://en.wikipedia.org/wiki/Secure_Shell Secure Shell (SSH)] extension for more secure data transmission. When you use FizeZilla or Cyberduck, you are using an [http://en.wikipedia.org/wiki/Comparison_of_FTP_client_software FTP client]that provides a graphical user interface ([http://en.wikipedia.org/wiki/Graphical_user_interface GUI]) to allow you to move files easily from one host (in this case, your computer) to another (the virtual desktop).
−	~~</div>~~
−
−
−	~~<li> The connection information should be as follows~~
−	~~<pre>~~
−	~~username: demo~~
−	~~password: demo~~
−	~~IP/Hostname: 192.168.56.101 < results of ifconfig likely '192.168.56.*'~~
−	~~port: 22~~
−	~~destination folder: /home/demo/ < if this is not set you will have to navigate to /home/demo directory~~
−	~~</pre>~~
−	~~</br>~~
−	* Here is an example of setting up the connection information in <strong>FileZilla</strong>.
−
−	~~</br>~~
−	~~[[File:FileZilla_SFTP.png]]~~
−	~~</br>~~
−
−	* Note that the username, password, and host are all input into the top of the FileZilla browser.
−	* In FileZilla, your home computer's directory is displayed on the left hand side, while Archivematica's virtual appliance directory is on the right hand side. Once the connection is established, you can drag and drop content from one side to the other to upload content.
−	* If you require more support using FileZilla, please visit their documentation wiki [http://wiki.filezilla-project.org/Main_Page here].
−	* If you have dragged your content to the <strong>/home/demo </strong> folder, you can find your content in the Archivematica virtual appliance window by clicking on the "Home" icon on the desktop:
−	~~</br>~~
−	~~[[File:home_demo_filezilla.png]]~~
−	~~</br>~~
−	~~</br>~~
−	* Here is an example of setting up the connection information in <strong>Cyberduck</strong>:
−	~~[[File:CDconnect.png]]~~
−	*Cyberduck will only show one directory, so you may have to click on the Action button and select "Upload" to change the display and reveal Archivematica's directory.
−	~~[[File:CDhome-demo.png]]~~
−	*You will need to create a new folder inside an existing Media folder to upload your media files into. For example, double click on the arrow to open the "Pictures" folder and then create new folder in it and upload your digital images.
−	~~[[File:CDuploadfolder.png]]~~
−	*All further actions will occur in the <b>Archivematica dashboard</b> and instructions can be found in the User Manual under [https://www.archivematica.org/wiki/UM_transfer Transfer].
−	~~</br>~~

	==Turn off virtual machine==		==Turn off virtual machine==

@@ Line 57: / Line 57: @@
 <li>Click Continue</li>
 <li>Select 'Use existing hard disk' and browse to and select archivematica-0.10-beta.vmdk</li>
 <li>Click Continue. Review Summary and Click Create</li>
 <li>The virtual box will open with Archivematica 0.10-beta listed on the left-hand side (in some cases "archivematica" will be listed on the left-hand side). Select Archivematica 0.10-beta and click Start (the green arrow in the menu).</li>
 [[File:6_start_archivematica_VM.png]]

@@ Line 56: / Line 56: @@
 <li>Click Continue</li>
-<li>Select 'Use existing hard disk' and browse to and select archivematica-0.9-beta.vmdk</li>
+<li>Select 'Use existing hard disk' and browse to and select archivematica-0.10-beta.vmdk</li>
 [[File:4_use_exist_hardisk_select_archivematica.png]]
 <li>Click Continue. Review Summary and Click Create</li>
@@ Line 99: / Line 99: @@
 '''Important:'''</br> Archivematica may appear to crash when used as a virtual appliance. See Ubuntu login reset issue, below.
 </div>
 ==Import files into virtual appliance (optional)==

@@ Line 74: / Line 74: @@
 </br>
 [[File:inside_the_VM.png]]
-<li>From here it is suggested that you use your external browser to access the archivematica dashboard (see '''Ubuntu login reset issue''', below)</li>
+<li>From here it is suggested that you use your external browser to access the archivematica dashboard. Due to an issue with the Ubuntu 12.04.1 desktop, we suggest you add settings to allow the Archivematica dashboard and ICA-AtoM to be accessed from your web browser, outside of the virtual machine. The steps are as follows [Please note, you may need to adjust your virtualbox preferences prior to taking this step. To do so, simply go to the network section of virtualbox preferences and click the "add" button, then save your change):
 <ol>
@@ Line 101: / Line 88: @@
 <li> In your web browser, go to the url http://192.168.56.101/transfer/ (there is no need to login to the Archivematica virtual machine first). For ICA-AtoM, go to http://192.168.56.101/ica-atom/.
 <li>Congratulations! You can now use both Archivematica and ICA-AtoM via your web browser.
 </ol>
 ==Import files into virtual appliance (optional)==

@@ Line 15: / Line 15: @@
 *Processor: Intel core 2 or AMD Opteron
-*Memory: 1 GB for the virtual appliance ('guest') operating system, i.e: if the 'host' operating system has 2 GB available, 1 GB needs to allocated to the 'guest'. Depending on the operating system, machines with less than 2 GB total memory will likely have trouble running Archivematica. Note that the default allocation setting in Archivematica is 512 MB; however, the more that is allocated the better the system will run. The setting can be changed once Archivematica is running.
+*Memory: 2 GB for the virtual appliance ('guest') operating system, i.e: if the 'host' operating system has 4 GB available, 2 GB needs to allocated to the 'guest'. Depending on the operating system, machines with less than 2 GB total memory will likely have trouble running Archivematica. Note that the default allocation setting in Archivematica is 512 MB; 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 3 GB to test the system on a small scale (i.e. use the available test files or import a small set of test files); 12 GB or more for larger implementations
@@ Line 60: / Line 60: @@
 <li>Click Continue. Review Summary and Click Create</li>
 [[File:5_review_click_create.png]]
-<li>The virtual box will open with Archivematica 0.10-beta listed on the left-hand side (in some cases "archivematica" will be listed on the left-hand side). Select Archivematica 0.9-beta and click Start (the green arrow in the menu).</li>
+<li>The virtual box will open with Archivematica 0.10-beta listed on the left-hand side (in some cases "archivematica" will be listed on the left-hand side). Select Archivematica 0.10-beta and click Start (the green arrow in the menu).</li>
 [[File:6_start_archivematica_VM.png]]