Manually Installing Archivematica on Ubuntu¶
Archivematica packages are hosted at packages.archivematica.org as a central place to store packages for multiple operating systems. Packages for both Ubuntu 16.04 and 18.04 are available.
Note
Manual installation using packages on Ubuntu is not officially supported. Please see Instructions for new installation.
On this page
- Installation instructions for Ubuntu 16.04 (Xenial) and Ubuntu 18.04 (Bionic)
- Post-installation configuration
Ubuntu 16.04 (Xenial) and Ubuntu 18.04 (Bionic) installation instructions¶
Use these commands to install the repositories:
Ubuntu 16.04 (Xenial):
sudo wget -O - https://packages.archivematica.org/1.8.x/key.asc | sudo apt-key add - sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.8.x/ubuntu xenial main" >> /etc/apt/sources.list' sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.8.x/ubuntu-externals xenial main" >> /etc/apt/sources.list'
Ubuntu 18.04 (Bionic):
sudo wget -O - https://packages.archivematica.org/1.8.x/key.asc | sudo apt-key add - sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.8.x/ubuntu bionic main" >> /etc/apt/sources.list' sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.8.x/ubuntu-externals bionic main" >> /etc/apt/sources.list'
Add Elasticsearch package source (optional). Elasticsearch comes from its own package repository.
Note
Skip this step if you are planning to run Archivematica without Elasticsearch.
- <<<<<<< HEAD
Ubuntu 16.04 (Xenial):
sudo wget -O - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add - sudo sh -c 'echo "deb http://packages.elasticsearch.org/elasticsearch/1.7/debian stable main" >> /etc/apt/sources.list'
Ubuntu 18.04 (Bionic):
Skip this step, the package will be downloaded directly in step 4.
lines: 20-21
>>>>>>> 6140e75… Remove SWORD API sync warning (#285)
Update to the most recent OS release. This step will also fetch a list of the software from the package repositories you just added to your system.
sudo apt-get update sudo apt-get upgrade
<<<<<<< HEAD 4. Install Elasticsearch (optional) =======
5. Install Elasticsearch (optional) >>>>>>> 6140e75… Remove SWORD API sync warning (#285)
Note
Skip this step if you are planning to run Archivematica in indexless mode (without Elasticsearch).
Ubuntu 16.04 (Xenial):
sudo apt-get install elasticsearchUbuntu 18.04 (Bionic):
sudo apt-get install -y htop ntp unzip openjdk-8-jre-headless sudo curl -s https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.7.6.deb -o /var/cache/apt/archives/elasticsearch-1.7.6.deb sudo dpkg -i /var/cache/apt/archives/elasticsearch-1.7.6.deb
Install the Storage Service package.
sudo apt-get install -y archivematica-storage-service
Configure the Storage Service.
sudo rm -f /etc/nginx/sites-enabled/default sudo ln -s /etc/nginx/sites-available/storage /etc/nginx/sites-enabled/storage
- <<<<<<< HEAD
Warning
If you are planning to use the Sword API of the Archivematica Storage Service, then (due to a known issue), you must instruct Gunicorn to use the
sync
worker class:sudo sh -c 'echo "SS_GUNICORN_WORKER_CLASS=sync" >> /etc/default/archivematica-storage-service'
7. Update pip
. This is used to install Python dependencies for both the¶
8. Update pip
. This is used to install Python dependencies for both the
>>>>>>> 6140e75… Remove SWORD API sync warning (#285)
Storage Service and the Dashboard. This step is optional on Ubuntu 16.04, but is still a good idea to get the most recent version of
pip
.curl -Ls https://bootstrap.pypa.io/get-pip.py | sudo python -
Install the Archivematica packages. The order of installation is important - the archivematica-mcp-server package must be installed before the dashboard package. While it is possible to install the archivematica-mcp-client package on a separate machine, that configuration is not documented in these instructions.
The archivematica-mcp-server package will install MySQL and configure the database used by Archivematica. Depending on the version of MySQL that is installed, the interfaces that you see may differ slightly.
When you are prompted to create a password for the archivematica-mcp-server, you must use
demo
as the password during the install process. The password can be changed after the installation is complete.sudo apt-get install -y archivematica-mcp-server sudo apt-get install -y archivematica-dashboard sudo apt-get install -y archivematica-mcp-client
Configure the Archivematica components (optional). There are a number of environment variables that Archivematica recognizes which can be used to alter how it is configured. For the full list, see the Dashboard install README, the MCPClient install README, and the MCPServer install README.
Note
If you are planning on running Archivematica in indexless mode (i.e. without Elasticsearch), then modify the relevant systemd EnvironmentFile files by adding lines that set the relevant environment variables to
false
:sudo sh -c 'echo "ARCHIVEMATICA_DASHBOARD_DASHBOARD_SEARCH_ENABLED=false" >> /etc/default/archivematica-dashboard' sudo sh -c 'echo "ARCHIVEMATICA_MCPSERVER_MCPSERVER_SEARCH_ENABLED=false" >> /etc/default/archivematica-mcp-server' sudo sh -c 'echo "ARCHIVEMATICA_MCPCLIENT_MCPCLIENT_SEARCH_ENABLED=false" >> /etc/default/archivematica-mcp-client'
Configure the dashboard.
sudo ln -s /etc/nginx/sites-available/dashboard.conf /etc/nginx/sites-enabled/dashboard.conf
Start Elasticsearch (optional).
Note
Skip this step if you are planning to run Archivematica in indexless mode (without Elasticsearch).
sudo service elasticsearch restart sudo update-rc.d elasticsearch defaults 95 10
Start the remaining services
sudo service clamav-freshclam restart sudo service clamav-daemon start sudo service gearman-job-server restart sudo service archivematica-mcp-server start sudo service archivematica-mcp-client restart sudo service archivematica-storage-service start sudo service archivematica-dashboard restart sudo service nginx restart sudo systemctl enable fits-nailgun sudo service fits-nailgun start
If you have trouble with the gearman command try restarting it:
sudo service gearman-job-server restart
Configure your firewall (if applicable)
On Ubuntu, the default firewall configuration tool is ufw (Uncomplicated Firewall). To see the firewall status, enter:
sudo ufw status
If ufw is active, you must ensure that it is not blocking the ports used by the dashboard and the Storage Service, i.e., 80 and 8000.
sudo ufw allow 80 sudo ufw allow 8000 sudo ufw reload
Complete Post Install Configuration.
Post-install configuration¶
After successfully completing a new installation, follow these steps to complete the configuration of your new server.
The Storage Service runs as a separate web application from the Archivematica dashboard. The Storage Service is exposed on port 8000 by default for Ubuntu package installs. Use your web browser to navigate to the Storage Service at the IP address of the machine you have been installing on, e.g.,
http://<MY-IP-ADDR>:8000
(orhttp://localhost:8000
orhttp://127.0.0.1:8000
if this is a local development setup).If you are using an IP address or fully-qualified domain name instead of localhost, you will need to configure your firewall rules and allow access only to ports 80 and 8000 for Archivematica usage.
The Storage Service has its own set of users. Add at least one administrative user:
sudo -u archivematica bash -c " \ set -a -e -x source /etc/default/archivematica-storage-service || \ source /etc/sysconfig/archivematica-storage-service \ || (echo 'Environment file not found'; exit 1) cd /usr/lib/archivematica/storage-service /usr/share/archivematica/virtualenvs/archivematica-storage-service/bin/python manage.py createsuperuser ";
After you have created this user an API key will be generated that will connect the Archivematica pipeline to the Storage Service API. Click edit to see the new user’s details. The API key will be found at the bottom of the page. Copy this to your clipboard as it will be used later on in the post-installation configuration.
Note
It is recommended that you also modify the test user and change the default password. This will also result in a new API key for the test user but that does not need to be copied to the clipboard in this instance.
To finish the installation, use your web browser to navigate to the Archivematica dashboard using the IP address of the machine on which you have been installing, e.g.,
http://<MY-IP-ADDR>:80
(orhttp://localhost:80
orhttp://127.0.0.1:80
if this is a local development setup).At the Welcome page, create an administrative user for the Archivematica pipeline by entering the organization name, the organization identifier, username, email, and password.
On the next screen, connect your pipeline to the Storage Service by entering the Storage Service URL and username, and by pasting in the API key that you copied in Step (2).
- If the Storage Service and the Archivematica dashboard are installed on
the same machine, then you should supply
http://127.0.0.1:8000
as the Storage Service URL at this screen. - If the Storage Service and the Archivematica dashboard are installed on
different nodes (servers), then you should use the IP address or
fully-qualified domain name of your Storage Service instance,
e.g.,
http://<MY-IP-ADDR>:8000
and you must ensure that any firewall rules (i.e., iptables, ufw, AWS security groups, etc.) are configured to allow requests from your dashboard IP to your Storage Service IP on the appropriate port.
- If the Storage Service and the Archivematica dashboard are installed on
the same machine, then you should supply