アプリケーションサーバーのインストール application-server-install

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.
NOTE
AEM がリリースされているファイル形式は JARWAR です。これらの形式に対しては、アドビが提供するサポートレベルを維持できるよう、品質保証プロセスが実施されています。

この節では、Adobe Experience Manager(AEM)をアプリケーションサーバーと共にインストールする方法について説明します。個々のアプリケーションサーバーに提供されているサポートのレベルについては、サポートされているプラットフォームを参照してください。

以下のアプリケーションサーバーのインストール手順について説明します。

Web アプリケーションのインストール、サーバーの設定、サーバーの起動および停止方法について詳しくは、該当するアプリケーションサーバーのドキュメントを参照してください。

NOTE
WAR デプロイメントでDynamic Mediaを使用している場合は、 dynamic media ドキュメント.

概要 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 つのアプリケーションサーバーにオーサーインスタンスとパブリッシュインスタンスをインストールするのが適切な場合があります。 その場合は、次の手順を実行します。

  1. パブリッシュインスタンスの sling.home 変数と sling.run.modes 変数を変更します。
  2. AEM war ファイルから WEB-INF/web.xml ファイルを展開します。
  3. sling.home パラメーターを別のパス(絶対パスと相対パスが指定可能)に変更します。
  4. sling.run.modes を、パブリッシュインスタンス用に publish に変更します。
  5. web.xml ファイルを再圧縮します。
  6. war ファイルの名前を、別々の名前になるように変更します。例えば、一方を aemauthor.war に、もう一方を aempublish.war に変更します。
  7. 高めのメモリ設定を使用します。例えば、デフォルトの AEM インスタンスの場合は、-Xmx3072m などを使用します。
  8. 2 つの Web アプリケーションをデプロイします。
  9. デプロイ後に、2 つの Web アプリケーションを停止します。
  10. オーサーインスタンスとパブリッシュインスタンスの両方で、sling.properties ファイルで property felix.service.urlhandlers=false が false に設定されていると仮定します(デフォルトでは true に設定)。
  11. 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 を検索し、設定します(例:set WLS_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-configweb.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

インストール時に発生する可能性のある問題の対処方法については、以下を参照してください。

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56