OSGi組態設定

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

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

這樣可以輕鬆管理捆綁包，因為它們可以單獨停止、安裝和啟動。會自動處理互依性。每個OSGi元件(請參閱 OSGi規範)包含在其中一個不同套件組合中。使用AEM時，有數種方法可管理這類套件組合的組態設定；請參閱配置OSGi 以取得詳細資訊和建議的實務。

下列OSGi組態設定（根據套件組合列出）與專案實作相關。並非所有列出的設定都需要調整，有些設定可協助您了解AEM的運作方式。

注意

清單旨在作為指引，並非詳盡無遺。並非所有套件組合都列出，某些套件組合的所有參數也未列出。

所需的設定因專案而異。

請參閱Web主控台，以取得所用值和參數的詳細資訊。

注意

OSGi配置差異工具， AEM工具，可用來列出預設OSGi設定。

注意

特定功能區域在AEM中可能需要進一步的套件組合。在這些情況下，可在與適當功能相關的頁面上找到設定詳細資料。

AEM復寫事件接聽程式 配置：

此 執行模式，複製事件將分發給偵聽器。例如，如果定義為作者，則此系統將「啟動」復寫。
執行模式發佈如果專案程式碼在發佈環境中處理復寫事件（反向復寫），則需要新增。例如，當使用Dispatcher排清發佈環境，或發生標準復寫至其他發佈例項時。

AEM Repository更改偵聽器 配置：

此路徑，監聽存放庫事件以供分發的位置。

CRX Sling用戶端存放庫 配置對基礎內容儲存庫的訪問。

此 管理員密碼 安裝後應進行變更，以確保安全例項。
其他變更則不必執行，且必須謹慎處理，因為這些變更可能會影響存放庫的存取權。

Apache Felix OSGi Management Console 配置：

外掛程式，主要導覽項目（主控台外掛程式）可在 Apache Felix Web Management Console 作為頂級菜單項。停用您不需要的任何項目，因為每個項目都需要空間和資源。

注意

請務必設定下列項目：

使用者名稱 和密碼，此為存取Apache Felix Web Management Console本身的憑證。
密碼必須在初始安裝後更改，以確保安全例項。

注意

啟動時需使用Felix Console才能進行此設定，存放庫才可使用。

Apache Sling Customized Request Data Logger 配置：

記錄器名稱 和 記錄格式 設定請求和存取記錄的位置和格式(預設值： request.log)。分析與Web鏈相關的效能或調試功能時，此日誌檔案是必不可少的。

這會與Apache Sling Request Logger成對。

如需詳細資訊，請參閱 AEM記錄和 Sling記錄.

Apache Sling事件線程池 配置：

最小池大小 和 最大池大小，用於保存事件線程的池的大小。
隊列大小，如果池已用盡，則線程隊列的最大大小。

建議的值為 -1 因為這把隊列設定為「無限」；如果設定了限制，則超過限制時可能會發生損失。
變更這些設定有助於在發生大量事件的情況下執行；例如，大量使用AEM DAM或工作流程。
應使用測試來建立藍本的特定值。
這些設定可能會影響執行個體的效能，因此請勿無故變更，並給予適當考量。

Apache SlingGETServlet 設定轉譯的某些方面：

自動索引 啟用/禁用瀏覽的目錄呈現。
啟用（或停用）預設轉譯，例如 HMTL, 純文字, JSON 或 XML.

您不應停用JSON。

注意

如果您在中執行AEM，系統會自動為生產執行個體設定此設定生產就緒模式.

Apache Sling Java指令碼處理常式 配置.java檔案編譯為指令碼(servlet)的設定。

某些設定可能會影響效能，應盡可能停用這些設定，尤其是生產執行個體。

S 源VM 和 目標VM，請將JDK版本定義為執行階段JVM
針對生產執行個體：
- disable 產生除錯資訊

Apache Sling JCR安裝程式 這些參數可能不需要設定，但在開發或除錯時可能有助於了解。例如，安裝資料夾對於簽入/簽出或建立包很有用。

安裝資料夾名稱regexp 和 安裝資料夾的最大層次結構深度 — 指定在何處和到哪個深度搜索儲存庫資料夾以查找要安裝的資源。使用萬用字元時(如中。*/install)會搜尋所有適當的相符項目，例如 /libs/sling/install 和 /libs/cq/core/install.
搜尋路徑, jcrinstall會搜尋要安裝的資源的路徑清單，以及表示該路徑之加權因數的數字。

Apache Sling作業事件處理常式 配置管理作業調度的參數：

重試間隔, 最大重試次數, 最大並行作業數, 確認等待時間，其中包括。
更改這些設定可以改善大量作業的情況下的效能；例如，大量使用AEM DAM和工作流程。
應使用測試來建立藍本的特定值。
請勿無故變更這些設定，僅在適當考慮後變更。

Apache Sling JSP指令碼處理常式 為JSP指令碼處理程式配置與效能相關的設定。要提高效能，應盡可能禁用。

尤其適用於生產執行個體：

disable 產生除錯資訊
disable 保留生成的Java
disable 對應內容
disable 顯示來源片段

注意

如果您在中執行AEM，系統會自動為生產執行個體設定此設定生產就緒模式.

Apache Sling記錄設定 配置：

記錄層級 和 記錄檔，定義中央記錄設定的位置和記錄層級(error.log)。該級別可設定為 DEBUG, INFO, WARN, ERROR 和 FATAL.
日誌檔案數 和 記錄檔臨界值 定義日誌檔案的大小和版本旋轉。
訊息模式 定義日誌消息的格式。

如需詳細資訊，請參閱 AEM記錄和 Sling記錄.

Apache Sling Logging Logger Configuration(Factory Configuration) 配置：

記錄層級, 記錄檔 和 訊息格式 定義日誌檔案和消息的詳細資訊。
記錄器 定義類別；例如，僅記錄com.day.cq。
使用 工廠配置，可以新增任何數量的其他設定，以符合所需的各種記錄層級和類別。
這類設定在開發期間很有幫助；例如，在特定日誌檔案中記錄特定服務的TRACE消息。
這類設定在生產環境中很有用；例如，將特定服務的相關訊息記錄到個別記錄檔中，以便更輕鬆進行監控。

如需詳細資訊，請參閱 AEM記錄和 Sling記錄.

Apache Sling記錄撰寫器設定（工廠設定） 配置：

記錄檔 定義日誌檔案的存在。
日誌檔案數 來定義版本旋轉。
此寫入器可由 Apache Sling Logging Logger Configuration 設定。
這類設定在開發期間很有幫助；例如，在特定日誌檔案中記錄特定服務的TRACE消息。
這類設定在生產環境中很有用；例如，將特定服務的相關訊息記錄到個別記錄檔中，以便更輕鬆進行監控。

如需詳細資訊，請參閱 AEM記錄和 Sling記錄.

Apache Sling主要Servlet 配置：

每個請求的呼叫數 和 遞歸深度 以保護您的系統，避免無限遞回和過多的指令碼呼叫。

Apache Sling MIME Type Service 配置：

MIME類型 將專案所需的項目新增至系統。這可讓 GET 請求設定正確的內容類型標題，以連結檔案類型和應用程式。

Apache Sling反向連結篩選器 若要解決CRX WebDAV和Apache Sling中跨網站請求偽造(CSRF)的已知安全性問題，您需要設定反向連結篩選器。

反向連結篩選服務是OSGi服務，可讓您設定：

應篩選哪些http方法
是否允許空的反向連結標題
以及除伺服器主機外允許的伺服器清單。

請參閱安全性檢查清單 — 跨網站請求偽造問題以取得詳細資訊。

注意

Apache Sling Referrer Filter取決於快速修正套件的安裝。

Apache Sling Request Logger 配置：

定義要求記錄方式的各種參數。
啟用請求日誌，以啟用或停用。
啟用訪問日誌，以啟用或停用。

這會與Apache Sling Customid Request Data Logger配對。

如需詳細資訊，請參閱 AEM記錄和 Sling記錄.

Apache Sling Resource Resolver Factory 設定Sling資源解決的中心層面：

資源搜索路徑(s)，新增任何專案特定路徑(但不會移除 /libs 或 /apps)。
虛擬URL 定義虛名URL對應。
URL對應 定義任何別名；例如，從 /content to /.
映射位置，中外部化的映射器設定 /etc/map.
使用本機安裝(例如，使用 http://localhost:4502/system/console/jcrresolver)，以判斷哪個資源解析器作用中。

如需詳細資訊，請參閱： https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution.

注意

尤其是必須在存放庫中設定這些選項。

否則，對 URL對應 使用Felix主控台時，AEM可能會在下次啟動時覆寫。

Apache Sling Servlet/指令碼解析器和錯誤處理常式 Sling Servlet和指令碼解析器有多項工作：

它會作為 ServletResolver ，選擇要調用以處理請求的Servlet或指令碼。
其作用為 SlingScriptResolver.
它可透過實作 ErrorHandler 介面使用相同的演算法來選取錯誤處理servlet和指令碼，如同用來解析請求處理servlet和指令碼一樣。

可設定各種參數，包括：

執行路徑 列出了搜索可執行指令碼的路徑；透過設定特定路徑，您可以限制可執行的指令碼。如果未配置任何路徑，則使用預設值( / =root)，則可執行所有指令碼。

如果配置的路徑值以斜線結尾，則搜索整個子樹。若沒有這類尾隨斜線，則只有在指令碼完全相符時，才會執行指令碼。
指令碼用戶 — 此可選屬性可指定用於讀取指令碼的儲存庫用戶帳戶。如果未指定帳戶，則 admin 預設會使用使用者。
預設擴充功能 將使用預設行為的擴充功能清單。這表示資源類型的最後一個路徑區段可作為指令碼名稱使用。
定義 字型路徑 搜索項目特定字型。

例如， /apps/myapp/fonts.

Apache HTTP元件代理配置 使用Apache HTTP用戶端，在進行HTTP時使用的所有程式碼的代理設定；例如在復寫時。

建立新配置時，請勿更改工廠配置，而是使用此處提供的配置管理器為此元件建立新的工廠配置： http://localhost:4502/system/console/configMgr/. 代理配置可在 org.apache.http.proxyconfigurator。

注意

在AEM 6.0及舊版中，Proxy是在Day Commons HTTP Client中設定。自AEM 6.1和更新版本起，Proxy設定已移至「Apache HTTP元件Proxy設定」，而非「Day Commons HTTP Client」設定。

Day CQ反垃圾郵件 設定使用的反垃圾郵件服務(Akismet)。這需要您註冊：

提供者
API金鑰
註冊URL

AdobeGraniteHTML程式庫管理員 設定此項以控制用戶端程式庫（css或js）的處理；包括如何看見基礎結構。

針對生產執行個體：
- 啟用 Minify （移除CRLF和空格字元）。
- 啟用 Gzip （允許使用一個請求對檔案進行gzippe和訪問）。
- disable 除錯
- disable 計時
針對JS開發（尤其是進行除錯/除錯時）:
- disable Minify
- 啟用除錯區隔檔案以進行除錯，並與firebug搭配使用。
- 啟用計時就是對時間感興趣。
- 啟用除錯主控台，查看JS主控台記錄訊息。

注意

變更 Minify 或 Gzip 您也需要刪除clientlibs快取的內容。請參閱知識庫文章以取得詳細資訊。

注意

如果您在中執行AEM，系統會自動為生產執行個體設定此設定生產就緒模式.

Day CQ HTTP標題驗證處理常式 HTTP要求的基本驗證方法的系統範圍設定。

使用時關閉的使用者群組您可以設定（其中包括）:

HTTP領域
此 預設登入頁面

日CQ連結檢查程式服務 檢查並視需要進行設定：

排程器期間 定義要自動檢查外部連結的間隔。
檢查 鏈路容差間隔錯誤 在此期間，失敗的外部連結會被視為錯誤。
連結檢查覆蓋模式，定義要從連結檢查中排除的任何路徑。

日CQ連結檢查程式任務 配置單個連結檢查程式任務（檢查外部連結的任務）的設定：

檢查中定義的間隔 良好的連結測試間隔 和 鏈路測試間隔錯誤
檢查連結時外部訪問所需的與Internet訪問代理和NTLM相關的各種參數。

Day CQ Mail Service 配置郵件伺服器的主機名和訪問詳細資訊。請參閱設定郵件服務一節。

Day CQ MCM電子報 配置電子報使用的各種設定。

日CQ根對應 配置：

目標路徑 定義請求「 /」。

有兩個UI 可在AEM中使用：

導入觸控最佳化UI
而傳統UI仍可完全運作

使用AEM根對應，您可以設定要用來作為執行個體預設的UI:

若要將觸控最佳化UI設為預設UI，請在 目標路徑 應指向：
```
   /projects.html
```
若要將傳統UI設為預設UI，請 目標路徑 應指向：
```
   /welcome.html
```

注意

在標準安裝時，觸控最佳化UI為預設UI。

AdobeGranite SSO驗證處理常式 配置單一登錄(SSO)詳細資訊；企業作者設定中通常需要這些項目，通常與LDAP搭配使用。

提供各種配置屬性：

路徑
此身份驗證處理程式處於活動狀態的路徑。如果此參數留空，則會停用驗證處理常式。例如，路徑/會使驗證處理常式用於整個存放庫。
服務排名
OSGi Framework服務排名值用於指示用於調用此服務的順序。這是
int 值中值越高，優先順序越高。

預設值為 0.
標題名稱
可能包含使用者ID之標題的名稱。
Cookie名稱
可能包含使用者ID之Cookie的名稱。
參數名稱
可能提供使用者ID之請求參數的名稱。
使用者對應
對於選取的使用者，從HTTP要求擷取的使用者名稱可以取代為憑證物件中的不同名稱。此處定義對應。如果使用者名稱
admin 會顯示在地圖的兩側，而會忽略對應。請注意，字元"="必須以前導的""逸出。
格式
指出提供使用者ID的格式。使用:
- Basic 如果使用HTTP基本驗證格式來編碼使用者ID
- AsIs 如果使用者ID是以純文字提供，或應以原樣或任何規則運算式使用套用的值

Day CQ WCM除錯篩選器 在開發時，這個用法很有用，因為它允許在存取頁面時使用尾碼，例如？debug=layout。例如，http://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layout將提供開發人員可能感興趣的版面資訊。

在生產執行個體上停用此功能以確保效能和安全性。

Day CQ WCM篩選器 配置：

WCM模式 來定義預設模式。
在製作例項上，這可能 edit, disable,preview 或 analytics.

其他模式可從sidekick或尾碼存取 ?wcmmode=disabled 可用來模擬生產環境。
在發佈例項上，此值必須設為 disabled 以確保無法存取其他模式。

注意

如果您在中執行AEM，系統會自動為生產執行個體設定此設定生產就緒模式.

Day CQ WCM連結檢查程式設定器 配置：

重寫配置清單 ，指定基於內容的連結檢查程式配置的位置清單。配置可以基於運行模式；這對於區分製作環境和發佈環境很重要，因為linkchecker設定可能不同。

Day CQ WCM頁面處理器 配置：

路徑，系統會在觸發前監聽頁面修改的位置清單 jcr:Event.

Adobe頁面曝光次數追蹤器 針對製作例項進行設定：

sling.auth.requirements:將此屬性的值設定為 -/libs/wcm/stats/tracker

注意

此設定將允許匿名請求至追蹤服務。

注意

請參閱頁面曝光數以取得更多資訊。

Day CQ WCM頁面統計資料 發佈例項設定：

要傳送資料的URL 設定用來追蹤頁面統計資料的URL（如果追蹤器請求經過dispatcher，則此為重要）;例如，預設為 http://localhost:4502/libs/wcm/stats/tracker.
已啟用追蹤指令碼 啟用( true)或禁用( false)將追蹤指令碼納入頁面中。預設值為 false。

注意

請參閱頁面曝光數以取得更多資訊。

Day CQ WCM Version Manager 控制是否在您的系統中管理版本以及如何管理版本：

在啟動時建立版本，在標準安裝中啟用
啟用清除
清除路徑，則搜尋動作將搜尋的路徑
隱式版本設定路徑，隱式版本設定作用中的路徑。
最大版本年齡，版本的最大年齡（以天為單位）
最大數量版本，要保留的版本數上限

請參閱版本清除以取得更多資訊。

Day CQ工作流程電子郵件通知服務 配置由工作流發送通知的電子郵件設定。

CQ重寫器HTML解析器工廠

控制CQ重寫器的HTML剖析器。

要處理的其他標籤 — 您可以新增或移除要由剖析器處理的HTML標籤。依預設，會處理下列標籤：A,IMG,AREA,FORM,BASE,LINK,SCRIPT,BODY,HEAD。
保留駝峰大小寫 — 依預設，HTML剖析器會將駝峰式大小寫（例如eBay）的屬性轉換為小寫式（例如eBay）。您可以關閉此選項以保留駝峰大小寫屬性。這在使用前端架構(例如Angular2)時相當實用。

Day Commons JDBC連接池 配置對用作內容源的外部資料庫的訪問。

這是工廠配置，因此可以配置多個實例。

CDN重寫器 必須確保AEM與CDN之間的通訊，以安全的方式將資產/二進位檔傳送給使用者。這包括兩項任務：

第一次（或快取中的過期後）透過CDN從AEM存取資源。
安全地存取CDN中快取的資源，因為在CDN中快取資源後，請求就不會傳至AEM，而所有可存取該資源的使用者都應從CDN提供服務。

AEM提供重新寫入程式，可將內部資產URL重新寫入外部CDN URL。它會重寫要傳遞至CDN的連結，包括JWS簽章和過期時間，以便安全地存取資產。此功能將用於製作執行個體。

整體流程如下：

使用者向AEM驗證，並使用資產要求頁面。
請求的頁面包含類似 /content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png
重寫程式會將連結轉換為包含JWS簽名的CDN URL:

CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE
然後，使用者的瀏覽器會將資產請求轉送至CDN伺服器
CDN應已設定成將請求連同 cdn_sign 參數。
驗證處理常式會驗證 cdn_sign 參數並將資產傳回至CDN，然後再傳送給使用者