Як встановити dotCMS на Ubuntu 16.04

Передумови

Встановіть Java

Встановіть PostgreSQL

Встановіть dotCMS

Налаштуйте Systemd

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

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

Передумови

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

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

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

Встановіть Java

Додайте репозиторій Ubuntu для Oracle Java 8.

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

Встановіть Java.

sudo apt -y install oracle-java8-installer

Ви зможете перевірити версію Java.

java -version

Ви побачите наступний висновок.

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)

Встановіть шлях за замовчуванням для Java, встановивши наступний пакет.

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

Ви можете переконатися, що JAVA_HOMEце встановлено.

echo $JAVA_HOME

Ви повинні побачити наступне.

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

Якщо ви не бачите жодного виводу, вам потрібно буде вийти з поточної оболонки та знову ввійти.

Встановіть PostgreSQL

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

PostgreSQL - це об'єктно-реляційна система баз даних, відома своєю стабільністю та швидкістю. Сховище Ubuntu за замовчуванням містить стару версію PostgreSQL, тому додайте репозиторій 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

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

sudo apt -y install postgresql

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

sudo systemctl start postgresql
sudo systemctl enable postgresql

Змініть пароль для користувача 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.3.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

Після успішного запуску сервера ви побачите наступний висновок.

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.

Наведена вище команда запустить веб-сервер Tomcat для обслуговування програми на порту 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

Створіть нову службу 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, згенерованого за допомогою Let's Encrypt.

Встановіть Nginx.

sudo apt -y install nginx

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

sudo systemctl start nginx
sudo systemctl enable nginx

Додайте сховище Certbot.

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

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

sudo apt -y install certbot

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

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

sudo certbot certonly --webroot -w /var/www/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/sites-available/dotcms

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

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

Активуйте конфігурацію.

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

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

sudo systemctl restart nginx

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

https://cms.example.com/dotAdmin

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

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