OSGi の設定 configuring-osgi
OSGi は、Adobe Experience Manager(AEM)の技術スタックにおける基本要素です。AEM の複合バンドルおよびそれらの設定を制御するために使用します。
OSGi は「標準化されたプリミティブを提供し、小さく再利用が可能で連携機能に優れたコンポーネントを組み合わせてアプリケーションを構築することを可能にします。これらのコンポーネントからアプリケーションを作成し、デプロイすることができます」。
これにより、バンドルの管理が容易になり、バンドルの停止、インストール、開始を個別に実行できます。相互依存関係は自動的に処理されます。各 OSGi コンポーネント ( OSGi の仕様を参照) は、様々なバンドルの 1 つに含まれています。
これらのバンドルの設定は、次のいずれかの方法で管理できます。
いずれの方法も使用できますが、主に実行モードに関連する、次のようなわずかな違いがあります。
-
-
Web コンソールは OSGi 設定の標準インターフェイスです。様々なプロパティを編集するための UI が提供されており、事前に定義されているリストから設定可能な値を選択できます。
そのため、最も簡単に使用できます。
-
Web コンソールで行われた設定は、現在のインスタンスにすぐに適用されます。現在の実行モードや、今後の実行モードの変更には関係ありません。
-
-
- Web コンソールで定義される設定を含みます。
- 他のインスタンスで使用できるよう、コンテンツパッケージに含めることができます。
-
リポジトリ内のコンテンツノード(sling:osgiConfig)
- CRXDE Lite を使用した手動による設定が必要です。
sling:OsgiConfig
ノードの命名規則により、設定を特定の実行モードに関連付けることができます。同じリポジトリに複数の実行モードの設定を保存することもできます。- 適切な設定がすぐに適用されます(実行モードに依存)。
使用するメソッドに関わらず、次のことが可能です。
- リポジトリのコンテンツをコピーまたはレプリケートすることにより、同一の設定を再作成できます。
- セキュリティや追加の更新のために、FileVault または Subversion に設定をチェックアウトできます。
- パッケージとして保存し、他のインスタンスを設定する際に使用できます。
- スクリプトを使用して設定の詳細を反映させることにより、設定のロールアウトを実行できます。
Web コンソールでの OSGi 設定 osgi-configuration-with-the-web-console
AEM の web コンソールには、バンドルを設定するための標準化されたインターフェイスが搭載されています。「設定」タブは、OSGi バンドルの設定に使用します。AEM システムパラメーターを設定するための基盤となるメカニズムです。
行った変更は、関連する OSGi 設定にすぐに適用されます。再起動の必要はありません。
Web コンソールで設定を更新するには:
-
次のいずれかの方法で、web コンソールの「設定」タブにアクセスします。
-
ツール/操作 メニューのリンクから web コンソールを開きます。コンソールにログインしたら、次のドロップダウンメニューを使用できます。
OSGi >
-
ダイレクト URL 例:
http://localhost:4502/system/console/configMgr
リストが表示されます。
-
-
次のいずれかの方法で、設定するバンドルを選択します。
- 該当するバンドルの「編集」アイコンをクリック
- 該当するバンドルの 名前 をクリック
-
ダイアログボックスが表示されます。必要に応じて、ここで編集できます。 例えば、以下のように ログレベル を
INFO
に設定します。note note NOTE 更新内容は、設定ファイルとしてリポジトリ内に保存されます。コンテンツパッケージに含めて別のインスタンスで使用する場合など、後で必要になったときにこれらのファイルを探し出せるように、永続 ID( PID
)をメモしておく必要があります。 -
「保存」をクリックします。
変更内容は、実行しているシステムの関連する OSGi 設定にすぐに適用されます。再起動は不要です。
note note NOTE これで、関連する設定ファイルを探し出せるようになりました。例えば、コンテンツパッケージに含めて別のインスタンスで使用する場合に役立ちます。
設定ファイルでの OSGi 設定 osgi-configuration-with-configuration-files
Web コンソールで行った設定変更は、設定ファイル(.config
)としてリポジトリ内の次の場所に保存されます。
/apps
これらの設定ファイルをコンテンツパッケージに含めて、他のインスタンスで再利用することができます。
- Apache Sling Provisioning Model と Apache SlingStart に関する詳細。
- Sling でのリソースとプロパティの取得に関するチュートリアルと例。
Web コンソールには、リポジトリのどの場所に変更が保存されたかは表示されませんが、次の手順で簡単に見つけることができます。
-
Web コンソールで最初の変更を行うことで、設定ファイルを作成します。
-
CRXDE Lite を開きます。
-
ツール メニューの「クエリ」を選択します。
-
更新した設定の PID を検索するには、タイプ が
SQL
のクエリを送信します。例えば、Apache Felix OSGi マネージメントコンソール の永続 ID(PID)は次のとおりです。
org.apache.felix.webconsole.internal.servlet.OsgiManager
よって、SQL クエリは次のようになります。
code language-shell select * from nt:base where jcr:path like '/apps/%' and contains(*, 'org.apache.felix.webconsole.internal.servlet.OsgiManager')
-
設定ファイルのノードが表示されます。
上の例では、次のようになります。
/apps/system/config/org.apache.felix.webconsole.internal.servlet.OsgiManager.config
note caution CAUTION このファイルを開くと、変更内容を確認できます。ただし、タイプミスを防ぐために、実際の変更はコンソールで行うことをお勧めします。 -
このノードを含むコンテンツパッケージをビルドしておくと、必要に応じて他のインスタンスで使用できます。
リポジトリでの OSGi 設定 osgi-configuration-in-the-repository
Web コンソールを使用するほかに、リポジトリで設定の詳細を定義することもできます。これにより、様々な実行モードを簡単に設定できます。
これらの設定は、システムが参照するリポジトリ内の sling:OsgiConfig
ノードを作成することによって行います。これらのノードは OSGi 設定を反映し、OSGi 設定に対するユーザーインターフェイスが形成されます。設定データを更新するには、ノードのプロパティを更新します。
リポジトリ内の設定データを変更すると、関連する OSGi 設定に変更が直ちに適用されます。この際、web コンソールで変更した場合と同様に、適切な検証と整合性チェックが行われます。このワークフローは、設定を /libs/
から /apps/
へコピーするアクションの場合にも適用されます。
同じ設定パラメーターが複数の場所に配置されるので、システムでは次の処理が行われます。
- タイプが
sling:OsgiConfig
のすべてのノードを検索 - サービス名に従ってフィルター処理
- 実行モードに従ってフィルター処理
リポジトリへの新しい設定の追加 adding-a-new-configuration-to-the-repository
必要な知識 what-you-need-to-know
設定をリポジトリに追加するには、以下を知っておく必要があります。
-
サービスの 永続 ID(PID)。
Web コンソールの「設定 」フィールドを参照します。この名前は、バンドル名の後に括弧でくくって(またはページの下部に向かって 設定情報 に)表示されます。
例えば、
com.day.cq.wcm.core.impl.VersionManagerImpl.
ノードを作成して、AEM WCM バージョンマネージャー を設定します。 -
特定の実行モードが必要かどうか。フォルダーを作成:
config
- すべての実行モード用config.author
- オーサー環境用config.publish
- パブリッシュ環境用config.<run-mode>
- 適宜
-
設定 または ファクトリ設定 が必要かどうか。
-
設定する個々のパラメーター。再作成が必要な既存のパラメーター定義を含めます。
Web コンソールの個々のパラメーターフィールドを参照します。名前は、各パラメーターに対して角括弧で囲まれて表示されます。
例えば、プロパティを作成します。
versionmanager.createVersionOnActivation
で アクティベーション時にバージョンを作成 を設定します。 -
/libs
に設定が存在するかどうか。インスタンスに含まれるすべての設定をリストするには、CRXDE Lite の クエリ ツールを使用して、次の SQL クエリを送信します。select * from sling:OsgiConfig
その場合は、この設定を
/apps/<yourProject>/
にコピーすると、新しい場所にカスタマイズされます。
リポジトリでの設定の作成 creating-the-configuration-in-the-repository
新しい設定をリポジトリに実際に追加するには、次の手順を実行します。
-
CRXDE Lite を使用して次の場所に移動します。
/apps/<yourProject>
-
存在しない場合は、
config
フォルダー(sling:Folder
)を作成します。config
- すべての実行モードに該当config.<run-mode>
- 特定の実行モードに固有
-
このフォルダーの下に、次の設定でノードを作成します。
-
タイプ:
sling:OsgiConfig
-
名前:永続 ID(PID)
例えば、AEM WCM Version Manager の場合は
com.day.cq.wcm.core.impl.VersionManagerImpl
を使用します
note note NOTE ファクトリ設定を作成する場合は、 -<identifier>
を名前に付加します。例: org.apache.sling.commons.log.LogManager.factory.config-<identifier>
<identifier>
の部分は、インスタンスを識別するフリーテキストに置き換えます(この情報は省略できません)。次に例を示します。org.apache.sling.commons.log.LogManager.factory.config-MINE
-
-
設定するパラメーターごとに、このノードでプロパティを作成します。
- 名前:Web コンソールに表示される名前。名前は、フィールドの説明の最後に角括弧で囲んで表示されます。例:
Create Version on Activation
ではversionmanager.createVersionOnActivation
を使用 - タイプ:適宜。
- 値:必要に応じて。
プロパティを作成する必要があるのは、設定対象のパラメーターのみです。その他のプロパティは AEM で設定されているデフォルト値を引き続き使用します。
- 名前:Web コンソールに表示される名前。名前は、フィールドの説明の最後に角括弧で囲んで表示されます。例:
-
すべての変更を保存します。
変更は、サービスを再起動することによってノードが更新されるとすぐに適用されます(web コンソールで行った変更と同様)。
/libs
パス内は一切変更しないでください。設定の詳細 configuration-details
起動時の優先順位 resolution-order-at-startup
次の優先順位が使用されます。
-
/apps/*/config...
の下のリポジトリノード。タイプsling:OsgiConfig
またはプロパティファイル。 -
/libs/*/config...
の下にある、タイプsling:OsgiConfig
のリポジトリノード。(標準定義) -
<*cq-installation-dir*>/crx-quickstart/launchpad/config/...
からの任意の.config
ファイル。ローカルファイルシステム上。
/libs
内の汎用設定は、/apps
内のプロジェクト固有の設定によってマスクできます。
実行時の優先順位 resolution-order-at-runtime
システム実行中に設定変更を行うと、変更後の設定で再読み込みが開始されます。
その後、次の優先順位が適用されます。
- Web コンソールでの設定変更が、実行時に優先されるので、すぐに有効になります。
/apps
での設定変更がすぐに有効になります。/apps
で設定によってマスクされない限り、/libs
での設定変更は直ちに有効になります。
複数の実行モードの解決 resolution-of-multiple-run-modes
実行モード固有の設定では、複数の実行モードを組み合わせることができます。例えば、次のスタイルで設定フォルダーを作成できます。
/apps/*/config.<runmode1>.<runmode2>/
このようなフォルダー内の設定は、すべての実行モードが起動時に定義されている実行モードと一致した場合に適用されます。
例えば、インスタンスが実行モード author,dev,emea
で起動された場合は、/apps/*/config.emea
、/apps/*/config.author.dev/
、/apps/*/config.author.emea.dev/
の設定ノードが適用され、/apps/*/config.author.asean/
と /config/author.dev.emea.noldap/
の設定ノードは適用されません。
同じ PID に複数の設定が該当する場合は、一致する実行モードの数が最も大きい設定が適用されます。
例えば、インスタンスが実行モード author,dev,emea
で起動され、/apps/*/config.author/
と /apps/*/config.emea.author/
の両方で com.day.cq.wcm.core.impl.VersionManagerImpl
の設定が定義されている場合は、/apps/*/config.emea.author/
の設定が適用されます。
このルールの精度は PID レベルです。
つまり、/apps/*/config.author/
で同じ PID の一部のプロパティと、/apps/*/config.emea.author/
で同じ PID のより具体的なプロパティを定義することはできません。
一致する実行モードの数が最も多い設定は、PID 全体で有効です。
標準設定 standard-configurations
次のリストは、リポジトリで(標準インストールで)使用できる設定の一部を示しています。
-
作成者 - AEM WCM フィルター:
libs/wcm/core/config.author/com.day.cq.wcm.core.WCMRequestFilter
-
公開 - AEM WCM フィルター:
libs/wcm/core/config.publish/com.day.cq.wcm.core.WCMRequestFilter
-
公開 - AEM WCM ページ統計:
libs/wcm/core/config.publish/com.day.cq.wcm.core.stats.PageViewStatistics
/libs
内にあるので、直接編集はせず、アプリケーション領域(/apps
)にコピーしてからカスタマイズしてください。インスタンスに含まれるすべての設定ノードをリストするには、CRXDE Lite の クエリ 機能を使用して、次の SQL クエリを送信します。
select * from sling:OsgiConfig
設定の永続性 configuration-persistence
-
Web コンソールを使用して設定を変更した場合、(通常は)リポジトリの次の場所に書き込まれます。
/apps/{somewhere}
-
デフォルトでは、
{somewhere}
はsystem/config
なので、設定は次の場所に書き込まれます。/apps/system/config
-
ただし、最初にリポジトリ内の別の場所から取得した設定を編集する場合は、次のようにします。例:
/libs/foo/config/someconfig
その後、更新された設定が元の場所に書き込まれます。例:
/apps/foo/config/someconfig
-
-
admin
によって変更された設定は、次の場所の下の*.config
ファイルに保存されます。code language-none /crx-quickstart/launchpad/config
-
この領域には、OSGi 設定管理者の非公開データがあり、システムへの入力方法に関係なく、
admin
で指定されたすべての設定の詳細が保持されています。 -
この領域は実装の詳細であり、ユーザーがこのディレクトリを直接編集することはできません。
-
ただし、これらの設定ファイルの場所を把握しておくと、バックアップ、複数のインストール、またはその両方を目的としてコピーを作成する際に役立ちます。
-
Apache Felix OSGi Management Console
../crx/org/apache/felix/webconsole/internal/servlet/OsgiManager.config
-
CRX Sling クライアントリポジトリ
../com/day/crx/sling/client/impl/CRXSlingClientRepository/<pid-nr>.config
-
-
/crx-quickstart/launchpad/config