配置OSGi

OSGi 是Adobe Experience Manager(AEM)技術堆疊中的基本元素。它用於控制AEM的組合束及其配置。

OSGi「提供標準化的基元，允許應用程式從可重複使用的小型元件和協作元件中建構。這些元件可以構成應用程式並部署"。

這樣可以輕鬆管理捆綁包，因為它們可以單獨停止、安裝和啟動。互依關係會自動處理。每個OSGi元件(請參見OSGi規範)都包含在各種捆綁包中。

您可以透過以下任一方式管理此類組合的組態設定：

使用 Adobe CQ Web主控台
使用配置檔案
在儲存庫中配置內 sling:OsgiConfig容節點()

雖然有細微差異，但這兩種方法都可使用，主要與執行模式有關:

Adobe CQ Web Console
- Web控制台是OSGi配置的標準介面。它提供編輯各種屬性的UI，可從預先定義的清單中選擇可能的值。
  
  因此，它是最簡單的使用方法。
- 使用Web控制台進行的任何配置都會立即應用並適用於當前實例，而不考慮當前運行模式或對運行模式的任何後續更改。
配置檔案
- 包含Web主控台中定義的設定。
- 可包含在內容套件中，以用於其他例項。
content-nodes(sling:osgiConfig) in the repository
- 這需要使用CRXDE Lite進行手動配置。
- 由於節點的命名約 sling:OsgiConfig 定，您可以將配置關聯到特定運行模式。您甚至可以在同一儲存庫中保存多個運行模式的配置。
- 任何適當的組態都會立即套用（視執行模式而定）。

無論您使用哪種方法，所有這些配置方法：

確保複製或複製儲存庫內容會重新建立相同的配置。
允許您將配置檢出到FileVault或Subversion; 安全性或更新。
可以保存在包中，以便在設定其他實例時使用。
允許您使用指令碼來傳播配置詳細資訊，以執行配置推展。

注意

某些重要設定的詳細資訊會列在「 OSGi組態設定」下。

使用Web控制台進行OSGi配置

AEM中的Web主控台，提供了用於設定套件的標準化介面。「 Configuration 」（設定）標籤可用來設定OSGi叢集，因此是設定AEM系統參數的基礎機制。

所做的任何更改都會立即應用於相關的OSGi配置，無需重新啟動。

注意

在Web控制台中所做的更改將保存在儲存庫中，作為配置檔案。這些內容可包含在內容套件中，以便在進一步安裝中重複使用。

注意

在Web主控台上，任何提及預設設定的說明都與Sling預設值相關。

Adobe Experience Manager有自己的預設值，因此預設值設定可能與主控台上記載的預設值不同。

要使用Web控制台更新配置，請執行以下操作：

通過以 下任一方 ，訪問Web控制台的「配置」頁籤：
- 從「工具->操作」菜單上的鏈 接開啟Web控制台 。登入主控台後，您可使用下列功能表：
  
  OSGi >
- 直接網址；例如：
  
  http://localhost:4502/system/console/configMgr
  將會顯示清單。
選擇要通過以下任一方法配置的包：
- 按一下該包 的「編輯 」表徵圖
- 按一下包的名稱
對話方塊將會開啟。您可在此視需要編輯；例如，將「日誌級別」設定為 INFO:

注意

更新將保存在儲存庫中作為配置檔案。若要在之後找到這些項目（例如，要包含在內容套件中以便用於另一個例項），您應記下永久性身分( PID)。
按一下「儲存」。

您的更改會立即應用於正在運行的系統的相關OSGi配置，無需重新啟動。

注意

您現在可以找到相關的配置檔案; 例如，要包含在內容套件中，以便用於另一個例項。

OSGi配置與配置檔案

使用Web Console進行的配置更改將作為配置檔案( .config)保存在儲存庫中，位於：

/apps

這些內容可包含在內容封裝中，並可在其他例項上重複使用。

注意

設定檔的格式非常特定——請參閱 Sling Apache檔案，以取得完整詳細資訊。

因此，建議在Web控制台中進行實際更改，以建立和維護配置檔案。

Web Console不顯示已保存更改的儲存庫中的位置，但可以輕鬆找到這些更改：

在Web控制台中進行初始更改以建立配置檔案。
開啟CRXDE Lite。
在「工具」菜單中，選 擇「查詢……」 .
提交 Type 查詢 SQL ，以搜索已更新的配置的PID。

例如， Apache Felix OSGi Management Console 具有下列的永久性識別(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')
```
將顯示配置檔案節點。

對於上述範例：

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

注意

您可以開啟此檔案以檢視您所做的變更，但為避免輸入錯誤，建議您使用主控台進行實際變更。
您現在可以建立包含此節點的內容套件，並視需要在其他執行個體上使用。

儲存庫中的OSGi配置

除了使用Web控制台外，您還可以在儲存庫中定義配置詳細資訊。這可讓您輕鬆設定不同的執行模式。

這些配置是通過在儲存庫中 sling:OsgiConfig 建立節點來進行的，供系統參考。這些節點將鏡像OSGi配置，並對其形成用戶介面。要更新配置資料，請更新節點屬性。

如果修改儲存庫中的配置資料，則更改將立即應用到相關的OSGi配置，就像更改是使用Web控制台進行的一樣，並執行相應的驗證和一致性檢查。這也適用於將配置從複製到的操 /libs/ 作 /apps/。

由於相同的配置參數可以位於多個位置，因此系統：

搜索所有類型的節點 sling:OsgiConfig
根據服務名稱進行篩選
根據運行模式進行篩選

注意

另請閱讀如何僅定義特定實例的基於儲存庫的配置。

向儲存庫添加新配置

您需要知道的

要向儲存庫添加新配置，您需要瞭解以下內容：

服 務的永續性 (PID)。

參考Web 控制台 (Web console)中的「配置」(Configurations)欄位。名稱會在包名稱后面的方括弧中顯示(或在頁面底部的 Configuration Information （配置資訊）中)。

例如，建立節點以 com.day.cq.wcm.core.impl.VersionManagerImpl. 設定 AEM WCM版本管理器。
是否需要特定的運行模式。建立資料夾：
- config -所有運行模式
- config.author -適用於作者環境
- config.publish -適用於發佈環境
- config.<run-mode> -適當
是否需 要配置還是工廠配置 。
要配置的單個參數；包括需要重新建立的任何現有參數定義。

參考Web控制台中的個別參數欄位。每個參數的名稱以方括弧顯示。

例如，建立屬性
versionmanager.createVersionOnActivation 在啟動 時設定Create Version。
中是否存在配置 /libs? 要列出實例中的所有配置，請使用CRXDE Lite中的 Query tool提交以下SQL查詢：

select * from sling:OsgiConfig

如果是，則可將此配置複製到， /apps/<yourProject>/然後在新位置中自定義。

在儲存庫中建立配置

要將新配置實際添加到儲存庫，請執行以下操作：

使用CRXDE Lite導覽至：

/apps/<yourProject>
如果尚未存在，請建立 config 資料夾( sling:Folder):
- config -適用於所有運行模式
- config.<run-mode> -特定於特定運行模式
在此資料夾下建立一個節點：
- 類型: sling:OsgiConfig
- 名稱：持久性身份(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
對於要配置的每個參數，請在此節點上建立一個屬性：
- 名稱：參數名稱，如Web控制台所示；名稱會在欄位說明結尾的方括弧中顯示。例如，若 Create Version on Activation 使用 versionmanager.createVersionOnActivation
- 類型：視情況而定。
- 值：視需要。
您只需要為要設定的參數建立屬性，其他人仍會採用AEM設定的預設值。
儲存所有變更。

當節點更新時，會立即重新啟動服務（如Web控制台中所做的變更）。

注意

您不得變更路徑中的任 /libs 何項目。

注意

配置的完整路徑必須正確，才能在啟動時讀取。

配置詳細資訊

啟動時的解析順序

使用下列優先順序：

儲存庫節 /apps/*/config...點位於。下，具有類 sling:OsgiConfig 型或屬性檔案。
類型在下的儲存庫 sling:OsgiConfig 節點 /libs/*/config...。（現成可用的定義）。
任何 .config 來自的文 <*cq-installation-dir*>/crx-quickstart/launchpad/config/...件。在本機檔案系統上。

這表示中的通用配置可 /libs 以由中的項目特定配置進行掩碼 /apps。

執行時期的解析順序

在系統運行時所做的配置更改會觸發重新載入並使用修改的配置。

接著，應按下列優先順序：

在Web控制台中修改配置將立即生效，因為它在運行時優先。
在中修改配 /apps 置將立即生效。
在中修改配 /libs 置將立即生效，除非它被中的配置遮住 /apps。

多種執行模式的解析度

對於運行模式特定的配置，可以組合多種運行模式。例如，您可以建立以下樣式的配置資料夾：

/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層級。
您不能在中為相同PID定義某些屬性，在中 /apps/*/config.author/ 為相同PID定義更 /apps/*/config.emea.author/ 多特定屬性。
對於整個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

注意

由於這些組態位於 /libs 其中，因此不得直接編輯，而是在自訂前複製至您的應用程 /apps式區域()。

要列出實例中的所有配置節點，請使用CRXDE Lite中的 Query （查詢）功能提交以下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 Client Repository
    
    ../com/day/crx/sling/client/impl/CRXSlingClientRepository/<pid-nr>.config

注意

您絕對不能 :

/crx-quickstart/launchpad/config

adobe.com 上的資源

Content Insights Personalized Communications Embedded Charts Dynamic Forms Content Management Content Management System