Comment installer Alfresco Community Edition sur Ubuntu 16.04

• Conditions préalables
• Installer les dépendances
• Installer Alfresco
• Configurer le proxy inverse

Alfresco Community Edition est une version open source des services de contenu Alfresco. Il est écrit en Java et utilise PostgreSQL pour stocker sa base de données. Alfresco est un système de gestion de contenu d'entreprise pour de nombreux types d'actifs numériques tels que des documents, des enregistrements, du Web, des images, des vidéos et plus encore. Il est également utilisé pour le développement de contenu collaboratif. Le référentiel de fichiers de votre Alfresco hébergé est accessible à l'aide de SMB, WebDAV, FTP et CIMS. La recherche dans les fichiers est optimisée par Apache Solr.

Conditions préalables

• Une instance de serveur Vultr Ubuntu 16.04 avec au moins 4 Go de RAM.
• Un utilisateur sudo .
• Un nom de domaine pointé vers le serveur.

Pour ce didacticiel, nous utiliserons 192.168.0.1 comme adresse IP publique et share.example.com comme nom de domaine pointé vers l'instance Vultr. Veuillez vous assurer de remplacer toutes les occurrences de l'exemple de nom de domaine et de l'adresse IP publique par celui-ci.

Mettez à jour votre système de base à l'aide du guide Comment mettre à jour Ubuntu 16.04 . Une fois votre système mis à jour, procédez à l'installation des dépendances.

Installer les dépendances

Alfresco fournit un package d'installation binaire prêt à installer qui contient tous les logiciels requis pour exécuter l'application. Cependant, nous devons installer quelques dépendances pour prendre en charge le plugin LibreOffice.

sudo apt -y install fontconfig libsm-dev libice-dev libxt-dev libxrender-dev libxext-dev cups libglu1-mesa-dev libcairo2-dev libgl-dev
sudo ln -s /usr/lib/x86_64-linux-gnu/mesa/libGL.so.1 /usr/lib/x86_64-linux-gnu/libGL.so.1

Installer Alfresco

Téléchargez le package d'installation sur le site Web d'Alfresco. Vous pouvez toujours trouver le lien vers le dernier programme d'installation sur la page de téléchargement d'Alfresco .

wget https://download.alfresco.com/release/community/201707-build-00028/alfresco-community-installer-201707-linux-x64.bin

Fournissez des autorisations d'exécution au fichier d'installation.

sudo chmod +x alfresco-community-installer-201707-linux-x64.bin

Démarrez l'installation.

sudo ./alfresco-community-installer-201707-linux-x64.bin

Sélectionnez la langue de l'installation. Pour le type d'installation, vous pouvez choisir le premier qui dit " Easy install". Cela installera l'application avec la configuration par défaut.

Choisissez l'emplacement par défaut,, /opt/alfresco-communitypour l'installation de l'application.

Spécifiez le mot de passe administrateur et choisissez " Y" pour l'installation en tant que service. Cela créera un service de démarrage pour démarrer et gérer facilement le processus de demande.

Remarque: Alfresco recommande au moins 2 processeurs et 4 Go de RAM. Si votre système n'a pas la configuration recommandée, vous pouvez recevoir un avertissement indiquant que l'environnement n'est pas configuré de manière optimale pour Alfresco Content Services. Vous pouvez cependant continuer l'installation.

L'installation de l'application devrait commencer maintenant. Une fois l'application installée, il vous sera demandé si vous souhaitez lancer Alfresco Community Server. Si vous choisissez " Y", l'application démarrera le serveur immédiatement et vous verrez la sortie suivante.

Launch Alfresco Community [Y/n]: y

waiting for server to start.... done
server started
/opt/alfresco-community/postgresql/scripts/ctl.sh : postgresql  started at port 5432
Using CATALINA_BASE:   /opt/alfresco-community/tomcat
Using CATALINA_HOME:   /opt/alfresco-community/tomcat
Using CATALINA_TMPDIR: /opt/alfresco-community/tomcat/temp
Using JRE_HOME:        /opt/alfresco-community/java
Using CLASSPATH:       /opt/alfresco-community/tomcat/bin/bootstrap.jar:/opt/alfresco-community/tomcat/bin/tomcat-juli.jar
Using CATALINA_PID:    /opt/alfresco-community/tomcat/temp/catalina.pid
Tomcat started.
/opt/alfresco-community/tomcat/scripts/ctl.sh : tomcat started

Étant donné que le programme d'installation a également ajouté un service de démarrage, vous pouvez également démarrer l'application.

sudo systemctl start alfresco

Par défaut, Alfresco démarre le serveur Web Tomcat pour servir l'application sur le port 8080. Ouvrez votre navigateur préféré et allez à http://192.168.0.1:8080/share, vous verrez la page de destination Alfresco.

Configurer le proxy inverse

Par défaut, le serveur Tomcat d'Alfresco écoute le port 8080. Dans ce tutoriel, nous utiliserons Nginx comme proxy inverse afin que l'application soit accessible via la norme HTTP et les HTTPS ports. Nous allons également configurer Nginx pour utiliser un SSL généré avec Let's Encrypt.

Installez Nginx.

sudo apt -y install nginx

Démarrez Nginx et activez-le pour démarrer automatiquement au démarrage.

sudo systemctl start nginx
sudo systemctl enable nginx

Ajoutez le référentiel Certbot.

sudo add-apt-repository --yes ppa:certbot/certbot
sudo apt-get update

Installez Certbot, qui est l'application cliente de Let's Encrypt CA.

sudo apt -y install certbot

Remarque: Pour obtenir des certificats de Let's Encrypt CA, le domaine pour lequel les certificats doivent être générés doit être dirigé vers le serveur. Sinon, apportez les modifications nécessaires aux enregistrements DNS du domaine et attendez que le DNS se propage avant de refaire la demande de certificat. Certbot vérifie l'autorité de domaine avant de fournir les certificats.

Générez les certificats SSL.

sudo certbot certonly --webroot -w /var/www/html -d share.example.com

Les certificats générés sont susceptibles d'être stockés dans /etc/letsencrypt/live/share.example.com/. Les certificats Let's Encrypt expirent dans 90 jours, il est donc recommandé de configurer le renouvellement automatique des certificats à l'aide des tâches Cron.

Ouvrez le fichier de tâche cron.

sudo crontab -e

Ajoutez la ligne suivante à la fin du fichier.

30 5 * * * /usr/bin/certbot renew --quiet

La tâche cron ci-dessus s'exécutera tous les jours à 5h30. Si le certificat doit expirer, il sera automatiquement renouvelé.

Modifiez le fichier de configuration du serveur Tomcat d'Alfresco.

sudo nano /opt/alfresco-community/tomcat/conf/server.xml

Trouvez les lignes suivantes.

<Connector port="8080" URIEncoding="UTF-8" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" maxHttpHeaderSize="32768" />

Ajoutez la ligne proxyPort="443" scheme="https" dans le bloc de configuration ci-dessus pour qu'elle ressemble au bloc illustré ci-dessous.

<Connector port="8080" URIEncoding="UTF-8" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" maxHttpHeaderSize="32768" 
               proxyPort="443" scheme="https" />

Ouvrez le fichier de configuration par défaut d'Alfresco.

sudo nano /opt/alfresco-community/tomcat/shared/classes/alfresco-global.properties

Trouvez les lignes suivantes.

alfresco.context=alfresco
alfresco.host=127.0.0.1
alfresco.port=8080
alfresco.protocol=http

share.context=share
share.host=127.0.0.1
share.port=8080
share.protocol=http

...

system.serverMode=UNKNOWN

Modifiez les lignes ci-dessus en fonction de votre système. Il devrait ressembler à ce qui est illustré ci-dessous.

alfresco.context=alfresco
alfresco.host=share.example.com
alfresco.port=443
alfresco.protocol=https

share.context=share
share.host=share.example.com
share.port=443
share.protocol=https

...

system.serverMode=PRODUCTION

Créez un nouveau fichier de blocage de serveur pour Alfresco.

sudo nano /etc/nginx/sites-available/alfresco

Remplissez le fichier.

server {
    listen 80;
    server_name share.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443;
    server_name share.example.com;

    ssl_certificate           /etc/letsencrypt/live/share.example.com/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/share.example.com/privkey.pem;

    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/alfresco.access.log;
    location / {

           root /opt/alfresco-community/tomcat/webapps/ROOT;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080;
           proxy_redirect default;
    }

    location /share/ {
           root /opt/alfresco-community/tomcat/webapps/share/;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080/share/;
           proxy_redirect http:// https://;
    }

    location /alfresco/ {
           root /opt/alfresco-community/tomcat/webapps/alfresco/;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080/alfresco/;
           proxy_redirect http:// https://;
    }
}

Activez le fichier de configuration.

sudo ln -s /etc/nginx/sites-available/alfresco /etc/nginx/sites-enabled/alfresco

Redémarrez le serveur Web et Alfresco pour que les modifications de la configuration puissent prendre effet.

sudo systemctl restart nginx alfresco

Alfresco est maintenant installé et configuré sur votre serveur. Vous pouvez accéder aux modules Alfresco à l'adresse suivante.

https://share.example.com/alfresco

Pour accéder aux services de partage Alfresco, visitez l'adresse suivante.

https://share.example.com/share

Connectez-vous en utilisant le compte administrateur initial admin et le mot de passe que vous avez choisi lors de l'installation.

Félicitations, l'édition communautaire Alfresco est maintenant installée sur votre serveur.