كيفية تثبيت dotCMS على أوبونتو 16.04

• المتطلبات الأساسية
• قم بتثبيت Java
• قم بتثبيت PostgreSQL
• قم بتثبيت dotCMS
• تكوين Systemd
• تكوين الوكيل العكسي

DotCMS هو نظام إدارة محتوى مفتوح المصدر على مستوى المؤسسة مكتوب بلغة Java. يحتوي على كل ميزة مطلوبة تقريبًا لإنشاء موقع ويب لعملك. يوفر RESTful API للتكامل مع خدمات أخرى مثل CRM وتطبيقات الهاتف المحمول والمزيد. ويستخدم Elasticsearch لفهرسة المحتوى في الوقت الفعلي و Redis لتنفيذ ذاكرة تخزين مؤقت متعددة المستويات.

المتطلبات الأساسية

• نسخة خادم Vultr Ubuntu 16.04.
• A المستخدم سودو .
• أشار اسم المجال نحو الخادم.

في هذا البرنامج التعليمي ، سوف نستخدم 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

إذا كنت لا ترى أي إخراج على الإطلاق ، فستحتاج إلى تسجيل الخروج من shell الحالي وتسجيل الدخول مرة أخرى.

قم بتثبيت 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 shell لتشغيل الاستعلامات على خادم قاعدة البيانات. قم بالتبديل إلى غلاف 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= واستبدال القيم الموجودة مع اسم المستخدم وكلمة المرور للمستخدم قاعدة البيانات كيو الخاص بك. إذا كنت قد استخدمت اسم قاعدة بيانات بخلاف 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.

افتح متصفحك المفضل وتصفح إلى http://192.168.0.1:8080. سترى أن التطبيق يقوم بتشغيل موقع ويب تجريبي. إذا كنت لا ترى موقعك على الويب ، فالرجاء الانتظار حتى يستغرق بدء التشغيل الأول لخادم dotCMS من خمس إلى عشر دقائق أثناء كتابة البيانات في قاعدة بيانات PostgreSQL وإنشاء ذاكرة التخزين المؤقت. يمكنك أيضًا التحقق من سجلات بدء التشغيل.

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

تكوين Systemd

يمكن بدء خادم dotCMS مباشرة باستخدام البرنامج النصي لبدء التشغيل المقدم في حزمة المثبت. من باب الراحة ، يجب عليك إعداد ملف وحدة Systemd لخادم dotCMS. سيضمن ذلك بدء تشغيل خادم التطبيق تلقائيًا عند إعادة تشغيل النظام وإخفاقه.

قم بإيقاف تشغيل خادم dotCMS باستخدام البرنامج النصي لإيقاف التشغيل.

sudo bin/shutdown.sh

قم بإنشاء مستخدم غير مميز لتشغيل خادم dotCMS ، لأسباب أمنية.

sudo adduser --home /opt/dotcms -gecos "dotCMS User" --disabled-password --disabled-login dotcms

قم بتوفير ملكية الملفات لمستخدم dotCMS.

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. وسوف تكوين إنجن إكس باسم وكيل عكسي بحيث يمكن الوصول إلى التطبيق عبر المعيار 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/. تنتهي صلاحية شهادات التشفير في غضون 90 يومًا ، وبالتالي يوصى بإعداد التجديد التلقائي للشهادات باستخدام وظائف 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 مثبت الآن على الخادم الخاص بك. يمكنك تعديل الموقع التجريبي أو يمكنك البدء في بناء موقعك من الصفر.