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. から ZIP アーカイブをダウンロードします。 https://dev.mysql.com/downloads/connector/j/

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

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

    • 例: http://localhost:4502/system/console/bundles
    • 選択 Install/Update
    • ダウンロードした ZIP アーカイブから抽出したバンドルを参照し、選択します。
    • 確認する Oracle社の MySQLcom.mysql.jdbc 用 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、バージョン 2.2.2) を使用する必要があります。 それによって、SCORM 2017 でサポートされているラーニングリソースを再生できます。

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

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

既存の SCORM インストールをにアップグレードできます cq-social-scorm-package,バージョン 2.2.2 ( SCORM 2017.1)、作成したコースコンテンツに SCORM 2017.1 が必要な場合。

メモ

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

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

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

  2. のインストール cq-social-scorm-package,バージョン 2.2.2.

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

  4. に移動します。 インストーラー 抽出したディレクトリのフォルダ。

  5. 更新 SystemDatabaseConnectionStringscorm db connection url ファイル内 EngineInstall.xml.

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

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

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

  8. 追加 /content/communities/scorm/RecordResults in 除外されたパス 次のプロパティを CSRF フィルターで使用 https://<hostname>:<port>/system/console/configMgr (発行者)

SCORM ロギング

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

必要に応じて、ログレベルを RusticiSoftware.* パッケージ。

ログの操作については、 監査レコードとログファイルの操作.

AEM の高度な MLS

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

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

  • AEM-SOLR-MLS-phasetwo

    高度な MLS パッケージを入手するには、 高度な MLS のAEM (ドキュメントのデプロイ節)を参照してください。

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

詳細およびインストール情報については、 Solr 設定 (SRP 用)

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

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

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

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

  • を選択します。 Assets タブ
  • 選択 ディスクにダウンロード

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

設定

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

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

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

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

chlimage_1-411

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

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

レプリケーションは、コミュニティグループなど、パブリッシュ環境で作成されたサイトコンテンツに対して使用され、 トンネルサービス.

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

他のユーザーが適切な権限を持つには、そのユーザーをメンバーとして administrators ユーザーグループ ( Communities Administrators) をクリックします。

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

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

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

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

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

      1. エージェントを選択
      2. 選択 編集
      3. を選択します。 輸送 タブ
      4. ポートでない場合 4503URI 正しいポートを指定するには
      5. ユーザーでない場合 adminユーザー および パスワード メンバを指定するには administrators ユーザーグループ

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

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

chlimage_1-412

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

chlimage_1-413

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

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

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

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

chlimage_1-414

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

AEM Communities には、すべての AEM サーバーインスタンスで同じ暗号鍵を使用する必要がある機能が 2 つあります。以下が該当します。 Analytics および ASRP.

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 つのファイルを貼り付けます。

    • ~する必要がある。 Granite Crypto バンドルを更新します。 (target AEMインスタンスが現在実行中の場合 )

注意

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

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

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 サーバーを使用する場合は、すべての関連エントリで正しいサーバー名を使用していることを確認してください。

特に、正しいサーバー名を使用するように注意してください。 localhostRedirectMatch.

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) と、コミュニティのコンポーネントと機能のカスタマイズについて説明します。

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

このページ