JMX Console可讓您監控和管理CRX伺服器上的服務。 以下各節概述了通過JMX框架公開的屬性和操作。
有關如何使用控制台控制項的資訊,請參見使用JMX控制台。 有關JMX的背景資訊,請參見Oracle網站上的Java管理擴展(JMX)技術頁。
有關使用JMX控制台建立MBean以管理服務的資訊,請參見將服務與JMX控制台整合。
管理運行、完成、過時和失敗的工作流實例的操作。
有關其他工作流管理工具和可能的工作流實例狀態的說明,請參閱工作流控制台。
listRunningWorkflowsPerModel列出每個工作流模型正在運行的工作流實例數。
listCompletedWorkflowsPerModel列出每個工作流模型的已完成工作流實例數。
returnWorkflowQueueInfoLists有關已處理且已排入處理佇列的工作流程項目的資訊。
引數:nown
傳回值:包含下列欄的表格資料:
returnWorkflowJobTopicInfo 列出按主題組織的工作流作業的處理資訊。
引數:nown
傳回值:包含下列欄的表格資料:
returnFailedWorkflowCount 顯示失敗的工作流實例數。您可以指定工作流模型來查詢或檢索所有工作流模型的資訊。
引數:
模型:要查詢的模型ID。 要查看所有工作流模型的失敗工作流實例計數,請不指定任何值。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:失敗的工作流程例項數。
returnFailedWorkflowCountPerModel顯示每個工作流模型失敗的工作流實例數。
terminateFailedInstances 終止失敗的工作流實例。您可以終止所有失敗實例,或僅終止特定模型的失敗實例。 (可選)您可以在終止實例後重新啟動實例。 您也可以測試操作,以查看結果,而不實際執行操作。
引數:
重新啟動實例:(可選)指定true
值,以在實例終止後重新啟動。 預設值false
導致終止的工作流實例不會重新啟動。
乾跑:(可選)指定true
值,以查看操作結果,而不實際執行操作。 預設值false
將導致執行操作。
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的失敗實例的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:關於終止的實例的表資料,包含以下列:
retryFailedWorkItems 嘗試執行失敗的工作項目步驟。您可以重試所有失敗的工作項目,或僅針對特定工作流模型重試失敗的工作項目。 您可以選擇測試工序以查看結果,而不實際執行工序。
引數:
乾跑:(可選)指定true
值,以查看操作結果,而不實際執行操作。 預設值false
將導致執行操作。
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的失敗工作項目的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:重試失敗工作項目的表格資料,包括下列:
PurgeActiveRemoves active特定年齡的活動工作流實例。您可以清除所有模型的活動實例,或僅清除特定模型的實例。 您可以選擇性地測試工序以查看結果,而無需實際執行工序。
引數:
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的工作流實例的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
工作流程開始後的天數:要清除的工作流實例的年齡(以天為單位)。
乾跑:(可選)指定true
值,以查看操作結果,而不實際執行操作。 預設值false
將導致執行操作。
傳回值:有關已清除的活動工作流實例的表格式資料,包括以下列:
countStaleWorkflows 傳回過時的工作流程例項數。您可以檢索所有工作流模型或特定模型的過時實例數。
引數:
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的工作流實例的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:過時的工作流程例項數。
重新啟 動過時工作流程重新啟動過時的工作流程例項。您可以重新啟動所有過時實例,或僅重新啟動特定模型的過時實例。 您也可以測試操作,以查看結果,而不實際執行操作。
引數:
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的過時實例的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
乾跑:(可選)指定true
值,以查看操作結果,而不實際執行操作。 預設值false
將導致執行操作。
傳回值:已重新啟動的工作流實例清單。
fetchModelList 列出所有工作流模型。
countRunningWorkflows 傳回正在執行的工作流程例項數。您可以檢索所有工作流模型或特定模型的運行實例數。
引數:
型號:(可選)傳回執行中例項數的模型ID。 指定不要模型,以傳回所有工作流程模型的執行中例項數。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:正在運行的工作流實例數。
countCompletedWorkflows 傳回已完成的工作流程例項數。您可以檢索所有工作流模型或特定模型的已完成實例數。
引數:
型號:(可選)傳回完成例項數的模型ID。 指定不要模型,以傳回所有工作流程模型的已完成例項數。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
傳回值:已完成的工作流實例數。
purgeCompleted 從儲存庫中刪除特定年齡的已完成工作流的記錄。定期使用此操作,在您大量使用工作流時最大限度地減少儲存庫的大小。 您可以清除所有模型的已完成實例,或僅清除特定模型的實例。 您可以選擇性地測試工序以查看結果,而無需實際執行工序。
引數:
型號:(可選)應用操作的模型的ID。 指定不要將操作應用於所有工作流模型的工作流實例的模型。 ID是指向模型節點的路徑,例如:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
工作流程完成後的天數:工作流實例已處於完成狀態的天數。
乾跑:(可選)指定true
值,以查看操作結果,而不實際執行操作。 預設值false
將導致執行操作。
傳回值:有關已清除的已完成工作流實例的表格式資料,包括以下列:
有關CRX儲存庫的資訊
名 稱JCR儲存庫實施的名稱。唯讀.
版 本儲存庫實施版本。唯讀.
主 目錄儲存庫所在的目錄。預設位置為<QuickStart_Jar_Location>/crx-quickstart/repository。 唯讀.
CustomerName 軟體許可證發放給的客戶的名稱。唯讀.
LicenseKey 此儲存庫安裝的唯一許可證密鑰。唯讀.
AvailableDiskSpace 儲存庫的此實例可用的磁碟空間(以兆位元組為單位)。唯讀.
MaximumNumberOfOpenFiles一次可開啟的檔案數。 唯讀.
SessionTrackercrx.debug.sessions系統變數的值。true表示調試會話。 false表示正常作業。 讀/寫。
描 述符表示儲存庫屬性的一組鍵值對。所有屬性都是唯讀的。
關鍵 | 值 |
---|---|
option.node.and.property.with.same.name.supported | 指示節點和節點的屬性是否可以具有相同的名稱。 true表示支援相同的名稱,false表示不支援。 |
identifier.stability | 指示不可引用節點標識符的穩定性。 可以使用下列值:
|
query.xpath.pos.index | 指示是否支援JCR 1.0 XPath查詢語言。 true表示支援,false表示不支援。 |
crx.repository.systemid | 在system.id檔案中找到的系統識別碼。 |
option.query.sql.supported | 指示是否支援JCR 1.0 XPath查詢語言。 true表示支援,false表示不支援。 |
jcr.repository.version | 儲存庫實施的版本。 |
option.update.primary.node.type.supported | 指示是否可以更改節點的主節點類型。 true表示可以更改主節點類型,false表示不支援更改。 |
option.node.type.management.supported | 指示是否支援節點類型管理。 true表示支援,false表示不支援。 |
node.type.management.overrides.supported | 指示可以覆蓋節點類型的繼承屬性還是子節點定義。 true表示支援覆寫,false表示無覆寫。 |
option.observation.supported | true表示支援對儲存庫更改進行非同步觀察。 非同步觀察的支援可讓應用程式在每次變更發生時,接收並回覆通知。 |
query.jcrscore | true表示jcr:score偽屬性可用於包含jcrfn:contains(在XPath中)或CONTAINS(在SQL中)函式的XPath和SQL查詢,以執行全文搜索。 |
option.simple.versioning.supported | true表示儲存庫支援簡單的版本控制。 使用簡單的版本控制,儲存庫會維護節點的一系列連續版本。 |
option.workspace.management.supported | true表示儲存庫支援使用API建立和刪除工作區。 |
option.update.mixin.node.types.supported | true表示儲存庫支援添加和刪除現有節點的混合節點類型。 |
node.type.management.primary.item.name.supported | true表示儲存庫使節點定義能夠將主項作為子項包含。 使用API可存取主要項目,而不需知道項目名稱。 |
level.2.supported | true表示LEVEL_1_SUPPORTED和OPTION_XML_IMPORT_SUPPORTED都為true。 |
write.supported | true表示儲存庫使用API提供寫訪問。 false表示唯讀存取。 |
node.type.management.update.in.use.supported | true表示您可以更改現有節點正在使用的節點定義。 |
jcr.specification.version | 儲存庫實施的JCR規範版本。 |
option.journaled.observation.supported | true表示應用程式可以執行儲存庫的日誌觀察。 通過記錄的觀察,可以獲得一組特定時間段的更改通知。 |
query.languages | 儲存庫支援的查詢語言。 無值表示沒有查詢支援。 |
option.xml.export.supported | true表示儲存庫支援將節點導出為XML代碼。 |
node.type.management.multiple.binary.properties.supported | true表示儲存庫支援註冊具有多個二進位屬性的節點類型。 false表示節點類型支援單一二進位屬性。 |
option.access.control.supported | true表示儲存庫支援訪問控制,用於設定和確定節點訪問的用戶權限。 |
option.baselines.supported | true表示儲存庫同時支援配置和基線。 |
option.shareable.nodes.supported | true表示儲存庫支援建立可共用節點。 |
crx.cluster.id | 儲存庫群集的標識符。 |
query.stored.queries.supported | true表示儲存庫支援儲存查詢。 |
query.full.text.search.supported | true表示儲存庫支援全文搜索。 |
node.type.management.inheritance | 指示對節點類型繼承的儲存庫支援級別。 可以使用下列值: node.type.management.inheritance.minimal:主節點類型的註冊僅限於僅具有nt:base作為超類型的節點類型。 混合節點類型的配準被限制為沒有超類型的。 node.type.management.inheritance.single:主節點類型的註冊限於具有一個超級類型的節點類型。 混合節點類型的配準被限制為具有最多一個超類型的節點類型。
|
crx.cluster.preferredMaster | true表示此群集節點是群集的首選主節點。 |
option.transactions.supported | true表示儲存庫支援事務。 |
jcr.repository.vendor.url | 儲存庫供應商的URL。 |
node.type.management.value.constraints.supported | true表示儲存庫支援節點屬性的值約束。 |
node.type.management.property.types | javax.jcr.PropertyType常數的陣列,這些常數表示註冊節點類型可以指定的屬性類型。 零長陣列表示註冊的節點類型不能指定屬性定義。 屬性類型包括STRING、URI、BOOLEAN、LONG、DOUBLE、DECIMAL、BINARY、DATE、NAME、PATH、WEAKREFERENCE、REFERENCE和UNDEFINED(如果支援) |
node.type.management.orderable.child.nodes.supported | true表示儲存庫支援保存子節點的順序。 |
jcr.repository.vendor | 儲存庫供應商的名稱。 |
query.joins | 查詢中連接的支援級別。 可以使用下列值:
|
org.apache.jackrabbit.spi.commons.AdditionalEventInfo | |
query.xpath.doc.order | true表示儲存庫支援XPath 1.0查詢語言。 |
query.jcrpath | |
option.xml.import.supported | true表示儲存庫支援將XML代碼導入為內容。 |
node.type.management.same.name.siblings.supported | true表示儲存庫支援具有相同名稱的同級節點(具有相同父代的節點)。 |
node.type.management.residual.definitions.supported | true表示儲存庫支援具有剩餘定義的名稱屬性。 支援時,項目定義的名稱屬性可以是星號("*")。 |
node.type.management.autocreated.definitions.supported | true表示儲存庫支援在建立節點時自動建立節點的子項(節點或屬性)。 |
crx.cluster.master | true表示此儲存庫節點是群集的主節點。 |
level.1.supported | true表示option.xml.export.support為true,query.languages為非零長度。 |
option.unfiled.content.supported | true表示儲存庫支援未歸檔的內容。 未歸檔節點不屬於儲存庫層次結構。 |
jcr.specification.name | 儲存庫實施的JCR規範的名稱。 |
option.versioning.supported | true表示儲存庫支援完整的版本控制。 |
jcr.repository.name | 儲存庫的名稱。 |
option.locking.supported | true表示儲存庫支援節點鎖定。 鎖定使用戶能夠暫時防止其他用戶進行更改。 |
jcr.repository.version.display | |
option.activities.supported | true表示儲存庫支援活動。 活動是一組在合併到另一個工作區的工作區中執行的更改。 |
node.type.management.multivalued.properties.supported | true表示儲存庫支援的節點屬性可以具有零或多個值。 |
option.retention.supported | true表示儲存庫支援使用外部保留管理應用程式將保留策略應用於內容,並支援暫掛和釋放。 |
option.lifecycle.supported | true表示儲存庫支援生命週期管理。 |
工 作區名稱儲存庫中工作區的名稱。唯讀.
DataStoreGarbageCollectionDelay 廢棄項目收集在掃描每十個節點後休眠的時間(以毫秒為單位)。讀/寫。
BackupDelay 備份過程在備份的每個步驟之間休眠的時間(以毫秒為單位)。讀/寫。
BackupInProgressA值為true表示正在執行備份進程。唯讀.
BackupProgress對於當前備份,是已備份的所有檔案的百分比。唯讀.
CurrentBackupTarget 對於當前備份,儲存備份檔案的ZIP檔案。當備份未進行時,不會顯示任何值。 唯讀.
BackupWasSuccessfulA值為true表示當前備份期間未發生錯誤,或者未進行備份。false表示當前備份期間發生錯誤。 唯讀.
BackupResult 當前備份的狀態。可以使用下列值:
唯讀.
TarOptimizationRunningSince目前TAR檔案最佳化程式開始的時間。 唯讀.
TarOptimizationDelay TAR最佳化程式在每個流程步驟之間停留的時間(以毫秒為單位)。讀/寫。
ClusterProperties 一組代表群集屬性和值的鍵值對。表中的每一行都表示群集屬性。 唯讀.
ClusterNodes 儲存庫群集的成員。
ClusterId 此儲存庫群集的標識符。唯讀.
ClusterMasterId 此儲存庫群集的主節點的標識符。唯讀.
ClusterNodeId 儲存庫群集的此節點的標識符。唯讀.
創 建工作區在此儲存庫中建立工作區。
引數:
傳回值:nown
runDataStoreGarbageCollection 在儲存庫節點上執行廢棄項目收集。
引數:
傳回值:nown
stopDataStoreGarbageCollection 停止執行中的資料儲存廢棄項目收集。
啟動 備份備份ZIP檔案中的儲存庫資料。
引數:
target
:(可選)一 String
個值,它表示要存檔儲存庫資料的ZIP檔案或目錄的名稱。若要使用ZIP檔案,請加入ZIP檔案副檔名。 要使用目錄,請不包括檔案副檔名。
要執行增量備份,請指定以前用於備份的目錄。
您可以指定絕對路徑或相對路徑。 相對路徑相對於crx-quickstart目錄的父目錄。
當您未指定值時,會使用預設值backup-currentdate.zip
,其中currentdate
的格式為yyyyMMdd-HHmm
。
傳回值:nown
取 消備份停止當前備份進程並刪除為存檔資料而建立的臨時存檔。
blockRepositoryWritesBlocks對儲存庫資料的更改。所有儲存庫備份偵聽程式都會收到該塊的通知。
取消 阻止儲存庫寫入從儲存庫中刪除塊。所有儲存庫備份偵聽程式都會收到刪除塊的通知。
startTarOptimization使用tarOptimizationDelay的預設值啟動TAR檔案優化過程。
stopTarOptimization 停止TAR檔案最佳化。
tarIndexMerge 合併所有TAR集的頂部索引檔案。頂級索引檔案是具有不同主要版本的檔案。 例如,以下檔案將合併到檔案index_3_1.tar中:index_1_1.tar、index_2_0.tar、index_3_0.tar。 已合併的檔案將被刪除(在上例中,將刪除index_1_1.tar、index_2_0.tar和index_3_0.tar)。
引數:
background
:一個布爾值,指示是否在後台運行操作,以便在執行期間使用Web控制台。值true在後台運行操作。傳回值:nown
bemeClusterMaster將此儲存庫節點設定為群集的主節點。如果尚未是主實例,則此命令將停止當前主實例的偵聽器,並在當前節點上啟動主實例的偵聽器。 然後,此節點將設定為主節點並重新啟動,導致群集中的所有其他節點(即由主節點控制的節點)連接到此實例。
joinCluster 將此儲存庫作為由群集主節點控制的節點添加到群集中。您必須提供使用者名稱和密碼才能進行驗證。 連接使用基本驗證。 安全憑證在傳送至伺服器之前,先經過Base-64編碼。
引數:
master
:一個字串值,它代表運行主資料庫節點的電腦的IP地址或電腦名。username
:用於向群集驗證的名稱。password
:用於驗證的密碼。傳回值:nown
traversalCheckTraverses和(可選)修正從特定節點開始的子樹中的不一致。這在持久性管理器文檔中有詳細說明。
consistencyCheckChecks 並選擇性地修正資料儲存區中的一致性。Datastore上的文檔將對此進行詳細介紹。
org.apache.jackrabbit.api.stats.RepositoryStatistics
定義的每個統計類型的「時間系列」欄位的值。
網域: com.adobe.granite
類型: TimeSeries
名稱:org.apache.jackrabbit.api.stats.RepositoryStatistics.Type
Enum類中的下列值之一:
為報告的每個統計類型提供以下屬性:
關於儲存庫查詢的統計資訊。
SlowQuerys 有關已花費最長時間完成的儲存庫查詢的資訊。唯讀.
SlowQuerysQueueSize 要包含在SlowQuerys清單中的查詢數上限。讀寫。
PopularQueries 最常發生的儲存庫查詢的相關資訊。唯讀.
PopularQueriesQueueSize PopularQueries清單中的查詢數上限。讀寫。
clearSlowQuerysQueueRemovesSlowQuerys清單中的所有查詢。
clearPopularQueriesQueueRemovesPopularQuerys清單中的所有查詢。
監視每個複製代理的服務。 建立複製代理時,該服務會自動出現在JMX控制台中。
Id代表複製代理配置標識符的字串值。多個代理可以使用相同的配置。 唯讀.
ValidA布林值,指出代理是否已正確設定:
true
:有效的配置。false
:配置包含錯誤。唯讀.
Enabled 一個布爾值,指示是否啟用代理:
true
: 已啟用.false
: 停用.QueueBlockedA 布林值,指出佇列是否存在且已封鎖:
true
: 已封鎖. 自動重試擱置中。false
:未阻止或不存在。唯讀.
QueuePaused 指示作業佇列是否暫停的布林值:
true
:暫停(暫停)false
:未暫停或不存在。讀寫。
QueueNumEntries 表示代理隊列中作業數的int值。唯讀.
QueueStatusTimeA日期值,它指出獲取顯示狀態值時伺服器上的時間。 值與載入頁面的時間相對應。 唯讀.
QueueNextRetryTime 對於被阻止的隊列,是一個日期值,它指示下次自動重試的時間。未顯示任何時間時,不會阻止隊列。 唯讀.
QueueProcessingSinceA指出當前作業開始處理的日期值。 當沒有出現時間時,佇列會被封鎖或閒置。 唯讀.
QueueLastProcessTimeA 指出上一個作業何時完成的日期值。唯讀.
queueForceRetry 對於被阻止的隊列,向隊列發出retry命令。
queueClear 從隊列中刪除所有作業。
提供有關HTTP請求的統計資料,以便您監控SlingRequestProcessor服務的效能。
RequestsCount 自上次重設統計資料以來發生的請求數。
MinRequestDurationMsec自上次重設統計資料以來,處理請求所需的最短時間(以毫秒為單位)。
MaxRequestDuratioMsec自上次重設統計資料以來,處理請求所需的最長時間(以毫秒為單位)。
StandardDevationDurationMsec處理請求所需時間量的標準差。 自上次重設統計資料起,標準差會使用所有請求來計算。
MeanRequestDurationMsec 處理請求所需的平均時間量。平均值是使用統計資料上次重設後的所有請求計算
resetStatistics 將所有統計資料設為零。在您需要分析特定時段內的請求處理效能時,重設統計資料。
有關包管理器包含的所有包的資訊。
有關啟動過程和快速啟動啟動程式的資訊。
日誌
在「快速啟動」窗口中顯示一條消息。
引數:
String
值。 下圖顯示調用p1值this is a log message
的log
的結果。startupFinished
調用伺服器啟動器的startupFinished方法。 方法會嘗試在網頁瀏覽器中開啟「歡迎」頁面。
startupProgress
設定伺服器啟動進程的完成值。 「快速啟動」(QuickStart)窗口上的進度條表示完成值。
引數:
傳回值:沒有。
數個協力廠商伺服器資源會安裝MBeans,將屬性和作業公開至JMX主控台。 下表列出協力廠商資源,並提供更多資訊的連結。
網域 | 類型 | MBean類 |
---|---|---|
JMI實施 | MBeanServerDelegate | javax.management.MBeanServerDelegate |
com.sun.management | HotSpotDiagnostic | com.sun.management.HotSpotDiagnosticMXBean |
java.lang |
|
javax. managementpackage |
java.util.logging | java.util.logging.LoggingMXBean | |
osgi.core |
|
org.osgi.jmx. frameworkpackage |
JMX控制台顯示有關伺服器上運行的若干服務的資訊:
與OSGi服務一起部署的MBeans會將服務屬性和操作暴露到控制台。 MBean決定公開的屬性和操作,以及屬性是只讀還是讀寫。
JMX主控台的首頁包含服務表。 表中的每一行都代表由MBean公開的服務。
CRX允許外部應用程式通過Java管理擴展(JMX)與受管Bean(MBeans)交互。 使用通用控制台(如JConsole或特定於域的監視應用程式),可以獲取和設定CRX配置和屬性,以及對效能和資源使用情況的監視。
要使用JConsole連接到CRX,請執行以下步驟:
開啟終端窗口。
輸入以下命令:
jconsole
JConsole將啟動,並出現JConsole窗口。
JConsole將顯示本地Java虛擬機進程的清單。 該清單將包含兩個快速啟動進程。 從本地進程清單(通常是PID較高的進程)中選擇快速啟動的「CHILD」進程。
為了連接到遠程CRX進程,需要啟用承載遠程CRX進程的JVM以接受遠程JMX連接。
要啟用遠程JMX連接,啟動JVM時必須設定以下系統屬性:
com.sun.management.jmxremote.port=portNum
在上述屬性中,portNum
是要啟用JMX RMI連接的埠號。 請務必指定未使用的埠號。 除了發佈RMI連接器以進行本地訪問外,設定此屬性還使用眾所周知的名稱"jmxrmi"在指定埠的專用只讀註冊表中發佈附加的RMI連接器。
預設情況下,啟用JMX代理進行遠程監視時,它會根據在啟動Java VM時需要使用以下系統屬性指定的口令檔案使用口令驗證:
com.sun.management.jmxremote.password.file=pwFilePath
有關設定密碼檔案的詳細說明,請參閱相關的JMX文檔。
範例:
$ java
-Dcom.sun.management.jmxremote.password.file=pwFilePath
-Dcom.sun.management.jmxremote.port=8463
-jar ./cq-quickstart.jar
在連接到快速啟動進程後,JConsole為CRX正在運行的JVM提供了一系列常規監控工具。
要訪問CRX的內部監視和配置選項,請轉至「MBeans」(MBeans)頁籤,然後從左側的分層內容樹中選擇您感興趣的「屬性」(Attributes)或「操作」(Operations)部分。 例如,com.adobe.granite/Repository/Operations區段。
在該區段中,在左窗格中選擇所需的屬性或操作。