Sådan installeres dotCMS på Ubuntu 16.04

DotCMS er et open source, enterprise-grade content management system skrevet i Java. Den indeholder næsten alle de funktioner, der kræves for at oprette en hjemmeside til din virksomhed. Det giver en RESTful API til at integrere med andre tjenester såsom CRM, mobilapplikationer og mere. Den bruger Elasticsearch til realtidsindeksering af indhold og Redis til implementering af en multi-tier cache.

Forudsætninger

• En Vultr Ubuntu 16.04-serverinstans.
• En sudo-bruger .
• Et domænenavn pegede mod serveren.

Til denne vejledning vil vi bruge 192.168.0.1 som den offentlige IP-adresse og cms.example.com som domænenavnet, der pegede mod Vultr-forekomsten. Sørg for at erstatte alle forekomster af eksempeldomænenavnet og den offentlige IP-adresse med den faktiske.

Opdater dit basissystem ved hjælp af vejledningen Sådan opdaterer du Ubuntu 16.04 . Når dit system er blevet opdateret, skal du fortsætte med at installere Java.

Installer Java

Tilføj Ubuntu-depotet til Oracle Java 8.

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

Installer Java.

sudo apt -y install oracle-java8-installer

Du vil være i stand til at verificere Javas version.

java -version

Du vil se følgende output.

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)

Indstil standardstien til Java ved at installere følgende pakke.

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

Du kan bekræfte, at det JAVA_HOMEer indstillet.

echo $JAVA_HOME

Du bør se følgende.

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

Hvis du slet ikke ser noget output, skal du logge ud fra den aktuelle shell og logge ind igen.

Installer PostgreSQL

Som standard er dotCMS konfigureret til at bruge H2-databasemotoren. H2-databasemotoren er en fladfilbaseret databasemotor. Det anbefales ikke at bruge i produktionen. I denne vejledning vil vi bruge PostgreSQL-serveren til at gemme dotCMS-databasen.

PostgreSQL er et objektrelationelt databasesystem, kendt for dets stabilitet og hastighed. Standard Ubuntu-depotet indeholder en gammel version af PostgreSQL, så tilføj PostgreSQL-depotet.

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

Installer PostgreSQL-databaseserveren.

sudo apt -y install postgresql

Start PostgreSQL-serveren og aktiver den til at starte automatisk ved opstart.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Skift adgangskoden til standard PostgreSQL-brugeren.

sudo passwd postgres

Log ind som PostgreSQL-bruger.

sudo su - postgres

Opret en ny PostgreSQL-bruger til dotCMS.

createuser dotcms 

PostgreSQL leverer psql skallen til at køre forespørgsler på databaseserveren. Skift til PostgreSQL-skallen.

psql

Indstil en adgangskode for den nyoprettede bruger til dotCMS-databasen.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Erstat databasens brugeradgangskode DBPassword med en sikker adgangskode.

Opret en ny database til dotCMS-installationen.

CREATE DATABASE dotcms OWNER dotcms;

Udgang fra psql skallen.

\q

Skift til sudo brugeren.

exit

Installer dotCMS

Download dotCMS-arkivet.

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

Du kan altid finde linket til den seneste version af applikationen på dotCMS-downloadsiden .

Opret en ny mappe til at gemme dotCMS-filerne og udpakke dem ind i den.

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

Åbn databasens konfigurationsfil.

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

Find H2 blokken.

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

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

Kommenter hele H2 afsnittet ved at flytte kommentarafgrænseren --> fra starten af ​​afsnittet til slutningen af ​​afsnittet. Det skal se ud som følgende.

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

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

Fjern kommentarer til PostgreSQL-sektionen ved at fjerne kommentarafgrænseren --> fra slutningen af ​​sektionen og placere den på den øverste indpakning POSTGRESQL. Find username= og password= og erstat de eksisterende værdier med brugernavnet og adgangskoden til din PostgreSQL-databasebruger. Hvis du har brugt et andet databasenavn end dotcms, så skal du ændre databasenavnet i url=. Når den er konfigureret, vil PostgreSQL-blokken i filen se ud som følgende.

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

Angiv eksekveringstilladelsen for alle de eksekverbare filer.

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

DotCMS er nu installeret på din server. For straks at køre programmet skal du udføre følgende.

cd /opt/dotcms
sudo bin/startup.sh

Du vil se følgende output, når serveren er startet.

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.

Ovenstående kommando starter Tomcat-webserveren for at betjene applikationen på port 8080.

Open your favorite browser and browse to http://192.168.0.1:8080. You will see that the application is running a demo website. If you do not see your website, please wait as the first startup of the dotCMS server takes five to ten minutes as it writes data into the PostgreSQL database and builds the cache. You can also check the startup logs.

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

Configure Systemd

The dotCMS server can be started directly using the startup script provided in the installer package. As a matter of convenience, you should set up a Systemd unit file for the dotCMS server. This will ensure that the application server is automatically started on system restart and failures.

Stop the running dotCMS server using the shutdown script.

sudo bin/shutdown.sh

Create an unprivileged user for running the dotCMS server, for security reasons.

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

Provide ownership of the files to the dotCMS user.

sudo chown -R dotcms:dotcms /opt/dotcms

Opret en ny Systemd-tjeneste.

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

Udfyld filen.

[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

Start applikationen og aktiver den til automatisk at starte ved opstart.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Sørg for, at tjenesten kører.

sudo systemctl status dotcms

Konfigurer den omvendte proxy

Som standard lytter dotCMS-serveren på port 8080. Vi vil konfigurere Nginx som den omvendte proxy, så applikationen kan tilgås via standarden HTTP og HTTPS portene. Vi vil også konfigurere Nginx til at bruge SSL genereret med Let's Encrypt.

Installer Nginx.

sudo apt -y install nginx

Start Nginx og aktiver den til automatisk at starte ved opstart.

sudo systemctl start nginx
sudo systemctl enable nginx

Tilføj Certbot-depotet.

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

Installer Certbot, som er klientapplikationen til Let's Encrypt CA.

sudo apt -y install certbot

Bemærk: For at få certifikater fra Let's Encrypt CA, skal det domæne, som certifikaterne skal genereres for, pege mod serveren. Hvis ikke, skal du foretage de nødvendige ændringer i domænets DNS-poster og vente på, at DNS'en udbreder sig, før du foretager certifikatanmodningen igen. Certbot kontrollerer domæneautoriteten, før certifikaterne leveres.

Generer SSL-certifikaterne.

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

De genererede certifikater vil sandsynligvis blive gemt i /etc/letsencrypt/live/cms.example.com/. Lad os kryptere certifikater udløber om 90 dage, derfor anbefales det at konfigurere automatisk fornyelse af certifikaterne ved hjælp af Cron-job.

Åbn cron-jobfilen.

sudo crontab -e

Tilføj følgende linje i slutningen af ​​filen.

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

Ovenstående cron-job kører hver dag kl. 5:30. Hvis certifikatet udløber, vil det automatisk blive fornyet.

Opret en ny serverblokfil til dotCMS-webstedet.

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

Udfyld filen.

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

Aktiver konfigurationen.

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

Genstart Nginx-webserveren, så ændringerne kan træde i kraft.

sudo systemctl restart nginx

DotCMS-applikationen er nu installeret på din server til produktionsbrug. Få adgang til det administrative dashboard på følgende adresse.

https://cms.example.com/dotAdmin

Log ind med den oprindelige administratorkonto [email protected] og adgangskoden admin. Skift standardadgangskoden umiddelbart efter login.

Tillykke, dotCMS indholdsstyringssystemet er nu installeret på din server. Du kan ændre demo-webstedet, eller du kan begynde at bygge dit websted fra bunden.