配置OSGi

注意

AEM 6.4已結束延伸支援，本檔案不再更新。如需詳細資訊，請參閱技術支援期. 尋找支援的版本此處.

OSGi 是Adobe Experience Manager(AEM)技術堆疊中的基本元素。它可用來控制AEM的複合套件組合及其設定。

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

這樣可以輕鬆管理捆綁包，因為它們可以單獨停止、安裝和啟動。會自動處理互依性。每個OSGi元件(請參閱 OSGi規範)包含在其中一個不同套件組合中。

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

使用 Adobe CQ Web主控台
使用組態檔
配置內容節點( sling:OsgiConfig)

雖然有細微差異，但可使用任一方法，主要與執行模式:

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

無論您使用何種方法，以下所有設定方法：

確保複製或複製儲存庫內容會重新建立相同的配置。
允許您將配置簽出到FileVault或Subversion;安全性或更新。
可在設定其他執行個體時儲存在套件中以供使用。
可讓您使用指令碼執行配置轉出，以傳播配置詳細資訊。

注意

某些重要設定的詳細資訊列於 OSGi組態設定。

使用Web控制台進行OSGi配置

此 Web主控台在AEM中提供用於設定套件組合的標準化介面。此設定 tab可用來設定OSGi套件組合，因此是設定AEM系統參數的基礎機制。

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

注意

在Web主控台中所做的變更會儲存在存放庫中，作為組態檔. 這些內容可以包含在內容包中，以便在進一步安裝中重複使用。

注意

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

Adobe Experience Manager有其專屬的預設值，因此預設值集可能與主控台上記錄的不同。

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

存取設定頁簽，方法是：
- 從 工具 — >操作 功能表。登入主控台後，您可以使用下拉式功能表：
  
  OSGi >
- 直接URL;例如：
  
  http://localhost:4502/system/console/configMgr
  將會顯示清單。
選擇要配置的包，方法為：
- 按一下編輯圖示
- 按一下名稱束
對話方塊將會開啟。您可以在此視需要編輯；例如，設定 記錄層級 to INFO:

注意

更新會儲存在存放庫中，如組態檔. 若要在之後找到這些識別碼，（例如納入內容套件以用於其他執行個體）您應記下永久身分( PID)。
按一下「儲存」。

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

注意

您現在可以找到配置檔案;例如，納入內容套件中以用於其他例項。

OSGi配置配置配置檔案

使用Web控制台進行的配置更改將作為配置檔案保存在儲存庫中( .config)底下：

/apps

這些內容可包含在內容套件中，並可在其他執行個體上重複使用。

注意

組態檔的格式非常具體 — 請參閱 Sling Apache檔案以取得完整詳細資訊。

因此，建議您在Web主控台中進行實際變更，以建立和維護設定檔案。

Web Console不會顯示儲存庫中已儲存變更的位置，但可輕鬆找到變更：

建立配置檔案的方法在web主控台中進行初始變更.
開啟CRXDE Lite。
在工具功能表選取 查詢…… .
提交的查詢類型 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/ to /apps/.

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

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

注意

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

將新配置添加到儲存庫

需知

若要將新配置添加到儲存庫，您需要知道以下資訊：

此 永久身份 (PID)。

參考配置欄位。此名稱會在套件名稱后面的方括弧中顯示(或 配置資訊 向下)。

例如，建立節點 com.day.cq.wcm.core.impl.VersionManagerImpl. 設定 AEM WCM Version Manager.
特定運行模式為必要項目。建立資料夾：
- config — 所有運行模式
- config.author — 適用於製作環境
- config.publish — 適用於發佈環境
- config.<run-mode> - 依需要
若設定或 工廠配置 是必要的。
要配置的單個參數；包括需要重新建立的任何現有參數定義。

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

例如，建立屬性
versionmanager.createVersionOnActivation 設定 在啟動時建立版本.
中是否已存在配置 /libs? 若要列出執行個體中的所有設定，請使用查詢工具以提交以下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 use 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/ 中所有規則的URL區段。

此規則的粒度為PID層級。
您無法在 /apps/*/config.author/ 更具體的 /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

注意

由於這些設定位於 /libs 不得直接編輯，而是複製到您的應用程式區域( /apps)。

若要列出執行個體中的所有設定節點，請使用查詢 CRXDE Lite中提交以下SQL查詢的功能：

select * from sling:OsgiConfig

配置持久性

如果您透過Web主控台變更設定，通常會寫入存放庫(位於：

/apps/{somewhere}
- 依預設 {somewhere} is 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

注意

您必須從不編輯以下資料夾或檔案：

/crx-quickstart/launchpad/config

Business.Adobe.com 資源

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

配置OSGi

使用Web控制台進行OSGi配置

OSGi配置配置配置檔案

儲存庫中的OSGi配置

將新配置添加到儲存庫

需知

在儲存庫中建立配置

配置詳細資訊

啟動時的解析順序

運行時的解析順序

解析多運行模式

標準配置

配置持久性

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe