OSGはAEMのテクノロジスタックの基本要素です。AEMの複合バンドルとその設定を制御するために使用されます。
OSGi は標準化されたプリミティブを提供し、小さく再利用が可能で連携機能に優れたコンポーネントを組み合わせてアプリケーションを構築することを可能にします。これらのコンポーネントからアプリケーションを作成し、デプロイすることができます。**
これにより、 バンドルの管理が容易になり、バンドルを個別に停止、インストール、開始できます。相互依存関係は自動的に処理されます。各OSGiコンポーネント(OSGi仕様を参照)は、様々なバンドルの1つに含まれています。 AEMで作業する場合、このようなバンドルの設定を管理する方法はいくつかあります。詳細と推奨プラクティスについては、OSGiの設定を参照してください。
次の OSGi 設定(バンドルに従ったリスト)は、プロジェクトの実装に関連しています。すべての設定に調整が必要なわけではなく、一部の設定は AEM の動作を説明する目的で言及されています。
このリストはガイドラインの役割を果たすものであり、完全ではありません。すべてのバンドルがリストされているわけではなく、リストされているバンドルに関しても、すべてのパラメーターがリストされているわけではありません。
必要な設定は、プロジェクトによって異なります。
使用する値およびパラメーターの詳細は、Web コンソールを確認してください。
AEM Toolsの一部であるOSGi Configuration Diffツールは、デフォルトのOSGi設定のリストに使用できます。
AEM 内の機能の特定の領域では、さらに多くのバンドルが必要な場合があります。この場合、設定の詳細は、該当する機能の関連ページで確認できます。
AEMレプリケーションイベント ListenerConfigure:
実行モード。このモードでは、レプリケーションイベントがリスナーに配布されます。 たとえば、authorと定義した場合、これはレプリケーションを「開始」するシステムです。
プロジェクトコードがパブリッシュ環境でレプリケーションイベント(逆複製)を処理する場合は、実行モードpublishを追加する必要があります。 例えば、ディスパッチャーを使用して発行環境からフラッシュする場合や、他の発行インスタンスへの標準複製が発生する場合などです。
AEMリポジトリ変更 リスナーの設定:
CRX Sling Client Repository基盤となるコンテンツリポジトリへのアクセスを設定します。
Wikiメール サービスWikiから送信される電子メールの電子メール設定を構成します。
Apache Felix OSGi Management Console設定:
必ず以下を設定してください。
ユーザー 名と パスワード。Apache Felix Web Management Consoleにアクセスするための秘密鍵証明書です。
インスタンスのセキュリティを確実にするために、最初のインストール後にパスワードを変更する必要があります。
この設定は起動時に必要なので、リポジトリが使用可能になる前に、Felix コンソールを使用して設定する必要があります。
Apache Slingカスタマイズ可能な要求データ ロガー設定:
request.log
)をクリックします。 このログファイルは、Webチェーンに関連するパフォーマンスやデバッグ機能を分析する際に重要です。これは Apache Sling Request Logger とペアで使用されます。詳しくは、AEM のログおよび Sling のログに関するページを参照してください。
Apache Sling Eventing Thread Pool設定:
Min Pool Size および Max Pool Size:イベントスレッドを保持するために使用するプールのサイズ。
Queue Size:プールを使い果たした場合のスレッドキューの最大サイズ。推奨値は-1
です。これにより、キューは無制限に設定されます。制限を設定すると、制限を超えた場合に損失が発生する可能性があります。
これらの設定を変更すると、イベント数が非常に多い状況(例:AEM DAM またはワークフローの使用頻度が高い場合)におけるパフォーマンスの強化に役立ちます。
テストを実施して、状況に応じた値を確立する必要があります。
これらの設定はインスタンスのパフォーマンスに影響を及ぼす可能性があるので、変更の際は十分な理由と検討が必要です。
Apache SlingGET サーブレットレンダリングの設定
AEM を実稼動準備完了モードで実行している場合は、この設定は自動的に実稼動インスタンス用に設定されます。
Apache Sling Java Script Handlerスクリプト(サーブレット)としての.javaファイルのコンパイルの設定。
特定の設定がパフォーマンスに影響を及ぼす可能性があります。可能な場合(特に、実稼動インスタンスの場合)は、それらを無効にしてください。
Source VM および Target VM:ランタイム JVM として使用する JDK バージョンを定義します。
実稼動インスタンスの場合:
Apache Sling JCR Installerこれらのパラメーターは、おそらく設定は必要ありませんが、開発時やデバッグ時に知っておくと役立ちます。例えば、インストールフォルダーはパッケージのチェックイン/チェックアウトまたは作成に役立つ場合があります。
インストールフォルダ名 regexpandインストールフォルダの階層の最大深度 — インストールするリソースを検索する場所と深さを指定します。ワイルドカードを使用する場合(.など)*/install)適切なすべての一致が検索されます(例:/libs/sling/install
、/libs/cq/core/install
)。
Search Path:インストールするリソースを jcrinstall が検索するパスのリストです。そのパスの重み付け係数を示す数値も表示されます。
Apache Slingジョブイベント ハンドラジョブスケジュールを管理する設定パラメーター:
再試行間隔、 最大再試行数、最大並列ジョブ数 、認識待ち時間 など。
これらの設定を変更すると、ジョブ数が多いシナリオでのパフォーマンスが向上します。例えば、AEM DAMやワークフローを大量に使用している場合などです。
テストを実施して、状況に応じた値を確立する必要があります。
これらの設定は理由なく変更しないでください。変更は、考慮が必要な場合にのみ行ってください。
Apache Sling JSPスクリプト ハンドラJSPスクリプトハンドラのパフォーマンス関連の設定を行います。パフォーマンスを向上するには、可能な限り設定を無効にしてください。
特に、実稼動インスタンスの場合は、次の設定を無効にします。
AEM を実稼動準備完了モードで実行している場合は、この設定は自動的に実稼動インスタンス用に設定されます。
Apache Slingログの 設定:
Log Level および Log File:主要なログ設定(error.log)の場所とログレベルを定義します。レベルは、DEBUG
、INFO
、WARN
、ERROR
、FATAL
のいずれかに設定できます。
Number of Log Files および Log File Threshold:ログファイルのサイズとバージョンのローテーションを定義します。
Message Pattern:ログメッセージの形式を定義します。
詳しくは、AEM のログおよび Sling のログに関するページを参照してください。
Apache Sling Logging Logger Configuration(ファクトリ設定) 設定:
Log Level、Log File および Message Format:ログファイルとメッセージの詳細を定義します。
Logger:カテゴリを定義します(例:com.day.cq のログのみ)。
「Factory Configurations」を使用することにより、必要とされる様々なログレベルとカテゴリに応じて、任意の数の設定を追加できます。
このような設定は開発時に役立ちます。例えば、特定のログファイルで、特定のサービスのトレースメッセージをログに記録する場合などです。
このような設定は実稼動環境で役立ちます。例えば、特定のサービスに関するメッセージを個々のログファイルに記録して、簡単に監視できるようにする場合などです。
詳しくは、AEM のログおよび Sling のログに関するページを参照してください。
Apache Sling Logging Writerの設定(工場出荷時の設定) 設定:
Log File:ログファイルの有無を定義します。
Number of Log Files:バージョンのローテーションを定義します。
ライターは Apache Sling Logging Logger Configuration 設定で使用できます。
このような設定は開発時に役立ちます。例えば、特定のログファイルで、特定のサービスのトレースメッセージをログに記録する場合などです。
このような設定は実稼動環境で役立ちます。例えば、特定のサービスに関するメッセージを個々のログファイルに記録して、簡単に監視できるようにする場合などです。
詳しくは、AEM のログおよび Sling のログに関するページを参照してください。
Apache Sling Main ServletConfigure:
Apache Sling MIME Type ServiceConfigure:
GET
要求において、ファイル形式とアプリケーションをリンクするための適切な content-type ヘッダーを設定できます。Apache Sling転送者 フィルタCRX WebDAVとApache SlingのCross-Site Request Forgery(CSRF)に関する既知のセキュリティの問題に対処するには、転送者フィルタを設定する必要があります。
リファラーフィルターサービスは OSGi のサービスの 1 つであり、次の設定が可能です。
詳しくは、「セキュリティチェックリスト」のクロスサイトのリクエスト偽造に関する問題を参照してください。
Apache Sling Referrer Filter はクイックフィックスパッケージのインストールに依存します。
Apache Sling要求 ロガー設定:
要求をログに記録する方法を定義するための様々なパラメーター。
Enable Request Log:有効または無効にします。
Enable Access Log:有効または無効にします。
これは Apache Sling Customizable Request Data Logger とペアで使用されます。
詳しくは、AEM のログおよび Sling のログに関するページを参照してください。
Apache Sling Resource Resolver FactorySlingリソース解決の中心的側面を設定します。
リソース検索パス(複数可)、プロジェクト固有のパスを追加します(削除 /libs
や /apps
削除はしません)。
Virtual URLs:バニティー URL のマッピングを定義します。
URL マッピングを使用してエイリアスを定義します。例えば、から /content
に /
。
マッピングの場所、で外部化されたマッパー設定 /etc/map
。
ローカルインストールを使用して(例えば、https://localhost:4502/system/console/jcrresolver
を使用して)、どのリソースリゾルバーがアクティブかを判断します。
詳しくは、https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution を参照してください。
具体的には、これらのオプションはリポジトリで設定する必要があります。
そうしないと、Felix コンソールでおこなった「URL Mappings」に対する変更が、次回の起動時に AEM によって上書きされる可能性があります。
Apache Slingサーブレット/スクリプトリゾルバーとエラー ハンドラーSlingサーブレットとスクリプトリゾルバーには複数のタスクがあります。
ServletResolver
として使用され、要求を処理するために呼び出す Servlet または Script を選択します。
SlingScriptResolver
として機能します。
エラー処理を管理します。そのためには、要求処理のサーブレット/スクリプトの解決に使用するのと同じアルゴリズムを使用してエラー処理のサーブレット/スクリプトを選択する ErrorHandler
インターフェイスを実装します。
次のような様々なパラメーターを設定できます。
/
= root)。これにより、すべてのスクリプトが実行されます。設定したパス値がスラッシュで終わる場合は、サブツリー全体が検索されます。末尾にスラッシュを指定しないと、完全一致の場合にのみスクリプトが実行されます。
Script User:このオプションのプロパティでは、スクリプトの読み取りに使用するリポジトリユーザーアカウントを指定できます。アカウントを指定しない場合は、admin
ユーザーがデフォルトで使用されます。
Default Extensions:デフォルトの動作が使用される拡張子のリストです。つまり、リソースタイプの最後のパスセグメントをスクリプト名として使用できます。
Day Commons GFX Font Helperグラフィックのレンダリング時に、DrawTextを使用してテキストを埋め込むことができます。そのために、独自のフォントをインストールすることも可能です。
/apps/myapp/fonts
です。Apache HTTPコンポーネントプロキシ 設定Apache HTTPクライアントを使用するすべてのコードのプロキシ設定。HTTPが作成されたときに使用されます。例えば、レプリケーション時に
新しい設定を作成する場合は、ファクトリの設定を変更せず、代わりに、次のURLで提供されているConfiguration Managerを使用して、このコンポーネントの新しいファクトリ設定を作成します。https://localhost:4502/system/console/configMgr/. プロキシ設定はorg.apache.http.proxyconfiguratorで入手できます。
AEM 6.0 以前のリリースでは、プロキシは Day Commons HTTP Client で設定されていました。AEM 6.1 以降のリリースでは、プロキシ設定は、「Day Commons HTTP Client」設定ではなく、「Apache HTTP Components Proxy Configuration」に移動されました。
Day CQ Antispam使用するスパム対策サービス(Akismet)を設定します。次の項目を登録する必要があります。
AdobeGranite HTML Library Managerクライアントライブラリ(cssまたはjs)の処理を制御するように設定します。例えば、基になる構造体の見え方を含む。
実稼動インスタンスの場合:
JS 開発の場合(特に、Firebug を使用するか、デバッグをおこなう場合):
縮小またはGzipの設定を変更する場合は、/var/clientlibs
の内容も削除する必要があります。これはclientlibsのキャッシュバージョンで、次の要求時に再構築されます。
AEM を実稼動準備完了モードで実行している場合は、この設定は自動的に実稼動インスタンス用に設定されます。
Day CQ HTTP Header Authentication HandlerHTTPリクエストの基本的な認証方法に関する全体的な設定。
閉じられたユーザーグループを使用すると、(特に)以下を設定できます。
Day CQ Link Checker ServiceCheckと、必要に応じて次の設定を行います。
Scheduler Period:外部リンクを自動的にチェックする間隔を定義します。
Bad Link Tolerance Interval:失敗した外部リンクが無効と見なされるまでの期間を指定します。
Link Check Override Patterns:リンクチェックから除外するパスを定義します。
Day CQ Link Checker Task単一のリンクチェッカー タスク(外部リンクをチェックするタスク)の設定:
Good Link Test Interval および Bad Link Test Interval で定義されている間隔をチェックします。
リンクをチェックする際に外部アクセスのために必要な、インターネットアクセスおよび NTLM 用のプロキシに関連する様々なパラメーターを設定します。
Day CQ Mail Serviceメールサーバーのホスト名とアクセスの詳細を設定します。「Mail Serviceの設定」の節を参照してください。
Day CQ MCM ニュースレターニュースレターで使用する様々な設定を指定します。
Day CQ Root Mapping設定:
/
」へのリクエストがリダイレクトされる先を定義します。AEM では次の 2 つの UI を使用できます。
AEM ルートマッピングを使用すると、希望する UI を、インスタンスのデフォルトとして設定できます。
タッチ対応UIをデフォルトのUIにするには、ターゲットパスが次を指すようにします。
/projects.html
クラシックUIをデフォルトのUIにするには、ターゲットパスが次を指すようにします。
/welcome.html
標準インストールでは、タッチ操作向け UI がデフォルトの UI です。
AdobeGranite SSO認証 ハンドラーシングルサインオン(SSO)の設定の詳細;これらは、多くの場合、エンタープライズ作成者の設定で必要となり、LDAPと組み合わせて使用されます。
様々な設定プロパティがあります。
Pathこの認証ハンドラーをアクティブにする対象のパス。このパラメーターを空のままにすると、認証ハンドラーは無効になります。例えば、/ というパスを指定すると、認証ハンドラーはリポジトリ全体に対して使用されます。
サービス
のランキングOSGiフレームワークサービスのランキング値は、このサービスの呼び出しに使用される順序を示します。これは、
int
値を大きくすると、優先順位が高くなります。デフォルト値は 0
です。
Header Names
ユーザー ID を含む可能性のあるヘッダーの名前です。
Cookie Names
ユーザー ID を含む可能性のある cookie の名前です。
Parameter Names
ユーザー ID を指定する可能性のある要求パラメーターの名前です。
ユーザ
マップ選択したユーザに対して、HTTP要求から抽出されたユーザ名を、credentialsオブジェクト内の別のユーザ名に置き換えることができます。マッピングはここで定義します。ユーザー名
admin
がマップの両側に表示される場合、マッピングは無視されます。「=」の文字は、先頭に「\」を付けてエスケープする必要があります。
Format
ユーザー ID を指定する際の形式を示します。次のいずれかを使用します。
Basic
:ユーザー ID が HTTP Basic 認証形式でエンコードされている場合AsIs
:ユーザー ID がプレーンテキストで指定されている場合や、正規表現が適用されている値をそのまま、または正規表現として使用する必要がある場合Day CQ WCM Debug Filterこれは、ページにアクセスする際に?debug=layoutなどのサフィックスを使用できる開発時に役立ちます。例えば、https://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layoutは開発者にとって興味のあるレイアウト情報を提供します。
Day CQ WCM Filter設定:
WCMモードを使用して、デフォルトのモードを定義します。
作成者インスタンスでは、edit
、disable,preview
、analytics
のいずれかになります。
その他のモードはサイドキックからアクセスできます。または、サフィックス?wcmmode=disabled
を使用して実稼動環境をエミュレートできます。
パブリッシュインスタンスでは、disabled
に設定して、その他のモードにアクセスできないようにする必要があります。
AEM を実稼動準備完了モードで実行している場合は、この設定は自動的に実稼動インスタンス用に設定されます。
Day CQ WCM Link Checker Configurator設定:
Day CQ WCM Page Processor設定:
jcr:Event
をトリガーする前にページの変更をリッスンする場所のリストです。Adobeページインプレッション数 トラッカー作成者インスタンスに対して次のように設定します。
-/libs/wcm/stats/tracker
この設定では、トラッキングサービスへの匿名リクエストが許可されます。
詳しくは、ページインプレッションを参照してください。
Day CQ WCM Page Statisticsパブリッシュインスタンスの設定:
URL to send data:ページ統計の追跡に使用する URL を設定します(トラッカー要求が Dispatcher を経由する場合は必須)。例えば、デフォルトは https://localhost:4502/libs/wcm/stats/tracker
です。
Tracking script enabled:ページ上の追跡スクリプトのインクルードを有効化(true
)または無効化(false
)します。デフォルト値は false
です。
詳しくは、ページインプレッションを参照してください。
Day CQ WCM Version ManagerControlは、システムでバージョンが管理されているかどうか、および管理方法を示します。
Create Version on Activation:標準インストールで有効になります。
Enable Purging
Purge Paths:検索アクションで検索するパス。
Implicit Versioning Paths:暗黙のバージョン管理がアクティブなパス。
Max Version Age:バージョンの最長有効期間(日数)。
Max Number Versions:保存するバージョンの最大数。
詳しくは、バージョンのパージを参照してください。
Day CQワークフロー電子メール通知 サービスワークフローから送信される通知の電子メール設定を指定します。
Day CQSE HTTP ServiceCQサーブレットエンジンの制御:
HTTPの場合はNIO、HTTPにNIOを使用するかどうか。デフォルトはtrueです。HTTPが有効な場合にのみ使用されます。
接続タイムアウト。接続タイムアウト(ミリ秒)。このプロパティは、HTTP接続とHTTPS接続の両方に適用されます。初期設定は60秒です。
HTTPSを有効にする、HTTPSが有効 かどうかを指定します。デフォルトはfalseです。
Session Timeout(セッションタイムアウト)。HTTPセッションのデフォルトの有効期間(分単位)です。タイムアウトが0以下の場合、セッションはタイムアウトしません。デフォルトは10分です。
デバッグログ(DEBUGレベルのメッセージを書き込むかどうか)。デフォルトはfalseです。
Request Buffer Size、要求のバッファーのサイズ(バイト単位)。初期設定は8KBです。
スレッドの最大数、要求の処理に使用するスレッドの最大数。初期設定は200です。
以下のプロパティは、HTTPS が有効な場合にのみ適用されます。
SSL関連のオプションの詳細およびCQSEでHTTPSを有効にする方法の詳細については、「HTTP Over SSLの有効化」も参照してください。
CQ Rewriter HTML Parser Factory
CQ リライターの HTML パーサーを制御します。
Day Commons JDBC Connections Poolコンテンツのソースとして使用されている外部データベースへのアクセスを設定します。
これはファクトリ設定なので、複数のインスタンスを設定できます。
Adobe CQメディアDPSセッション サービスパブリケーションで使用するDPSセッションの管理
具体的には、dps.session.service.url.name
、 を定義できます。デフォルトは https://dpsapi2.digitalpublishing.acrobat.com/webservices/sessions に設定されています。
CDN リライターAEMとCDNの間の通信は、アセット/バイナリがエンドユーザーに安全な方法で配信されるように保証する必要があります。この方法では 2 つのタスクをおこないます。
AEM は、内部アセットの URL を外部の CDN URL に書き直すリライターを提供しています。これにより、JWS 署名および有効期限を含む、CDN に渡すリンクが書き直され、アセットに安全にアクセスできるようになります。この機能は、オーサーインスタンスで使用されます。
全体的なフローは次のとおりです。
ユーザーが AEM で認証をおこない、アセットを含むページを要求します。
要求されたページには/content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png
と類似したアセットが含まれています
リライターがJWS署名を含むCDN URLにリンクを変換します。
CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE
ユーザーのブラウザーによって、CDN サーバーにアセット要求が転送されます。
要求が cdn_sign
パラメーターと共に AEM に転送されるように、CDN を設定する必要があります。
認証ハンドラーによって cdn_sign
パラメーターが検証され、CDN にアセットが返された後、アセットがユーザーに配信されます。
次の図に、ユーザーのブラウザー、CDN および AEM の間のフローを示します。
現在、この機能は、AEM オーサーインスタンスでのみ使用できます。
CDNConfigServiceImplCDN設定を提供
CDN書き換え機能は、com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImplの設定にCDN配布ドメイン名を指定することで有効にできます。
また、このサービスには、CDN 書き直しの有効化/無効化、CDN 書き直しが実行されるパスのプレフィックス、TTL 値、プロトコル(HTTP または HTTPS)など、その他の設定オプションも含まれます。
CDNRewriter内部 画像URLをCDN URLに書き換えるためのリライタ
com.adobe.cq.cdn.rewriter.impl.CDNRewriterのタグ属性値は、選択されたイメージリンクのみを書き換えるように定義できます。