Communities のデプロイ

前提条件

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

AEM プラットフォーム​用

Communities 機能​用

最新リリース

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

AEM 6.4 のアップデート

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

AEM 6.4の最新のアップデートについては、 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コンソールを使用してバンドルをインストールし、起動します。

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

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

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

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

chlimage_1-410

SCORM パッケージ

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

AEM Communities SCORM エンジンはイネーブルメント機能で必要になります。AEM Communities 6.4バージョンでサポートされるSCORMパッケージは次のとおりです。

SCORMエンジンの新規インストールの場合は、SCORM 2017.1( cq -social- scorm -package, version 2.2.2)を含むパッケージを使用する必要があります。 それによって、SCORM 2017 でサポートされているラーニングリソースを再生できます。

SCORM パッケージを初めてインストールする場合

  1. cq-social-scorm-package, version 2.2.2.​をインストールします。
  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 2017.1が必要な場合は、既存のSCORMインストールを​cq-social-scorm-package, version 2.2.2SCORM 2017.1を使用)にアップグレードできます。

メモ

SCORM 2017.1パッケージにアップグレードするには、既存のデータベースを移行する必要があります(詳しくは、後述)。

SCORM エンジンのバージョンをアップグレードするには

  1. ScormEngineDB スキーマのバックアップを作成します。

  2. cq-social-scorm-package, version 2.2.2.​をインストールします。

  3. /libs/social/config/scorm/ScormEngine.zipからパッケージをダウンロードし、同じものを抽出します。

  4. 展開したディレクトリの​Installer​フォルダーに移動します。

  5. EngineInstall.xml​のscorm db connection urlSystemDatabaseConnectionStringを更新します。

  6. 次のコマンドを使用して、Installer フォルダー内で mysql スキーマアップグレードツールを実行します。

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. engine_upgrade.log ファイルを監視して、エラーとスキーマアップグレードステータスを確認します。

  8. パブリッシャーの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インスタンスで、パッケージマネージャー(例:http://localhost:4502/crx/packmgr/)を使用して、ローカルのAEMパッケージリポジトリにアップロードします。

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

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

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

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

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

アップグレード

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

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

設定

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

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

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

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

chlimage_1-411

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

  • 管理者権限でログイン

  • 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 に変更した結果を示しています。

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

chlimage_1-412

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

chlimage_1-413

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

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

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

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

chlimage_1-414

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

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 を使用して、次の手順を実行します。

chlimage_1-415

Granite 暗号バンドルの更新

chlimage_1-416

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

    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)とコミュニティのコンポーネントと機能のカスタマイズについては、 コミュニティの開発を参照してください。

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

このページ