Jak nainstalovat dotCMS na Ubuntu 16.04

Předpoklady

Nainstalujte Javu

Nainstalujte PostgreSQL

Nainstalujte dotCMS

Konfigurace Systemd

Nakonfigurujte reverzní proxy

DotCMS je open-source podnikový systém pro správu obsahu napsaný v Javě. Obsahuje téměř všechny funkce potřebné k vytvoření webových stránek pro vaši firmu. Poskytuje RESTful API pro integraci s dalšími službami, jako je CRM, mobilní aplikace a další. Využívá Elasticsearch pro indexování obsahu v reálném čase a Redis pro implementaci vícevrstvé mezipaměti.

Předpoklady

• Instance serveru Vultr Ubuntu 16.04.
• Uživatel sudo .
• Název domény směřující k serveru.

Pro tento tutoriál použijeme 192.168.0.1 jako veřejnou IP adresu a cms.example.com jako název domény směřující k instanci Vultr. Ujistěte se, že jste nahradili všechny výskyty vzorového názvu domény a veřejné IP adresy skutečnými.

Aktualizujte svůj základní systém pomocí průvodce Jak aktualizovat Ubuntu 16.04 . Jakmile bude váš systém aktualizován, pokračujte v instalaci Javy.

Nainstalujte Javu

Přidejte úložiště Ubuntu pro Oracle Java 8.

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

Nainstalujte Javu.

sudo apt -y install oracle-java8-installer

Budete moci ověřit verzi Java.

java -version

Uvidíte následující 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 výchozí cestu pro Java instalací následujícího balíčku.

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

Můžete ověřit, že JAVA_HOMEje nastaveno.

echo $JAVA_HOME

Měli byste vidět následující.

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

Pokud nevidíte vůbec žádný výstup, budete se muset odhlásit z aktuálního shellu a znovu se přihlásit.

Nainstalujte PostgreSQL

Ve výchozím nastavení je dotCMS nakonfigurován pro použití databázového stroje H2. Databázový stroj H2 je databázový stroj založený na plochých souborech. Nedoporučuje se používat ve výrobě. V tomto tutoriálu použijeme PostgreSQL server k uložení databáze dotCMS.

PostgreSQL je objektově relační databázový systém, známý svou stabilitou a rychlostí. Výchozí úložiště Ubuntu obsahuje starou verzi PostgreSQL, takže přidejte úložiště 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

Nainstalujte databázový server PostgreSQL.

sudo apt -y install postgresql

Spusťte PostgreSQL server a povolte jeho automatické spouštění při bootování.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Změňte heslo pro výchozího uživatele PostgreSQL.

sudo passwd postgres

Přihlaste se jako uživatel PostgreSQL.

sudo su - postgres

Vytvořte nového uživatele PostgreSQL pro dotCMS.

createuser dotcms 

PostgreSQL poskytuje psql prostředí pro spouštění dotazů na databázovém serveru. Přepněte do prostředí PostgreSQL.

psql

Nastavte heslo pro nově vytvořeného uživatele pro databázi dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Nahraďte heslo uživatele databáze DBPassword bezpečným heslem.

Vytvořte novou databázi pro instalaci dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Vyjděte ze psql skořápky.

\q

Přepnout na sudo uživatele.

exit

Nainstalujte dotCMS

Stáhněte si archiv dotCMS.

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

Odkaz na nejnovější verzi aplikace vždy najdete na stránce ke stažení dotCMS .

Vytvořte nový adresář pro uložení souborů dotCMS a extrahujte je do něj.

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

Otevřete konfigurační soubor databáze.

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

Najděte H2 blok.

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

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

Zakomentujte celou H2 sekci přesunutím oddělovače komentáře --> ze začátku sekce na konec sekce. Mělo by to vypadat následovně.

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

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

Odkomentujte sekci PostgreSQL odstraněním oddělovače komentáře --> z konce sekce a jeho umístěním na horní obal POSTGRESQL. Také vyhledejte username= a password= nahraďte existující hodnoty uživatelským jménem a heslem uživatele vaší databáze PostgreSQL. Pokud jste použili jiný název databáze než dotcms, budete muset změnit název databáze v url=. Po konfiguraci bude blok PostgreSQL v souboru vypadat následovně.

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

Poskytněte oprávnění ke spuštění pro všechny spustitelné soubory.

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

DotCMS je nyní nainstalován na vašem serveru. Pro okamžité spuštění aplikace proveďte následující.

cd /opt/dotcms
sudo bin/startup.sh

Po úspěšném spuštění serveru uvidíte následující výstup.

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.

Výše uvedený příkaz spustí webový server Tomcat, aby obsluhoval aplikaci na portu 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

Vytvořte novou službu Systemd.

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

Vyplňte soubor.

[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

Spusťte aplikaci a povolte její automatické spouštění při spouštění.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Ujistěte se, že služba běží.

sudo systemctl status dotcms

Nakonfigurujte reverzní proxy

Server dotCMS standardně naslouchá na portu 8080. Nakonfigurujeme Nginx jako reverzní proxy, aby bylo možné přistupovat k aplikaci přes standard HTTP a HTTPS porty. Nakonfigurujeme také Nginx tak, aby používal SSL generovaný pomocí Let's Encrypt.

Nainstalujte Nginx.

sudo apt -y install nginx

Spusťte Nginx a povolte jeho automatické spouštění při spouštění.

sudo systemctl start nginx
sudo systemctl enable nginx

Přidejte úložiště Certbot.

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

Nainstalujte Certbot, což je klientská aplikace pro Let's Encrypt CA.

sudo apt -y install certbot

Poznámka: Chcete-li získat certifikáty od Let's Encrypt CA, doména, pro kterou mají být certifikáty generovány, musí být nasměrována na server. Pokud ne, proveďte potřebné změny v záznamech DNS domény a počkejte, až se DNS rozšíří, než znovu požádáte o certifikát. Certbot před poskytnutím certifikátů zkontroluje autoritu domény.

Vygenerujte certifikáty SSL.

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

Vygenerované certifikáty budou pravděpodobně uloženy ve formátu /etc/letsencrypt/live/cms.example.com/. Platnost certifikátů Let's Encrypt vyprší za 90 dní, proto se doporučuje nastavit automatické obnovování certifikátů pomocí úloh Cron.

Otevřete soubor úlohy cron.

sudo crontab -e

Přidejte následující řádek na konec souboru.

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

Výše uvedená úloha cron se spustí každý den v 5:30. Pokud má platnost certifikátu vypršet, bude automaticky obnoven.

Vytvořte nový soubor bloku serveru pro web dotCMS.

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

Vyplňte soubor.

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 konfiguraci.

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

Restartujte webový server Nginx, aby se změny projevily.

sudo systemctl restart nginx

Aplikace dotCMS je nyní nainstalována na vašem serveru pro produkční použití. Přístup k administrativnímu panelu na následující adrese.

https://cms.example.com/dotAdmin

Přihlaste se pomocí počátečního účtu správce [email protected] a hesla admin. Ihned po přihlášení změňte výchozí heslo.

Gratulujeme, systém pro správu obsahu dotCMS je nyní nainstalován na vašem serveru. Můžete upravit demo stránku nebo můžete začít budovat svůj web od začátku.