Как да инсталирате 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 вече е инсталирана на вашия сървър. Можете да модифицирате демонстрационния сайт или да започнете да създавате своя сайт от нулата.