Comment installer Alfresco Community Edition sur RHEL/CentOS 7/6 et Debian 8

Alfresco est un système ECM open source (Enterprise Content Management) écrit en Java qui fournit une gestion électronique, une collaboration et un contrôle des activités commerciales.

Install Alfresco Community Edition in Linux

Ce guide couvrira comment installer et configurer Alfresco Community Edition sur les systèmes RHEL/CentOS 7/6, Debian 8 et Ubuntu avec le serveur Nginx en tant que serveur web frontal pour l’application.

Exigences

En ce qui concerne les exigences minimales du système, Alfresco nécessite une machine avec au moins 4 Go de RAM et un système d’exploitation 64 bits.

Étape 1 : Installer Alfresco Community Edition

1. Avant de procéder à l’installation d’Alfresco, assurez-vous tout d’abord que l’utilitaire wget est installé sur votre machine en exécutant la commande ci-dessous avec des privilèges root ou depuis le compte root.

# yum install wget
# apt-get install wget

2. Ensuite, configurez le nom d’hôte de votre système et assurez-vous que la résolution locale pointe vers l’adresse IP de votre serveur en exécutant les commandes suivantes:

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

3. Supprimez tout MTA de la machine (dans ce cas, le serveur de messagerie Postfix) en exécutant la commande ci-dessous:

# yum remove postfix
# apt-get remove postfix

4. Installez les dépendances suivantes requises par le logiciel Alfresco pour fonctionner correctement :

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

5. Ensuite, allez à la page du dépôt de Alfresco Community Edition hébergée sur le portail sourceforge.net et téléchargez la dernière version binaire (c’est-à-dire alfresco-community-5.0.d-installer-linux-x64.bin) pour Linux en utilisant l’utilitaire wget.

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

6. Après la fin du téléchargement du fichier binaire, exécutez la commande suivante pour accorder les permissions d’exécution au fichier et exécuter l’installateur Alfresco.

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

7. Après le démarrage du processus d’installation, sélectionnez la langue et poursuivez le processus d’installation en utilisant le guide d’installation ci-dessous pour configurer 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] :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

Installation of Alfresco Community Edition

Assistant d’installation d’Alfresco en cours…

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

Installation d’Alfresco en cours…

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

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

Configuration de l’installation d’Alfresco en cours…

----------------------------------------------------------------------------
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....[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. Après la fin du processus d’installation et le démarrage des services Alfresco, exécutez les commandes ci-dessous pour ouvrir les ports de pare-feu suivants afin de permettre aux hôtes externes de votre réseau de se connecter à l’application 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

Si vous avez besoin d’ajouter d’autres règles de pare-feu pour ouvrir des ports afin d’accéder à des services Alfresco personnalisés, exécutez la commande ss pour obtenir une liste de tous les services s’exécutant sur votre machine.

# ss -tulpn

9. Pour accéder aux services web Alfresco, ouvrez un navigateur et utilisez les URLs suivantes (remplacez l’adresse IP ou le domaine en conséquence). Connectez-vous avec l’utilisateur admin et le mot de passe configuré pour Admin lors du processus d’installation.

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

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

Pour WebDAV.

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

Pour HTTPS, acceptez l’exception de sécurité.

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

Module Alfresco SharePoint avec Microsoft.

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

Étape 2 : Configurer Nginx en tant que serveur web frontal pour Alfresco

10. Pour installer le serveur Nginx sur le système, ajoutez d’abord les repositories Epel sur CentOS/RHEL en lançant la commande suivante :

# yum install epel-release

11. Une fois que les dépôts Epel sont ajoutés dans le système, procédez à l’installation du serveur web Nginx en lançant la commande suivante :

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

12. À l’étape suivante, ouvrez le fichier de configuration de Nginx depuis /etc/nginx/nginx.conf avec un éditeur de texte et effectuez les changements suivants :

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

Allez en dessous et assurez-vous de commenter la deuxième déclaration de localisation en plaçant un # devant les lignes suivantes :

#location / {
#        }

13. Une fois que vous avez terminé, enregistrez et fermez le fichier de configuration de Nginx et redémarrez le démon pour refléter le changement en lançant la commande suivante :

# systemctl restart nginx.service

14. Pour accéder à l’interface web d’Alfresco, ajoutez une nouvelle règle de pare-feu pour ouvrir le port 80 sur votre machine et accédez à l’URL ci-dessous. Assurez-vous également que la politique Selinux est désactivée sur les systèmes RHEL/CentOS.

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

Pour désactiver complètement la politique Selinux sur le système, ouvrez le fichier /etc/selinux/config et modifiez la ligne SELINUX de enforcing à disabled.

15. Vous pouvez maintenant accéder à Alfresco via Nginx.

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

15. Si vous souhaitez visiter de manière sécurisée l’interface web d’Alfresco via un proxy Nginx avec SSL, créez un certificat auto-signé pour Nginx dans le répertoire /etc/nginx/ssl/ et remplissez le certificat avec vos paramètres personnalisés comme illustré dans la capture d’écran ci-dessous :

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

Veillez à ce que le Nom commun du certificat corresponde au nom d’hôte de votre domaine.

17. Ensuite, ouvrez le fichier de configuration de Nginx pour l’édition et ajoutez le bloc suivant avant le dernier crochet fermant (le symbole }).

# vi /etc/nginx/nginx.conf

Extrait du bloc Nginx SSL :

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. Enfin, redémarrez le démon Nginx pour appliquer les modifications, ajoutez une nouvelle règle de pare-feu pour le port 443.

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

et indiquez au navigateur l’URL de votre domaine en utilisant le protocole HTTPS.

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

19. Pour activer les démons Alfresco et Nginx à l’échelle du système, exécutez la commande suivante :

# systemctl enable nginx alfresco

C’est tout ! Alfresco offre une intégration avec MS Office et LibreOffice via le protocole CIFs fournissant un flux de travail familier pour les utilisateurs.