アプリケーションサーバーのインストール application-server-install
JAR
と WAR
です。これらの形式に対しては、アドビが提供するサポートレベルを維持できるよう、品質保証プロセスが実施されています。この節では、Adobe Experience Manager(AEM)をアプリケーションサーバーと共にインストールする方法について説明します。個々のアプリケーションサーバーに提供されているサポートのレベルについては、サポートされているプラットフォームを参照してください。
以下のアプリケーションサーバーのインストール手順について説明します。
Web アプリケーションのインストール、サーバーの設定、サーバーの起動および停止方法について詳しくは、該当するアプリケーションサーバーのドキュメントを参照してください。
概要 general-description
アプリケーションサーバーに AEM をインストールするときのデフォルトの動作 default-behaviour-when-installing-aem-in-an-application-server
AEMは、デプロイする単一の war ファイルとして提供されます。
デプロイした場合は、デフォルトで次の処理がおこなわれます。
-
実行モードは
author
-
インスタンス(リポジトリ、Felix OSGI 環境、バンドルなど)は
${user.dir}/crx-quickstart
にインストールされます。${user.dir}
は現在の作業ディレクトリです。crx-quickstart へのこのパスはsling.home
と呼ばれます。 -
コンテキストルートは war ファイル名(例:
aem-6
)
設定 configuration
デフォルトの動作は、次の方法で変更できます。
-
実行モード:デプロイメント前に、AEM war ファイルの
sling.run.modes
ファイルでWEB-INF/web.xml
パラメーターを設定 -
sling.home:デプロイメント前に、AEM war ファイルの
WEB-INF/web.xml
ファイルでsling.home
パラメーターを設定 -
コンテキストルート:AEM war ファイル名を変更
パブリッシュインストール publish-installation
パブリッシュインスタンスをデプロイするには、実行モードを publish に設定する必要があります。
- AEM war ファイルからWEB-INF/web.xmlを解凍します。
- sling.run.modes パラメーターを publish に変更します。
- web.xml ファイルをAEM war ファイルに再パック
- AEM war ファイルをデプロイします。
インストールの確認 installation-check
すべてがインストールされているかどうかを確認するには、次の操作を実行します。
error.log
ファイルに対して「テール」を実行して、すべてのコンテンツがインストールされていることを確認/system/console
を調べて、すべてのバンドルがインストールされていることを確認
同じアプリケーションサーバー上の 2 つのインスタンス two-instances-on-the-same-application-server
デモ用に、1 つのアプリケーションサーバーにオーサーインスタンスとパブリッシュインスタンスをインストールするのが適切な場合があります。 その場合は、次の手順を実行します。
- パブリッシュインスタンスの sling.home 変数と sling.run.modes 変数を変更します。
- AEM war ファイルから WEB-INF/web.xml ファイルを展開します。
- sling.home パラメーターを別のパス(絶対パスと相対パスが指定可能)に変更します。
- sling.run.modes を、パブリッシュインスタンス用に publish に変更します。
- web.xml ファイルを再圧縮します。
- war ファイルの名前を、別々の名前になるように変更します。例えば、一方を aemauthor.war に、もう一方を aempublish.war に変更します。
- 高めのメモリ設定を使用します。例えば、デフォルトの AEM インスタンスの場合は、-Xmx3072m などを使用します。
- 2 つの Web アプリケーションをデプロイします。
- デプロイ後に、2 つの Web アプリケーションを停止します。
- オーサーインスタンスとパブリッシュインスタンスの両方で、sling.properties ファイルで property felix.service.urlhandlers=false が false に設定されていると仮定します(デフォルトでは true に設定)。
- 2 つの Web アプリケーションを再度起動します。
アプリケーションサーバーのインストール手順 application-servers-installation-procedures
WebSphere 8.5 websphere
デプロイメントの前に、上記の概要をお読みください。
サーバーの準備
-
Basic Auth ヘッダーを通す:
- AEMでユーザーを認証する方法の 1 つは、WebSphere サーバーのグローバル管理セキュリティを無効にすることです。無効にするには、次の手順を実行します。[ セキュリティ ] -> [ グローバルセキュリティ ] に移動し、[ 管理セキュリティを有効にする ] チェックボックスをオフにして、サーバを保存して再起動します。
-
"JAVA_OPTS= -Xmx2048m"
を設定 -
コンテキストルート = / を使用して AEM をインストールする場合は、まず既存のデフォルト web アプリケーションのコンテキストルートを変更する必要があります
AEM web アプリケーションのデプロイ
-
AEM war ファイルをダウンロードします。
-
必要に応じて web.xml で設定します(上記の「一般的な説明」を参照)。
- WEB-INF/web.xml ファイルを解凍
- sling.run.modes パラメーターを publish に変更
- sling.home 初期パラメーターをコメント解除し、必要に応じてこのパスを設定
- web.xml ファイルを再圧縮
-
AEM war ファイルをデプロイします。
- コンテキストルートを選択します(Sling 実行モードを設定する場合は、デプロイウィザードの詳細な手順を選択し、ウィザードの手順 6 で指定する必要があります)。
-
AEM Web アプリケーションを起動します
JBoss EAP 6.3.0/6.4.0 jboss-eap
デプロイメントの前に、上記の概要をお読みください。
JBoss サーバーの準備
設定ファイル(standalone.conf
など)でメモリ引数を設定
- JAVA_OPTS="-Xms64m -Xmx2048m"
deployment-scanner を使用して AEM web アプリケーションをインストールする場合は、deployment-timeout,
の値を増やすことをお勧めします。そのためには、インスタンスの xml ファイル(configuration/standalone.xml)
など)で deployment-timeout
属性を設定してください。
<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
<deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>
AEM web アプリケーションのデプロイ
-
JBoss 管理コンソールで AEM web アプリケーションをアップロードします。
-
AEM web アプリケーションを有効にします。
Oracle WebLogic 12.1.3/12.2 oracle-weblogic
デプロイメントの前に、上記の概要をお読みください。
これは、管理サーバーのみを使用するシンプルなサーバーレイアウトを使用します。
WebLogic Server の準備
-
${myDomain}/config/config.xml
で、security-configuration セクションに以下を追加します。<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
正確な位置については、https://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd を参照してください(デフォルトではセクションの最後に追加すれば問題ありません)。
-
VM メモリ設定の値を増やします。
${myDomain}/bin/setDomainEnv.cmd
(resp .sh)を開いて WLS_MEM_ARGS を検索し、設定します(例:setWLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
)- WebLogic Server を再起動します。
-
${myDomain}
に packages フォルダーを作成し、その中に cq フォルダー、その中に Plan フォルダーを作成します。
AEM web アプリケーションのデプロイ
-
AEM war ファイルをダウンロードします。
-
AEM war ファイルを the ${myDomain}/packages/cq フォルダー内に配置します。
-
必要に応じて、
WEB-INF/web.xml
で設定します(上記の「概要」を参照)。WEB-INF/web.xml
ファイルを解凍します- sling.run.modes パラメーターを publish に変更
- sling.home 初期パラメーターをコメント解除し、必要に応じてこのパスを設定します(「概要」を参照)。
- web.xml ファイルを再圧縮
-
AEM war ファイルをデプロイします。 をアプリケーションとして(他の設定ではデフォルト設定を使用)
-
インストールには時間がかかる場合があります…
-
上記の「一般説明」で説明したように、インストールが完了したことを確認します(error.log の追跡など)。
-
コンテキストルートは、WebLogic
/console
の web アプリケーションの「設定」タブで変更できます。
Tomcat 8/8.5 tomcat
デプロイ前に、上記の概要をお読みください。
-
Tomcat サーバーの準備
-
VM メモリ設定の値を増やします。
bin/catalina.bat
(Unix の場合はcatalina.sh
)に、次の設定を追加します。set "JAVA_OPTS= -Xmx2048m
-
Tomcat では、インストール時に管理者もマネージャもアクセスできません。そのため、次のアカウントへのアクセスを許可するには
tomcat-users.xml
を手動で編集する必要があります。tomcat-users.xml
を編集して、管理者およびマネージャーのアクセスを含めます。設定は次の例のようになります。
code language-xml <?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager"/> <role rolename="tomcat"/> <role rolename="admin"/> <role rolename="role1"/> <role rolename="manager-gui"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="admin" password="admin" roles="admin,manager-gui"/> <user username="role1" password="tomcat" roles="role1"/> </tomcat-users>
-
コンテキストルート「/」を使用してAEMをデプロイする場合は、既存の ROOT Web アプリのコンテキストルートを変更する必要があります。
- ROOT Web アプリの停止とデプロイ解除
- Tomcat の webapps フォルダーの ROOT.war フォルダーの名前を変更します。
- Web アプリを再起動
-
manager-gui を使用してAEM Web アプリケーションをインストールする場合は、アップロードされたファイルの最大サイズを増やす必要があります。これは、デフォルトで許可されるアップロードサイズが 50 MB のみであるためです。 これに対して、マネージャー web アプリケーションの web.xml を開き、
webapps/manager/WEB-INF/web.xml
max-file-size と max-request-size を少なくとも 500 MB に増やします。次を参照してください。
multipart-config
例web.xml
ファイル:code language-none <multipart-config> <!-- 500MB max --> <max-file-size>524288000</max-file-size> <max-request-size>524288000</max-request-size> <file-size-threshold>0</file-size-threshold> </multipart-config>
-
-
AEM web アプリケーションのデプロイ
-
AEM war ファイルをダウンロードします。
-
必要に応じて web.xml で設定します(上記の「一般的な説明」を参照)。
- WEB-INF/web.xml ファイルを解凍
- sling.run.modes パラメーターを publish に変更
- sling.home 初期パラメーターをコメント解除し、必要に応じてこのパスを設定
- web.xml ファイルを再圧縮
-
AEM war ファイルをルート Web アプリとしてデプロイする場合は、名前を ROOT.war に変更し、aemauthor をコンテキストルートとして使用する場合は、名前を aemauthor.war に変更します。
-
tomcat の webapps フォルダーにコピーします。
-
AEMがインストールされるまで待つ
-
トラブルシューティング troubleshooting
インストール時に発生する可能性のある問題の対処方法については、以下を参照してください。