ローカル環境にクリーンバンドルをセットアップする方法

問題

• クリーンバンドルとは何でしょうか

• ローカル環境にクリーンバンドルを構築する際の手順を教えてください

環境

• Liferay DXP 7.0
• Liferay DXP 7.1
• Liferay DXP 7.2
• Liferay DXP 7.3
• Liferay DXP 7.4

解決

• クリーンバンドル（Clean Bundle）とは

  • 「カスタマイズが適用されていない状態」を指します

  • 事象を再現確認するための「必要最低限の設定のみ適用した環境」を意味します

• 事前準備

  • セットアップするローカル環境（ノートパソコン等のマシン）を用意します
  • Help Centerのダウンロードページのドロップダウンメニューより製品およびタイプを選択し、使用するバンドルを入手します
    • ご利用のバージョンに合わせて、サービスパックを事前に入手してください
    • サービスパック＋フィックスパックの組み合わせでもダウンロードが可能です
  • Help Centerのアクティベーションキーの発行ページより開発ライセンス（アクティベーションキー）を入手します 

• セットアップ手順

  • ローカル環境にLiferayインスタンス専用のbundlesディレクトリを作成します
    次のようにディレクトリを構成します
    
    • Windows: C:\liferay\bundles を作成
    • Unix/Linux: ユーザー名/liferay/bundles を作成
  • 事前にダウンロードしたサービスパックの圧縮ファイル（liferay-dxp-tomcat-[バージョン].tar.gz/7z）を解凍し、次のディレクトリの直下に展開します
    
    • Windows: C:\liferay\bundles 
    • Unix/Linux: ユーザー名/liferay/bundles 
  • アクティベーションキー(xmlファイル)を{LIFERAY_HOME}/deployディレクトリにコピーします
  • {TOMCAT_HOME}/binディレクトリに移動した後、以下の操作にてTomcatを起動します
    
    • Windows: startup.bat をダブルクリック
    • Unix/Linux: ターミナル上で ./catalina.sh run を実行
  • アクティベーションキーの自動デプロイが行われます
  • サーバー起動が完了すると、URL「http://localhost:8080」へアクセスされたブラウザが立ち上がります
  • 初期起動時の「基本設定」の設定終了後、以下の初期設定を行います
    
    • 利用規約に同意する
    • パスワードを変更する
    • パスワードを忘れた場合の質問、回答を設定する
  • 初期起動時のセットアップが終わると、{LIFERAY_HOME}ディレクトリにportal-setup-wizard.properties が格納されます
  • 以上でセットアップは完了です

• セットアップ時の注意点

  • サービスパック＋フィックスパックの組み合わせでクリーンバンドルをセットアップする際には、Tomcatを起動する前に「フィックスパックの適用」が必須となりますので、予めご注意ください
    
  • 互換性があるJDKをインストールし、必要に応じてJavaの環境変数JAVA_HOMEのパスをご調整ください

追加情報

• 互換性マトリクス
• Liferay DXPのフィックスパック、ホットフィックスの適用方法
• サービスパックとフィックスパックの概要