Kako instalirati dotCMS na CentOS 7

Preduvjeti

Instalirajte Javu

Instalirajte PostgreSQL

Instalirajte dotCMS

Konfigurirajte Systemd uslugu

Konfigurirajte obrnuti proxy

dotCMS je open source sustav upravljanja sadržajem poslovnog razreda napisan na Javi. Sadrži gotovo sve značajke potrebne za izradu web stranice za vašu tvrtku. Pruža RESTful API za integraciju s drugim uslugama kao što su CRM, mobilne aplikacije i još mnogo toga. Koristi Elasticsearch za indeksiranje sadržaja u stvarnom vremenu i Redis za implementaciju višeslojne predmemorije.

Ovaj članak je napisan za dotCMS 4.2.2, no navedene upute mogu raditi i za novije verzije.

Preduvjeti

• Instanca poslužitelja Vultr CentOS 7.
• Korisnik sudoa .
• Naziv domene usmjeren prema poslužitelju.

Za ovaj vodič koristit ćemo 192.168.0.1kao javnu IP adresu i cms.example.comkao ime domene usmjereno na Vultr instancu. Svakako zamijenite sva pojavljivanja primjera naziva domene i javne IP adrese stvarnim.

Ažurirajte svoj osnovni sustav pomoću vodiča Kako ažurirati CentOS 7 . Nakon što se vaš sustav ažurira, nastavite s instalacijom Jave.

Instalirajte Javu

OpenJDK se može lako instalirati jer je paket dostupan u zadanom YUM spremištu.

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

Ako je Java ispravno instalirana, moći ćete provjeriti njezinu verziju.

java -version

Dobit ćete sličan izlaz.

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

Prije nego što nastavimo dalje, morat ćemo postaviti varijable okruženja JAVA_HOMEi JRE_HOME. Pronađite apsolutni put izvršne Java datoteke na vašem sustavu.

readlink -f $(which java)

Vidjet ćete sličan izlaz.

[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

Sada postavite varijable JAVA_HOMEi JRE_HOMEokoline prema putu Java direktorija.

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

Izvršite bash_profiledatoteku.

source ~/.bash_profile

Sada možete pokrenuti echo $JAVA_HOMEnaredbu kako biste bili sigurni da je varijabla okruženja postavljena.

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

Instalirajte PostgreSQL

Prema zadanim postavkama, dotCMS je konfiguriran za korištenje H2 baze podataka. Mehanizam baze podataka H2 je motor baze podataka baziran na ravnoj datoteci. Ne preporuča se koristiti u proizvodnji. U ovom vodiču koristit ćemo PostgreSQL poslužitelj za pohranu dotCMS baze podataka.

PostgreSQL je objektno-relacijski sustav baze podataka poznat po svojoj stabilnosti i brzini. Dodajte spremište najnovijeg izdanja PostgreSQL-a u sustav.

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

Instalirajte PostgreSQL poslužitelj baze podataka.

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

Inicijalizirajte bazu podataka.

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

Pokrenite PostgreSQL poslužitelj i omogućite mu automatsko pokretanje prilikom pokretanja.

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

Promijenite lozinku za zadanog korisnika PostgreSQL.

sudo passwd postgres

Prijavite se kao zadani PostgreSQL korisnik.

sudo su - postgres

Stvorite novog PostgreSQL korisnika za dotCMS.

createuser dotcms 

PostgreSQL pruža psqlljusku za pokretanje upita na poslužitelju baze podataka. Prijeđite na ljusku PostgreSQL.

psql

Postavite lozinku za novostvorenog korisnika za dotCMS bazu podataka.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Zamijenite korisničku lozinku baze podataka DBPasswordsigurnom lozinkom. Napravite novu bazu podataka za instalaciju dotCMS-a.

CREATE DATABASE dotcms OWNER dotcms;

Izađite iz psqlljuske.

\q

Prebacite se na sudokorisnika.

exit

Instalirajte dotCMS

Preuzmite dotCMS arhivu.

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

Link na najnoviju verziju aplikacije uvijek možete pronaći na stranici za preuzimanje dotCMS-a .

Napravite novi direktorij za pohranu dotCMS datoteka i izdvojite ih u njega.

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

Otvorite konfiguracijsku datoteku baze podataka.

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

Pronađite H2blok.

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

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

Komentirajte cijeli H2odjeljak zamjenom graničnika komentara -->od početka odjeljka do kraja odjeljka. Trebalo bi izgledati ovako.

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

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

Dekomentirajte odjeljak PostgreSQL tako da uklonite graničnik komentara -->s kraja odjeljka i stavite ga na gornji omotač POSTGRESQL. Također, pronađite username=i password=zamijenite postojeće vrijednosti korisničkim imenom i lozinkom vašeg korisnika PostgreSQL baze podataka. Ako ste koristili naziv baze podataka koji nije dotcms, tada ćete morati promijeniti naziv baze podataka u url=. Nakon što je konfiguriran, PostgreSQL blok u datoteci trebao bi izgledati ovako.

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

Osigurajte dopuštenje za izvršenje za sve izvršne datoteke.

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

dotCMS je sada instaliran na vašem poslužitelju. Da biste odmah pokrenuli aplikaciju, izvršite sljedeće.

cd /opt/dotcms
sudo bin/startup.sh

Vidjet ćete sljedeći izlaz kada se poslužitelj uspješno pokrene.

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

Gornja naredba će pokrenuti Tomcat web poslužitelj za posluživanje aplikacije na portu 8080. Da biste provjerili radi li web-mjesto dotCMS, dopustite traženi port 8080kroz vatrozid sustava.

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

Otvorite svoj omiljeni preglednik i idite na http://192.168.0.1:8080. Trebali biste vidjeti da aplikacija pokreće demo web stranicu. Ako ne vidite svoju web stranicu, pričekajte jer prvo pokretanje dotCMS poslužitelja traje nekoliko minuta dok zapisuje podatke u PostgreSQL bazu podataka i gradi predmemoriju. Također možete provjeriti zapisnike pokretanja.

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

Konfigurirajte Systemd uslugu

DotCMS poslužitelj može se pokrenuti izravno pomoću skripte za pokretanje koja se nalazi u paketu za instalaciju. Radi praktičnosti, trebali biste postaviti Systemd jediničnu datoteku za dotCMS poslužitelj. To će osigurati da se aplikacijski poslužitelj automatski pokrene nakon ponovnog pokretanja sustava i kvarova.

Zaustavite pokrenuti dotCMS poslužitelj pomoću skripte za isključivanje.

sudo bin/shutdown.sh

Stvorite neprivilegiranog korisnika za pokretanje dotCMS poslužitelja, iz sigurnosnih razloga.

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

Omogućite vlasništvo nad datotekama dotCMS korisniku.

sudo chown -R dotcms:dotcms /opt/dotcms

Napravite novu Systemd uslugu.

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

Popunite datoteku.

[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

Pokrenite aplikaciju i omogućite joj automatsko pokretanje prilikom pokretanja.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Provjerite je li usluga pokrenuta.

sudo systemctl status dotcms

Konfigurirajte obrnuti proxy

Prema zadanim postavkama, dotCMS poslužitelj sluša port 8080. Nginx ćemo konfigurirati kao obrnuti proxy tako da se aplikaciji može pristupiti putem standarda HTTPi HTTPSportova. Također ćemo konfigurirati Nginx da koristi SSL generiran s Let's Encrypt besplatnim SSL-om.

Instalirajte Nginx web poslužitelj.

sudo yum -y install nginx

Pokrenite web-poslužitelj i omogućite mu automatsko pokretanje prilikom pokretanja.

sudo systemctl start nginx
sudo systemctl enable nginx

Instalirajte Certbot, klijentsku aplikaciju za Let's Encrypt CA.

sudo yum -y install certbot

Prije nego što možete zatražiti certifikate, morat ćete dopustiti portove 80i/ 443ili standard HTTPi HTTPSusluge putem vatrozida. Također, uklonite port 8080s popisa izuzetaka vatrozida jer više nije potreban.

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

Napomena: Za dobivanje certifikata od Let's Encrypt CA, domena za koju se certifikati trebaju generirati mora biti usmjerena prema poslužitelju. Ako nije, izvršite potrebne promjene u DNS zapisima domene i pričekajte da se DNS širi prije nego što ponovno uputite zahtjev za certifikatom. Certbot provjerava autoritet domene prije pružanja certifikata.

Generirajte SSL certifikate.

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

Generirani certifikati vjerojatno će biti pohranjeni u /etc/letsencrypt/live/cms.example.com/. Let's Encrypt certifikati istječu za 90 dana, stoga je preporučljivo postaviti automatsku obnovu certifikata pomoću Cron poslova.

Otvorite cron datoteku posla.

sudo crontab -e

Dodajte sljedeći redak na kraj datoteke.

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

Gornji cron posao će se izvoditi svaki dan u 5:30 ujutro. Ako potvrda istekne, automatski će se obnoviti.

Izradite novu datoteku bloka poslužitelja za dotCMS mjesto.

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

Popunite datoteku.

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

Ponovno pokrenite Nginx web poslužitelj kako bi promjene mogle stupiti na snagu.

sudo systemctl restart nginx

Aplikacija dotCMS sada je instalirana na vašem poslužitelju za upotrebu u proizvodnji. Pristupite administrativnoj nadzornoj ploči na sljedećoj adresi.

https://cms.example.com/dotAdmin

Prijavite se pomoću početnog administratorskog računa [email protected]i admin. Promijenite zadanu lozinku odmah nakon prijave.

Čestitamo, sustav za upravljanje sadržajem dotCMS sada je instaliran na vašem poslužitelju. Možete izmijeniti demo stranicu ili možete početi graditi svoju stranicu od nule.