Comment installer dotCMS sur CentOS 7

• Conditions préalables
• Installer Java
• Installer PostgreSQL
• Installer dotCMS
• Configurer le service Systemd
• Configurer le proxy inverse

dotCMS est un système de gestion de contenu d'entreprise open source écrit en Java. Il contient presque toutes les fonctionnalités requises pour créer un site Web pour votre entreprise. Il fournit une API RESTful pour s'intégrer à d'autres services tels que le CRM, les applications mobiles, etc. Il utilise Elasticsearch pour l'indexation en temps réel du contenu et Redis pour implémenter le cache à plusieurs niveaux.

Cet article a été écrit pour dotCMS 4.2.2, mais les instructions fournies peuvent également fonctionner pour les versions plus récentes.

Conditions préalables

• Une instance de serveur Vultr CentOS 7.
• Un utilisateur sudo .
• Un nom de domaine pointé vers le serveur.

Pour ce didacticiel, nous utiliserons 192.168.0.1comme adresse IP publique et cms.example.comcomme 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 CentOS 7 . Une fois votre système mis à jour, installez Java.

Installer Java

OpenJDK peut être facilement installé car le package est disponible dans le référentiel YUM par défaut.

sudo yum -y install java-1.8.0-openjdk-devel

Si Java est installé correctement, vous pourrez vérifier sa version.

java -version

Vous obtiendrez une sortie similaire.

[user@vultr ~]$ java -version
openjdk version "1.8.0_151"
OpenJDK Runtime Environment (build 1.8.0_151-b12)
OpenJDK 64-Bit Server VM (build 25.151-b12, mixed mode)

Avant de continuer, nous devrons configurer les variables d'environnement JAVA_HOMEet JRE_HOME. Trouvez le chemin absolu de l'exécutable Java sur votre système.

readlink -f $(which java)

Vous verrez une sortie similaire.

[user@vultr ~]$ readlink -f $(which java)
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.151-1.b12.el7_4.x86_64/jre/bin/java

Maintenant, définissez les variables d'environnement JAVA_HOMEet en JRE_HOMEfonction du chemin du répertoire Java.

echo "export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.151-1.b12.el7_4.x86_64" >> ~/.bash_profile
echo "export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.151-1.b12.el7_4.x86_64/jre" >> ~/.bash_profile

Exécutez le bash_profilefichier.

source ~/.bash_profile

Vous pouvez maintenant exécuter la echo $JAVA_HOMEcommande pour vous assurer que la variable d'environnement est définie.

[user@vultr ~]$ echo $JAVA_HOME
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.151-1.b12.el7_4.x86_64

Installer PostgreSQL

Par défaut, dotCMS est configuré pour utiliser le moteur de base de données H2. Le moteur de base de données H2 est un moteur de base de données basé sur des fichiers plats. Il n'est pas recommandé de l'utiliser en production. Dans ce tutoriel, nous utiliserons le serveur PostgreSQL pour stocker la base de données dotCMS.

PostgreSQL est un système de base de données relationnelle objet et connu pour sa stabilité et sa vitesse. Ajoutez le référentiel de la dernière version de PostgreSQL dans le système.

sudo yum -y install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-1.noarch.rpm

Installez le serveur de base de données PostgreSQL.

sudo yum -y install postgresql10-server postgresql10-contrib postgresql10 

Initialisez la base de données.

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

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

sudo systemctl start postgresql-10
sudo systemctl enable postgresql-10

Modifiez le mot de passe de l'utilisateur PostgreSQL par défaut.

sudo passwd postgres

Connectez-vous en tant qu'utilisateur PostgreSQL par défaut.

sudo su - postgres

Créez un nouvel utilisateur PostgreSQL pour dotCMS.

createuser dotcms 

PostgreSQL fournit le psqlshell pour exécuter des requêtes sur le serveur de base de données. Basculez vers le shell PostgreSQL.

psql

Définissez un mot de passe pour l'utilisateur nouvellement créé pour la base de données dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Remplacez le mot DBPasswordde passe utilisateur de la base de données par un mot de passe sécurisé. Créez une nouvelle base de données pour l'installation dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Sortez du psqlshell.

\q

Passez à l' sudoutilisateur.

exit

Installer dotCMS

Téléchargez l'archive dotCMS.

wget https://dotcms.com/physical_downloads/release_builds/dotcms_4.2.2.tar.gz

Vous pouvez toujours trouver le lien vers la dernière version de l'application sur la page de téléchargement dotCMS .

Créez un nouveau répertoire pour stocker les fichiers dotCMS et extrayez-les dedans.

sudo mkdir /opt/dotcms
sudo tar -zxf dotcms*.tar.gz -C /opt/dotcms

Ouvrez le fichier de configuration de la base de données.

cd /opt/dotcms
sudo nano dotserver/tomcat-*/webapps/ROOT/META-INF/context.xml

Trouvez le H2bloc.

<!-- H2 -->
<Resource name="jdbc/dotCMSPool" auth="Container"
 ...

 validationQuery="SELECT 1" testOnBorrow="true" testWhileIdle="true" />

Mettez en commentaire la H2section entière en remplaçant le délimiteur -->de commentaires du début à la fin de la section. Il devrait ressembler à ce qui suit.

<!-- H2
<Resource name="jdbc/dotCMSPool" auth="Container"
 ...

 validationQuery="SELECT 1" testOnBorrow="true" testWhileIdle="true" />
-->

Supprimez la mise en commentaire -->de la section PostgreSQL en supprimant le délimiteur de commentaires à la fin de la section et en le plaçant sur l'enveloppe supérieure POSTGRESQL. , Trouver également username=et password=et remplacer les valeurs existantes avec le nom d' utilisateur et mot de passe utilisateur de votre base de données PostgreSQL. Si vous avez utilisé un nom de base de données autre que dotcms, vous devrez modifier le nom de la base de données dans url=. Une fois configuré, le bloc PostgreSQL dans le fichier devrait ressembler à ce qui suit.

<!-- POSTGRESQL -->
<Resource name="jdbc/dotCMSPool" auth="Container"
      type="javax.sql.DataSource"
      factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
      driverClassName="org.postgresql.Driver"
      url="jdbc:postgresql://localhost/dotcms"
      username="dotcms" password="DBPassword" maxTotal="60" maxIdle="10" maxWaitMillis="60000"
      removeAbandonedOnBorrow="true" removeAbandonedOnMaintenance="true" removeAbandonedTimeout="60" logAbandoned="true"
      timeBetweenEvictionRunsMillis="30000" validationQuery="SELECT 1" testOnBorrow="true" testWhileIdle="true" />

Fournissez l'autorisation d'exécution pour tous les fichiers exécutables.

sudo chmod 755 ./bin/*.sh
sudo chmod 755 dotserver/tomcat-*/bin/*.sh

dotCMS est maintenant installé sur votre serveur. Pour exécuter immédiatement l'application, exécutez ce qui suit.

cd /opt/dotcms
sudo bin/startup.sh

Vous verrez la sortie suivante lorsque le serveur a démarré avec succès.

[user@vultr dotcms]$ sudo bin/startup.sh
Using DOTCMS_HOME = /opt/dotcms/dotserver/tomcat-8.0.18/webapps/ROOT
Using DOTSERVER = dotcms
Using CATALINA_PID = /tmp/dotcms.pid
Using JAVA_OPTS =  -Djava.awt.headless=true -Xverify:none -Dfile.encoding=UTF8 -server -XX:+DisableExplicitGC -XX:MaxMetaspaceSize=512m -Xmx1G -XX:+UseG1GC -javaagent:/opt/dotcms/dotserver/tomcat-8.0.18/webapps/ROOT/WEB-INF/lib/byte-buddy-agent-1.6.12.jar -Ddotserver=dotcms
Using CATALINA_BASE:   /opt/dotcms/dotserver/tomcat-8.0.18
Using CATALINA_HOME:   /opt/dotcms/dotserver/tomcat-8.0.18
Using CATALINA_TMPDIR: /opt/dotcms/dotserver/tomcat-8.0.18/temp
Using JRE_HOME:        /
Using CLASSPATH:       /opt/dotcms/dotserver/tomcat-8.0.18/bin/bootstrap.jar:/opt/dotcms/dotserver/tomcat-8.0.18/bin/tomcat-juli.jar
Using CATALINA_PID:    /tmp/dotcms.pid
Tomcat started.

La commande ci-dessus démarre le serveur Web Tomcat pour servir l'application sur le port 8080. Pour vérifier si le site Web dotCMS fonctionne, autorisez le port requis 8080via le pare-feu du système.

sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

Ouvrez votre navigateur préféré et accédez à http://192.168.0.1:8080. Vous devriez voir que l'application exécute un site Web de démonstration. Si vous ne voyez pas votre site Web, veuillez patienter, car le premier démarrage du serveur dotCMS prend quelques minutes car il écrit des données dans la base de données PostgreSQL et crée le cache. Vous pouvez également consulter les journaux de démarrage.

tail -n 1000 -f /opt/dotcms/dotserver/tomcat-*/webapps/ROOT/dotsecure/logs/dotcms.log

Configurer le service Systemd

Le serveur dotCMS peut être démarré directement à l'aide du script de démarrage fourni dans le package d'installation. Par souci de commodité, vous devez configurer un fichier d'unité Systemd pour le serveur dotCMS. Cela garantira que le serveur d'applications démarre automatiquement au redémarrage et aux échecs du système.

Arrêtez le serveur dotCMS en cours d'exécution à l'aide du script d'arrêt.

sudo bin/shutdown.sh

Créez un utilisateur non privilégié pour exécuter le serveur dotCMS, pour des raisons de sécurité.

sudo adduser -d /opt/dotcms -s /sbin/nologin dotcms

Attribuez la propriété des fichiers à l'utilisateur dotCMS.

sudo chown -R dotcms:dotcms /opt/dotcms

Créez un nouveau service Systemd.

sudo nano /etc/systemd/system/dotcms.service

Remplissez le fichier.

[Unit]
Description=dotCMS service
After=syslog.target network.target

[Service]
Type=forking
ExecStart=/opt/dotcms/bin/startup.sh
ExecStop=/opt/dotcms/bin/shutdown.sh
User=dotcms
Group=dotcms
Restart=always

[Install]
WantedBy=multi-user.target

Démarrez l'application et activez-la pour qu'elle démarre automatiquement au démarrage.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Assurez-vous que le service est en cours d'exécution.

sudo systemctl status dotcms

Configurer le proxy inverse

Par défaut, le serveur dotCMS écoute sur le port 8080. Nous allons configurer Nginx comme proxy inverse afin que l'application soit accessible via la norme HTTPet les HTTPSports. Nous allons également configurer Nginx pour utiliser SSL généré avec Let's Encrypt SSL gratuit.

Installez le serveur Web Nginx.

sudo yum -y install nginx

Démarrez le serveur Web et activez-le pour qu'il démarre automatiquement au démarrage.

sudo systemctl start nginx
sudo systemctl enable nginx

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

sudo yum -y install certbot

Avant de pouvoir demander les certificats, vous devez autoriser les ports 80et / 443ou la norme HTTPet les HTTPSservices à travers le pare-feu. Supprimez également le port 8080de la liste des exceptions de pare-feu car il n'est plus nécessaire.

sudo firewall-cmd --zone=public --remove-port=8080/tcp --permanent
sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --zone=public --add-service=https --permanent
sudo firewall-cmd --reload

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 /usr/share/nginx/html -d cms.example.com

Les certificats générés sont susceptibles d'être stockés dans /etc/letsencrypt/live/cms.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é.

Créez un nouveau fichier de blocage de serveur pour le site dotCMS.

sudo nano /etc/nginx/conf.d/cms.example.com.conf

Remplissez le fichier.

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

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

    ssl_certificate           /etc/letsencrypt/live/cms.example.com/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/cms.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/dotcms.access.log;

    location / {

      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;

      proxy_pass          http://localhost:8080;
      proxy_read_timeout  90;

      proxy_redirect      http://localhost:8080 https://cms.example.com;
    }
  }

Redémarrez le serveur Web Nginx pour que les modifications prennent effet.

sudo systemctl restart nginx

L'application dotCMS est maintenant installée sur votre serveur pour une utilisation en production. Accédez au tableau de bord administratif à l'adresse suivante.

https://cms.example.com/dotAdmin

Connectez-vous en utilisant le compte administrateur initial [email protected]et admin. Modifiez le mot de passe par défaut immédiatement après la connexion.

Félicitations, le système de gestion de contenu dotCMS est maintenant installé sur votre serveur. Vous pouvez modifier le site de démonstration ou vous pouvez commencer à créer votre site à partir de zéro.