How to Install Access to Memory (AtoM) on Fedora CoreOS Latest

Access to Memory (AtoM) is an open-source software designed to manage archival descriptions and digital objects in a web-based platform. In this tutorial, we will guide you through the installation process of AtoM on Fedora CoreOS Latest.

Prerequisites

A running instance of Fedora CoreOS Latest
A valid domain name or IP address that points to the server

Step 1: Update the system

Before installing AtoM, update your system to make sure all software packages are up-to-date.

sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo yum update -y

Step 2: Install Apache, PHP and MariaDB

To run AtoM, you need to have Apache, PHP and MariaDB installed on the server.

sudo yum install httpd mariadb-server php php-mysqlnd php-xml -y

Step 3: Install Dependencies

AtoM requires some additional packages to be installed on your system.

sudo yum install git zip unzip php-gd php-common php-intl php-mbstring php-bcmath php-zip -y

Step 4: Download AtoM archive

Go to the AtoM website (https://www.accesstomemory.org/) and download the latest stable version of the software.

wget https://github.com/artefactual/atom/releases/download/2.6.1/atom-2.6.1.tar.gz

Once the download is complete, extract the archive to the Apache root directory.

sudo tar xvfz atom-2.6.1.tar.gz -C /var/www/html/

Then change the ownership of the files to the Apache user.

sudo chown -R apache.apache /var/www/html/atom

Step 5: Create a new MySQL database

sudo mysql -u root
MariaDB> CREATE DATABASE atom;
MariaDB> GRANT ALL PRIVILEGES ON atom.* TO 'atomuser'@'localhost' IDENTIFIED BY 'password';
MariaDB> FLUSH PRIVILEGES;
MariaDB> exit;

Step 6: Configure Apache

Create a new virtual host configuration for AtoM in Apache.

sudo nano /etc/httpd/conf.d/atom.conf

Add the following configuration to the file. Replace "your-domain.com" with your domain name or IP address.

<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName your-domain.com
    DocumentRoot /var/www/html/atom
    <Directory /var/www/html/atom>
        Options FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
    ErrorLog /var/log/httpd/atom_error.log
    CustomLog /var/log/httpd/atom_access.log combined
</VirtualHost>

Save and close the file.

Step 7: Configure AtoM

Copy the sample configuration file to the main configuration file.

cd /var/www/html/atom
sudo cp config/sample_config.yml config/config.yml

Then edit the configuration file using your favorite text editor.

sudo nano config/config.yml

Update the following parameters with the database details you have created in Step 5.

database_name: 'atom'
database_user: 'atomuser'
database_password: 'password'
database_host: 'localhost'

Save and close the file.

Step 8: Restart Apache and MySQL

Restart the Apache and MySQL service to apply the changes.

sudo systemctl restart httpd
sudo systemctl restart mariadb

Step 9: Access AtoM

Open your favorite web browser and navigate to http://your-domain.com. You should see the AtoM installation page. Follow the instructions on the screen to complete the installation process.

Conclusion

In this tutorial, we have shown you how to install AtoM on Fedora CoreOS Latest. Now you can manage archival descriptions and digital objects in a web-based platform with AtoM.