Difference between revisions of "Install-1.0-packages"

From Archivematica
Jump to navigation Jump to search
(Created page with "Deploying Archivematica 1.0 packages Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive). There are a number of Archivematica PPA's, ...")
 
 
(45 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Deploying Archivematica 1.0 packages
+
[[Installation]] >> [[Install-1.0|Install 1.0]] >> Install 1.0 packages
  
Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive).  There are a number of Archivematica PPA's, the test versions of Archivematica 1.0 packages are hosted in the archivematica/daily ppa.  In order to install software onto your Ubuntu 12.04 system from this PPA:
+
== Deploying Archivematica 1.0 packages ==
  
* Update your system to the most recent 12.04 release (12.04.3)
+
Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive).  There are a number of Archivematica PPA's, the Archivematica 1.0 packages are hosted in the archivematica/release ppa.  In order to install software onto your Ubuntu 12.04.3 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 (12.04.3 has been tested and works, but Artefactual has not yet verified 12.04.4).  These instructions have been tested on both 32 bit and 64 bit versions of Ubuntu server. 
 +
*This step will also fetch a list of the software from the archivematica/release
 +
 +
<pre>
 
sudo apt-get update
 
sudo apt-get update
 
sudo apt-get upgrade
 
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 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.
  
* Add the archivematica/daily PPA to your list of trusted repositories:
+
<pre>
 +
sudo wget -q https://raw.github.com/artefactual/archivematica/stable/1.0.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>
  
sudo add-apt-repository ppa:archivematica/daily
+
* Test the [[Administrator_manual_1.0#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:
  
(for the final release, use ppa:archivematica/release )
+
http://localhost:8000  (or use the ip address of the machine you have been installing on).  <p>
 +
log in as user: test password: test
  
* Fetch a list of the software from the archivematica/daily ppa:
+
* Create a new administrative user in the Storage service
  
sudo apt-get update
+
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.
  
* Install the storage service
+
* Test the dashboard
 +
you can login to the archivematica dashboard and finish the installation in a web browser:
  
normally you would just do:
+
http://localhost
sudo apt-get install archivematica-storage-service
 
  
but for now it is necessary to do:
+
* Register your installation for full Format Policy Registry interoperability.
  
sudo apt-get install nginx uwsgi uwsgi-python-plugin
+
[[Register_1.0|Register Archivematica 1.0]]
sudo dpkg -i archivematica-storage-service_0.2.2ppa8_all.deb
 
  
* Configure the storage service
+
== Using ICA-AtoM with Archivematica ==
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.
 
  
sudo rm /etc/nginx/sites-enabled/default
+
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.
sudo ln -s /etc/nginx/sites-enabled/storage /etc/nginx/sites-available/storage
 
sudo ln -s /etc/uwsgi/apps-enabled/storage.ini /etc/nginx/apps-available/storage.ini
 
sudo service uwsgi restart
 
sudo service nginx restart
 
  
* Test the storage service
+
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):
go to the following link in a web browser:
+
<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>
  
http://localhost:8000
+
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].
  
log in as user: test pass: test
+
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.
  
* Delete the test user and create a new user
+
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:
  
The storage service runs as a separate web app from the Archivematica dashboard, and has its own set of users.  You should add at least one user, and delete or modify the test user.
+
<pre>
 +
sudo start atom-worker
 +
</pre>

Latest revision as of 21:59, 25 April 2014

Installation >> Install 1.0 >> Install 1.0 packages

Deploying Archivematica 1.0 packages[edit]

Archivematica packages are hosted on Launchpad, in an Ubuntu PPA (Personal Package Archive). There are a number of Archivematica PPA's, the Archivematica 1.0 packages are hosted in the archivematica/release ppa. In order to install software onto your Ubuntu 12.04.3 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):
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
sudo wget -O - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -

Then add this line to the bottom of /etc/apt/sources.list

deb http://packages.elasticsearch.org/elasticsearch/0.90/debian stable main


  • Update your system to the most recent 12.04 release (12.04.3 has been tested and works, but Artefactual has not yet verified 12.04.4). These instructions have been tested on both 32 bit and 64 bit versions of Ubuntu server.
  • This step will also fetch a list of the software from the archivematica/release
sudo apt-get update
sudo apt-get upgrade
  • 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:
sudo apt-get install archivematica-storage-service
sudo apt-get install archivematica-mcp-server 
sudo apt-get install archivematica-mcp-client 
sudo apt-get install archivematica-dashboard 
  • 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.

sudo wget -q https://raw.github.com/artefactual/archivematica/stable/1.0.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

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).

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 Archivematica 1.0

Using ICA-AtoM with Archivematica[edit]

If you are interested in using the 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):

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

You can finish your installation by visiting http://localhost/ica-atom/. For more information about ICA-AtoM installation see 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:

sudo start atom-worker