提供的 MBean 清單
Liberty 設定檔會提供一份可用來操作及監視伺服器的 MBean 及對應管理介面的清單。
清單中的每個 MBean 或 MXBean:
- 名稱是 javax.management.ObjectName 值,用來唯一識別 MBean 或 MXBean。 當 MBean 或 MXBean 有多重實例時,ObjectName 值可以包含這個主題的註解項目所說明的萬用字元 (*)。
- 管理介面項目指定可依照存取 MBean 屬性和作業的範例中所說明,用來建構 MBean 或 MXBean 的虛擬物件之 Java 介面的名稱。如需管理介面的相關資訊,請參閱 Liberty 設定檔的 Java API 文件。每一個 Liberty 設定檔 API 的 Java API 文件都詳述於資訊中心的程式設計介面 (API) 區段,也以個別的 .zip 檔來提供(其位於 ${wlp.install.dir}/dev 目錄下的其中一個 javadoc 子目錄中)。
WebSphere:feature=channelfw,type=endpoint,name=*
- 管理介面:com.ibm.websphere.endpoint.EndPointInfoMBean
- 註解:系統中每個端點都有一個可用的實例,其中 * 是唯一端點名稱。
WebSphere:feature=restConnector,type=FileService,name=FileService
- 管理介面:com.ibm.websphere.filetransfer.FileServiceMXBean
- 註解:這個 MXBean 可讓您在 Liberty 所在的主機上,執行各種檔案相關作業。您可以在下列位置找到它的類別和 API 文件:
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
顯現的作業包括能夠查詢給定檔案或目錄的某些 meta 資料(前次修改日期、大小,等等),也能夠查詢給定目錄的所有子檔案(及對應的 meta 資料)。 另外,還支援建立和擴充保存檔,對於壓縮 Liberty 日誌檔或在部署應用程式之前擷取應用程式,它可能很有用。
這個 MXBean 包含兩個屬性:讀取清單和寫入清單。 它們代表在使用 Liberty 所提供的 FileService 或 FileTransfer 功能時,使用者可以讀取或寫入的位置清單。 透過 MXBean,只能讀取這些屬性,但您可以透過 server.xml 檔中的下列元素來配置或自訂它們:
如果沒有指定 readDir 元素,預設值為 ${wlp.install.dir}、${wlp.user.dir} 和 ${server.output.dir} 的組合。 如果沒有指定 writeDir 元素,預設值就是一個空集合。<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
restConnector-1.0 特性必須包含在 server.xml 檔中,這個 MXBean 才能被載入以及實現其配置元素。
當使用 Liberty 定義的變數時,所有伺服器端參數都可以採用代表檔案路徑的字串。 這類變數定義於 liberty_home/README.TXT 檔。
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- 管理介面:com.ibm.websphere.filetransfer.FileTransferMBean
- 註解:這個 MBean 可讓您在 Liberty 所在的主機上,執行各種檔案傳送作業。
您可以在下列位置找到它的類別和 API 文件:
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
這個 MBean 是從對應的 Liberty 程序所執行的相同 JVM 登錄於 PlatformMBeanServer,但只能利用 IBM® JMX REST Connector 來存取。連線可以是本端或遠端連線,但必須使用 REST Connector。
顯現的作業包括能夠下載、上傳和刪除檔案。 伺服器上每個讀取和寫入要求都會連結至透過 FileServiceMXBean 來存取的可配置的讀取及寫入清單。 如果是透過 IBM JMX REST Connector 來連接 JConsole,FileTransferMBean 也完全可以從內建的 Java JConsole 來存取及操作。
當使用 Liberty 定義的變數時,所有伺服器端參數都可以採用代表檔案路徑的字串。 這類變數定義於 liberty_home/README.TXT 檔。
![[8.5.5.5 或更新版本]](../ng_v8555.gif)
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 管理介面:com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 註解:ServerXMLConfigurationMBean 提供一個介面,用來擷取伺服器已知的所有伺服器配置檔的檔案路徑。MBean 可從核心取得,因此您不必啟用特殊特性。您可以在下列位置找到 MBean 類別和 API 說明文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
![[8.5.5.4 或更新版本]](../ng_v8554.gif)
WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- 管理介面:com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- 註解:RuntimeUpdateNotificationMBean 提供伺服器執行時期更新通知。附加到通知中的使用者資料物件是 java.util.Map。這個 MBean 產生的執行時期更新通知的通知類型是 com.ibm.websphere.runtime.update.notification。
![[8.5.5.5 或更新版本]](../ng_v8555.gif)
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- 管理介面:com.ibm.websphere.config.mbeans.FeatureListMBean
- 註解:FeatureListMBean 顯露單一方法,可針對在執行時期安裝的所有特性,產生一份 XML 報告。MBean 可從核心取得,因此您不必啟用特殊特性。您可以在下列位置找到 MBean 類別和 API 說明文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
![[8.5.5.5 或更新版本]](../ng_v8555.gif)
WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- 管理介面:com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- 註解:ServerSchemaGenerator MBean 顯露一些方法,可從已安裝的映像檔、最常用的方式或現行執行時期產生綱目。MBean 可從核心取得,因此您不必啟用特殊特性。您可以在下列位置找到 MBean 類別和 API 說明文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- 管理介面:com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- 註解:請參閱 配置 Liberty 設定檔的 Web 伺服器外掛程式。
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- 管理介面:com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- 管理介面:com.ibm.websphere.application.ApplicationMBean
- 註解:系統中每個應用程式都有一個可用的實例,其中 * 是一個唯一應用程式名稱。
![[8.5.5.6 或更新版本]](../ng_v8556.gif)
WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=*
- 管理介面:com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- 註解:系統中每一個「連線管理程式」都有一個可用的實例,其中 * 是「連線管理程式」的 jndiName。如果「連線管理程式」沒有 jndiName,並且以巢狀方式置於 server.xml 的 DataSource 元素之下,則可能使用 DataSource 的 jndiName。
WebSphere:type=JvmStats
- 管理介面:com.ibm.websphere.monitor.jmx.JvmMXBean
- 註解:當啟用 monitor-1.0 特性時可供使用。請參閱 JVM 監視。
WebSphere:type=ServletStats,name=*
- 管理介面:com.ibm.websphere.webcontainer.ServletStatsMXBean
- 註解:當啟用 monitor-1.0 特性時,每個已提供的 Servlet 都有一個可用的實例,其中 * 的格式為<AppName>.<ServletName>。 請參閱 Web 應用程式監視。
WebSphere:type=ThreadPoolStats,name=Default Executor
- 管理介面:com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- 註解:當啟用 monitor-1.0 特性時可供使用。請參閱 ThreadPool 監視。