Overview
ArchivesSpace is an open-source archival information management application for managing archives, manuscripts, and digital objects, and providing web access.
I had the opportunity to set up ArchivesSpace on Amazon Lightsail, so this is a memo of the process.
Installation instructions are described on the following page.
https://archivesspace.github.io/tech-docs/readme_implement.html
Instance
I selected Ubuntu 20.04 LTS.
The documentation states the following, but since performance was sluggish with 2GB of memory, I selected 4GB.
At least 1024 MB RAM allocated to the application; at least 2 GB for optimal performance.
Installation
First, download ArchivesSpace.
cd /home/ubuntu/
sudo apt-get -y update
sudo apt-get -y upgrade
A confirmation prompt will appear.
sudo apt-get -y install openjdk-11-jdk
# Download
wget https://github.com/archivesspace/archivesspace/releases/download/v3.3.1/archivesspace-v3.3.1.zip -O /home/ubuntu/archivesspace-v3.3.1.zip
# Install unzip
sudo apt -y install unzip
# Extract
unzip /home/ubuntu/archivesspace-v3.3.1.zip
Installing Solr
cd /home/ubuntu/
# Download
wget -O solr.tgz https://www.apache.org/dyn/closer.lua/lucene/solr/8.11.2/solr-8.11.2.tgz?action=download -O /home/ubuntu/solr-8.11.2.tgz
tar zxf /home/ubuntu/solr-8.11.2.tgz
cd /home/ubuntu/solr-8.11.2
# Create conf directory
mkdir -p /home/ubuntu/solr-8.11.2/server/solr/configsets/archivesspace/conf/
cp /home/ubuntu/archivesspace/solr/* /home/ubuntu/solr-8.11.2/server/solr/configsets/archivesspace/conf/
cd /home/ubuntu/solr-8.11.2
# Create core
bin/solr start
bin/solr create -c archivesspace -d archivesspace
Installing MySQL
sudo apt install -y mysql-server mysql-client
sudo service mysql status
sudo mysql -uroot
Execute the following after logging in:
SET GLOBAL log_bin_trust_function_creators = 1;
create database archivesspace default character set utf8mb4;
create user 'as'@'localhost' identified by 'as123';
grant all privileges on archivesspace.* to 'as'@'localhost';
quit;
cd /home/ubuntu/archivesspace
vi config/config.rb
Modify the following:
AppConfig[:db_url] = "jdbc:mysql://localhost:3306/archivesspace?user=as&password=as123&useUnicode=true&characterEncoding=UTF-8"
Download and set up the JAR file:
cd /home/ubuntu/archivesspace/lib
curl -Oq https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.23/mysql-connector-java-8.0.23.jar
cd /home/ubuntu/archivesspace/
scripts/setup-database.sh
Starting
Start ArchivesSpace with the following command:
cd /home/ubuntu/archivesspace/
./archivesspace.sh
Networking
Configure the firewall in the Amazon Lightsail management console. Open ports 8080-8082 and 8089-8090.
Summary
You can confirm ArchivesSpace is running on port 8080 as shown below.
I hope this serves as a helpful reference for setting up ArchivesSpace.