Ubuntu 16.04にdotCMSをインストールする方法

• 前提条件
• Javaをインストールする
• PostgreSQLをインストールする
• dotCMSをインストールする
• Systemdを構成する
• リバースプロキシの構成

DotCMSは、Javaで書かれたオープンソースのエンタープライズグレードのコンテンツ管理システムです。それはあなたのビジネスのためのウェブサイトを作成するために必要なほぼすべての機能が含まれています。CRM、モバイルアプリケーションなどの他のサービスと統合するRESTful APIを提供します。コンテンツのリアルタイムインデックスにはElasticsearchを使用し、多層キャッシュの実装にはRedisを使用します。

前提条件

• Vultr Ubuntu 16.04サーバーインスタンス。
• sudoのユーザー。
• サーバーに向けられたドメイン名。

このチュートリアルでは192.168.0.1 、パブリックIPアドレスおよびcms.example.com Vultrインスタンスを指すドメイン名として使用 し ます。サンプルのドメイン名とパブリックIPアドレスのすべての出現箇所を実際のものに置き換えてください。

How to Update Ubuntu 16.04のガイドを使用してベースシステムを更新します 。システムが更新されたら、Javaのインストールに進みます。

Javaをインストールする

Oracle Java 8のUbuntuリポジトリを追加します。

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

出力がまったく表示されない場合は、現在のシェルからログアウトして、再度ログインする必要があります。

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

dotCMSの新しいPostgreSQLユーザーを作成します。

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.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=、PostgreSQLデータベースユーザーのユーザー名とパスワードに置き換えます。以外のデータベース名を使用した場合は、でデータベース名 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 Webサーバーを起動します 8080。

お気に入りのブラウザを開き、にアクセスし http://192.168.0.1:8080ます。アプリケーションがデモWebサイトを実行していることがわかります。Webサイトが表示されない場合は、dotCMSサーバーがPostgreSQLデータベースにデータを書き込み、キャッシュを構築するのに5〜10分かかります。起動ログを確認することもできます。

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

Systemdを構成する

dotCMSサーバーは、インストーラーパッケージで提供される起動スクリプトを使用して直接起動できます。便宜上、dotCMSサーバー用のSystemdユニットファイルを設定する必要があります。これにより、システムの再起動や障害時にアプリケーションサーバーが自動的に起動するようになります。

シャットダウンスクリプトを使用して、実行中の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。Nginxをリバースプロキシとして構成し、標準HTTP およびHTTPS ポートを介してアプリケーションにアクセスできるようにし ます。Let's Encryptで生成されたSSLを使用するようにNginxを構成します。

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

Let's Encrypt CAのクライアントアプリケーションであるCertbotをインストールします。

sudo apt -y install certbot

注： Let's Encrypt CAから証明書を取得するには、証明書を生成するドメインをサーバーに向ける必要があります。そうでない場合は、ドメインのDNSレコードに必要な変更を加え、DNSが伝播するのを待ってから、証明書要求を再度行ってください。証明書ボットは、証明書を提供する前にドメイン認証局をチェックします。

SSL証明書を生成します。

sudo certbot certonly --webroot -w /var/www/html -d cms.example.com

生成された証明書は、おそらくに保存され /etc/letsencrypt/live/cms.example.com/ます。Let's Encrypt証明書は90日で期限切れになるため、cronジョブを使用して証明書の自動更新を設定することをお勧めします。

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 Webサーバーを再起動して、変更を有効にします。

sudo systemctl restart nginx

dotCMSアプリケーションがサーバーにインストールされ、運用環境で使用できるようになりました。次のアドレスの管理ダッシュボードにアクセスします。

https://cms.example.com/dotAdmin

初期管理者アカウント[email protected] とパスワードを使用してログインし ますadmin。ログイン直後にデフォルトのパスワードを変更します。

おめでとうございます。dotCMSコンテンツ管理システムがサーバーにインストールされました。デモサイトを変更することも、ゼロからサイトを構築することもできます。