Com instal·lar Alfresco Community Edition a RHEL/CentOS 7/6 i Debian 8


Alfresco és un sistema ECM de codi obert (Enterprise Content Management) escrit en Java que proporciona gestió electrònica, col·laboració i control empresarial.

Aquesta guia tractarà com instal·lar i configurar Alfresco Community Edition als sistemes RHEL/CentOS 7/6, Debian 8 i Ubuntu amb el servidor Nginx com a servidor web frontal per a l'aplicació.

Pel que fa als requisits mínims del sistema, Alfresco necessita una màquina amb almenys 4 GB de RAM i un sistema operatiu de 64 bits.

Pas 1: instal·leu Alfresco Community Edition

1. Abans de procedir amb la instal·lació d'Alfresco, primer assegureu-vos que la utilitat wget està instal·lada a la vostra màquina emetent l'ordre següent amb privilegis de root o des del compte root.

# yum install wget
# apt-get install wget

2. A continuació, configureu el nom d'amfitrió del vostre sistema i assegureu-vos que la resolució local apunta a l'adreça IP del vostre servidor emetent les ordres següents:

# hostnamectl set-hostname server.alfresco.lan
# echo “192.168.0.40 server.alfresco.lan” >> /etc/hosts

3. Elimineu qualsevol MTA de la màquina (en aquest cas el servidor Postfix Mail) emetent l'ordre següent:

# yum remove postfix
# apt-get remove postfix

4. Instal·leu les dependències següents requerides pel programari Alfresco per tal de funcionar correctament:

# yum install fontconfig libSM libICE libXrender libXext cups-libs
# apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2

5. A continuació, aneu a la utilitat wget.

# wget http://nchc.dl.sourceforge.net/project/alfresco/Alfresco%205.0.d%20Community/alfresco-community-5.0.d-installer-linux-x64.bin

6. Quan finalitzi la descàrrega del fitxer binari, emeteu l'ordre següent per atorgar permisos d'execució per al fitxer i executeu l'instal·lador alfresco.

# chmod +x alfresco-community-5.0.d-installer-linux-x64.bin
# ./alfresco-community-5.0.d-installer-linux-x64.bin

7. Un cop s'iniciï el procés d'instal·lació, seleccioneu l'idioma i continueu el procés d'instal·lació utilitzant l'assistent d'instal·lació següent com a guia per configurar Alfresco:

 ./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] :y

PostgreSQL [Y/n] :y

Alfresco : Y (Cannot be edited)

Solr1 [y/N] : n

Solr4 [Y/n] :y

SharePoint [Y/n] :y

Web Quick Start [y/N] : y

Google Docs Integration [Y/n] :y

LibreOffice [Y/n] :y

Is the selection above correct? [Y/n]: y

L'assistent d'instal·lació d'Alfresco continua...

----------------------------------------------------------------------------
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.15 

Tomcat Server Port: [8080]: [Press Enter key

Tomcat Shutdown Port: [8005]: [Press Enter key

Tomcat SSL Port [8443]: [Press Enter key

Tomcat 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

La instal·lació a l'aire lliure continua...

----------------------------------------------------------------------------
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]

----------------------------------------------------------------------------

La configuració de la instal·lació d'Alfresco continua...

----------------------------------------------------------------------------
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]: n

Launch Alfresco Community Share [Y/n]: y

waiting for server to start....  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. Un cop finalitzi el procés d'instal·lació i s'iniciïn els serveis d'Alfresco, emeteu les ordres següents per obrir els ports del tallafoc següents per permetre que els hosts externs de la vostra xarxa es connectin a l'aplicació 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

En cas que necessiteu afegir altres regles de tallafoc als ports oberts per accedir als serveis personalitzats d'Alfresco, emeteu l'ordre ss per obtenir una llista de tots els serveis que s'executen a la vostra màquina.

# ss -tulpn

9. Per accedir als serveis web d'Alfresco, obriu un navegador i utilitzeu els URL següents (substituïu l'adreça IP o el domini en conseqüència). Inicieu sessió amb l'usuari administrador i la contrasenya configurada per a l'administrador mitjançant el procés d'instal·lació.

http://IP-or-domain.tld:8080/share/ 
http://IP-or-domain.tld:8080/alfresco/ 

Per a WebDAV.

http://IP-or-domain.tld:8080/alfresco/webdav 

Per a HTTPS, accepteu l'excepció de seguretat.

https://IP-or-domain.tld:8443/share/ 

Mòdul Alfresco SharePoint amb Microsoft.

http://IP-or-domain.tld:7070/

Pas 2: configureu Nginx com a servidor web frontend per a Alfresco

10. Per instal·lar el servidor Nginx al sistema, primer afegiu dipòsits Epel a CentOS/RHEL emetent l'ordre següent:

# yum install epel-release

11. Després d'afegir els repositoris d'Epel al sistema, procediu a la instal·lació del servidor web Nginx emetent l'ordre següent:

# yum install nginx       [On RHEL/CentOS Systems]
# apt-get install nginx   [On Debian/Ubuntu Systems]  

12. Al pas següent, obriu el fitxer de configuració de Nginx des de /etc/nginx/nginx.conf amb un editor de text i feu els canvis següents:

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;
    }

A continuació, assegureu-vos de comentar la segona declaració d'ubicació posant un # davant de les línies següents:

#location / {
#        }

13. Quan hàgiu acabat, deseu i tanqueu el fitxer de configuració de Nginx i reinicieu el dimoni per reflectir el canvi emetent l'ordre següent:

# systemctl restart nginx.service

14. Per accedir a la interfície web d'Alfresco, afegiu una nova regla de tallafoc per obrir el port 80 a la vostra màquina i navegueu a l'URL següent. A més, assegureu-vos que la política de Selinux estigui desactivada als sistemes RHEL/CentOS.

# firewall-cmd --add-service=http -permanent
# firewall-cmd --reload
# setenforce 0

Per desactivar completament la política de Selinux al sistema, obriu el fitxer /etc/selinux/config i configureu la línia SELINUX de aplicar a desactivat.

15. Ara podeu accedir a Alfresco a través de Nginx.

 http://IP-or-domain.tld/share/ 
 http://IP-or-domain.tld/alfresco/
 http://IP-or-domain.tld/alfresco/webdav 

15. En cas que vulgueu visitar de manera segura la interfície web d'Alfresco mitjançant el servidor intermediari Nginx amb SSL, creeu un certificat autofirmat per a Nginx al directori /etc/nginx/ssl/ i ompliu el certificat amb la vostra configuració personalitzada. tal com es mostra a la captura de pantalla següent:

# mkdir /etc/nginx/ssl
# cd /etc/nginx/ssl/
# openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout alfresco.key -out alfresco.crt

Pareu atenció al Nom comú del certificat perquè coincideixi amb el nom d'amfitrió del vostre domini.

17. A continuació, obriu el fitxer de configuració de Nginx per editar-lo i afegiu el bloc següent abans de l'últim claudàtor de tancament (el símbol }).

# vi /etc/nginx/nginx.conf

Fragment del bloc SSL de 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. Finalment, reinicieu el dimoni Nginx per aplicar els canvis, afegiu una nova regla de tallafoc per al port 443.

# systemctl restart nginx
# firewall-cmd -add-service=https --permanent
# firewall-cmd --reload

i indiqueu al navegador l'URL del vostre domini mitjançant el protocol HTTPS.

https://IP_or_domain.tld/share/
https://IP_or_domain.tld/alfresco/

19. Per habilitar els dimonis Alfresco i Nginx a tot el sistema, executeu l'ordre següent:

# systemctl enable nginx alfresco

Això és tot! Alfresco ofereix integració amb MS Office i LibreOffice mitjançant el protocol CIF que proporciona un flux de treball familiar per als usuaris.