Jak zainstalować dotCMS na CentOS 7

• Wymagania wstępne
• Zainstaluj Javę
• Zainstaluj PostgreSQL
• Zainstaluj dotCMS
• Skonfiguruj usługę Systemd
• Skonfiguruj odwrotny serwer proxy

dotCMS to otwarty system zarządzania treścią klasy korporacyjnej napisany w Javie. Zawiera prawie wszystkie funkcje wymagane do stworzenia strony internetowej dla Twojej firmy. Zapewnia interfejs API RESTful do integracji z innymi usługami, takimi jak CRM, aplikacje mobilne i inne. Wykorzystuje Elasticsearch do indeksowania treści w czasie rzeczywistym i Redis do implementacji wielowarstwowej pamięci podręcznej.

Ten artykuł został napisany dla dotCMS 4.2.2, jednak dostarczone instrukcje mogą również działać w przypadku nowszych wersji.

Wymagania wstępne

• Instancja serwera Vultr CentOS 7.
• Użytkownik sudo .
• Nazwa domeny wskazuje na serwer.

W tym samouczku użyjemy 192.168.0.1jako publicznego adresu IP i cms.example.comnazwy domeny wskazanej na instancję Vultr. Pamiętaj, aby zastąpić wszystkie wystąpienia przykładowej nazwy domeny i publicznego adresu IP faktycznym.

Zaktualizuj system podstawowy za pomocą przewodnika Jak zaktualizować CentOS 7 . Po zaktualizowaniu systemu przejdź do instalacji Java.

Zainstaluj Javę

OpenJDK można łatwo zainstalować, ponieważ pakiet jest dostępny w domyślnym repozytorium YUM.

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

Jeśli Java jest poprawnie zainstalowana, będziesz mógł zweryfikować jej wersję.

java -version

Otrzymasz podobny wynik.

[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)

Zanim przejdziemy dalej, musimy skonfigurować zmienne środowiskowe JAVA_HOMEi JRE_HOME. Znajdź bezwzględną ścieżkę do pliku wykonywalnego Java w swoim systemie.

readlink -f $(which java)

Zobaczysz podobne wyjście.

[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

Teraz ustaw zmienne środowiskowe JAVA_HOMEi JRE_HOMEzgodnie ze ścieżką do katalogu 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

Uruchom bash_profileplik.

source ~/.bash_profile

Teraz możesz uruchomić echo $JAVA_HOMEpolecenie, aby upewnić się, że zmienna środowiskowa jest ustawiona.

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

Zainstaluj PostgreSQL

Domyślnie dotCMS jest skonfigurowany do korzystania z silnika bazy danych H2. Aparat bazy danych H2 jest silnikiem bazy danych opartym na plikach płaskich. Nie zaleca się stosowania w produkcji. W tym samouczku użyjemy serwera PostgreSQL do przechowywania bazy danych dotCMS.

PostgreSQL to obiektowo-relacyjny system baz danych znany ze swojej stabilności i szybkości. Dodaj repozytorium najnowszej wersji PostgreSQL do systemu.

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

Zainstaluj serwer bazy danych PostgreSQL.

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

Zainicjuj bazę danych.

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

Uruchom serwer PostgreSQL i włącz go automatycznie podczas uruchamiania.

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

Zmień hasło dla domyślnego użytkownika PostgreSQL.

sudo passwd postgres

Zaloguj się jako domyślny użytkownik PostgreSQL.

sudo su - postgres

Utwórz nowego użytkownika PostgreSQL dla dotCMS.

createuser dotcms 

PostgreSQL zapewnia psqlpowłokę do uruchamiania zapytań na serwerze bazy danych. Przejdź do powłoki PostgreSQL.

psql

Ustaw hasło dla nowo utworzonego użytkownika do bazy danych dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Zastąp hasło użytkownika bazy danych DBPasswordbezpiecznym hasłem. Utwórz nową bazę danych dla instalacji dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Wyjdź ze psqlskorupy.

\q

Przejdź do sudoużytkownika.

exit

Zainstaluj dotCMS

Pobierz archiwum dotCMS.

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

Zawsze możesz znaleźć link do najnowszej wersji aplikacji na stronie pobierania dotCMS .

Utwórz nowy katalog do przechowywania plików dotCMS i rozpakuj je do niego.

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

Otwórz plik konfiguracyjny bazy danych.

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

Znajdź H2blok.

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

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

Skomentuj całą H2sekcję, zastępując ogranicznik komentarza -->od początku sekcji do końca sekcji. Powinno to wyglądać następująco.

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

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

Odkomentuj sekcję PostgreSQL, usuwając separator komentarza -->z końca sekcji i umieszczając go na górnym opakowaniu POSTGRESQL. Znajdź username=i password=zamień istniejące wartości na nazwę użytkownika i hasło użytkownika bazy danych PostgreSQL. Jeśli użyłeś innej nazwy bazy danych dotcms, musisz zmienić nazwę bazy danych w url=. Po skonfigurowaniu blok PostgreSQL w pliku powinien wyglądać następująco.

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

Podaj uprawnienia do wykonywania wszystkich plików wykonywalnych.

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

dotCMS jest teraz zainstalowany na twoim serwerze. Aby natychmiast uruchomić aplikację, wykonaj następujące czynności.

cd /opt/dotcms
sudo bin/startup.sh

Po pomyślnym uruchomieniu serwera zobaczysz następujące dane wyjściowe.

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

Powyższe polecenie spowoduje uruchomienie serwera WWW Tomcat w celu obsługi aplikacji na porcie 8080. Aby sprawdzić, czy witryna internetowa dotCMS działa, należy zezwolić na wymagany port 8080przez zaporę systemową.

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

Otwórz swoją ulubioną przeglądarkę i przejdź do http://192.168.0.1:8080. Powinieneś zobaczyć, że aplikacja prowadzi witrynę demonstracyjną. Jeśli nie widzisz swojej witryny, poczekaj, ponieważ pierwsze uruchomienie serwera dotCMS zajmuje kilka minut, ponieważ zapisuje dane w bazie danych PostgreSQL i buduje pamięć podręczną. Możesz także sprawdzić dzienniki uruchamiania.

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

Skonfiguruj usługę Systemd

Serwer dotCMS można uruchomić bezpośrednio za pomocą skryptu uruchamiania dostarczonego w pakiecie instalatora. Dla wygody należy skonfigurować plik jednostki Systemd dla serwera dotCMS. Zapewni to automatyczne uruchomienie serwera aplikacji przy ponownym uruchomieniu systemu i awarii.

Zatrzymaj działający serwer dotCMS za pomocą skryptu zamykania.

sudo bin/shutdown.sh

Ze względów bezpieczeństwa utwórz nieuprzywilejowanego użytkownika do uruchamiania serwera dotCMS.

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

Przekaż własność plików użytkownikowi dotCMS.

sudo chown -R dotcms:dotcms /opt/dotcms

Utwórz nową usługę Systemd.

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

Wypełnij plik.

[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

Uruchom aplikację i włącz automatyczne uruchamianie podczas uruchamiania.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Upewnij się, że usługa jest uruchomiona.

sudo systemctl status dotcms

Skonfiguruj odwrotny serwer proxy

Domyślnie serwer dotCMS nasłuchuje na porcie 8080. Skonfigurujemy Nginx jako zwrotny serwer proxy, aby aplikacja była dostępna za pośrednictwem standardu HTTPi HTTPSportów. Skonfigurujemy również Nginx do korzystania z SSL wygenerowanego za pomocą Let's Encrypt free SSL.

Zainstaluj serwer WWW Nginx.

sudo yum -y install nginx

Uruchom serwer WWW i włącz automatyczne uruchamianie się podczas uruchamiania.

sudo systemctl start nginx
sudo systemctl enable nginx

Zainstaluj Certbot, aplikację kliencką dla Let's Encrypt CA.

sudo yum -y install certbot

Zanim będziesz mógł poprosić o certyfikaty, musisz zezwolić na porty 80i / 443lub standard HTTPi HTTPSusługi za pośrednictwem zapory ogniowej. Usuń także port 8080z listy wyjątków zapory, ponieważ nie jest już wymagany.

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

Uwaga: Aby uzyskać certyfikaty z Let's Encrypt CA, domena, dla której mają być generowane certyfikaty, musi być skierowana w stronę serwera. Jeśli nie, dokonaj niezbędnych zmian w rekordach DNS domeny i poczekaj na propagację DNS przed ponownym żądaniem certyfikatu. Certbot sprawdza urząd domeny przed podaniem certyfikatów.

Wygeneruj certyfikaty SSL.

sudo certbot certonly --webroot -w /usr/share/nginx/html -d cms.example.com

Wygenerowane certyfikaty prawdopodobnie będą przechowywane /etc/letsencrypt/live/cms.example.com/. Ważność certyfikatów Let's Encrypt wygasa za 90 dni, dlatego zaleca się skonfigurowanie automatycznego odnawiania certyfikatów za pomocą zadań Cron.

Otwórz plik zadania cron.

sudo crontab -e

Dodaj następujący wiersz na końcu pliku.

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

Powyższe zadanie crona będzie uruchamiane codziennie o 5:30. Jeśli certyfikat wygasa, zostanie automatycznie odnowiony.

Utwórz nowy plik bloku serwera dla witryny dotCMS.

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

Wypełnij plik.

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

Uruchom ponownie serwer WWW Nginx, aby zmiany mogły zostać wprowadzone.

sudo systemctl restart nginx

Aplikacja dotCMS jest teraz zainstalowana na serwerze do użytku produkcyjnego. Uzyskaj dostęp do administracyjnego pulpitu nawigacyjnego pod następującym adresem.

https://cms.example.com/dotAdmin

Zaloguj się przy użyciu początkowego konta administratora [email protected]i admin. Zmień domyślne hasło natychmiast po zalogowaniu.

Gratulacje, system zarządzania treścią dotCMS jest teraz zainstalowany na twoim serwerze. Możesz zmodyfikować witrynę demonstracyjną lub rozpocząć tworzenie witryny od zera.