Acest ghid acoperă instalarea versiunii Providence (backend de administrare). Opțional, poți instala și Pawtucket (frontend public).

📋 Cerințe minime

Ubuntu 22.04 sau 24.04
2–4 GB RAM recomandat
Apache sau Nginx
PHP 8.1+
MariaDB / MySQL

1️⃣ Actualizare sistem

sudo apt update && sudo apt upgrade -y

2️⃣ Instalare Apache

sudo apt install apache2 -y
sudo systemctl enable apache2
sudo systemctl start apache2

Activează modulul rewrite:

sudo a2enmod rewrite
sudo systemctl reload apache2

3️⃣ Instalare MariaDB

sudo apt install mariadb-server -y
sudo mysql_secure_installation

Creează baza de date:

sudo mysql -u root -p

În consola MariaDB:

CREATE DATABASE collectiveaccess CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ca_user'@'localhost' IDENTIFIED BY 'parola_sigura';
GRANT ALL PRIVILEGES ON collectiveaccess.* TO 'ca_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4️⃣ Instalare PHP și extensii necesare

CollectiveAccess necesită mai multe extensii PHP:

sudo apt install php php-cli php-mysql php-gd php-curl php-xml php-mbstring php-intl php-zip php-bcmath php-soap unzip git -y

Verifică versiunea:

php -v

5️⃣ Descărcare CollectiveAccess (Providence)

cd /var/www
sudo git clone https://github.com/collectiveaccess/providence.git
sudo chown -R www-data:www-data providence
sudo chmod -R 755 providence

6️⃣ Configurare Apache Virtual Host

Creează fișierul:

sudo nano /etc/apache2/sites-available/collectiveaccess.conf

Adaugă:

<VirtualHost *:80>
    ServerName domeniul-tau.ro
    DocumentRoot /var/www/providence

    <Directory /var/www/providence>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/ca_error.log
    CustomLog ${APACHE_LOG_DIR}/ca_access.log combined
</VirtualHost>

Activează site-ul:

sudo a2ensite collectiveaccess.conf
sudo systemctl reload apache2

7️⃣ Configurare fișier setup.php

Copiază fișierul de configurare:

cd /var/www/providence
sudo cp setup.php-dist setup.php
sudo nano setup.php

Modifică datele bazei de date:

define("__CA_DB_HOST__", "localhost");
define("__CA_DB_USER__", "ca_user");
define("__CA_DB_PASSWORD__", "parola_sigura");
define("__CA_DB_DATABASE__", "collectiveaccess");

Salvează și închide.

8️⃣ Finalizare instalare din browser

Accesează:

http://IP_SERVER
sau
http://domeniul-tau.ro

Urmează wizard-ul de instalare:

Selectează profilul (ex: Museum, Archive etc.)
Configurează administratorul
Finalizează setup-ul

🔐 (Opțional) Instalare frontend public – Pawtucket

Dacă dorești interfață publică:

cd /var/www
sudo git clone https://github.com/collectiveaccess/pawtucket2.git
sudo chown -R www-data:www-data pawtucket2

Configurează setup.php similar cu Providence și creează un VirtualHost separat.

🔒 Activare HTTPS (Let’s Encrypt)

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache

🚀 Optimizări recomandate

Editează php.ini:

sudo nano /etc/php/8.1/apache2/php.ini

Modifică:

memory_limit = 512M
upload_max_filesize = 128M
post_max_size = 128M
max_execution_time = 300

Repornește Apache:

sudo systemctl restart apache2

✅ Verificare finală

✔ Acces admin: http://domeniu/admin
✔ Creare obiecte și colecții
✔ Configurare tipuri de metadate
✔ Posibilitate publicare frontend

📌 Concluzie

Instalarea CollectiveAccess pe Ubuntu este relativ directă, dar configurarea metadatelor și a profilurilor necesită atenție. Platforma este extrem de flexibilă și potrivită pentru colecții complexe.

Software Open Source pentru Educație și Biblioteci

🛠 Ghid de instalare pas cu pas CollectiveAccess pe Ubuntu 22.04 / 24.04