Install-1.2-packages - Revision history

Jhs: /* Installing Archivematica 1.2 packages (new install) */

2014-09-18T23:21:50Z

Installing Archivematica 1.2 packages (new install)

Jhs: /* Update Archivematica */

2014-09-18T23:00:17Z

Update Archivematica

Jhs at 18:51, 15 September 2014

2014-09-15T18:51:18Z

Mdemeo: Provide instructions to start/restart FITS

2014-08-08T18:50:41Z

Provide instructions to start/restart FITS

Mdemeo: Create page by copying 1.1 contents and tweaking

2014-08-08T18:33:34Z

Create page by copying 1.1 contents and tweaking

New page

[[Installation]] >> [[Install-1.2|Install 1.2]] >> Install 1.2 packages

== Updating from Archivematica 1.1 ==

If you have installed Archivematica 1.1.0 from packages, it is possible to update your installation without re-installing. The steps are:

=== Update Archivematica Storage Service ===
<pre>
sudo apt-get update
sudo apt-get install archivematica-storage-service
</pre>

=== Update Archivematica ===
During the update process you will be asked about updating configuration files. Choose to accept the maintainers versions. You will also be asked about updating the database, say 'ok' to each of those steps. If you have set a password for the root mysql database user, enter it when prompted.
<pre>
sudo apt-get install archivematica-mcp-server
sudo apt-get install archivematica-mcp-client
sudo apt-get install archivematica-dashboard
</pre>

=== Update ElasticSearch ===

Archivematica 1.2.0 has been tested most extensively against version 0.90.13 of ElasticSearch. It is possible to use an older version (e.g. 0.20.6, which is what was distributed with Archivematica 1.0.0). Do not attempt to use ElasticSearch 1.0 or greater.

*Add the ElasticSearch apt repository next (from http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/setup-repositories.html):
<pre>
sudo wget -O - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -
</pre>
Then add this line to the bottom of /etc/apt/sources.list
<pre>
deb http://packages.elasticsearch.org/elasticsearch/0.90/debian stable main
</pre>
Now refresh your list of available packages and upgrade elasticsearch
<pre>
sudo apt-get update
sudo apt-get install elasticsearch
</pre>

=== Restart Services ===
<pre>
sudo service uwsgi restart
sudo service nginx restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/elasticsearch restart
sudo /etc/init.d/gearman-job-server restart
sudo restart archivematica-mcp-server
sudo restart archivematica-mcp-client
</pre>

== Installing Archivematica 1.2 packages (new install) ==

Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive). In order to install software onto your Ubuntu 12.04.4 system from a PPA:

*Add the archivematica/release PPA to your list of trusted repositories (if add-apt-repositories is not available you must install python-software-properties first):
<pre>
sudo apt-get update
sudo apt-get install python-software-properties
sudo add-apt-repository ppa:archivematica/release
sudo add-apt-repository ppa:archivematica/externals
</pre>

*Add the ElasticSearch apt repository next (from http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/setup-repositories.html):
<pre>
sudo wget -O - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -
</pre>
Then add this line to the bottom of /etc/apt/sources.list
<pre>
deb http://packages.elasticsearch.org/elasticsearch/0.90/debian stable main
</pre>

*Update your system to the most recent 12.04 release

*This step will also fetch a list of the software from the PPAs you just added to your system.

<pre>
sudo apt-get update
sudo apt-get upgrade
</pre>

* Install all packages (each of these packages can be installed seperately, if necessary). Say YES or OK to any prompts you get after entering the following into terminal:
<pre>
sudo apt-get install archivematica-storage-service
sudo apt-get install elasticsearch
sudo apt-get install archivematica-mcp-server
sudo apt-get install archivematica-mcp-client
sudo apt-get install archivematica-dashboard
</pre>

* Configure the dashboard and storage service
note:these steps are safe to do on a desktop, or a machine dedicated to Archivematica. They may not be advisable on an existing web server. Consult with your web server administrator if you are unsure.

<pre>
sudo wget -q https://raw.github.com/artefactual/archivematica/stable/1.1.x/src/vm-includes/share/apache.default -O /etc/apache2/sites-available/default
sudo rm /etc/nginx/sites-enabled/default
sudo ln -s /etc/nginx/sites-available/storage /etc/nginx/sites-enabled/storage
sudo ln -s /etc/uwsgi/apps-available/storage.ini /etc/uwsgi/apps-enabled/storage.ini
sudo service uwsgi restart
sudo service nginx restart
sudo /etc/init.d/apache2 restart
sudo freshclam
sudo /etc/init.d/clamav-daemon start
sudo /etc/init.d/elasticsearch restart
sudo /etc/init.d/gearman-job-server restart
sudo start archivematica-mcp-server
sudo start archivematica-mcp-client
</pre>

* Test the [[Administrator_manual_1.2#Storage_service|storage service]]
The storage service runs as a separate web application from the Archivematica dashboard. Go to the following link in a web browser:

http://localhost:8000 (or use the IP address of the machine you have been installing on). <p>
log in as user: test password: test

* Create a new administrative user in the Storage service

The storage service has its own set of users. In the User menu in the Administrative tab of the storage service, add at least one administrative user, and delete or modify the test user.

* Test the dashboard
you can login to the archivematica dashboard and finish the installation in a web browser:

http://localhost

* Register your installation for full Format Policy Registry interoperability.

[[Register_1.2|Register Archivematica 1.2]]

== Using ICA-AtoM with Archivematica ==

If you are interested in using the [https://www.ica-atom.org/ ICA-Atom] web-based content management and access system you can use the package within our PPA. Archivematica can upload digital objects to their associated descriptions in ICA-AtoM.

It is installed by running the following commands in your Terminal (answer yes to all prompts, it may require your mysql adminitration password if one was entered above):
<pre>
sudo aptitude install ica-atom
sudo aptitude install upload-qubit
sudo /etc/init.d/apache2 restart
sudo cp /var/www/atom/init/atom-worker.conf /etc/init/atom-worker.conf
</pre>

You can finish your installation by visiting http://localhost/ica-atom/. For more information about ICA-AtoM installation see [https://www.ica-atom.org/doc/Installation ICA-AtoM 1.3.1 installation].

Occasionally when loading the ica-atom web installer for the first time an error appears, refreshing your web browser usually resolves this. We intend to fix this in future version of the AtoM package.

After the AtoM installation, configure it to use the Sword plugin (in the Plugins menu) as well as the job scheduler (in Settings), then start the atom-worker:

<pre>
sudo start atom-worker
</pre>

== Using AtoM 2.x with Archivematica ==

Archivematica has been successfully tested with Atom 2.x. The best known configuration is Archivematica 1.0.1 or greater with Atom 2.0.2-rc1 or greater.
Installation instructions for Atom 2 are available on the accesstomemory.org website https://www.accesstomemory.org/en/docs/2.0/ . When following those instructions, it is best to download Atom from the git repository (rather than use one of the supplied tarballs). When checking out Atom, use tag v2.0.2-rc1.

Once you have a working Atom installation, you can configure dip upload between Archivematica and Atom. The basic steps are:

* update atom dip upload configuration in the Archivematica dashboard
* confirm upload-qubit package is installed on the Archivematica server
* confirm atom-worker is configured on the Atom server
* enable the Sword Plugin in the Atom plugins page
* enable job scheduling in the Atom settings page
* confirm gearman is installed on the Atom server
* configure ssh keys to allow rsync to work for the archivematica user, from the Archivematica server to the Atom server
* start gearman on the Atom server
* start the atom worker on the Atom server

These steps are detailed on the [[Upload_DIP|DIP Upload page]].

@@ Line 12: / Line 12: @@
 === Update Archivematica ===
 During the update process you may be asked about updating configuration files.  Choose to accept the maintainers versions.  You will also be asked about updating the database, say 'ok' to each of those steps.  If you have set a password for the root mysql database user, enter it when prompted.  It is better to update the dashboard before updating the mcp components
 <pre>

@@ Line 54: / Line 54: @@
 sudo add-apt-repository ppa:archivematica/externals
 </pre>
 *Add the ElasticSearch apt repository next (from http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/setup-repositories.html):

@@ Line 12: / Line 12: @@
 === Update Archivematica ===
-During the update process you will be asked about updating configuration files.  Choose to accept the maintainers versions.  You will also be asked about updating the database, say 'ok' to each of those steps.  If you have set a password for the root mysql database user, enter it when prompted.
+During the update process you may be asked about updating configuration files.  Choose to accept the maintainers versions.  You will also be asked about updating the database, say 'ok' to each of those steps.  If you have set a password for the root mysql database user, enter it when prompted.  It is better to update the dashboard before updating the mcp components
 <pre>
 sudo apt-get install archivematica-mcp-server
 sudo apt-get install archivematica-mcp-client
-sudo apt-get install archivematica-dashboard
 </pre>
-=== Update ElasticSearch ===
+=== Update ElasticSearch (optional) ===
-Archivematica 1.2.0 has been tested most extensively against version 0.90.13 of ElasticSearch.  It is possible to use an older version (e.g. 0.20.6, which is what was distributed with Archivematica 1.0.0).  Do not attempt to use ElasticSearch 1.0 or greater.
+Archivematica 1.2.0 has been tested most extensively against version 0.90.13 of ElasticSearch.  This is the same version that was distributed with Archivematica 1.1.0, so no changes to ElasticSearch should be required in most cases.  Do not attempt to use ElasticSearch 1.0 or greater.
 === Restart Services ===
@@ Line 51: / Line 39: @@
 == Installing Archivematica 1.2 packages (new install) ==
-Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive).  In order to install software onto your Ubuntu 12.04.4 system from a PPA:
+Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive).  In order to install software onto your Ubuntu 12.04.5 system from a PPA:
 *Add the archivematica/release PPA to your list of trusted repositories (if add-apt-repositories is not available you must install python-software-properties first):
@@ Line 70: / Line 58: @@
 </pre>
-*Update your system to the most recent 12.04 release
+*Update your system to the most recent 12.04 release (12.04.5 at the time of this writing).
 *This step will also fetch a list of the software from the PPAs you just added to your system.
@@ Line 92: / Line 80: @@
 <pre>
-sudo wget -q https://raw.github.com/artefactual/archivematica/stable/1.1.x/src/vm-includes/share/apache.default -O /etc/apache2/sites-available/default
+sudo wget -q https://raw.githubusercontent.com/artefactual/archivematica/stable/1.2.x/localDevSetup/apache/apache.default -O /etc/apache2/sites-available/default
 sudo rm /etc/nginx/sites-enabled/default
 sudo ln -s /etc/nginx/sites-available/storage /etc/nginx/sites-enabled/storage
@@ Line 121: / Line 109: @@
 you can login to the archivematica dashboard and finish the installation in a web browser:
-http://localhost
+http://localhost (again, use the IP address of the machine you have been installing on)
 * Register your installation for full Format Policy Registry interoperability.
@@ Line 127: / Line 115: @@
 [[Register_1.2|Register Archivematica 1.2]]
-== Using ICA-AtoM with Archivematica ==
+== Using AtoM 2.x with Archivematica ==
-<pre>
+Archivematica has been successfully tested with [https://www.accesstomemory.org AtoM 2.x].  The best known configuration is Archivematica 1.2.0 with AtoM deployed from the stable/2.0.x branch. Archivematica has been successfully tested with the qa/2.1.x branch.
-Archivematica has been successfully tested with Atom 2.x.  The best known configuration is Archivematica 1.0.1 or greater with Atom 2.0.2-rc1 or greater.
+Installation instructions for Atom 2 are available on the accesstomemory.org website https://www.accesstomemory.org/en/docs/2.0/ .  When following those instructions, it is best to download Atom from the git repository (rather than use one of the supplied tarballs). When checking out Atom, use the head of either the stable/2.0.x or qa/2.1.x branch.
-Once you have a working Atom installation, you can configure dip upload between Archivematica and Atom.  The basic steps are:
+Once you have a working AtoM installation, you can configure dip upload between Archivematica and Atom.  The basic steps are:
 * update atom dip upload configuration in the Archivematica dashboard
-* confirm upload-qubit package is installed on the Archivematica server
+* confirm atom-worker is configured on the Atom server (copy the atom-worker.conf file from atom source to /etc/init/)
-* confirm atom-worker is configured on the Atom server
+* enable the Sword Plugin in the AtoM plugins page
-* enable the Sword Plugin in the Atom plugins page
+* enable job scheduling in the AtoM settings page
-* enable job scheduling in the Atom settings page
+* confirm gearman is installed on the AtoM server
 * configure ssh keys to allow rsync to work for the archivematica user, from the Archivematica server to the Atom server
 * start gearman on the Atom server

@@ Line 46: / Line 46: @@
 sudo restart archivematica-mcp-server
 sudo restart archivematica-mcp-client
 </pre>
@@ Line 104: / Line 105: @@
 sudo start archivematica-mcp-server
 sudo start archivematica-mcp-client
 </pre>