How to Install Access to Memory (AtoM) on OpenSUSE Latest

Access to Memory (AtoM) is an open-source, web-based application designed to describe, manage, and provide access to archives and digital objects. In this tutorial, we will guide you through the process of installing AtoM on the latest version of OpenSUSE.

Prerequisites

Before we begin, you need to make sure that:

  • You have a running instance of OpenSUSE latest version.
  • You have SSH access to the server.
  • You are logged in as a user with sudo privileges.

Step 1: Update your system

First, we need to update the system to the latest packages. 

sudo zypper update

Step 2: Install Required Dependencies

To run AtoM on OpenSUSE, we need to install some dependencies. We can install them by running the following command:

sudo zypper install apache2 mariadb php7 php7-mysql php7-curl php7-xml php7-mbstring wget unzip

Step 3: Download & extract AtoM

Download the latest version of AtoM from its official website using the below command:

wget https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/ica-atom/ica-atom-1.3.0.tar.gz

Once the download is complete, extract the archive using the following command:

tar xfz ica-atom-1.3.0.tar.gz

Step 4: Move AtoM files to /srv/atom

Now we need to move the extracted files to the webroot folder of our server. Here, we are moving the files to /srv/atom. 

sudo mkdir /srv/atom
sudo mv ica-atom-1.3.0/* /srv/atom

Step 5: Set the storage directory permissions

We need to provide write permissions to the storage directory of the AtoM installation.

sudo chown -R wwwrun:www /srv/atom
sudo chmod -R 777 /srv/atom/storage

Step 6: Configure MariaDB

We need to create a new database for AtoM and create a new user and grant privileges to that user.

mysql -u root -p

Once you are in the MySQL prompt, run the following commands:

CREATE DATABASE atom;
CREATE USER 'atom'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON atom.* TO 'atom'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 7: Configure AtoM

Copy the config/db.inc.template.php to config/db.inc.php and edit the database details as follows:

cp /srv/atom/config/db.inc.template.php /srv/atom/config/db.inc.php
sudo nano /srv/atom/config/db.inc.php

Change the following values according to your database:

define("DB_USER", "atom");
define("DB_PASSWORD", "yourpassword");
define("DB_HOST", "localhost");
define("DB_NAME", "atom");

Save and exit the file.

Step 8: Configure Apache

Create a new virtual host file for AtoM:

sudo nano /etc/apache2/vhosts.d/atom.conf

Add the following configuration to the file:

<VirtualHost *:80>
    ServerName atom.yourdomain.com
    DocumentRoot /srv/atom
    <Directory /srv/atom>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/apache2/atom-error.log
    CustomLog /var/log/apache2/atom-access.log combined
</VirtualHost>

Save and exit the file.

Enable Apache rewrite module, restart Apache and reload the new configuration of Apache:

sudo a2enmod rewrite
sudo systemctl restart apache2
sudo systemctl reload apache2

Step 9: Access AtoM Web Installation Wizard

Now, you can access AtoM installation wizard via your web browser by navigating to http://atom.yourdomain.com.

In the AtoM installation wizard, follow the on-screen instructions to complete the AtoM installation.

Congratulations! You have successfully installed AtoM on OpenSUSE latest.