OSGi 是Adobe Experience Manager(AEM)技術堆疊中的基本元素。 它可用來控制AEM的複合套件組合及其設定。
OSGi "提供標準化基元,允許從小型、可重複使用和協作的元件構建應用程式。 這些元件可組成應用程式並部署」。
這樣可以輕鬆管理捆綁包,因為它們可以單獨停止、安裝和啟動。 會自動處理互依性。 每個OSGi元件(請參閱 OSGi規範)包含在其中一個不同套件組合中。
您可以透過以下任一方式管理此類套件組合的組態設定:
sling:OsgiConfig
)雖然有細微差異,但可使用任一方法,主要與 執行模式:
Web控制台是OSGi配置的標準介面。 它提供用於編輯各種屬性的UI,可從預先定義的清單中選取可能的值。
因此,這是最簡單的使用方法。
使用Web控制台進行的任何配置都立即應用並適用於當前實例,而不考慮當前運行模式,也不考慮後續對運行模式的任何更改。
存放庫中的content-nodes(sling:osgiConfig)
sling:OsgiConfig
節點,您可以將設定連結至特定 運行模式. 您甚至可以在同一儲存庫中保存多個運行模式的配置。無論您使用何種方法,以下所有設定方法:
某些重要設定的詳細資訊列於 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配置,無需重新啟動。
您現在可以找到 配置檔案;例如,納入內容套件中以用於其他例項。
使用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
您可以開啟此檔案以檢視您的變更,但為避免輸入錯誤,建議您使用主控台進行實際變更。
您現在可以建立包含此節點的內容套件,並視需要在其他執行個體上使用。
除了使用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
針對您要設定的每個參數,在此節點上建立屬性:
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
.
在系統運行時所做的配置更改會觸發重新載入,並使用已修改的配置。
然後,應用以下優先順序:
/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