Cum se instalează dotCMS pe Ubuntu 16.04

• Cerințe preliminare
• Instalați Java
• Instalați PostgreSQL
• Instalați dotCMS
• Configurați Systemd
• Configurați proxy-ul invers

DotCMS este un sistem de gestionare a conținutului open-source, de calitate a întreprinderii, scris în Java. Conține aproape fiecare caracteristică necesară pentru a crea un site web pentru afacerea dvs. Acesta oferă o API RESTful pentru a se integra cu alte servicii, cum ar fi CRM, aplicații mobile și multe altele. Folosește Elasticsearch pentru indexarea conținutului în timp real și Redis pentru implementarea unui cache multi-nivel.

Cerințe preliminare

• O instanță a serverului Vultr Ubuntu 16.04.
• Un utilizator sudo .
• Un nume de domeniu îndreptat către server.

Pentru acest tutorial, vom folosi 192.168.0.1 ca adresă IP publică și cms.example.com ca nume de domeniu indicat spre instanța Vultr. Vă rugăm să vă asigurați că înlocuiți toate aparițiile numelui de domeniu și adresa IP publică cu una reală

Actualizați-vă sistemul de bază utilizând ghidul Cum să actualizați Ubuntu 16.04 . După ce sistemul dvs. a fost actualizat, continuați să instalați Java.

Instalați Java

Adăugați depozitul Ubuntu pentru Oracle Java 8.

sudo add-apt-repository --yes ppa:webupd8team/java
sudo apt update

Instalați Java.

sudo apt -y install oracle-java8-installer

Veți putea verifica versiunea Java.

java -version

Veți vedea următoarea ieșire.

user@vultr:~$ java -version
java version "1.8.0_161"
Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)

Setați calea implicită pentru Java instalând următorul pachet.

sudo apt -y install oracle-java8-set-default

Puteți verifica că JAVA_HOMEeste setat.

echo $JAVA_HOME

Ar trebui să vedeți următoarele.

user@vultr:~$ echo $JAVA_HOME
/usr/lib/jvm/java-8-oracle

Dacă nu vedeți deloc ieșire, va trebui să vă deconectați de pe shell-ul curent și să vă autentificați.

Instalați PostgreSQL

În mod implicit, dotCMS este configurat pentru a utiliza motorul bazei de date H2. Motorul bazei de date H2 este un motor de baze de date bazat pe fișiere plate. Nu se recomandă utilizarea în producție. În acest tutorial, vom folosi serverul PostgreSQL pentru a stoca baza de date dotCMS.

PostgreSQL este un sistem de baze de date relațional cu obiecte, cunoscut pentru stabilitatea și viteza sa. Depozitul Ubuntu implicit conține o versiune veche a PostgreSQL, deci adăugați depozitul PostgreSQL.

echo "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt update

Instalați serverul de baze de date PostgreSQL.

sudo apt -y install postgresql

Porniți serverul PostgreSQL și permiteți-l să pornească automat la momentul de pornire.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Modificați parola pentru utilizatorul implicit PostgreSQL.

sudo passwd postgres

Conectați-vă ca utilizator PostgreSQL.

sudo su - postgres

Creați un nou utilizator PostgreSQL pentru dotCMS.

createuser dotcms 

PostgreSQL furnizează psql shell - ul pentru a rula interogări pe serverul de baze de date. Comutați la shell-ul PostgreSQL.

psql

Setați o parolă pentru utilizatorul nou creat pentru baza de date dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Înlocuiți parola utilizatorului bazei de date DBPassword cu o parolă sigură.

Creați o nouă bază de date pentru instalarea dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Ieșiți din psql coajă.

\q

Comutați la sudo utilizator.

exit

Instalați dotCMS

Descărcați arhiva dotCMS.

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

Puteți găsi întotdeauna linkul la cea mai recentă versiune a aplicației pe pagina de descărcare dotCMS .

Creați un nou director pentru a stoca fișierele dotCMS și a le extrage în acesta.

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

Deschideți fișierul de configurare a bazei de date.

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

Găsiți H2 blocul.

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

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

Comentează întreaga H2 secțiune mutând delimitatorul de comentarii --> de la începutul secțiunii la sfârșitul secțiunii. Ar trebui să arate după cum urmează.

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

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

Decomandați secțiunea PostgreSQL prin eliminarea delimiterului de comentarii --> de la sfârșitul secțiunii și plasarea acesteia pe ambalajul de sus POSTGRESQL. De asemenea, găsiți username= și password= înlocuiți valorile existente cu numele de utilizator și parola utilizatorului dvs. de bază de date PostgreSQL. Dacă ați utilizat o altă bază de date decât dotcms, atunci va trebui să modificați numele bazei de date în url=. Odată configurat, blocul PostgreSQL din fișier va arăta după cum urmează.

<!-- 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" />

Furnizați permisiunea de execuție pentru toate fișierele executabile.

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

DotCMS este acum instalat pe serverul dvs. Pentru a rula imediat aplicația, executați următoarele.

cd /opt/dotcms
sudo bin/startup.sh

Veți vedea următoarea ieșire atunci când serverul a început cu succes.

user@vultr:/opt/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:        /usr
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.

Comanda de mai sus va porni serverul web Tomcat pentru a servi aplicația pe port 8080.

Deschideți browserul preferat și răsfoiți la http://192.168.0.1:8080. Veți vedea că aplicația rulează un site web demo. Dacă nu vedeți site-ul dvs. web, vă rugăm să așteptați, deoarece prima pornire a serverului dotCMS durează cinci-zece minute, deoarece scrie date în baza de date PostgreSQL și creează memoria cache. Puteți verifica, de asemenea, jurnalele de pornire.

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

Configurați Systemd

Serverul dotCMS poate fi pornit direct folosind scriptul de pornire furnizat în pachetul de instalare. Ca și comoditate, ar trebui să configurați un fișier unitate Systemd pentru serverul dotCMS. Acest lucru vă va asigura că serverul de aplicații este pornit automat la repornirea sistemului și a eșecurilor.

Opriți rularea serverului dotCMS folosind scriptul de oprire.

sudo bin/shutdown.sh

Creați un utilizator neprivitat pentru a rula serverul dotCMS, din motive de securitate.

sudo adduser --home /opt/dotcms -gecos "dotCMS User" --disabled-password --disabled-login dotcms

Oferiți proprietatea fișierelor utilizatorului dotCMS.

sudo chown -R dotcms:dotcms /opt/dotcms

Creați un nou serviciu Systemd.

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

Populați fișierul.

[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

Porniți aplicația și activați-o pentru a porni automat la momentul de pornire.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Asigurați-vă că serviciul este în funcțiune.

sudo systemctl status dotcms

Configurați proxy-ul invers

În mod implicit, serverul dotCMS ascultă port 8080. Vom configura Nginx ca proxy invers, astfel încât aplicația să poată fi accesată prin standard HTTP și HTTPS porturi. De asemenea, vom configura Nginx pentru a utiliza SSL-ul generat cu Let's Encrypt.

Instalați Nginx.

sudo apt -y install nginx

Porniți Nginx și permiteți-l să pornească automat la momentul de pornire.

sudo systemctl start nginx
sudo systemctl enable nginx

Adăugați depozitul Certbot.

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

Instalați Certbot, care este aplicația client pentru Let's Encrypt CA.

sudo apt -y install certbot

Notă: Pentru a obține certificate de la Let's Encrypt CA, domeniul pentru care se vor genera certificatele trebuie îndreptat către server. Dacă nu, faceți modificările necesare în înregistrările DNS ale domeniului și așteptați propagarea DNS înainte de a face din nou cererea de certificare. Certbot verifică autoritatea domeniului înainte de furnizarea certificatelor.

Generați certificatele SSL.

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

Este posibil ca certificatele generate să fie stocate în /etc/letsencrypt/live/cms.example.com/. Să criptăm certificatele să expire în 90 de zile, de aceea este recomandat să configurați reînnoirea automată a certificatelor folosind joburi Cron.

Deschideți fișierul de job cron.

sudo crontab -e

Adăugați următoarea linie la sfârșitul fișierului.

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

Slujba cron de mai sus va rula în fiecare zi la 5:30 AM. Dacă certificatul expiră, acesta va fi reînnoit automat.

Creați un nou fișier de bloc de server pentru site-ul dotCMS.

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

Populați fișierul.

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

Activați configurația.

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

Reporniți serverul web Nginx pentru ca modificările să aibă efect.

sudo systemctl restart nginx

Aplicația dotCMS este acum instalată pe serverul dvs. pentru utilizare. Accesați tabloul de bord administrativ pe următoarea adresă.

https://cms.example.com/dotAdmin

Conectați-vă folosind contul inițial de administrator [email protected] și parola admin. Modificați parola implicită imediat după autentificare.

Felicitări, sistemul de gestionare a conținutului dotCMS este acum instalat pe serverul dvs. Puteți modifica site-ul demo sau puteți începe să vă construiți site-ul de la zero.