نحوه نصب dotCMS در CentOS 7

• پیش نیازها
• جاوا را نصب کنید
• PostgreSQL را نصب کنید
• dotCMS را نصب کنید
• سرویس Systemd را پیکربندی کنید
• پروکسی معکوس را پیکربندی کنید

dotCMS یک سیستم مدیریت محتوای درجه سازمانی منبع باز است که به زبان جاوا نوشته شده است. این تقریباً همه ویژگی های لازم برای ایجاد یک وب سایت برای تجارت شما را دارد. این برنامه یک API RESTful برای ادغام با سایر سرویس ها مانند CRM ، برنامه های کاربردی تلفن همراه و موارد دیگر فراهم می کند. از Elasticsearch برای فهرست بندی در زمان واقعی محتوا و Redis برای اجرای حافظه پنهان چند لایه استفاده می کند.

این مقاله برای dotCMS 4.2.2 نوشته شده است ، اما دستورالعمل ارائه شده ممکن است برای نسخه های جدیدتر نیز کار کند.

پیش نیازها

• نمونه سرور Vultr CentOS 7.
• کاربران از sudo .
• نام دامنه به سمت سرور نشان داده شده است.

برای این آموزش ، ما به 192.168.0.1عنوان آدرس IP عمومی و cms.example.comبه عنوان نام دامنه به سمت نمونه Vultr اشاره خواهیم کرد. لطفاً اطمینان حاصل کنید که تمام وقایع نام دامنه مثال و آدرس IP عمومی را با واقعیت جایگزین کنید.

سیستم پایه خود را با استفاده از راهنمای نحوه به روزرسانی CentOS 7 به روز کنید . پس از به روزرسانی سیستم ، جاوا را نصب کنید.

جاوا را نصب کنید

OpenJDK را می توان به راحتی نصب کرد زیرا بسته موجود در مخزن پیش فرض YUM موجود است.

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

اگر جاوا به درستی نصب شود ، می توانید نسخه آن را تأیید کنید.

java -version

شما یک خروجی مشابه دریافت خواهید کرد.

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

قبل از اینکه بتوانیم بیشتر پیش برویم ، باید متغیرهای محیط JAVA_HOMEو JRE_HOMEمحیط را تنظیم کنیم. مسیر مطلق جاوا را در سیستم خود پیدا کنید.

readlink -f $(which java)

یک خروجی مشابه را خواهید دید.

[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

حال متغیرها JAVA_HOMEو JRE_HOMEمحیط را مطابق مسیر دایرکتوری جاوا تنظیم کنید.

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

bash_profileپرونده را اجرا کنید.

source ~/.bash_profile

اکنون می توانید echo $JAVA_HOMEدستور را اجرا کنید تا از تنظیم متغیر محیط اطمینان حاصل شود.

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

PostgreSQL را نصب کنید

به طور پیش فرض ، dotCMS برای استفاده از موتور پایگاه داده H2 پیکربندی شده است. موتور پایگاه داده H2 یک موتور پایگاه داده مبتنی بر پرونده های مسطح است. استفاده از آن در تولید توصیه نمی شود. در این آموزش از سرور PostgreSQL برای ذخیره بانک اطلاعاتی dotCMS استفاده خواهیم کرد.

PostgreSQL یک سیستم پایگاه داده رابطه ای است و به دلیل پایداری و سرعت آن شناخته شده است. مخزن آخرین نسخه PostgreSQL را به سیستم اضافه کنید.

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

سرور پایگاه داده PostgreSQL را نصب کنید.

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

اولویت بندی پایگاه داده.

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

سرور PostgreSQL را راه اندازی کنید و آن را فعال کنید تا به طور خودکار در زمان بوت شروع شود.

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

گذرواژه را برای کاربر پیش فرض PostgreSQL تغییر دهید.

sudo passwd postgres

به عنوان کاربر پیش فرض PostgreSQL وارد شوید.

sudo su - postgres

یک کاربر جدید PostgreSQL برای dotCMS ایجاد کنید.

createuser dotcms 

PostgreSQL psqlپوسته را برای اجرای نمایش داده ها روی سرور پایگاه داده فراهم می کند . به پوسته 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.2.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. همچنین مقادیر موجود را با نام کاربری و رمزعبور کاربر پایگاه داده 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 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.

دستور فوق سرویس دهنده وب Tomcat را برای ارائه برنامه در پورت شروع می کند 8080. برای بررسی اینکه وب سایت dotCMS در حال کار است ، اجازه دهید پورت مورد نیاز را 8080از طریق فایروال سیستم بگذارید .

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

مرورگر مورد علاقه خود را باز کرده و مرور کنید 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 -d /opt/dotcms -s /sbin/nologin 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. ما Nginx را به عنوان پراکسی معکوس پیکربندی می کنیم تا از طریق استاندارد HTTPو HTTPSپورت ها به برنامه دسترسی پیدا کنید . ما همچنین Nginx را پیکربندی خواهیم کرد تا از SSL تولید شده با SSL رایگان رمزگذاری شود.

وب سرور Nginx را نصب کنید.

sudo yum -y install nginx

سرور وب را راه اندازی کنید و آن را فعال کنید تا به طور خودکار در زمان بوت شروع شود.

sudo systemctl start nginx
sudo systemctl enable nginx

Certbot را نصب کنید ، که یک برنامه مشتری برای Let's Encrypt CA است.

sudo yum -y install certbot

قبل از اینکه شما می توانید گواهینامه های درخواست، شما نیاز به اجازه بنادر 80و 443یا استاندارد HTTPو HTTPSخدمات از طریق فایروال. همچنین ، بندر را 8080از لیست استثنائات فایروال حذف کنید زیرا دیگر لازم نیست.

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

توجه: برای به دست آوردن گواهینامه ها از Let Encrypt CA ، دامنه تولید شده برای صدور گواهینامه ها باید به سمت سرور هدایت شود. در این صورت ، تغییرات لازم را در سوابق DNS دامنه ایجاد کرده و منتظر انتشار DNS قبل از درخواست مجوز مجدد باشید. Certbot قبل از ارائه گواهینامه ها ، دامنه را بررسی می کند.

صدور گواهینامه SSL را ایجاد کنید.

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

گواهینامه های تولید شده احتمالاً در آنها ذخیره می شوند /etc/letsencrypt/live/cms.example.com/. بیایید مجوزهای رمزگذاری در مدت 90 روز منقضی شوند ، از این رو توصیه می شود با استفاده از مشاغل Cron ، تمدید خودکار گواهینامه ها را تنظیم کنید.

پرونده کار cron را باز کنید.

sudo crontab -e

در انتهای پرونده خط زیر را اضافه کنید.

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

کار cron فوق هر روز در 5:30 دقیقه صبح انجام می شود. اگر گواهی برای انقضا موقت باشد ، به طور خودکار تمدید می شود.

یک فایل بلوک سرور جدید برای سایت dotCMS ایجاد کنید.

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

پرونده را جمع کنید.

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

وب سرور Nginx را مجدداً راه اندازی کنید تا این تغییرات موثر واقع شوند.

sudo systemctl restart nginx

برنامه dotCMS اکنون برای استفاده در سرور شما نصب شده است. به داشبورد اداری در آدرس زیر دسترسی پیدا کنید.

https://cms.example.com/dotAdmin

با استفاده از حساب سرپرست اولیه وارد شوید [email protected]و admin. رمز ورود پیش فرض را بلافاصله پس از ورود تغییر دهید.

تبریک می گویم ، سیستم مدیریت محتوای dotCMS اکنون روی سرور شما نصب شده است. می توانید سایت آزمایشی را تغییر دهید و یا می توانید سایت خود را از ابتدا شروع کنید.