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 Manager6.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 アーカイブから抽出したバンドルを参照し、選択します。
    • Oracle社のMySQLcom.mysql.jdbc​用JDBCドライバーがアクティブであることを確認し、アクティブでない場合は開始します(またはログを確認します)
  4. JDBCの設定後に既存のデプロイメントにインストールする場合は、WebコンソールからJDBC設定を再保存して、JDBCを新しいコネクタに再バインドします。

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

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

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

小包

SCORM パッケージ

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

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

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

  1. パッケージ共有からcq-social-scorm-package、バージョン2.3.7をインストールします。
  2. cqインスタンスから/libs/social/config/scorm/database_scormengine_data.sqlをダウンロードし、mysqlサーバーで実行して、アップグレードされたscormEngineDBスキーマを作成します。
  3. パブリッシャーの追加https://<hostname>:<port>/system/console/configMgrからCSRFフィルターの除外されたパスプロパティの/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 Configurationを参照してください。

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 の変更について学習してください。

設定

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

選択した展開が発行ファームの場合、1つのAEM発行インスタンスを​primary publisher​として識別する必要があります。これは、通知​や​Adobe Analytics​に依存する機能など、すべてのインスタンスで発生しません。

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

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

chlimage_1-411

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

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

レプリケーションは、コミュニティグループなどの発行環境で作成されるサイトコンテンツに使用され、tunnel serviceを使用して作成者環境からメンバーとメンバーグループを管理します。

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

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

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

  • 作成者のレプリケーションコンソールにアクセスする

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

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

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

      1. エージェントの選択

      2. 編集​を選択

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

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

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

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

デフォルトエージェント(発行)

chlimage_1-412

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

chlimage_1-413

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

作成者環境を使用してサイトの作成](/docs/experience-manager-65/communities/sites-console.html?lang=ja)、サイトのプロパティの変更、またはコミュニティメンバーの管理を行う場合は、作成者に登録された環境ではなく、公開ユーザーにアクセスする必要があります。[

トンネルサービスは、作成者の複製エージェントを使用してこのアクセスを提供します。

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

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

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バンドル](#refresh-the-granite-crypto-bundle)を[更新する必要があります

CAUTION

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

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

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

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE

作成者](#replication-agents-on-author)の[レプリケーションエージェントが正しく構成されていることを確認することが重要です。

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

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

Granite 暗号バンドルの更新

  • 各発行インスタンスで、Webコンソールにアクセスします

  • Adobe Granite Crypto Supportバンドルを検索(com.adobe.granite.crypto)

  • 更新​を選択

    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 を使用する場合は、次の説明を参照してください。

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

  • Social Component Framework(SCF)とCommunitiesのコンポーネントと機能のカスタマイズについては、Developing Communitiesを参照してください。

  • Communitiesコンポーネントの作成方法と設定方法については、Authoring Communities Componentsを参照してください。

このページ