OSGi の設定

OSGi は、Adobe Experience Manager（AEM）の技術スタックにおける基本要素です。AEM の複合バンドルおよびそれらの設定を制御するために使用します。

OSGi は標準化されたプリミティブを提供し、小さく再利用が可能で連携機能に優れたコンポーネントを組み合わせてアプリケーションを構築することを可能にします。これらのコンポーネントからアプリケーションを作成し、デプロイすることができます​。

これにより、 バンドルの管理が容易になり、バンドルを個別に停止、インストール、開始できます。相互依存関係は自動的に処理されます。各 OSGi コンポーネント ( OSGi の仕様を参照) は、様々なバンドルの 1 つに含まれています。

これらのバンドルの設定は、次のいずれかの方法で管理できます。

• Adobe CQ Web コンソールを使用
• 設定ファイルを使用
• リポジトリ内のコンテンツノード（sling:OsgiConfig）を設定

いずれの方法も使用できますが、主に実行モードに関連する、次のようなわずかな違いがあります。

• Adobe CQ Web コンソール

  • Web コンソールは OSGi 設定の標準インターフェイスです。様々なプロパティを編集するための UI が提供されており、事前に定義されているリストから設定可能な値を選択できます。

    そのため、最も簡単に使用できます。

  • Web コンソールで行われた設定は、現在のインスタンスにすぐに適用されます。現在の実行モードや、今後の実行モードの変更には関係ありません。

• 設定ファイル

  • Web コンソールで定義される設定を含みます。
  • 他のインスタンスで使用できるよう、コンテンツパッケージに含めることができます。

• リポジトリ内のコンテンツノード（sling:osgiConfig）

  • CRXDE Lite を使用した手動による設定が必要です。
  • sling:OsgiConfig ノードの命名規則により、設定を特定の実行モードに関連付けることができます。同じリポジトリに複数の実行モードの設定を保存することもできます。
  • 適切な設定がすぐに適用されます（実行モードに依存）。

使用するメソッドに関わらず、次のことが可能です。

• リポジトリのコンテンツをコピーまたはレプリケートすることにより、同一の設定を再作成できます。
• セキュリティやさらなる更新のために、FileVault または Subversion に設定をチェックアウトできます。
• パッケージとして保存し、他のインスタンスを設定する際に使用できます。
• スクリプトを使用して設定の詳細を反映させることにより、設定のロールアウトを実行できます。

Web コンソールでの OSGi 設定

AEM の Web コンソールは、バンドルを設定するための標準化されたインターフェイスを提供します。「設定」タブは、OSGi バンドルの設定時に使用します。AEM システムパラメーターを設定するための基盤となるメカニズムです。

おこなった変更は、関連する OSGi 設定にすぐに適用されます。再起動の必要はありません。

Web コンソールで設定を更新するには：

1. 次のいずれかの方法で、Web コンソールの「設定」タブにアクセスします。

   • ツール／運営​メニューのリンクから Web コンソールを開きます。コンソールにログインしたら、次のドロップダウンメニューを使用できます。

     OSGi >

   • ダイレクト URL 例：

     http://localhost:4502/system/console/configMgr
     リストが表示されます。

2. 次のいずれかの方法で、設定するバンドルを選択します。

   • 該当するバンドルの「編集」アイコンをクリック
   • 該当するバンドルの「名前」をクリック

3. ダイアログが開きます。必要に応じて編集します。例えば「ログレベル」を INFO に設定します。

   

   メモ

   更新内容は、設定ファイルとしてリポジトリ内に保存されます。後で必要になったときに探し出せるようにするために（コンテンツパッケージに含めて別のインスタンスで使用できるようにする場合など）、永続 ID（PID）をメモしておく必要があります。

4. 「保存」をクリックします。

   変更内容は、実行しているシステムの関連する OSGi 設定にすぐに適用されます。再起動は不要です。

   メモ

   これで関連する設定ファイルを見つけられるようになります。例えば、コンテンツパッケージに含めて別のインスタンスで使用できるようにする場合などがあります。

設定ファイルでの OSGi 設定

Web コンソールで行った設定変更は、設定ファイル（.config）としてリポジトリ内の次の場所に保存されます。

/apps

これらの設定ファイルをコンテンツパッケージに含めて、他のインスタンスで再利用することができます。

Web コンソールには、リポジトリのどの場所に変更が保存されたかは表示されませんが、次の手順で簡単に見つけることができます。

1. Web コンソールで最初の変更をおこなうことで、設定ファイルを作成します。

2. CRXDE Lite を開きます。

3. ツール​メニューの「クエリー」を選択します。

4. タイプ​が SQL のクエリーを送信して、更新した設定の PID を検索します。

   例えば、Apache Felix OSGi マネージメントコンソール​の永続 ID（PID）は次のとおりです。

   org.apache.felix.webconsole.internal.servlet.OsgiManager

   よって、SQL クエリーは次のようになります。

   select * from nt:base where jcr:path like '/apps/%' and contains(*, 'org.apache.felix.webconsole.internal.servlet.OsgiManager')
   

5. 設定ファイルのノードが表示されます。

   上の例では、次のようになります。

   /apps/system/config/org.apache.felix.webconsole.internal.servlet.OsgiManager.config

   注意

   このファイルを開くと、変更内容を確認できます。ただし、タイプミスを防ぐために、実際の変更はコンソールでおこなうことをお勧めします。

6. このノードを含むコンテンツパッケージをビルドしておくと、必要に応じて他のインスタンスで使用できます。

リポジトリでの OSGi 設定

Web コンソールを使用するほかに、リポジトリで設定の詳細を定義することもできます。これにより、様々な実行モードを簡単に設定できます。

これらの設定は、システムが参照するリポジトリ内の sling:OsgiConfig ノードを作成することによって行います。これらのノードは OSGi 設定を反映し、OSGi 設定に対するユーザーインターフェイスを形成します。設定データを更新するには、ノードのプロパティを更新します。

リポジトリ内の設定データを変更すると、Web コンソールで変更した場合と同様に、適切な検証と整合性チェックが行われ、関連する OSGi 設定に変更が直ちに適用されます。これは、設定を /libs/ から /apps/ へコピーするアクションの場合も当てはまります。

同じ設定パラメーターを複数の場所に配置できるので、システムでは次の処理が行われます。

• タイプが sling:OsgiConfig のすべてのノードを検索
• サービス名に従ってフィルター処理
• 実行モードに従ってフィルター処理

リポジトリへの新しい設定の追加

必要な知識

新しい設定をリポジトリに追加するには、以下を知っておく必要があります。

1. サービスの 永続 ID（PID）。

   Web コンソールの「設定 」フィールドを参照します。この名前は、バンドル名の後に括弧でくくって（またはページの下部に向かって​設定情報​に）表示されます。

   例えば、com.day.cq.wcm.core.impl.VersionManagerImpl. ノードを作成して、AEM WCM バージョンマネージャー​を設定します。

   

2. 特定の実行モードが必要かどうか。次のようにフォルダーを作成します。

   • config - すべての実行モード用
   • config.author - オーサー環境用
   • config.publish - パブリッシュ環境用
   • config.<run-mode> - 適宜

3. 設定​または​ファクトリ設定​が必要かどうか。

4. 設定する個々のパラメーター。再作成が必要な既存のパラメーター定義を含めます。

   Web コンソールの個々のパラメーターフィールドを参照します。 名前は、各パラメーターに対して角括弧で囲まれて表示されます。

   例えば、プロパティを作成します。
   versionmanager.createVersionOnActivation で アクティベーション時にバージョンを作成​を設定します。

   

5. /libs に既に設定が存在しますか？インスタンス内のすべての設定をリストするには、CRXDELite の​クエリ​ツールを使用して、次の SQL クエリを送信します。

   select * from sling:OsgiConfig

   その場合は、この設定を /apps/<yourProject>/ にコピーすると、新しい場所にカスタマイズされます。

リポジトリでの設定の作成

新しい設定をリポジトリに実際に追加するには：

1. CRXDE Lite を使用して次の場所に移動します。

   /apps/<yourProject>

2. 存在しない場合は、config フォルダーを作成します（sling:Folder）。

   • config - すべての実行モードに該当
   • config.<run-mode> - 特定の実行モードに固有

3. このフォルダーの下に、次の設定でノードを作成します。

   • タイプ：sling:OsgiConfig

   • 名前：永続 ID（PID）

     例えば、AEM WCM Version Manager の場合は com.day.cq.wcm.core.impl.VersionManagerImpl を使用します

   メモ

   ファクトリ設定を作成する場合は、-<identifier> を名前に付加します。

   例： org.apache.sling.commons.log.LogManager.factory.config-<identifier>

   <identifier> の部分は、インスタンスを識別するフリーテキストに置き換えます（この情報は省略できません）。次に例を示します。

   org.apache.sling.commons.log.LogManager.factory.config-MINE

4. 設定するパラメーターごとに、このノードでプロパティを作成します。

   • 名前：Web コンソールに表示される名前。名前は、フィールドの説明の最後に角括弧で囲んで表示されます。例： Create Version on Activation では versionmanager.createVersionOnActivation を使用
   • タイプ：適宜。
   • 値：必要に応じて。

   プロパティを作成する必要があるのは、設定対象のパラメーターのみです。その他は、AEM で設定されているデフォルト値を引き続き使用します。

5. すべての変更を保存します。

   変更は、サービスを再起動することによってノードが更新されるとすぐに適用されます（Web コンソールでおこなった変更と同様）。

設定の詳細

起動時の優先順位

次の優先順位を使用します。

1. /apps/*/config... の下のリポジトリノード。タイプ sling:OsgiConfig またはプロパティファイル。

2. /libs/*/config... の下にある、タイプ sling:OsgiConfig のリポジトリノード。（標準定義）

3. <*cq-installation-dir*>/crx-quickstart/launchpad/config/... からの任意の .config ファイル。ローカルファイルシステム上。

これは、/libs 内の汎用設定は、/apps 内のプロジェクト固有の設定によってマスクできるということを意味します。

実行時の優先順位

システム実行中に設定変更をおこなうと、変更後の設定で再読み込みが開始されます。

その後、次の優先順位が適用されます。

1. Web コンソールでの設定変更が、実行時に優先されるので、すぐに有効になります。
2. /apps での設定変更がすぐに有効になります。
3. /apps で設定によってマスクされない限り、/libs での設定変更がすぐに有効になります。

複数の実行モードの解決

実行モードに固有の設定に関しては、複数の実行モードを組み合わせることができます。例えば、設定フォルダーを次のスタイルで作成できます。

/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 全体に対して効果的です。

標準設定

以下のリストは、リポジトリで使用できる（標準インストールの）設定の一部を示しています。

• 作成者 - 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

インスタンスに含まれるすべての設定ノードをリストするには、CRXDE Lite の​クエリ​機能を使用して、次の SQL クエリを送信します。

select * from sling:OsgiConfig

設定の永続性

• Web コンソールを使用して設定を変更した場合、（通常は）リポジトリの次の場所に書き込まれます。

  /apps/{somewhere}

  • デフォルトでは、{somewhere} は system/config なので、設定は次の場所に書き込まれます。

    /apps/system/config

  • ただし、最初にリポジトリ内の別の場所から取得した設定を編集する場合は、次のようにします。例：

    /libs/foo/config/someconfig

    その後、更新された設定が元の場所に書き込まれます。例：

    /apps/foo/config/someconfig

• admin によって変更された設定は、次の場所の下の *.config ファイルに保存されます。

     /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