Communities のデプロイ

前提条件

インストールチェックリスト

AEM プラットフォーム​用

Communities 機能​用

最新リリース

AEM 6.5 Communities GAにはCommunitiesパッケージが含まれています。 AEM 6.5 Communities のアップデートについて詳しくは、AEM 6.5 リリースノートを参照してください。

AEM 6.5 のアップデート

AEM 6.4 以降、Communities のアップデートは、AEM 累積修正パックおよびサービスパックの一部として提供されています。

AEM 6.5の最新の更新については、 Adobe Experience Manager 6.4累積修正パックおよびサービスパックを参照してください。

バージョン履歴

AEM 6.4 以降、AEM Communities 機能およびホットフィックスは、AEM Communities 累積修正パックおよびサービスパックの一部として提供されます。したがって、独立した機能パックは提供されません。

MySQL 用 JDBC ドライバー

以下の 2 つの Communities 機能で MySQL データベースを使用しています。

  • イネーブルメントの場合:SCORMアクティビティと学習者の記録
  • DSRPの場合:ユーザー生成コンテンツ(UGC)の保存

MySQL コネクタを別途入手し、インストールする必要があります。

必要な手順は次のとおりです。

  1. https://dev.mysql.com/downloads/connector/j/からZIPアーカイブをダウンロードします。

    • バージョンは5.1.38以降である必要があります
  2. mysql-connector-java-<version>-bin.jar(バンドル)をアーカイブから抽出します。

  3. Webコンソールを使用してバンドルをインストールし、起動します。

    • 例: https://localhost:4502/system/console/bundles
    • Install/Update
    • ダウンロードした ZIP アーカイブから抽出したバンドルを参照し、選択します。
    • MySQLcom.mysql.jdbc​用のOracleCorporationのJDBCドライバがアクティブであることを確認し、アクティブでない場合は起動します(またはログを確認します)。
  4. JDBCの設定後に既存のデプロイメントにインストールする場合は、WebコンソールからJDBC設定を再保存して、JDBCを新しいコネクタに再バインドします。

    • 例: https://localhost:4502/system/console/configMgr
    • Day Commons JDBC Connections Pool構成を探します
    • 選択して開きます。
    • Save
  5. すべてのオーサーインスタンスとパブリッシュインスタンスで手順3と4を繰り返します。

バンドルのインストールに関する詳細は、Webコンソールページを参照してください。

例:インストール済みの MySQL コネクタバンドル

connector-bundle

SCORM パッケージ

Shareable Content Object Reference Model(SCORM)は、e ラーニングの標準規格と仕様をまとめた参照モデルです。SCORM では、コンテンツを転送可能な ZIP ファイルにパッケージ化する方法も定義されています。

AEM Communities SCORM エンジンはイネーブルメント機能で必要になります。AEM 6.5 CommunitiesでサポートされるSCORMパッケージ:

SCORMパッケージをインストールするには

  1. パッケージ共有からcq-social-scorm-package, version 2.3.7をインストールします。
  2. cqインスタンスから/libs/social/config/scorm/database_scormengine_data.sqlをダウンロードし、mysqlサーバーで実行して、アップグレードされたscormEngineDBスキーマを作成します。
  3. パブリッシャーのhttps://<hostname>:<port>/system/console/configMgrからCSRFフィルターのExcluded Pathsプロパティに/content/communities/scorm/RecordResultsを追加します。

SCORM ロギング

インストールすると、すべてのイネーブルメントアクティビティがシステムコンソールに詳細にロギングされます。

必要に応じて、RusticiSoftware.*パッケージのログレベルをWARNに設定できます。

ログの操作については、監査レコードとログファイルの操作を参照してください。

AEM の高度な MLS

SRP コレクション(MSRP または DSRP)で高度な多言語検索(MLS)をサポートするには、カスタムスキーマと Solr 設定に加えて、新しい Solr プラグインが必要です。必要な項目はすべて、ダウンロード可能なzipファイルにパッケージ化されます。

高度な MLS のダウンロード(「phasetwo」ともいう)は、アドビのリポジトリから入手できます。

  • AEM-SOLR-MLS-phasetwo

    • バージョン1.2.40(2016年4月7日)
    • AEM-SOLR-MLS-phasetwo-1.2.40.zipをダウンロードします。

詳細とインストール情報については、SRPのSolr設定🔗を参照してください。

Adobe AEM クラウドでのパッケージの表示

このページのパッケージへのリンクは、adobeaemcloud.com上で共有をパッケージ化するので、AEMの実行インスタンスを必要としません。 パッケージは表示可能ですが、「Install」ボタンは、Adobeがホストするサイトにパッケージをインストールするためのものです。 ローカルのAEMインスタンスにインストールする場合は、Installを選択するとエラーが発生します。

ローカルの AEM インスタンスにインストールする方法

adobeaemcloud.comに表示されるパッケージをローカルのAEMインスタンスにインストールするには、まずパッケージをローカルディスクにダウンロードする必要があります。

  • アセット」タブを選択します。
  • ディスク​にダウンロードを選択します

ローカルのAEMインスタンスで、パッケージマネージャー(例:https://localhost:4502/crx/packmgr/)を使用して、ローカルのAEMパッケージリポジトリにアップロードします。

または、ローカルのAEMインスタンスからパッケージ共有を使用してパッケージにアクセスする(例えば、https://localhost:4502/crx/packageshare/)と、Downloadボタンは、ローカルのAEMインスタンスのパッケージリポジトリにダウンロードされます。

ローカルのAEMインスタンスのパッケージリポジトリに移動したら、パッケージマネージャーを使用してパッケージをインストールします。

詳しくは、パッケージの使い方を参照してください。

AEM Communitiesでは、共通ストアはユーザー生成コンテンツ(UGC)の格納に使用され、多くの場合、ストレージリソースプロバイダー(SRP)と呼ばれます。 推奨されるデプロイメントは、共通ストア用のSRPオプションの選択に重点を置いています。

この共通ストアは、パブリッシュ環境でのUGCのモデレートと分析をサポートし、UGCのレプリケーションを不要にします。

アップグレード

以前のバージョンの AEM から AEM 6.5 プラットフォームにアップグレードするときは、AEM 6.5 へのアップグレードをお読みください。

プラットフォームのアップグレードについてだけでなく、AEM Communities 6.5 へのアップグレードもお読みいただき、Communities の変更について学習してください。

設定

プライマリパブリッシャー

選択したデプロイメントがパブリッシュファームの場合、通知​や​Adobe Analytics​に依存する機能など、すべてのインスタンスで発生しないアクティビティの場合、1つのAEMパブリッシュインスタンスを​primary publisher​として識別する必要があります。

デフォルトでは、 AEM Communities Publisher Configuration OSGi設定では​Primary Publisher​チェックボックスがオンになっており、パブリッシュファーム内のすべてのパブリッシュインスタンスがプライマリとして自己識別されます。

したがって、すべてのセカンダリパブリッシュインスタンスの設定を編集して、「」チェックボックスをオフにする必要があります。Primary Publisher

primary-publisher

パブリッシュファーム内の他のすべての(セカンダリ)パブリッシュインスタンスについて、以下をおこないます。

  • 管理者権限でログイン

  • Webコンソールにアクセスします。

  • AEM Communities Publisher Configuration

  • 編集アイコンを選択します。

  • プライマリパブリッシャー」ボックスをオフにします。

  • 保存」を選択します。

オーサー環境でのレプリケーションエージェント

レプリケーションは、パブリッシュ環境で作成されたサイトコンテンツ(コミュニティグループなど)に使用され、トンネルサービスを使用してオーサー環境のメンバーとメンバーグループを管理します。

プライマリパブリッシャーの場合は、 レプリケーションエージェント設定でパブリッシュサーバーと承認済みユーザーが正しく識別されていることを確認します。 デフォルトの許可されたユーザーadmin,には、適切な権限が既に割り当てられています(Communities Administratorsのメンバーです)。

他のユーザーが適切な権限を持つには、そのユーザーをadministratorsユーザーグループ(Communities Administratorsのメンバーも含む)にメンバーとして追加する必要があります。

オーサー環境には 2 つのレプリケーションエージェントがあり、正しく設定するにはトランスポート設定が必要です。

  • オーサー環境のレプリケーションコンソールにアクセスする

    • グローバルナビゲーションから、ツール / デプロイ / レプリケーション / 作成者のエージェント​に移動します。
  • 両方のエージェントで同じ手順を実行します。

    • デフォルトエージェント(publish)

    • リバースレプリケーションエージェント(publish reverse)

      1. エージェントの選択

      2. edit​を選択します。

      3. トランスポート」タブを選択します。

      4. ポート4503以外の場合は、URI​を編集して正しいポートを指定します

      5. ユーザーadminでない場合は、User​と​Password​を編集して、administratorsユーザーグループのメンバーを指定します。

以下の画像は、ポートを 4503 から 6103 に変更した結果を示しています。

デフォルトエージェント(パブリッシュ)

default-agent-publish

リバースレプリケーションエージェント(publish reverse)

reverse-replication-agent

オーサー環境のトンネルサービス

オーサー環境を使用してサイトサイトのプロパティを変更またはコミュニティメンバーを管理する場合は、オーサー環境に登録されたユーザーではなく、パブリッシュ環境に登録されたメンバー(ユーザー)にアクセスする必要があります。

トンネルサービスは、オーサー環境のレプリケーションエージェントを使用してこのアクセスを提供します。

トンネルサービスを有効にするには:

暗号鍵のレプリケーション

AEM Communities には、すべての AEM サーバーインスタンスで同じ暗号鍵を使用する必要がある機能が 2 つあります。AnalyticsASRPです。

AEM 6.3以降では、重要な資料はファイルシステムに保存され、リポジトリには保存されなくなります。

オーサー環境から他のすべてのインスタンスに鍵の素材をコピーするには、以下の操作をおこなう必要があります。

  • コピーする主要な資料を含むAEMインスタンス(通常はオーサーインスタンス)にアクセスします

    • ローカルファイルシステム内のcom.adobe.granite.crypto.fileバンドルを探します。
      例:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • bundle.infoファイルはバンドルを識別します
    • データフォルダーに移動します。
      例:

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

      • hmacファイルとプライマリノードファイルをコピーする

  • 各ターゲットAEMインスタンス

    • データフォルダーに移動します。
      例:

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • 前にコピーした2つのファイルを貼り付けます。

    • ターゲットAEMインスタンスが現在実行中の場合は、Granite Cryptoバンドルを更新する必要があります

注意

既に暗号鍵に基づいて別のセキュリティ機能が設定されている場合、暗号鍵のレプリケーションをおこなうと設定が破損する可能性があります。サポートが必要な場合は、カスタマーケアにお問い合わせください。

リポジトリのレプリケーション

AEM 6.2以前と同様に、主要なマテリアルをリポジトリに保存する場合は、各AEMインスタンスの初回起動時に(初期リポジトリを作成する)次のシステムプロパティを指定することで、保持できます。

  • -Dcom.adobe.granite.crypto.file.disable=true
メモ

オーサー🔗上のレプリケーションエージェントが正しく設定されていることを確認することが重要です。

リポジトリに鍵の素材が格納されるので、オーサー環境から他のインスタンスへ暗号鍵をレプリケーションする方法は次のようになります。

CRXDE Lite を使用して、次の手順を実行します。

Granite 暗号バンドルの更新

  • 各パブリッシュインスタンスで、Webコンソールにアクセスします。

  • Adobe Granite Crypto Supportバンドル(com.adobe.granite.crypto)を探します

  • 更新​を選択します。

    granite-crypto

  • しばらくすると、成功​ダイアログが表示されます。
    Operation completed successfully.

Apache HTTP サーバー

Apache HTTP サーバーを使用する場合は、すべての関連エントリで正しいサーバー名を使用していることを確認してください。

特に、RedirectMatchではlocalhostではなく、正しいサーバー名を使用するように注意してください。

httpd.conf のサンプル

<IfModule alias_module>
     # XAMPP does not have a favicon; this prevents any 404 errors which may arise.
     Redirect 404 /favicon.ico
     <Location /favicon.ico>
         ErrorDocument 404 "No favicon"
     </Location>

    # Return from "Sign Out" generates response header directing you to "/", generating a 404 error
    # The RedirectMatch resolves it correctly when modified for the target Community Site :
    RedirectMatch ^/$ https://[server name]/content/sites/engage/en.html
 ...
 </IfModule>

Dispatcher

Dispatcher を使用する場合は、次の説明を参照してください。

  • コミュニティサイトの作成、コミュニティサイトテンプレートの設定、コミュニティコンテンツのモデレート、メンバーの管理およびメッセージングの設定については、コミュニティサイトの管理を参照してください。

  • ソーシャルコンポーネントフレームワーク(SCF)とコミュニティのコンポーネントと機能のカスタマイズについては、 コミュニティの開発を参照してください。

  • コミュニティコンポーネントを使用してオーサリングおよび設定する方法については、 コミュニティコンポーネントのオーサリングを参照してください。

このページ