Manually Installing Archivematica on Ubuntu¶

Ubuntu 16.04 (Xenial) and Ubuntu 18.04 (Bionic) installation instructions¶

1. Use these commands to install the repositories:

   Ubuntu 16.04 (Xenial):

   sudo wget -O - https://packages.archivematica.org/1.9.x/key.asc | sudo apt-key add -
   
   sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.9.x/ubuntu xenial main" >> /etc/apt/sources.list'
   sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.9.x/ubuntu-externals xenial main" >> /etc/apt/sources.list'
   

   Ubuntu 18.04 (Bionic):

   sudo wget -O - https://packages.archivematica.org/1.9.x/key.asc | sudo apt-key add -
   
   sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.9.x/ubuntu bionic main" >> /etc/apt/sources.list'
   sudo sh -c 'echo "deb [arch=amd64] http://packages.archivematica.org/1.9.x/ubuntu-externals bionic main" >> /etc/apt/sources.list'
   

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

   wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
   echo "deb https://artifacts.elastic.co/packages/6.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-6.x.list
   

3. 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 -y upgrade
   

4. Install some needed packages

   sudo apt-get install -y htop ntp apt-transport-https unzip openjdk-8-jre-headless
   

5. Install Elasticsearch (optional)

   Note

   Skip this step if you are planning to run Archivematica in indexless mode (without Elasticsearch).

   sudo apt-get install -y elasticsearch
   

6. Install the Storage Service package.

sudo apt-get install -y archivematica-storage-service

7. Configure the Storage Service.

   sudo rm -f /etc/nginx/sites-enabled/default
   sudo ln -sf /etc/nginx/sites-available/storage /etc/nginx/sites-enabled/storage
   

8. Update pip. This is used to install Python dependencies for both the 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.

   wget -O - https://bootstrap.pypa.io/get-pip.py | sudo python -
   

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

10. 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'
    

11. Configure the dashboard.

sudo ln -sf /etc/nginx/sites-available/dashboard.conf /etc/nginx/sites-enabled/dashboard.conf

12. Start Elasticsearch (optional).

    Note

    Skip this step if you are planning to run Archivematica in indexless mode (without Elasticsearch).

    sudo systemctl daemon-reload
    sudo service elasticsearch restart
    sudo systemctl enable elasticsearch
    

13. Start the remaining services

    sudo service clamav-freshclam restart
    sleep 120s
    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 or clamav command try restarting it:

    sudo service gearman-job-server restart
    sudo service clamav-daemon restart
    

14. 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 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 8000/tcp
sudo ufw reload

15. Complete Post Install Configuration.