Како инсталирати дотЦМС на Убунту 16.04

Предуслови

Инсталирајте Јава

Инсталирајте ПостгреСКЛ

Инсталирајте дотЦМС

Конфигуришите Системд

Конфигуришите обрнути прокси

ДотЦМС је систем за управљање садржајем отвореног кода за предузећа написан на Јави. Садржи скоро све функције потребне за креирање веб странице за ваше пословање. Пружа РЕСТфул АПИ за интеграцију са другим услугама као што су ЦРМ, мобилне апликације и још много тога. Користи Еластицсеарцх за индексирање садржаја у реалном времену и Редис за имплементацију вишеслојног кеша.

Предуслови

• Инстанца сервера Вултр Убунту 16.04.
• : Судо корисника .
• Име домена усмерено ка серверу.

За овај водич користићемо 192.168.0.1 као јавну ИП адресу и cms.example.com као име домена усмерено на Вултр инстанцу. Обавезно замените сва појављивања примера имена домена и јавне ИП адресе стварним.

Ажурирајте свој основни систем користећи водич Како ажурирати Убунту 16.04 . Када се ваш систем ажурира, наставите са инсталирањем Јаве.

Инсталирајте Јава

Додајте Убунту спремиште за Орацле Јава 8.

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

Инсталирајте Јава.

sudo apt -y install oracle-java8-installer

Моћи ћете да проверите верзију Јаве.

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)

Поставите подразумевану путању за Јаву тако што ћете инсталирати следећи пакет.

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

Можете да проверите да ли JAVA_HOMEје постављено.

echo $JAVA_HOME

Требало би да видите следеће.

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

Ако уопште не видите никакав излаз, мораћете да се одјавите из тренутне љуске и поново се пријавите.

Инсталирајте ПостгреСКЛ

Подразумевано, дотЦМС је конфигурисан да користи механизам базе података Х2. Механизам базе података Х2 је механизам базе података заснован на равним датотекама. Не препоручује се употреба у производњи. У овом водичу ћемо користити ПостгреСКЛ сервер за складиштење дотЦМС базе података.

ПостгреСКЛ је објектно-релациони систем базе података, познат по својој стабилности и брзини. Подразумевано Убунту спремиште садржи стару верзију ПостгреСКЛ-а, па додајте ПостгреСКЛ спремиште.

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

Инсталирајте ПостгреСКЛ сервер базе података.

sudo apt -y install postgresql

Покрените ПостгреСКЛ сервер и омогућите му да се аутоматски покреће при покретању.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Промените лозинку за подразумеваног корисника ПостгреСКЛ.

sudo passwd postgres

Пријавите се као ПостгреСКЛ корисник.

sudo su - postgres

Креирајте новог ПостгреСКЛ корисника за дотЦМС.

createuser dotcms 

ПостгреСКЛ обезбеђује psql љуску за покретање упита на серверу базе података. Пређите на ПостгреСКЛ шкољку.

psql

Поставите лозинку за новокреираног корисника за дотЦМС базу података.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Замените корисничку лозинку базе података DBPassword безбедном лозинком.

Креирајте нову базу података за инсталацију дотЦМС-а.

CREATE DATABASE dotcms OWNER dotcms;

Изађите из psql љуске.

\q

Пребаците се на sudo корисника.

exit

Инсталирајте дотЦМС

Преузмите дотЦМС архиву.

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

Увек можете пронаћи везу до најновије верзије апликације на страници за преузимање дотЦМС-а .

Направите нови директоријум за складиштење дотЦМС датотека и издвојите их у њега.

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. Такође, пронађите username= и password= замените постојеће вредности корисничким именом и лозинком вашег корисника ПостгреСКЛ базе података. Ако сте користили име базе података другачије од dotcms, онда ћете морати да промените име базе података у url=. Једном конфигурисан, ПостгреСКЛ блок у датотеци ће изгледати овако.

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

ДотЦМС је сада инсталиран на вашем серверу. Да бисте одмах покренули апликацију, извршите следеће.

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.

Горња команда ће покренути Томцат веб сервер да опслужује апликацију на порту 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

Креирајте нову Системд услугу.

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

Конфигуришите обрнути прокси

ДотЦМС сервер подразумевано слуша порт 8080. Нгинк ћемо конфигурисати као обрнути прокси тако да се апликацији може приступити преко стандарда HTTP и HTTPS портова. Такође ћемо конфигурисати Нгинк да користи ССЛ генерисан помоћу Лет'с Енцрипт.

Инсталирајте Нгинк.

sudo apt -y install nginx

Покрените Нгинк и омогућите му да се аутоматски покреће при покретању.

sudo systemctl start nginx
sudo systemctl enable nginx

Додајте Цертбот спремиште.

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

Инсталирајте Цертбот, који је клијентска апликација за Лет'с Енцрипт ЦА.

sudo apt -y install certbot

Напомена: Да бисте добили сертификате од Лет'с Енцрипт ЦА, домен за који треба да се генеришу сертификати мора бити усмерен ка серверу. Ако није, извршите неопходне промене у ДНС записима домена и сачекајте да се ДНС пропагира пре него што поново поднесете захтев за сертификат. Цертбот проверава ауторитет домена пре пружања сертификата.

Генеришите ССЛ сертификате.

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

Генерисани сертификати ће вероватно бити ускладиштени у /etc/letsencrypt/live/cms.example.com/. Лет'с Енцрипт сертификати истичу за 90 дана, па се препоручује да подесите аутоматско обнављање сертификата помоћу Црон послова.

Отворите црон датотеку посла.

sudo crontab -e

Додајте следећи ред на крај датотеке.

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

Горњи црон посао ће се покретати сваког дана у 5:30 ујутро. Ако сертификат истекне, аутоматски ће се обновити.

Креирајте нову датотеку блока сервера за дотЦМС локацију.

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

Поново покрените Нгинк веб сервер да би промене ступиле на снагу.

sudo systemctl restart nginx

Апликација дотЦМС је сада инсталирана на вашем серверу за производну употребу. Приступите административној контролној табли на следећој адреси.

https://cms.example.com/dotAdmin

Пријавите се користећи почетни администраторски налог [email protected] и лозинку admin. Промените подразумевану лозинку одмах након пријављивања.

Честитамо, дотЦМС систем за управљање садржајем је сада инсталиран на вашем серверу. Можете да измените демо локацију или можете да почнете да правите своју веб локацију од нуле.