Як встановити dotCMS на CentOS 7

Передумови

Встановіть Java

Встановіть PostgreSQL

Встановіть dotCMS

Налаштуйте службу Systemd

Налаштуйте зворотний проксі-сервер

dotCMS — це система управління вмістом корпоративного рівня з відкритим вихідним кодом, написана на Java. Він містить майже всі функції, необхідні для створення веб-сайту для вашого бізнесу. Він забезпечує RESTful API для інтеграції з іншими службами, такими як CRM, мобільні додатки тощо. Він використовує Elasticsearch для індексації вмісту в реальному часі та Redis для реалізації багаторівневого кешу.

Ця стаття була написана для dotCMS 4.2.2, однак надані інструкції можуть працювати і для новіших версій.

Передумови

• Примірник сервера Vultr CentOS 7.
• Користувач sudo .
• Доменне ім’я, спрямоване на сервер.

У цьому підручнику ми будемо використовувати 192.168.0.1як загальнодоступну IP-адресу та cms.example.comяк доменне ім’я, спрямоване на екземпляр Vultr. Будь ласка, не забудьте замінити всі приклади доменного імені та загальнодоступної IP-адреси фактичними.

Оновіть свою базову систему за допомогою посібника Як оновити CentOS 7 . Після оновлення системи перейдіть до встановлення Java.

Встановіть Java

OpenJDK можна легко встановити, оскільки пакет доступний у сховищі YUM за замовчуванням.

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

Якщо Java встановлена ​​правильно, ви зможете перевірити її версію.

java -version

Ви отримаєте аналогічний результат.

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

Перш ніж ми зможемо продовжити, нам потрібно буде налаштувати змінні середовища JAVA_HOMEта JRE_HOME. Знайдіть абсолютний шлях до виконуваного файлу Java у вашій системі.

readlink -f $(which java)

Ви побачите подібний вихід.

[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

Тепер встановіть змінні середовища JAVA_HOMEта JRE_HOMEвідповідно до шляху до каталогу 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

Виконайте bash_profileфайл.

source ~/.bash_profile

Тепер ви можете запустити echo $JAVA_HOMEкоманду, щоб переконатися, що змінна середовища встановлено.

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

Встановіть PostgreSQL

За замовчуванням dotCMS налаштовано на використання механізму баз даних H2. Механізм баз даних H2 — це система баз даних на основі плоского файлу. Не рекомендується використовувати у виробництві. У цьому підручнику ми будемо використовувати сервер PostgreSQL для зберігання бази даних dotCMS.

PostgreSQL - це об'єктно-реляційна система баз даних, відома своєю стабільністю та швидкістю. Додайте в систему репозиторій останнього випуску PostgreSQL.

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

Встановіть сервер бази даних PostgreSQL.

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

Ініціалізуйте базу даних.

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

Запустіть сервер PostgreSQL і ввімкніть його автоматичний запуск під час завантаження.

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

Змініть пароль для користувача PostgreSQL за замовчуванням.

sudo passwd postgres

Увійдіть як користувач PostgreSQL за замовчуванням.

sudo su - postgres

Створіть нового користувача PostgreSQL для dotCMS.

createuser dotcms 

PostgreSQL надає psqlоболонку для виконання запитів на сервері бази даних. Перейдіть до оболонки PostgreSQL.

psql

Встановіть пароль для новоствореного користувача для бази даних dotCMS.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Замініть пароль користувача бази даних DBPasswordна безпечний пароль. Створіть нову базу даних для встановлення dotCMS.

CREATE DATABASE dotcms OWNER dotcms;

Вихід з psqlоболонки.

\q

Перейти до sudoкористувача.

exit

Встановіть dotCMS

Завантажте архів dotCMS.

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

Ви завжди можете знайти посилання на останню версію програми на сторінці завантаження dotCMS .

Створіть новий каталог для зберігання файлів dotCMS та розпакуйте їх у нього.

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

Відкрийте файл конфігурації бази даних.

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

Знайдіть H2блок.

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

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

Прокоментуйте весь H2розділ, замінивши роздільник коментарів -->від початку розділу до кінця розділу. Це має виглядати наступним чином.

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

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

Розкоментуйте розділ PostgreSQL, видаливши роздільник коментарів -->з кінця розділу та розмістивши його у верхній обгортці POSTGRESQL. Також знайдіть username=і password=замініть наявні значення ім’ям користувача та паролем вашого користувача бази даних PostgreSQL. Якщо ви використовували інше ім’я бази даних, ніж dotcms, вам потрібно буде змінити ім’я бази даних у url=. Після налаштування блок PostgreSQL у файлі має виглядати так.

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

Надайте дозвіл на виконання для всіх виконуваних файлів.

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

dotCMS тепер встановлено на вашому сервері. Щоб негайно запустити програму, виконайте наступне.

cd /opt/dotcms
sudo bin/startup.sh

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

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

The above command will start the Tomcat web server to serve the application on port 8080. To check if the dotCMS website is working, allow the required port 8080 through the system firewall.

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

Open your favorite browser and browse to http://192.168.0.1:8080. You should 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 a couple of 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 service

Сервер dotCMS можна запустити безпосередньо за допомогою сценарію запуску, наданого в пакеті інсталятора. Для зручності вам слід налаштувати файл модуля Systemd для сервера dotCMS. Це забезпечить автоматичний запуск сервера додатків при перезавантаженні системи та збоях.

Зупиніть запущений сервер dotCMS за допомогою сценарію завершення роботи.

sudo bin/shutdown.sh

З міркувань безпеки створіть непривілейованого користувача для запуску сервера dotCMS.

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

Надайте право власності на файли користувачеві dotCMS.

sudo chown -R dotcms:dotcms /opt/dotcms

Створіть нову службу Systemd.

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

Заповніть файл.

[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

Запустіть програму та ввімкніть її автоматичний запуск під час завантаження.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Переконайтеся, що служба запущена.

sudo systemctl status dotcms

Налаштуйте зворотний проксі-сервер

За замовчуванням сервер dotCMS прослуховує порт 8080. Ми налаштуємо Nginx як зворотний проксі-сервер, щоб до програми можна було отримати доступ через стандарт HTTPі HTTPSпорти. Ми також налаштуємо Nginx на використання SSL, згенерованого за допомогою безкоштовного SSL Let's Encrypt.

Встановіть веб-сервер Nginx.

sudo yum -y install nginx

Запустіть веб-сервер і ввімкніть його автоматичний запуск під час завантаження.

sudo systemctl start nginx
sudo systemctl enable nginx

Установіть Certbot, який є клієнтською програмою для Let's Encrypt CA.

sudo yum -y install certbot

Перш ніж ви зможете запитати сертифікати, вам потрібно буде дозволити порти 80та/ 443або стандарт HTTPі HTTPSслужби через брандмауер. Також видаліть порт 8080зі списку винятків брандмауера, оскільки він більше не потрібен.

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

Примітка. Щоб отримати сертифікати від Let's Encrypt CA, домен, для якого мають бути створені сертифікати, має бути спрямований на сервер. Якщо ні, внесіть необхідні зміни в записи DNS домену та зачекайте, поки DNS пошириться, перш ніж знову надсилати запит на сертифікат. Certbot перевіряє авторитет домену перед наданням сертифікатів.

Згенеруйте сертифікати SSL.

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

Згенеровані сертифікати, ймовірно, зберігатимуться в /etc/letsencrypt/live/cms.example.com/. Термін дії сертифікатів Let's Encrypt закінчується через 90 днів, тому рекомендується налаштувати автоматичне оновлення сертифікатів за допомогою завдань Cron.

Відкрийте файл завдання cron.

sudo crontab -e

Додайте наступний рядок у кінці файлу.

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

Вищезазначене завдання cron виконуватиметься щодня о 5:30 ранку. Якщо термін дії сертифіката закінчився, його буде автоматично поновлено.

Створіть новий файл блоку сервера для сайту dotCMS.

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

Заповніть файл.

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

Перезапустіть веб-сервер Nginx, щоб зміни вступили в силу.

sudo systemctl restart nginx

Програма dotCMS тепер встановлена ​​на вашому сервері для використання у виробництві. Отримайте доступ до адміністративної панелі за такою адресою.

https://cms.example.com/dotAdmin

Увійдіть, використовуючи початковий обліковий запис адміністратора, [email protected]і admin. Змініть пароль за замовчуванням відразу після входу.

Вітаємо, система керування вмістом dotCMS тепер встановлена ​​на вашому сервері. Ви можете змінити демонстраційний сайт або почати створювати свій сайт з нуля.