Alfresco è un sistema ECM open source (Enterprise Content Management) scritto in Java che fornisce gestione elettronica, collaborazione e controllo aziendale.
Questa guida coprirà come installare e configurare Alfresco Community Edition su sistemi RHEL/CentOS 7/6, Debian 8 e Ubuntu con Nginx server come server web frontend per l’applicazione.
Requisiti
Per quanto riguarda i requisiti minimi di sistema, Alfresco necessita di una macchina con almeno 4 GB di RAM e un Sistema Operativo a 64 bit.
Passo 1: Installare Alfresco Community Edition
1. Prima di procedere con l’installazione di Alfresco, assicurati che l’utility wget sia installata sulla tua macchina emettendo il seguente comando con privilegi di root o dall’account root.
# yum install wget # apt-get install wget
2. Successivamente, configura il nome host del tuo sistema e assicurati che la risoluzione locale punti all’indirizzo IP del server emettendo i seguenti comandi:
# hostnamectl set-hostname server.alfresco.lan # echo “192.168.0.40 server.alfresco.lan” >> /etc/hosts
3. Rimuovi qualsiasi MTA dalla macchina (in questo caso Postfix Mail server) emettendo il seguente comando:
# yum remove postfix # apt-get remove postfix
4. Installa le seguenti dipendenze richieste dal software Alfresco per funzionare correttamente:
# yum install fontconfig libSM libICE libXrender libXext cups-libs # apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2
5. Successivamente, vai alla pagina del repository di Alfresco Community Edition ospitata sul portale sourceforge.net e scarica l’ultima versione binaria (ossia alfresco-community-5.0.d-installer-linux-x64.bin) per Linux utilizzando l’utilità wget.
# wget http://nchc.dl.sourceforge.net/project/alfresco/Alfresco%205.0.d%20Community/alfresco-community-5.0.d-installer-linux-x64.bin
6. Dopo il completamento del download del file binario, esegui il seguente comando per concedere i permessi di esecuzione al file e avviare l’installer di Alfresco.
# chmod +x alfresco-community-5.0.d-installer-linux-x64.bin # ./alfresco-community-5.0.d-installer-linux-x64.bin
7. Dopo l’avvio del processo di installazione, seleziona la lingua e continua il processo di installazione utilizzando il seguente assistente all’installazione come guida per configurare Alfresco:
[root@server ~]# ./alfresco-community-5.0.d-installer-linux-x64.bin Language Selection Please select the installation language [1] English - English [2] French - Français [3] Spanish - Español [4] Italian - Italiano [5] German - Deutsch [6] Japanese - 日本語 [7] Dutch - Nederlands [8] Russian - Русский [9] Simplified Chinese - 简体中文 [10] Norwegian - Norsk bokmål [11] Brazilian Portuguese - Português Brasileiro Please choose an option [1] :1---------------------------------------------------------------------------- Welcome to the Alfresco Community Setup Wizard. ---------------------------------------------------------------------------- Installation Type [1] Easy - Installs servers with the default configuration [2] Advanced - Configures server ports and service properties.: Also choose optional components to install. Please choose an option [1] :2---------------------------------------------------------------------------- Select the components you want to install; clear the components you do not want to install. Click Next when you are ready to continue. Java [Y/n] :yPostgreSQL [Y/n] :yAlfresco : Y (Cannot be edited) Solr1 [y/N] :nSolr4 [Y/n] :ySharePoint [Y/n] :yWeb Quick Start [y/N] :yGoogle Docs Integration [Y/n] :yLibreOffice [Y/n] :yIs the selection above correct? [Y/n]:y
Prosegue l’Assistente all’Installazione di Alfresco…
---------------------------------------------------------------------------- Installation Folder Please choose a folder to install Alfresco Community Select a folder [/opt/alfresco-5.0.d]:[Press Enter key]---------------------------------------------------------------------------- Database Server Parameters Please enter the port of your database. Database Server port [5432]:[Press Enter key]---------------------------------------------------------------------------- Tomcat Port Configuration Please enter the Tomcat configuration parameters you wish to use. Web Server domain: [127.0.0.1]:192.168.0.15Tomcat Server Port: [8080]:[Press Enter keyTomcat Shutdown Port: [8005]:[Press Enter keyTomcat SSL Port [8443]:[Press Enter keyTomcat AJP Port: [8009]:[Press Enter key---------------------------------------------------------------------------- Alfresco FTP Port Please choose a port number to use for the integrated Alfresco FTP server. Port: [21]:[Press Enter key
Prosegue l’Installazione di Alfresco…
---------------------------------------------------------------------------- Admin Password Please give a password to use for the Alfresco administrator account. Admin Password: :[Enter a strong password for Admin user]Repeat Password: :[Repeat the password for Admin User]---------------------------------------------------------------------------- Alfresco SharePoint Port Please choose a port number for the SharePoint protocol. Port: [7070]:[Press Enter key]---------------------------------------------------------------------------- Install as a service You can optionally register Alfresco Community as a service. This way it will automatically be started every time the machine is started. Install Alfresco Community as a service? [Y/n]:y---------------------------------------------------------------------------- LibreOffice Server Port Please enter the port that the Libreoffice Server will listen to by default. LibreOffice Server Port [8100]:[Press Enter key]----------------------------------------------------------------------------
Continua la Configurazione dell’Installazione di Alfresco…
---------------------------------------------------------------------------- Setup is now ready to begin installing Alfresco Community on your computer. Do you want to continue? [Y/n]:y---------------------------------------------------------------------------- Please wait while Setup installs Alfresco Community on your computer. Installing 0% ______________ 50% ______________ 100% ######################################### ---------------------------------------------------------------------------- Setup has finished installing Alfresco Community on your computer. View Readme File [Y/n]:nLaunch Alfresco Community Share [Y/n]:ywaiting for server to start....[root@server ~]# done server started /opt/alfresco-5.0.d/postgresql/scripts/ctl.sh : postgresql started at port 5432 Using CATALINA_BASE: /opt/alfresco-5.0.d/tomcat Using CATALINA_HOME: /opt/alfresco-5.0.d/tomcat Using CATALINA_TMPDIR: /opt/alfresco-5.0.d/tomcat/temp Using JRE_HOME: /opt/alfresco-5.0.d/java Using CLASSPATH: /opt/alfresco-5.0.d/tomcat/bin/bootstrap.jar:/opt/alfresco-5.0.d/tomcat/bin/tomcat-juli.jar Using CATALINA_PID: /opt/alfresco-5.0.d/tomcat/temp/catalina.pid Tomcat started. /opt/alfresco-5.0.d/tomcat/scripts/ctl.sh : tomcat started
8. Dopo il completamento del processo di installazione e l’avvio dei servizi di Alfresco, esegui i seguenti comandi per aprire le seguenti porte del firewall al fine di consentire agli host esterni nella tua rete di connettersi all’applicazione web.
# firewall-cmd --add-port=8080/tcp -permanent # firewall-cmd --add-port=8443/tcp -permanent # firewall-cmd --add-port=7070/tcp -permanent # firewall-cmd --reload
Se hai bisogno di aggiungere altre regole del firewall per aprire porte al fine di accedere a servizi Alfresco personalizzati, esegui il comando ss per ottenere un elenco di tutti i servizi in esecuzione sulla tua macchina.
# ss -tulpn
9. Per accedere ai servizi web di Alfresco, aprire un browser e utilizzare i seguenti URL (sostituendo l’indirizzo IP o il dominio di conseguenza). Accedi con l’utente admin e la password configurata per l’Admin durante il processo di installazione.
http://IP-or-domain.tld:8080/share/
http://IP-or-domain.tld:8080/alfresco/
Per WebDAV.
http://IP-or-domain.tld:8080/alfresco/webdav
Per HTTPS accetta l’eccezione di sicurezza.
https://IP-or-domain.tld:8443/share/
Modulo Alfresco SharePoint con Microsoft.
http://IP-or-domain.tld:7070/
Passo 2: Configura Nginx come Server Web Frontend per Alfresco
10. Per installare il server Nginx sul sistema, aggiungi prima Repository Epel su CentOS/RHEL emettendo il comando seguente:
# yum install epel-release
11. Dopo che i repository Epel sono stati aggiunti al sistema, procedi con l’installazione del server web Nginx emettendo il seguente comando:
# yum install nginx [On RHEL/CentOS Systems] # apt-get install nginx [On Debian/Ubuntu Systems]
12. Al passaggio successivo apri il file di configurazione di Nginx da /etc/nginx/nginx.conf con un editor di testo e apporta le seguenti modifiche:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Vai sotto e assicurati di commentare la seconda dichiarazione di posizione inserendo un # davanti alle seguenti righe:
#location / {
# }
13. Una volta terminato, salva e chiudi il file di configurazione di Nginx e riavvia il daemon per riflettere le modifiche emettendo il seguente comando:
# systemctl restart nginx.service
14. Per accedere all’interfaccia web di Alfresco, aggiungi una nuova regola del firewall per aprire la porta 80 sul tuo computer e vai all’URL sottostante. Assicurati inoltre che la policy Selinux sia disabilitata nei sistemi RHEL/CentOS.
# firewall-cmd --add-service=http -permanent # firewall-cmd --reload # setenforce 0
Per disabilitare completamente la politica di Selinux nel sistema, apri il file /etc/selinux/config e imposta la riga SELINUX da enforcing a disabled.
15. Ora puoi accedere ad Alfresco tramite Nginx.
http://IP-or-domain.tld/share/ http://IP-or-domain.tld/alfresco/ http://IP-or-domain.tld/alfresco/webdav
15. Nel caso tu voglia visitare in modo sicuro l’interfaccia web di Alfresco attraverso il proxy Nginx con SSL, crea un Certificato Autofirmato per Nginx nella directory /etc/nginx/ssl/ e compila il certificato con le tue impostazioni personalizzate come illustrato nello screenshot sottostante:
# mkdir /etc/nginx/ssl # cd /etc/nginx/ssl/ # openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout alfresco.key -out alfresco.crt
Fai attenzione al Certificate Common Name per abbinare il nome host del tuo dominio.
17. Successivamente, apri il file di configurazione di Nginx per la modifica e aggiungi il seguente blocco prima dell’ultima parentesi graffa chiusa (il simbolo }).
# vi /etc/nginx/nginx.conf
Estratti dal blocco SSL di Nginx:
server {
listen 443;
server_name _;
ssl_certificate /etc/nginx/ssl/alfresco.crt;
ssl_certificate_key /etc/nginx/ssl/alfresco.key;
ssl on;
ssl_session_cache builtin:1000 shared:SSL:10m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
ssl_prefer_server_ciphers on;
access_log /var/log/nginx/ssl.access.log;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
## This is the last curly bracket before editing the file.
}
18. Infine, riavvia il demone Nginx per applicare le modifiche, aggiungi una nuova regola del firewall per la porta 443.
# systemctl restart nginx # firewall-cmd -add-service=https --permanent # firewall-cmd --reload
e indica al browser il tuo URL di dominio utilizzando il protocollo HTTPS.
https://IP_or_domain.tld/share/ https://IP_or_domain.tld/alfresco/
19. Per abilitare i demoni di Alfresco e Nginx a livello di sistema esegui il comando seguente:
# systemctl enable nginx alfresco
Questo è tutto! Alfresco offre l’integrazione con MS Office e LibreOffice tramite il protocollo CIFs fornendo un flusso di lavoro familiare per gli utenti.
Source:
https://www.tecmint.com/install-alfresco-community-edition-on-centos-debian-ubuntu/