Ako nainštalovať dotCMS na Ubuntu 16.04

Predpoklady

Nainštalujte Java

Nainštalujte PostgreSQL

Nainštalujte dotCMS

Nakonfigurujte Systemd

Nakonfigurujte reverzný proxy

DotCMS je open source podnikový systém na správu obsahu napísaný v jazyku Java. Obsahuje takmer všetky funkcie potrebné na vytvorenie webovej stránky pre vašu firmu. Poskytuje RESTful API na integráciu s inými službami, ako je CRM, mobilné aplikácie a ďalšie. Používa Elasticsearch na indexovanie obsahu v reálnom čase a Redis na implementáciu viacvrstvovej vyrovnávacej pamäte.

Predpoklady

• Inštancia servera Vultr Ubuntu 16.04.
• Sudo používateľ .
• Názov domény nasmerovaný na server.

V tomto návode budeme používať 192.168.0.1 ako verejnú IP adresu a cms.example.com ako názov domény smerujúci k inštancii Vultr. Uistite sa, že ste nahradili všetky výskyty vzorového názvu domény a verejnej IP adresy skutočnými.

Aktualizujte svoj základný systém pomocou príručky Ako aktualizovať Ubuntu 16.04 . Po aktualizácii systému pokračujte v inštalácii Java.

Nainštalujte Java

Pridajte úložisko Ubuntu pre Oracle Java 8.

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

Nainštalujte Java.

sudo apt -y install oracle-java8-installer

Verziu Java si budete môcť overiť.

java -version

Uvidíte nasledujúci výstup.

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)

Nastavte predvolenú cestu pre Java inštaláciou nasledujúceho balíka.

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

Môžete si overiť, že JAVA_HOMEje to nastavené.

echo $JAVA_HOME

Mali by ste vidieť nasledovné.

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

Ak nevidíte žiadny výstup, budete sa musieť odhlásiť z aktuálneho shellu a znova sa prihlásiť.

Nainštalujte PostgreSQL

Predvolene je dotCMS nakonfigurovaný na používanie databázového nástroja H2. Databázový stroj H2 je databázový stroj založený na plochých súboroch. Neodporúča sa používať vo výrobe. V tomto návode použijeme PostgreSQL server na uloženie databázy dotCMS.

PostgreSQL je objektovo-relačný databázový systém známy svojou stabilitou a rýchlosťou. Predvolené úložisko Ubuntu obsahuje starú verziu PostgreSQL, takže pridajte úložisko 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

Nainštalujte databázový server PostgreSQL.

sudo apt -y install postgresql

Spustite server PostgreSQL a povoľte jeho automatické spustenie pri štarte.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Zmeňte heslo pre predvoleného používateľa PostgreSQL.

sudo passwd postgres

Prihláste sa ako používateľ PostgreSQL.

sudo su - postgres

Vytvorte nového používateľa PostgreSQL pre dotCMS.

createuser dotcms 

PostgreSQL poskytuje psql shell na spúšťanie dotazov na databázovom serveri. Prepnite sa do prostredia PostgreSQL.

psql

Nastavte heslo pre novovytvoreného používateľa pre databázu dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Nahraďte heslo používateľa databázy DBPassword bezpečným heslom.

Vytvorte novú databázu pre inštaláciu dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Vyjdite z psql ulity.

\q

Prepnúť na sudo používateľa.

exit

Nainštalujte dotCMS

Stiahnite si archív dotCMS.

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

Odkaz na najnovšiu verziu aplikácie nájdete vždy na stránke na stiahnutie dotCMS .

Vytvorte nový adresár na uloženie súborov dotCMS a extrahujte ich doň.

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

Otvorte konfiguračný súbor databázy.

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

Nájdite H2 blok.

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

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

Okomentujte celú H2 sekciu presunutím oddeľovača komentára --> zo začiatku sekcie na koniec sekcie. Malo by to vyzerať nasledovne.

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

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

Uncomment the PostgreSQL section by removing the comment delimiter --> from the end of section and placing it on the top wrapping POSTGRESQL. Also, find username= and password= and replace the existing values with the username and password of your PostgreSQL database user. If you have used a database name other than dotcms, then you will need to change the database name in url=. Once configured, the PostgreSQL block in the file will look like the following.

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

Provide the execution permission for all the executable files.

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

DotCMS is now installed on your server. To immediately run the application, execute the following.

cd /opt/dotcms
sudo bin/startup.sh

You will see the following output when the server has started successfully.

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.

The above command will start the Tomcat web server to serve the application on 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

Create a new Systemd service.

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

Populate the file.

[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 the application and enable it to automatically start at boot time.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Ensure that the service is running.

sudo systemctl status dotcms

Configure the Reverse Proxy

By default, the dotCMS server listens on port 8080. We will configure Nginx as the reverse proxy so that the application can be accessed via the standard HTTP and HTTPS ports. We will also configure Nginx to use the SSL generated with Let's Encrypt.

Install Nginx.

sudo apt -y install nginx

Start Nginx and enable it to automatically start at boot time.

sudo systemctl start nginx
sudo systemctl enable nginx

Add the Certbot repository.

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

Install Certbot, which is the client application for Let's Encrypt CA.

sudo apt -y install certbot

Poznámka: Ak chcete získať certifikáty od Let's Encrypt CA, doména, pre ktorú sa majú certifikáty vygenerovať, musí byť nasmerovaná na server. Ak nie, vykonajte potrebné zmeny v záznamoch DNS domény a počkajte, kým sa DNS rozšíri, a až potom znova požiadajte o certifikát. Certbot pred poskytnutím certifikátov skontroluje autoritu domény.

Vygenerujte certifikáty SSL.

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

Vygenerované certifikáty budú pravdepodobne uložené v /etc/letsencrypt/live/cms.example.com/. Platnosť certifikátov Let's Encrypt vyprší o 90 dní, preto sa odporúča nastaviť automatické obnovovanie certifikátov pomocou úloh Cron.

Otvorte súbor úlohy cron.

sudo crontab -e

Na koniec súboru pridajte nasledujúci riadok.

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

Vyššie uvedená úloha cron sa spustí každý deň o 5:30. Ak platnosť certifikátu vyprší, automaticky sa obnoví.

Vytvorte nový súbor bloku servera pre lokalitu dotCMS.

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

Vyplňte súbor.

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

Aktivujte konfiguráciu.

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

Reštartujte webový server Nginx, aby sa zmeny prejavili.

sudo systemctl restart nginx

Aplikácia dotCMS je teraz nainštalovaná na vašom serveri na produkčné použitie. Prístup k administratívnemu panelu nájdete na nasledujúcej adrese.

https://cms.example.com/dotAdmin

Prihláste sa pomocou počiatočného účtu správcu [email protected] a hesla admin. Ihneď po prihlásení zmeňte predvolené heslo.

Gratulujeme, systém na správu obsahu dotCMS je teraz nainštalovaný na vašom serveri. Môžete upraviť demo stránku alebo môžete začať budovať svoju stránku od začiatku.