AEM がリリースされているファイル形式は JAR
と WAR
です。これらの形式に対しては、アドビが提供するサポートレベルを維持できるよう、品質保証プロセスが実施されています。
この節では、Adobe Experience Manager(AEM)をアプリケーションサーバーと共にインストールする方法について説明します。個々のアプリケーションサーバーに提供されているサポートのレベルについては、サポートされているプラットフォームを参照してください。
以下のアプリケーションサーバーのインストール手順について説明します。
Web アプリケーションのインストール、サーバーの設定、サーバーの起動および停止方法について詳しくは、該当するアプリケーションサーバーのドキュメントを参照してください。
WAR デプロイメントで Dynamic Media を使用している場合は、Dynamic Media のドキュメントを参照してください。
AEM は、単一の war ファイルとしてデプロイされます。
デプロイすると、デフォルトで次のようになります。
実行モードは author
インスタンス(リポジトリ、Felix OSGI 環境、バンドルなど)は ${user.dir}/crx-quickstart
にインストールされます。${user.dir}
は現在の作業ディレクトリです。crx-quickstart へのこのパスは sling.home
と呼ばれます。
コンテキストルートは war ファイル名(例:aem-6
)
デフォルトの動作は次のように変更できます。
実行モード:デプロイメント前に、AEM war ファイルの sling.run.modes
ファイルで WEB-INF/web.xml
パラメーターを設定
sling.home:デプロイメント前に、AEM war ファイルの WEB-INF/web.xml
ファイルで sling.home
パラメーターを設定
コンテキストルート:AEM war ファイル名を変更
パブリッシュインスタンスをデプロイするには、実行モードを publish に設定する必要があります。
すべてがインストールされているかどうかは、次の手順で確認します。
error.log
ファイルに対して「テール」を実行して、すべてのコンテンツがインストールされていることを確認/system/console
を調べて、すべてのバンドルがインストールされていることを確認デモンストレーション目的で、オーサーインスタンスとパブリッシュインスタンスを 1 つのアプリケーションサーバーにインストールすることが適切な場合があります。そのためには、次の手順を実行します。
デプロイメントの前に、上記の概要をお読みください。
サーバーの準備
Basic 認証ヘッダーを無効にします。
"JAVA_OPTS= -Xmx2048m"
を設定
コンテキストルート = / を使用して AEM をインストールする場合は、まず既存のデフォルト web アプリケーションのコンテキストルートを変更する必要があります
AEM web アプリケーションのデプロイ
AEM war ファイルをダウンロードします。
必要に応じて、web.xml で設定します(上記の「概要」を参照)。
AEM war ファイルをデプロイします。
AEM Web アプリケーションを起動します。
デプロイメントの前に、上記の概要をお読みください。
JBoss サーバーの準備
設定ファイル(standalone.conf
など)でメモリ引数を設定
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 アプリケーションを有効にします。
デプロイメントの前に、上記の概要をお読みください。
管理サーバーが 1 つだけのシンプルなサーバーレイアウトを使用します。
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 を検索し、設定します(例:set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
)${myDomain}
に packages フォルダーを作成し、その中に cq フォルダー、その中に Plan フォルダーを作成します。
AEM web アプリケーションのデプロイ
AEM war ファイルをダウンロードします。
AEM war ファイルを the ${myDomain}/packages/cq フォルダー内に配置します。
必要に応じて、WEB-INF/web.xml
で設定します(上記の「概要」を参照)。
WEB-INF/web.xml
ファイルを解凍しますAEM war ファイルをデプロイします。 をアプリケーションとして(他の設定ではデフォルト設定を使用)
インストールには時間がかかる場合があります。
上記の「概要」で説明した方法で、インストールが完了したことを確認します(error.log を追跡するなど)。
コンテキストルートは、WebLogic /console
の web アプリケーションの「設定」タブで変更できます。
デプロイ前に、上記の概要をお読みください。
Tomcat サーバーの準備
VM メモリ設定の値を増やします。
bin/catalina.bat
(Unix の場合は catalina.sh
)に、次の設定を追加します。set "JAVA_OPTS= -Xmx2048m
Tomcat では、インストール時に管理者もマネージャもアクセスできません。そのため、次のアカウントへのアクセスを許可するには tomcat-users.xml
を手動で編集する必要があります。
tomcat-users.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 アプリケーションのコンテキストルートを変更する必要があります。
manager-gui を使用して AEM Web アプリケーションをインストールする場合は、アップロードファイルの最大サイズを増やす必要があります。デフォルトで許可されているアップロードサイズは 50 MB のみです。これに対して、マネージャー web アプリケーションの web.xml を開き、
webapps/manager/WEB-INF/web.xml
max-file-size と max-request-size を 500 MB 以上に増やします。そのような web.xml
ファイルの例として、以下の multipart-config
の例を参照してください。
<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 で設定します(上記の「概要」を参照)。
AEM war ファイルは、ルート Web アプリケーションとしてデプロイする場合は ROOT.war に名前を変更し、aemauthor をコンテキストルートとする場合は aemauthor.war などに名前を変更します。
ファイルを Tomcat の webapps フォルダーにコピーします。
AEM がインストールされるまで待ちます。
インストール中に発生する可能性のある問題の処理について詳しくは、以下を参照してください。