Collective Access - Providence is a web-based collection management application that is used by museums, archives, and libraries. It offers a complete suite of tools to manage collections, including cataloging, media management, and reporting. In this tutorial, we will show you how to install Collective Access - Providence on Fedora Server Latest.
Before we begin, make sure that you have root access or sudo privileges on your server. Also, ensure that your system is up-to-date by running the following command.
sudo dnf update -y
The first step is to install Apache and PHP on your system. We will be using Apache as the web server and PHP as the scripting language.
Run the following command to install Apache and PHP:
sudo dnf install httpd php php-cli php-mysqlnd php-xml php-mbstring php-pdo
Once the installation is complete, start the Apache service and enable it to start on boot:
sudo systemctl start httpd
sudo systemctl enable httpd
To confirm that Apache is running, you can run the following command:
systemctl status httpd
Collective Access - Providence requires a database server to store data. We will be using MariaDB Server as the database server.
Install MariaDB Server by running the following command:
sudo dnf install mariadb-server
Once the installation is complete, start the MariaDB service and enable it to start on boot:
sudo systemctl start mariadb
sudo systemctl enable mariadb
To secure the MariaDB installation, run the following command:
sudo mysql_secure_installation
Follow the prompts to set a root password, disable remote root login, remove anonymous users, and remove the test database.
Next, we will create a database and user for Collective Access.
Log in to the MariaDB server as the root user:
sudo mysql -u root -p
Enter the root password when prompted.
Create a database for Collective Access:
CREATE DATABASE collectiveaccess;
Create a user for Collective Access and grant all privileges to the database:
GRANT ALL ON collectiveaccess.* TO 'providence'@'localhost' IDENTIFIED BY 'password';
Replace "password" with a secure password that you choose for the user.
Exit the MariaDB shell:
exit
Now we can install the Collective Access - Providence application.
Download the latest version of the software from the official website:
wget https://github.com/collectiveaccess/providence/archive/refs/tags/ca_object_1.8.5.tar.gz
Extract the downloaded archive:
tar -xzf ca_object_1.8.5.tar.gz
Rename the extracted directory to "providence":
mv providence-ca_object_1.8.5 providence
Move the "providence" directory to the web server's "DocumentRoot" directory:
sudo mv providence/ /var/www/html/
Set the appropriate permissions for the "providence" directory:
sudo chown -R apache:apache /var/www/html/providence
sudo chmod -R 755 /var/www/html/providence
Before we can use Collective Access - Providence, we need to configure it.
Copy the "setup.php-dist" file to "setup.php":
cd /var/www/html/providence/
cp app/setup.php-dist app/setup.php
Edit the "setup.php" file with your favorite text editor:
nano app/setup.php
Find the following lines and replace the values with the appropriate information:
$ca_site_title = 'Providence';
$ca_base_url = 'http://localhost/providence/';
Set "ca_site_title" to the title of your website and "ca_base_url" to the URL of your website.
Scroll down to find the following lines and replace the values with your MariaDB Server details:
$db['default'] = array(
'driver' => 'mysqli',
'host' => 'localhost',
'database' => 'collectiveaccess',
'username' => 'providence',
'password' => 'password',
'prefix' => ''
);
Set "host" to "localhost", "database" to "collectiveaccess", "username" to "providence", and "password" to the password you set in Step 3.
Save and close the file.
Now we can run the installation script to complete the installation.
Open your web browser and navigate to your Collective Access - Providence installation URL:
http://localhost/providence/
You will see the installation page. Follow the prompts to complete the installation.
Once the installation is finished, you will be redirected to the Collective Access - Providence login page.
Congratulations, you have successfully installed Collective Access - Providence on Fedora Server Latest!
In this tutorial, we showed you how to install Collective Access - Providence on Fedora Server Latest. You learned how to install Apache, PHP, and MariaDB Server and how to create a database and user for Collective Access. We also showed you how to download and configure Collective Access - Providence and how to run the installation script.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
