Show Menu
主題×

OSGi配置設定

OSGi 是AEM技術層的基本元素。 它用於控制AEM的組合束及其配置。
OSGi「提​ 供標準化的基元,允許應用程式從可重複使用的小型元件和協作元件中建構。 這些元件可以構成應用程式並部署 "。
這樣可以輕鬆管理捆綁包,因為它們可以單獨停止、安裝和啟動。 互依關係會自動處理。 每個OSGi元件(請參 見OSGi規範 )都包含在各種捆綁包中。 使用AEM時,有幾種方法可管理此類組合的組態設定;如需詳 細資訊 ,請參閱設定OSGi。
下列OSGi組態設定(依照套件列出)與專案實作相關。 並非所有列出的設定都需要調整,有些設定會提及以協助您瞭解AEM的運作方式。
這份清單旨在作為一項准則,並非詳盡無遺。 並非所有束都列出,也並非某些束的所有參數都列出。
所需的設定會因專案而異。
請參閱Web主控台,以取得所用值和參數的詳細資訊。
OSGi Configuration Diff工具是 AEM Tools的一部分 ,可用來列出預設的OSGi組態。
AEM中的特定功能區域可能需要進一步的組合。 在這些情況下,可在與適當功能相關的頁面上找到配置詳細資訊。
AEM Replication Event Listener Configure:
  • 行模式 ,複製事件將分發到偵聽程式。 例如,如果定義為作者,則此系統將「啟動」複製。
  • 如果項目代 碼在發佈環境中 ,處理複製事件(反向複製),則需要添加運行模式publish。 例如,當調度程式用於從發佈環境刷新時,或當發生到其他發佈實例的標準複製時。
AEM Repository變更監聽程式 Configure:
  • 路徑 ,用於監聽儲存庫事件以便分發的位置。
CRX Sling Client Repository Configure access to the belleing content repository.
  • 裝後 ,應變更管理員密碼,以確保 例項的安全
  • 其他更改不應該是必要的,而且必須小心,因為它們可能影響對儲存庫的訪問。
Wiki郵件服務 :為Wiki發送的電子郵件配置電子郵件設定。
Apache Felix OSGi Management Console Configure:
  • 外掛程式 ,主導覽項目(主控台外掛程式)可在 ​Apache Felix Web Management Console中做為頂層功能表項目使用。 停用您不需要的任何項目,因為每個項目都需要空間和資源。
請務必設定下列項目:
使用者名 稱和密碼 ,是存取Apache Felix Web Management Console本身的認證。 在初始安裝後必須更改密碼,以確保實 例的安 全性。
啟動時,應視需要使用Felix Console進行此設定——儲存庫才可使用。
Apache Sling Customized Request Data Logger Configure:
  • Logger Name and Log Format to configure the location and format of request and access logging(default: request.log )。 在分析與Web鏈相關的效能或調試功能時,此日誌檔案是必不可少的。
    This is paired with the Apache Sling Request Logger.
如需詳細資訊,請 參閱「AEM記錄 和「Sling記錄」
Apache Sling Eventing Thread Pool Configure:
  • 最小池大小 和最 大池大小 ,用於保存事件線程的池大小。
  • 隊列大小 ,即當池用完時線程隊列的最大大小。
    建議的值是 -1 因為這會將佇列設為無限;如果設定了限制,則超出限制時可能會發生損失。
  • 變更這些設定有助於在發生大量事件的情況下提供效能;例如,大量使用AEM DAM或Workflow。
  • 應使用測試建立藍本的特定值。
  • 這些設定會影響執行個體的效能,因此請勿在沒有理由和適當考量的情況下變更執行個體。
Apache Sling GET Servlet Configure some asepts of rendering:
  • 自動索引 ,啟用/停用瀏覽的目錄轉換。
  • 啟用 (或停用)預設轉譯,例如 HMTL 、純文字 JSON ​或XML Cloud。
    您不應停用JSON。
如果您在「生產就緒模式」中執行AEM,此設定會自動設定 給生產例項
Apache Sling Java Script Handler Configure settings for the complication of .java files as scripts(servlets)。
某些設定可能會影響效能,但應盡可能停用這些設定,尤其是針對生產執行個體。
  • 源​ VM 和目標VM ,將JDK版本定義為用作運行時JVM
  • 對於生產實例:
    • 停用產 生除錯資訊
Apache Sling JCR Installer These parameters may not need configuration, but cas suable to know when developing or debugging. 例如,安裝資料夾對於簽入/簽出或建立軟體包非常有用。
  • 安裝資料夾名稱regexp 和安裝文 件夾的最大層次深度 —指定在何處和到哪個深度搜索儲存庫資料夾以查找要安裝的資源。 使用萬用字元時(如中。*/install)將搜索所有適當的匹配項,例如 /libs/sling/install /libs/cq/core/install
  • Search Path (搜索路徑),jcrinstall搜索要安裝的資源的路徑清單,以及一個表示該路徑加權系數的數字。
Apache Sling Job Event Handler Configure parameters that manage job scheduling:
  • 重試間隔 、最 大重試次數 、最大並行作業數 ​確認等待時間 ,以及其他。
  • 更改這些設定可以改進具有大量作業的場景的效能;例如,大量使用AEM DAM和工作流程。
  • 應使用測試建立藍本的特定值。
  • 請勿無故變更這些設定,但必須經過適當考慮才變更。
Apache Sling JSP指令碼處理常式 :設定JSP指令碼處理常式的效能相關設定。 為了改善效能,您應盡可能停用。
尤其是生產例項:
  • 停用產 生除錯資訊
  • 禁用保 留生成的Java
  • 停用 映射內容
  • 停用顯 示來源片段
如果您在「生產就緒模式」中執行AEM,此設定會自動設定 給生產例項
Apache Sling Logging Configuration Configure:
  • Log Level and Log File ,用於定義中央記錄配置(error.log)的位置和日誌級別。 級別可以設定為 DEBUG INFO WARN ERROR 之一 FATAL
  • 定義日誌檔案大小 和版 ​本旋轉的日誌檔案數和日誌檔案閾值。
  • 消息模式 (Message Pattern)定義日誌消息的格式。
如需詳細資訊,請 參閱「AEM記錄 和「Sling記錄」
Apache Sling Logging Logger Configuration(Factory Configuration) Configure:
  • 日誌級別 、日 志檔案和 消息格式 ​,以定義日誌檔案和消息的詳細資訊。
  • Logger to define the category;例如,僅記錄com.day.cq的記錄。
  • 通過使 用工廠配置 ,可以添加任何數量的附加配置,以適應所需的各種日誌級別和類別。
  • 這類配置在開發過程中很有幫助;例如,要在特定日誌檔案中記錄特定服務的TRACE消息。
  • 這種配置在生產環境中非常有用;例如,將有關特定服務的消息記錄到單個日誌檔案中,以便更方便地進行監視。
如需詳細資訊,請 參閱「AEM記錄 和「Sling記錄」
Apache Sling Logging Writer Configuration(Factory Configuration) Configure:
  • 日誌檔案 ,定義日誌檔案的存在性。
  • 要定義版本旋轉的日誌檔案數
  • The writer can be used by a Apache Sling Logging Logger Configuration configuration.
  • 這類配置在開發過程中很有幫助;例如,要在特定日誌檔案中記錄特定服務的TRACE消息。
  • 這種配置在生產環境中非常有用;例如,將有關特定服務的消息記錄到單個日誌檔案中,以便更方便地進行監視。
如需詳細資訊,請 參閱「AEM記錄 和「Sling記錄」
Apache Sling Main Servlet Configure:
  • 「每個請求的呼叫數 」和「 遞回深度 」,可保護您的系統不受無限遞回和過多指令碼呼叫的影響。
Apache Sling MIME Type Service Configure:
  • MIME類型 ,將項目所需的類型添加到系統中。 這允許對文 GET 件發出請求,以設定用於連結檔案類型和應用程式的正確內容類型標題。
Apache Sling Referrer Filter (Apache Sling反向連結篩選):若要解決CRX WebDAV和Apache Sling中跨網站要求偽造(CSRF)的已知安全性問題,您必須設定反向連結篩選。
反向連結篩選服務是一項OSGi服務,可讓您設定:
  • 哪些http方法應加以篩選
  • 是否允許空的反向連結標題
  • 以及除伺服器主機外還允許的伺服器的白名單。
Apache Sling Referrer Filter取決於快速修正套件的安裝。
Apache Sling Request Logger Configure:
  • 定義請求記錄方式的各種參數。
  • 啟用請求記錄 ,以啟用或停用。
  • 啟用訪問日誌 ,以啟用或禁用。
This is paired with the Apache Sling Customized Request Data Logger.
如需詳細資訊,請 參閱「AEM記錄 和「Sling記錄」
Apache Sling Resource Resolver Factory Configure central insects of Sling resource resolution:
  • 資源搜索路徑 ,添加任何項目特定路徑(但不刪除或 /libs /apps 刪除)。
  • 虛擬URL ,以定義虛名的URL對應。
  • URL映射 ,用於定義任何別名;例如,從 /content /
  • 映射位置 ,中外部化的映射器配置 /etc/map
  • 使用本地安裝(例如,使用 http://localhost:4502/system/console/jcrresolver )確定哪個資源解析程式處於活動狀態。
特別是,必須在儲存庫中配置這些選項。
否則,AEM可能會在下次 啟動時覆寫使用Felix主控台對「 URL對應」所做的變更。
Apache Sling Servlet/Script Resolver和錯誤處理常式 The Sling Servlet和Script Resolver有多項工作:
  1. 它用作選擇 ServletResolver 要調用的Servlet或指令碼以處理請求。
  2. 它起著作用 SlingScriptResolver
  3. 它使用與用於解決請求處理 ErrorHandler servlet和指令碼相同的算法來實施介面,以便選擇錯誤處理servlet和指令碼,從而管理錯誤處理。
可設定各種參數,包括:
  • 執行路徑 (Execution Paths)列出搜索可執行指令碼的路徑;通過配置特定路徑,您可以限制可以執行的指令碼。 如果未配置路徑,則使用預設路徑( / = root),則允許執行所有指令碼。
    如果已配置的路徑值以斜線結尾,則搜索整個子樹。 若沒有這樣的尾隨斜線,則只有在指令碼完全符合時才會執行它。
  • 指令碼用戶 -此可選屬性可以指定用於讀取指令碼的儲存庫用戶帳戶。 如果未指定帳戶,則 admin 預設會使用使用者。
  • Default Extensions (預設擴展)將使用預設行為的擴展的清單。 這表示資源類型的最後一個路徑段可用作指令碼名稱。
Day Commons GFX Font Helper —— 在轉換圖形時,您可以使用DrawText來內嵌文字。 為此,您也可以安裝您自己的字型:
  • 定義要 搜尋的字型路徑 ,以尋找專案特定的字型。
    For example, /apps/myapp/fonts .
Apache HTTP Components Proxy Configuration (Apache HTTP Client的Apache HTTP用戶端的所有程式碼的Proxy設定),用於建立HTTP時;例如,在複製時。
建立新配置時,請勿更改工廠配置,而是使用此處提供的配置管理器為此元件建立新工廠配置: http://localhost:4502/system/console/configMgr/ 。 proxy設定可在 org.apache.http.proxyconfigurator中使用。
在AEM 6.0及舊版中,Proxy是在Day Commons HTTP Client中設定。 自AEM 6.1和更新版本起,Proxy設定已移至「Apache HTTP Components Proxy Configuration」,而非「Day Commons HTTP Client」設定。
Day CQ Antispam Configure the anti-spam service(Akismet)used. 您必須註冊:
  • 提供者
  • API金鑰
  • 註冊的URL
Adobe Granite HTML Library Manager Configure this to control handling of client libraries(css或js);例如,包括如何看待基礎結構。
  • 對於生產實例:
    • 啟用 Minify (以移除CRLF和空白字元)。
    • 用Gzip (允許使用一個請求對檔案進行壓縮和訪問)。
    • 停用除
    • 停用計
  • 針對JS開發(尤其是當防火牆/除錯時):
    • 禁用微
    • 啟用 Debug ,將檔案分開以進行除錯,並與firebug搭配使用。
    • 用計時 (如果對計時感興趣)。
    • 啟用 Debug console可查看JS主控台記錄訊息。
當變更 Minify Gzip的設定時,您也需要刪除 /var/clientlibs 。 這是clientlibs的快取版本,將在下次要求時重建。
如果您在「生產就緒模式」中執行AEM,此設定會自動設定 給生產例項
Day CQ HTTP Header Authentication Handler (日CQ HTTP標頭驗證處理常式)HTTP請求基本驗證方法的系統寬設定。
使用關閉 的使用者群組 ,您可以設定(其中包括):
  • HTTP領域
  • 預設 登錄頁
Day CQ Link Checker Service Check and if neced configure:
  • 排程器期間 ,定義自動檢查外部連結的間隔。
  • 檢查 不成功的外部連結在其後被視為錯誤的期間 ,鏈路允差間隔錯誤。
  • 「連結檢查覆寫模式 」,以定義任何要排除在連結檢查之外的路徑。
Day CQ Link Checker Task Configure settings for a single link checker task(day CQ Link Checker Task)(Task thicks an external link):
  • 檢查「良好鏈路測試間 隔」和「不良鏈路測試間隔 中定義的間隔
  • 檢查連結時,外部訪問所需的與Internet訪問代理和NTLM相關的各種參數。
Day CQ Mail Service Configure hostname and access details for the mail server. 請參閱「配置郵件服務」部分。
Day CQ MCM Newsletter Configure the vicion settings used with the newsletter.
日CQ根映射配置 :
  • 定位路徑 ,以定義「 / 」請求將重新導向至的位置。
AEM中 有兩個 UI可用:
  • 已推出觸控最佳化的UI
  • 而且傳統UI仍可完全運作
使用「AEM根對應」,您可以設定您要擁有的UI做為例項的預設值:
  • 若要讓觸控最佳化UI做為預設UI, Target路徑應指向 :
       /projects.html
    
    
  • 若要將傳統UI設為預設UI, Target路徑應指向 :
       /welcome.html
    
    
標準安裝時,觸控最佳化UI為預設UI。
Adobe Granite SSO驗證處理常式 :設定單一登入(SSO)詳細資訊;在企業作者設定中通常需要這些功能,通常與LDAP搭配使用。
可使用各種配置屬性:
  • Path ​此驗證處理常式作用中的路徑。 如果此參數留空,驗證處理常式會停用。 例如,路徑/會使驗證處理常式用於整個資料庫。
  • 服務排名 OSGi框架服務排名值用於指示調用此服務所用的順序。 這是一個值, int 其中值越高,表示優先順序越高。
    預設值為 0 .
  • 標題名 ​稱可能包含使用者ID的標題名稱。
  • Cookie名稱 ​可能包含使用者ID的Cookie名稱。
  • 參數名 ​稱可能提供使用者ID之請求參數的名稱。
  • 用戶圖 ​對於選定用戶,從HTTP請求提取的用戶名可以替換為憑據對象中的不同用戶名。 此處定義了映射。 如果使用者名 admin 稱出現在地圖的任一側,則會忽略對應。 請注意,字元"="必須以前導"\"逸出。
  • 格式 ​表示提供用戶ID的格式。 使用:
    • Basic 如果使用者ID編碼為HTTP基本驗證格式
    • AsIs 如果使用者ID是以純文字提供,或任何規則運算式套用值應以原樣使用或任何規則運算式
Day CQ WCM Debug Filter (日CQ WCM除錯篩選器)這在開發時很有用,因為它允許在存取頁面時使用字尾,例如?debug=layout。 例如,http://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layout將提供開發人員可能感興趣的版面資訊。
  • 在生產實例上禁用此功能,以確保效能和安全性。
Day CQ WCM Filter Configure:
  • WCM模式 ,以定義預設模式。
  • 在作者例項中,這可能是 edit , disable,preview analytics
    其他模式可從sidekick存取,或者字尾 ?wcmmode=disabled 可用來模擬生產環境。
  • 在發佈例項上,此值必須設定為 disabled 以確保無法存取其他模式。
如果您在「生產就緒模式」中執行AEM,此設定會自動設定 給生產例項
第CQ天WCM連結檢查器配置器 配置:
  • 重寫配置清單 ,以指定基於內容的連結檢查器配置的位置清單。 配置可以基於運行模式;這對於區分作者和發佈環境很重要,因為連結檢查器設定可能不同。
第CQ WCM頁面處理器配置 :
  • 路徑 ,即系統在觸發頁面之前監聽頁面修改的位置清單 jcr:Event
Adobe頁面印象追蹤 :針對作者例項設定:
  • sling.auth.requirements :將此屬性的值設定為 -/libs/wcm/stats/tracker
此設定將允許追蹤服務的匿名要求。
如需詳 細資訊 ,請參閱頁面印象。
Day CQ WCM Page Statistics For a publish instance configure:
  • 傳送資料的URL ,以設定用來追蹤頁面統計資料的URL(如果追蹤器要求經過發送器,此URL至關重要);例如,預設值為 http://localhost:4502/libs/wcm/stats/tracker
  • 追蹤指令碼 ,可啟用( true )或停用( false )頁面上包含追蹤指令碼。 預設值為 false
如需詳 細資訊 ,請參閱頁面印象。
Day CQ WCM Version Manager Control if and how, versions are managed in your system:
  • 在啟動時建立版本 ,在標準安裝中啟用
  • 啟用清除
  • 清除路徑 ,即搜索操作將搜索的路徑
  • 隱式版本化路徑 ,即隱式版本化處於活動狀態的路徑。
  • 最大版本年齡 ,版本的最大年齡(以天為單位)
  • 最大版本數 ,要保留的最大版本數
如需詳 細資訊 ,請參閱版本清除。
Day CQ Workflow Email Notification Service (日CQ工作流程電子郵件通知服務)為工作流程傳送的通知設定電子郵件設定。
Day CQSE HTTP Service Control the CQ Servlet Engine:
  • NIO for HTTP ,是否使用NIO for HTTP。 預設為true。 僅在啟用HTTP時使用。
  • 連線逾時 ,連線逾時(以毫秒為單位)。 此屬性同時適用於HTTP和HTTPS連接。 預設為60秒。
  • 啟用HTTPS ,是否啟用HTTPS。 預設為false。
  • Session Timeout , Default lifetime of an HTTP session specified in minutes. 如果逾時為0或更少,則作業不會逾時。 預設為10分鐘。
  • 除錯記錄 ,是否要寫入DEBUG級別消息。 預設為false。
  • 請求緩衝區大小 ,請求的緩衝區大小(以位元組為單位)。 預設值為8KB。
  • 最大線程數 ,用於處理請求的線程數。 預設值為200。
以下屬性僅在啟用HTTPS時適用。
  • HTTPS Port ,監聽HTTPS要求的埠。 預設為 433.
  • NIO for HTTPS ,是否使用NIO for HTTP。 預設為NIO for HTTP屬性的值。
  • 密鑰 ​庫,用於HTTPS的密鑰庫的絕對路徑。 若已啟用HTTPS,則此為必要項目。
  • 密鑰庫密碼 ,用於訪問密鑰庫的密碼。
  • 密鑰別名 ,密鑰庫中密鑰的別名。
  • 密鑰密碼 ,用於解鎖密鑰庫中的密鑰的密碼。
  • 用戶端憑證 ,用戶端提供有效憑證的要求。 預設為無。
另請參 閱啟用HTTP Over SSL ,以取得有關SSL相關選項的詳細資訊,以及如何為CQSE啟用HTTPS的完整說明。
CQ重寫器HTML剖析器工廠
控制CQ重寫器的HTML剖析器。
  • 要處理的附加標籤 -您可以添加或刪除要由解析器處理的HTML標籤。 依預設,會處理下列標籤:A,IMG,AREA,FORM,BASE,LINK,SCRIPT,BODY,HEAD。
  • 保留駝峰大小寫 -依預設,HTML剖析器會將駝峰大小寫的屬性(例如eBay)轉換為小寫(例如ebay)。 您可以關閉此選項以保留駝峰大小寫屬性。 當使用Angular 2等前向框架時,這很有用。
Day Commons JDBC連接池 :配置對用作內容源的外部資料庫的訪問。
這是工廠配置,因此可以配置多個實例。
Adobe CQ Media DPS Sessions Service Manage DPS Sessions for use with Publications。
您尤其可以定義 dps.session.service.url.name :預設值設為 https://dpsapi2.digitalpublishing.acrobat.com/webservices/sessions
必須確保AEM與CDN之間的CDN Rewriter Communication,以便以安全的方式將資產/二進位檔傳送給使用者。 這包括兩項任務:
  • 第一次(或在快取中過期後)透過CDN存取AEM中的資源。
  • 安全地存取在CDN中快取的資源,因為一旦在CDN中快取資源,請求就不會前往AEM,而所有可存取該資源的使用者都應從CDN提供服務。
AEM提供重寫器,可將內部資產URL重寫至外部CDN URL。 它會重寫要傳遞至CDN的連結,包括JWS簽章和過期時間,以便安全地存取資產。 此功能將用於作者實例。
總體流程如下:
  1. 使用者向AEM驗證,並請求含有資產的頁面。
  2. 請求的頁面包含類似 /content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png
  3. 重新寫入器會轉換包含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
  4. 然後,使用者的瀏覽器會將資產要求轉送至CDN伺服器
  5. CDN應設定為將請求與參數一起轉送至 cdn_sign AEM。
  6. 驗證處理常式會驗 cdn_sign 證參數並傳回資產至CDN,然後再傳送給使用者
使用者瀏覽器、CDN和AEM之間的流量可視化如下。
此功能目前僅針對AEM作者例項啟用。
CDNConfigServiceImpl 提供CDN組態
在com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImpl的組態中提供 CDN散發網域名稱 ,可啟用CDN重寫功能。
此服務也包含其他設定選項,例如啟用/停用CDN重寫、執行CDN重寫的路徑字首、TTL值和通訊協定(HTTP或HTTPS)。
CDNRewriter A rewriter,用於將內部影像URL重寫至CDN URL
可定 義com.adobe.cq.cdn.rewriter.impl.CDNRewriter中的「標籤屬性 」值,以便僅重寫選擇性影像連結。