Kuinka asentaa dotCMS CentOS 7:ään

Edellytykset

Asenna Java

Asenna PostgreSQL

Asenna dotCMS

Määritä Systemd-palvelu

Määritä käänteinen välityspalvelin

dotCMS on avoimen lähdekoodin yritystason sisällönhallintajärjestelmä, joka on kirjoitettu Java-kielellä. Se sisältää lähes kaikki ominaisuudet, joita tarvitaan verkkosivuston luomiseen yrityksellesi. Se tarjoaa RESTful API:n integroitavaksi muihin palveluihin, kuten CRM:ään, mobiilisovelluksiin ja muihin palveluihin. Se käyttää Elasticsearchia sisällön reaaliaikaiseen indeksointiin ja Redistä monitasoisen välimuistin toteuttamiseen.

Tämä artikkeli on kirjoitettu dotCMS 4.2.2:lle, mutta annetut ohjeet saattavat toimia myös uudemmissa versioissa.

Edellytykset

• Vultr CentOS 7 -palvelinesiintymä.
• Sudo käyttäjä .
• Verkkotunnus osoitti palvelimeen.

Tässä opetusohjelmassa käytämme 192.168.0.1julkisena IP-osoitteena ja cms.example.comVultr-instanssiin osoittavana toimialueen nimenä. Muista korvata kaikki esimerkkiverkkotunnuksen ja julkisen IP-osoitteen esiintymät todellisella.

Päivitä perusjärjestelmäsi CentOS 7:n päivittäminen -oppaan avulla . Kun järjestelmäsi on päivitetty, jatka Javan asentamista.

Asenna Java

OpenJDK voidaan asentaa helposti, koska paketti on saatavana oletusarvoisessa YUM-arkistossa.

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

Jos Java on asennettu oikein, voit tarkistaa sen version.

java -version

Saat samanlaisen tulosteen.

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

Ennen kuin voimme jatkaa, meidän on määritettävä JAVA_HOMEja JRE_HOMEympäristömuuttujat. Etsi Java-suoritettavan tiedoston absoluuttinen polku järjestelmästäsi.

readlink -f $(which java)

Näet samanlaisen tulosteen.

[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

Aseta nyt JAVA_HOMEja JRE_HOMEympäristömuuttujat Java-hakemiston polun mukaan.

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

Suorita bash_profiletiedosto.

source ~/.bash_profile

Nyt voit suorittaa echo $JAVA_HOMEkomennon varmistaaksesi, että ympäristömuuttuja on asetettu.

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

Asenna PostgreSQL

Oletusarvoisesti dotCMS on määritetty käyttämään H2-tietokantamoottoria. H2-tietokantamoottori on kiinteä tiedostopohjainen tietokantamoottori. Ei suositella käytettäväksi tuotannossa. Tässä opetusohjelmassa käytämme PostgreSQL-palvelinta dotCMS-tietokannan tallentamiseen.

PostgreSQL on oliorelaatiotietokantajärjestelmä, joka tunnetaan vakaudestaan ​​ja nopeudestaan. Lisää järjestelmään PostgreSQL:n uusimman julkaisun arkisto.

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

Asenna PostgreSQL-tietokantapalvelin.

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

Alusta tietokanta.

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

Käynnistä PostgreSQL-palvelin ja ota se käyttöön automaattisesti käynnistyksen yhteydessä.

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

Vaihda PostgreSQL-oletuskäyttäjän salasana.

sudo passwd postgres

Kirjaudu sisään PostgreSQL-oletuskäyttäjänä.

sudo su - postgres

Luo uusi PostgreSQL-käyttäjä dotCMS:lle.

createuser dotcms 

PostgreSQL tarjoaa psqlkomentotulkin kyselyjen suorittamiseen tietokantapalvelimella. Vaihda PostgreSQL-kuoreen.

psql

Aseta salasana äskettäin luodulle käyttäjälle dotCMS-tietokantaa varten.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Korvaa tietokannan käyttäjän salasana DBPasswordsuojatulla salasanalla. Luo uusi tietokanta dotCMS-asennusta varten.

CREATE DATABASE dotcms OWNER dotcms;

Poistu psqlkuoresta.

\q

Vaihda sudokäyttäjäksi.

exit

Asenna dotCMS

Lataa dotCMS-arkisto.

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

Löydät aina linkin sovelluksen uusimpaan versioon dotCMS-lataussivulta .

Luo uusi hakemisto dotCMS-tiedostojen tallentamiseksi ja pura ne siihen.

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

Avaa tietokannan määritystiedosto.

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

Etsi H2lohko.

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

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

Kommentoi koko H2osio korvaamalla kommentin erotin -->osion alusta osion loppuun. Sen pitäisi näyttää seuraavalta.

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

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

Poista PostgreSQL-osion kommentit poistamalla kommentin erotin -->osan lopusta ja asettamalla se ylimpään kääreeseen POSTGRESQL. Lisäksi etsi username=ja password=korvaa olemassa olevat arvot PostgreSQL-tietokannan käyttäjän käyttäjätunnuksella ja salasanalla. Jos olet käyttänyt muuta tietokannan nimeä kuin dotcms, sinun on vaihdettava tietokannan nimi kohdassa url=. Kun se on määritetty, tiedoston PostgreSQL-lohkon pitäisi näyttää seuraavalta.

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

Anna suoritusoikeudet kaikille suoritettaville tiedostoille.

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

dotCMS on nyt asennettu palvelimellesi. Jos haluat suorittaa sovelluksen välittömästi, suorita seuraava.

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

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 -d /opt/dotcms -s /sbin/nologin dotcms

Provide ownership of the files to the dotCMS user.

sudo chown -R dotcms:dotcms /opt/dotcms

Create a new Systemd service.

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

Populate the file.

[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

Start the application and enable it to automatically start at boot time.

sudo systemctl start dotcms
sudo systemctl enable dotcms

Ensure that the service is running.

sudo systemctl status dotcms

Configure the Reverse Proxy

Oletuksena dotCMS-palvelin kuuntelee porttia 8080. Määritämme Nginxin käänteiseksi välityspalvelimeksi, jotta sovellusta voidaan käyttää vakio- HTTPja HTTPSporttien kautta. Määritämme myös Nginxin käyttämään Let's Encrypt ilmaisella SSL:llä luotua SSL:ää.

Asenna Nginx-verkkopalvelin.

sudo yum -y install nginx

Käynnistä verkkopalvelin ja ota se käyttöön automaattisesti käynnistyksen yhteydessä.

sudo systemctl start nginx
sudo systemctl enable nginx

Asenna Certbot, joka on Let's Encrypt CA:n asiakassovellus.

sudo yum -y install certbot

Ennen kuin voit pyytää varmenteita, sinun on sallittava portit 80ja/ 443tai standardit HTTPja HTTPSpalvelut palomuurin kautta. Poista myös portti 8080palomuurin poikkeusten luettelosta, koska sitä ei enää tarvita.

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

Huomautus: Jotta Let's Encrypt CA:lta saadaan varmenteita, toimialue, jolle sertifikaatit luodaan, on osoitettava palvelimeen. Jos ei, tee tarvittavat muutokset toimialueen DNS-tietueisiin ja odota DNS:n leviämistä ennen kuin teet varmennepyynnön uudelleen. Certbot tarkistaa toimialueen viranomaisen ennen varmenteiden toimittamista.

Luo SSL-varmenteet.

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

Luodut varmenteet tallennetaan todennäköisesti kansioon /etc/letsencrypt/live/cms.example.com/. Let's Encrypt -sertifikaatit vanhenevat 90 päivässä, joten on suositeltavaa määrittää varmenteiden automaattinen uusiminen Cron-töiden avulla.

Avaa cron-työtiedosto.

sudo crontab -e

Lisää seuraava rivi tiedoston loppuun.

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

Yllä oleva cron-työ suoritetaan joka päivä klo 5.30. Jos varmenteen voimassaolo päättyy, se uusitaan automaattisesti.

Luo dotCMS-sivustolle uusi palvelinlohkotiedosto.

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

Täytä tiedosto.

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

Käynnistä Nginx-verkkopalvelin uudelleen, jotta muutokset tulevat voimaan.

sudo systemctl restart nginx

dotCMS-sovellus on nyt asennettu palvelimellesi tuotantokäyttöä varten. Siirry järjestelmänvalvojan hallintapaneeliin seuraavassa osoitteessa.

https://cms.example.com/dotAdmin

Kirjaudu sisään käyttämällä alkuperäistä järjestelmänvalvojan tiliä [email protected]ja admin. Vaihda oletussalasana heti sisäänkirjautumisen jälkeen.

Onnittelut, dotCMS-sisällönhallintajärjestelmä on nyt asennettu palvelimellesi. Voit muokata esittelysivustoa tai aloittaa sivustosi rakentamisen alusta.