Hvernig á að setja upp dotCMS á CentOS 7

dotCMS er opinn uppspretta vefumsjónarkerfi fyrir fyrirtæki skrifað í Java. Það inniheldur næstum alla eiginleika sem þarf til að búa til vefsíðu fyrir fyrirtækið þitt. Það veitir RESTful API til að samþætta við aðra þjónustu eins og CRM, farsímaforrit og fleira. Það notar Elasticsearch fyrir rauntíma flokkun efnis og Redis til að innleiða skyndiminni í mörgum flokkum.

Þessi grein var skrifuð fyrir dotCMS 4.2.2, en leiðbeiningarnar sem fylgja gætu virkað fyrir nýrri útgáfur líka.

Forkröfur

• Vultr CentOS 7 netþjónstilvik.
• A sudo notandi .
• Lén vísaði í átt að þjóninum.

Fyrir þessa kennslu munum við nota 192.168.0.1sem opinbera IP tölu og cms.example.comsem lénið sem vísaði í átt að Vultr tilvikinu. Vinsamlega vertu viss um að skipta út öllum tilfellum af dæmi léninu og opinberu IP-tölu fyrir hið raunverulega.

Uppfærðu grunnkerfið þitt með því að nota handbókina Hvernig á að uppfæra CentOS 7 . Þegar kerfið þitt hefur verið uppfært skaltu halda áfram að setja upp Java.

Settu upp Java

Auðvelt er að setja OpenJDK upp þar sem pakkinn er fáanlegur í sjálfgefna YUM geymslunni.

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

Ef Java er rétt uppsett, þá muntu geta staðfest útgáfu þess.

java -version

Þú munt fá svipað framleiðsla.

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

Áður en við getum haldið áfram þurfum við að setja upp JAVA_HOMEog JRE_HOMEumhverfisbreyturnar. Finndu algera slóð Java executable á kerfinu þínu.

readlink -f $(which java)

Þú munt sjá svipaða framleiðsla.

[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

Stilltu nú JAVA_HOMEog JRE_HOMEumhverfisbreyturnar í samræmi við slóð Java möppunnar.

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

Keyra bash_profileskrána.

source ~/.bash_profile

Nú geturðu keyrt echo $JAVA_HOMEskipunina til að tryggja að umhverfisbreytan sé stillt.

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

Settu upp PostgreSQL

Sjálfgefið er dotCMS stillt til að nota H2 gagnagrunnsvélina. H2 gagnagrunnsvélin er gagnagrunnsvél sem byggir á flatri skrá. Ekki er mælt með því að nota það í framleiðslu. Í þessari kennslu munum við nota PostgreSQL miðlara til að geyma dotCMS gagnagrunninn.

PostgreSQL er gagnagrunnskerfi sem tengist hlutum og er þekkt fyrir stöðugleika og hraða. Bættu við geymslu nýjustu útgáfu PostgreSQL inn í kerfið.

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

Settu upp PostgreSQL gagnagrunnsþjóninn.

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

Frumstilla gagnagrunninn.

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

Ræstu PostgreSQL þjóninn og gerðu það kleift að ræsast sjálfkrafa við ræsingu.

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

Breyttu lykilorðinu fyrir sjálfgefinn PostgreSQL notanda.

sudo passwd postgres

Skráðu þig inn sem sjálfgefinn PostgreSQL notandi.

sudo su - postgres

Búðu til nýjan PostgreSQL notanda fyrir dotCMS.

createuser dotcms 

PostgreSQL veitir psqlskelina til að keyra fyrirspurnir á gagnagrunnsþjóninum. Skiptu yfir í PostgreSQL skelina.

psql

Stilltu lykilorð fyrir nýstofnaðan notanda fyrir dotCMS gagnagrunninn.

ALTER USER dotcms WITH ENCRYPTED password 'DBPassword';

Skiptu um lykilorð notanda gagnagrunnsins DBPasswordfyrir öruggt lykilorð. Búðu til nýjan gagnagrunn fyrir dotCMS uppsetninguna.

CREATE DATABASE dotcms OWNER dotcms;

Farið úr psqlskelinni.

\q

Skiptu yfir í sudonotanda.

exit

Settu upp dotCMS

Sæktu dotCMS skjalasafnið.

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

Þú getur alltaf fundið hlekkinn á nýjustu útgáfuna af forritinu á dotCMS niðurhalssíðunni .

Búðu til nýja möppu til að geyma dotCMS skrárnar og draga þær út í hana.

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

Opnaðu gagnagrunnsstillingarskrána.

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

Finndu H2blokkina.

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

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

Skrifaðu athugasemd út allan H2kaflann með því að skipta um athugasemdaafmörkun -->frá upphafi hlutans til loka hlutans. Það ætti að líta svona út.

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

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

Taktu athugasemdir við PostgreSQL hlutann með því að fjarlægja athugasemdaafmörkunina -->í lok hlutans og setja hann á efstu umbúðirnar POSTGRESQL. Finndu líka username=og password=skiptu út núverandi gildum fyrir notandanafn og lykilorð PostgreSQL gagnagrunnsnotandans þíns. Ef þú hefur notað annað nafn gagnagrunns en dotcms, þá þarftu að breyta nafni gagnagrunnsins í url=. Þegar það hefur verið stillt ætti PostgreSQL blokkin í skránni að líta svona út.

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

Gefðu framkvæmdarheimild fyrir allar keyranlegu skrárnar.

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

dotCMS er nú sett upp á netþjóninum þínum. Til að keyra forritið strax skaltu framkvæma eftirfarandi.

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

Sjálfgefið er að dotCMS þjónninn hlustar á port 8080. Við munum stilla Nginx sem andstæða proxy þannig að hægt sé að nálgast forritið í gegnum staðlaða HTTPog HTTPShöfn. Við munum einnig stilla Nginx til að nota SSL sem er búið til með Let's Encrypt ókeypis SSL.

Settu upp Nginx vefþjóninn.

sudo yum -y install nginx

Ræstu vefþjóninn og gerðu honum kleift að ræsa sjálfkrafa við ræsingu.

sudo systemctl start nginx
sudo systemctl enable nginx

Settu upp Certbot, sem er biðlaraforrit fyrir Let's Encrypt CA.

sudo yum -y install certbot

Áður en þú getur beðið um skírteinin þarftu að leyfa höfnum 80og/ 443eða staðli HTTPog HTTPSþjónustu í gegnum eldvegginn. Fjarlægðu einnig gátt 8080af listanum yfir eldveggundantekningar þar sem það er ekki lengur krafist.

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

Athugið: Til að fá skírteini frá Let's Encrypt CA verður lénið sem á að búa til skírteini að vera beint að þjóninum. Ef ekki, gerðu nauðsynlegar breytingar á DNS-skrám lénsins og bíddu eftir að DNS breiðist út áður en þú gerir vottorðsbeiðnina aftur. Certbot athugar lénsvaldið áður en það gefur upp vottorðin.

Búðu til SSL vottorðin.

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

Líklegt er að útbúin skírteini séu geymd í /etc/letsencrypt/live/cms.example.com/. Við skulum dulkóða vottorð renna út eftir 90 daga, þess vegna er mælt með því að setja upp sjálfvirka endurnýjun skírteina með Cron störf.

Opnaðu cron vinnuskrána.

sudo crontab -e

Bættu við eftirfarandi línu í lok skráarinnar.

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

Ofangreint cron starf mun keyra á hverjum degi klukkan 5:30. Ef skírteinið á að renna út verður það sjálfkrafa endurnýjað.

Búðu til nýja netþjónablokkaskrá fyrir dotCMS síðuna.

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

Fylltu út skrána.

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

Endurræstu Nginx vefþjóninn svo breytingarnar geti tekið gildi.

sudo systemctl restart nginx

DotCMS forritið er nú sett upp á netþjóninum þínum til framleiðslunotkunar. Fáðu aðgang að stjórnunarborðinu á eftirfarandi heimilisfangi.

https://cms.example.com/dotAdmin

Skráðu þig inn með upphaflega stjórnandareikningnum [email protected]og admin. Breyttu sjálfgefna lykilorðinu strax eftir innskráningu.

Til hamingju, dotCMS vefumsjónarkerfið er nú sett upp á netþjóninum þínum. Þú getur breytt kynningarsíðunni eða þú getur byrjað að byggja upp síðuna þína frá grunni.