Come installare ImpressCMS 1.0 Final su Debian Etch

Versione e autore

Versione 1.0
Autore: Oliver Meyer

Introduzione

Questo documento descrive come configurare ImpressCMS 1.0 Final su Debian Etch. ImpressCMS è un CMS sviluppato dalla community per creare e mantenere siti web dinamici in modo semplice, sicuro e flessibile. Questa guida è pratica e non entra nei dettagli teorici: mostra un percorso possibile per ottenere un sito funzionante.

Importante: questa guida viene fornita senza garanzie. Adatta gli esempi (indirizzi IP, nomi host, password) all’ambiente reale.

Contenuto della guida

• Nota preliminare
• Pacchetti necessari
• Configurazione MySQL
  • Bind address
  • Utente root
  • Database e utente ImpressCMS
• Vhost per ImpressCMS
• Scaricare e copiare ImpressCMS
• Installazione via browser
• Operazioni post-installazione
• Controlli di sicurezza e checklist
• Casi di errore comuni e runbook di rollback
• Criteri di accettazione
• Glossario rapido

1 Nota preliminare

Per questa guida è stato usato un sistema Debian Etch minimale (installazione in rete). La macchina virtuale di esempio è configurata così:

Hostname: server1.example.com
IP: 192.168.0.100
Gateway: 192.168.0.2
Tutte le password d’esempio: howtoforge

Adatta subito questi dati prima dell’uso in produzione (soprattutto le password).

2 Pacchetti necessari

Installa i pacchetti richiesti (comando da root):

apt-get install apache2 libapache2-mod-php5 php5-mysql mysql-server mysql-client

Questo installerà Apache, PHP con estensione MySQL e il server MySQL.

3 Configurazione MySQL

3.1 Bind address

Per fare in modo che il server MySQL ascolti tutte le interfacce, modifica la configurazione:

vi /etc/mysql/my.cnf

Cerca la linea:

bind-address = 127.0.0.1

Commentala così:

# bind-address = 127.0.0.1

Poi riavvia MySQL:

/etc/init.d/mysql restart

Nota: in ambienti di produzione preferisci limitare l’accesso via firewall invece di esporre MySQL a tutte le interfacce.

3.2 Utente root di MySQL

Imposta la password per l’utente root di MySQL:

mysqladmin -u root password %sql_root_password%  
mysqladmin -h server1.example.com -u root password %sql_root_password%

Sostituisci %sql_root_password% con una password forte.

3.3 Database e utente per ImpressCMS

Crea il database:

mysqladmin -u root -p create impresscms

Entra nella shell MySQL per creare l’utente e concedere i permessi:

mysql -u root -p

Esegui queste istruzioni dentro MySQL:

GRANT CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES, SELECT, INSERT, UPDATE, DELETE ON impresscms.* TO 'impresscms_admin'@'localhost' IDENTIFIED BY '%impresscms_admin_password%';  
GRANT CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES, SELECT, INSERT, UPDATE, DELETE ON impresscms.* TO 'impresscms_admin'@'localhost.localdomain' IDENTIFIED BY '%impresscms_admin_password%';  
FLUSH PRIVILEGES;

Poi esci:

quit;

Sostituisci %impresscms_admin_password% con una password sicura.

4 Vhost per ImpressCMS

Crea la document root e la directory “trust”:

mkdir /var/www/impresscms/

mkdir /var/www/impresscms_trust/

Crea il file di configurazione del vhost:

vi /etc/apache2/sites-available/impresscms

Esempio di contenuto del vhost:

NameVirtualHost 192.168.0.100:80

    ServerName server1.example.com
    ServerAdmin [email protected]
    DocumentRoot /var/www/impresscms/
    LogLevel warn
    ErrorLog /var/log/apache2/impresscms_error.log
    CustomLog /var/log/apache2/impresscms_access.log combined

Abilita il sito e riavvia Apache:

a2ensite impresscms

/etc/init.d/apache2 restart

5 Scaricare ImpressCMS

Controlla la pagina ufficiale per la versione più recente: http://www.impresscms.org/modules/mastop_publish/?tac=Download (al tempo della guida era la 1.0).

Esempio di download e estrazione:

cd /tmp/  
wget http://downloads.sourceforge.net/impresscms/impresscms_1.0_final.tar.gz  
tar xvfz impresscms_1.0_final.tar.gz

Copia il contenuto della cartella estratta “htdocs” nella document root del vhost:

cp -R /tmp/htdocs/* /var/www/impresscms/

Poi modifica i permessi (esempio fornito dall’autore):

chown -R www-data:www-data /var/www/impresscms/ /var/www/impresscms_trust/
 chmod -R 755 /var/www/impresscms/uploads/ /var/www/impresscms/cache/ /var/www/impresscms/templates_c/ /var/www/impresscms/mainfile.php
 

Nota: mantieni esattamente i comandi come sopra; la riga contiene tag HTML utilizzati nell’originale.

6 Installazione via browser

Apri nel browser l’indirizzo del server (es.: http://server1.example.com/). Un wizard di installazione guiderà il resto del processo. File di lingua aggiuntivi sono disponibili su SourceForge.

Lo script controllerà la configurazione del server: tutti i controlli dovrebbero risultare verdi.

Lo script controllerà permessi di file e directory. Se richiesto, modifica il percorso trust in “/var/www/impresscms_trust” e crea la directory tramite il pulsante corrispondente.

Inserisci nome DB, utente e password creati nella sezione 3.3.

Procedi con l’installazione; lo script creerà le tabelle nel database.

Inserisci i dati dell’account amministratore (nell’esempio l’utente è “admin”).

Lo script popolerà il database con i dati iniziali.

Installazione completata: clicca su “Show my site” per vedere il sito.

Prima di effettuare il login elimina la directory di installazione e modifica i permessi del mainfile:

rm -Rf /var/www/impresscms/install/  
chmod 444 /var/www/impresscms/mainfile.php

Ora puoi effettuare il login con l’account amministratore creato durante l’installazione.

7 Collegamenti utili

• Debian: http://www.debian.org/
• ImpressCMS: http://www.impresscms.org/
• ImpressCMS su SourceForge: http://sourceforge.net/projects/impresscms/

Controlli di sicurezza consigliati

Importante: dopo l’installazione esegui questi passaggi per aumentare la sicurezza:

• Rimuovi directory di install come mostrato sopra.
• Assicurati che /var/www/impresscms_trust sia fuori dalla document root e non accessibile via web.
• Imposta permessi stretti sui file di configurazione (ad es. mainfile.php 0444).
• Usa password forti per MySQL root e per l’utente impresscms_admin.
• Blocca l’accesso esterno a MySQL tramite firewall e limita gli host autorizzati.
• Tieni aggiornati Apache/PHP/MySQL quando possibile (valuta backport o upgrade di distribuzione).

Casi in cui l’installazione può fallire e soluzioni rapide

• Errore di connessione al DB: verifica che MySQL stia girando, che bind-address e firewall permettano l’accesso e che le credenziali siano corrette.
• Permessi file non corretti: controlla owner (www-data) e le cartelle uploads, cache, templates_c.
• Errori PHP: abilita log errori di PHP e consulta /var/log/apache2/*.
• Timeout durante l’installazione: aumenta max_execution_time e memory_limit in php.ini temporaneamente.

Runbook di rollback rapido (se l’installazione causa problemi)

1. Disabilita il sito Apache: a2dissite impresscms && /etc/init.d/apache2 reload.
2. Ripristina backup della document root se presente.
3. Se il DB è corrotto, ripristina dal dump: mysql -u root -p impresscms < backup.sql.
4. Controlla i permessi e i log per diagnosticare la causa prima di riprovare l’installazione.

Criteri di accettazione

• Il sito si carica su http://server1.example.com/ senza errori PHP.
• L’utente amministratore può accedere al pannello di controllo.
• Tutte le directory upload/cache/templates_c sono scrivibili da web server e non sono accessibili direttamente via web.
• La directory install è stata rimossa e mainfile.php ha permessi 0444.

Checklist per ruoli (sintetica)

• Sysadmin: creare VM, aggiornare pacchetti, configurare MySQL, firewall, vhost Apache.
• Webmaster: copiare file ImpressCMS, impostare permessi, verificare trust path.
• Content editor: creare contenuti dopo login, verificare permessi upload.

Mini-metodologia per un’installazione ripetibile

1. Preparare immagine di base Debian Etch aggiornata.
2. Eseguire script di provisioning (installare pacchetti e creare utenti DB).
3. Testare con ambiente di staging.
4. Eseguire deploy su produzione con backup e checklist di sicurezza.

Glossario (una riga)

• vhost: configurazione Apache per uno specifico sito/host.
• trust path: directory fuori dalla webroot dove ImpressCMS può mettere file sensibili.
• mainfile.php: file di configurazione principale di ImpressCMS.

Riepilogo

Questa guida mostra i passi pratici per installare ImpressCMS 1.0 su Debian Etch: installazione pacchetti, configurazione MySQL e Apache, copia dei file, esecuzione del wizard e operazioni di sicurezza post-installazione. Segui la checklist di sicurezza e prepara un piano di rollback prima di operare in ambienti con dati reali.