Communities のデプロイ deploying-communities

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

前提条件 prerequisites

インストールチェックリスト installation-checklist

AEM platform

コミュニティ機能

最新リリース latest-releases

AEM 6.4 Communities GA には Communities パッケージが含まれています。 AEM 6.4 の更新について知るには コミュニティ、を参照してください。 AEM 6.4 リリースノート.

AEM 6.4 の更新 aem-updates

AEM 6.3 以降、Communities の更新はAEM Cumulative Fix Packs および Service Pack の一部として提供されます。

AEM 6.4 の最新の更新については、 Adobe Experience Manager 6.4 累積修正パックおよびサービスパック.

バージョン履歴 version-history

AEM 6.4 以降と同様に、AEM Communitiesの機能とホットフィックスは、AEM Communitiesの累積修正パックおよびサービスパックの一部です。 したがって、別の機能パックはありません。

MySQL 用 JDBC ドライバー jdbc-driver-for-mysql

2 つのコミュニティ機能で 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 Connector バンドルがインストールされている example-installed-mysql-connector-bundle

chlimage_1-410

SCORM パッケージ scorm-package

SCORM(Shareable Content Object Reference Model) は、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 が必要な場合。

NOTE
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 ログ scorm-logging

インストールすると、すべてのイネーブルメントアクティビティがシステムコンソールに完全に記録されます。

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

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

高度な MLS のAEM aem-advanced-mls

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

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

  • AEM-SOLR-MLS-phasetwo

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

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

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

パッケージはAdobeAEM Cloud で表示

このページのパッケージへのリンクでは、共有をパッケージ化するので、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インスタンスのパッケージリポジトリで、パッケージマネージャーを使用してパッケージをインストールします。

詳しくは、 パッケージの操作方法.

推奨されるデプロイメント recommended-deployments

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

共通ストアは、パブリッシュ環境で UGC のモデレートと分析をサポートし、 複製 UGC の

アップグレード upgrading

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

プラットフォームのアップグレードに加えて、 AEM Communities 6.4 へのアップグレード コミュニティの変更について学ぶには

設定 configurations

プライマリ発行者 primary-publisher

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

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

したがって、次の操作が必要です。 すべてのセカンダリパブリッシュインスタンスで設定を編集 チェックを外す Primary Publisher チェックボックス。

chlimage_1-411

パブリッシュファーム内のその他(セカンダリ)パブリッシュインスタンスの場合:

オーサー環境のレプリケーションエージェント replication-agents-on-author

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

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

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

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

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

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

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

    • リバースレプリケーションエージェント(パブリッシュリバース)

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

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

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

chlimage_1-412

リバースレプリケーションエージェント(パブリッシュリバース) reverse-replication-agent-publish-reverse

chlimage_1-413

オーサー環境のトンネルサービス tunnel-service-on-author

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

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

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

chlimage_1-414

暗号鍵のレプリケート replicate-the-crypto-key

AEM Communitiesには 2 つの機能があり、すべてのAEMサーバーインスタンスで同じ暗号化キーを使用する必要があります。 以下が該当します。 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インスタンスが現在実行中の場合 )

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

リポジトリレプリケーション repository-replication

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

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE
重要なのは、 オーサー環境のレプリケーションエージェント が正しく設定されている。

リポジトリに保存されたキー材料を使用して、オーサーから他のインスタンスに暗号キーをレプリケートする方法は次のとおりです。

使用 CRXDE Lite:

chlimage_1-415

Granite 暗号バンドルを更新します。 refresh-the-granite-crypto-bundle

chlimage_1-416

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

    Operation completed successfully.

Apache HTTP サーバー apache-http-server

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

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

httpd.conf のサンプル httpd-conf-sample

<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

Dispatcher を使用する場合は、以下を参照してください。

関連するコミュニティドキュメント related-communities-documentation

  • 訪問 コミュニティサイトの管理 コミュニティサイトの作成、コミュニティサイトテンプレートの設定、コミュニティコンテンツのモデレート、メンバーの管理、メッセージングの設定について説明します。

  • 訪問 コミュニティの開発 ソーシャルコンポーネントフレームワーク (SCF) と、コミュニティのコンポーネントと機能のカスタマイズについて説明します。

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

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6