提供的 MBean 清單
Liberty 提供一份 MBean 及對應管理介面的清單,可用來操作及監視伺服器。
- WebSphere:feature=channelfw,type=endpoint,name=*
- WebSphere:feature=dynamicRouting,type=DynamicRouting,name=DynamicRouting
- WebSphere:feature=kernel,name=ServerInfo
- WebSphere:feature=restConnector,type=FileService,name=FileService
- WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- WebSphere:feature=scalingController,type=StackManager,name=StackManager
- WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- WebSphere:type=JvmStats
- WebSphere:type=ServletStats,name=*
- WebSphere:type=ThreadPoolStats,name=Default Executor
- WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- 名稱是 javax.management.ObjectName 值,用來唯一識別 MBean 或 MXBean。 當 MBean 或 MXBean 有多重實例時,ObjectName 值可以包含這個主題的註解項目所說明的萬用字元 (*)。
- 管理介面項目指定可依照存取 MBean 屬性和作業的範例中所說明,用來建構 MBean 或 MXBean 的虛擬物件之 Java 介面的名稱。如需管理介面的相關資訊,請參閱 Liberty 的 Java API 文件。每一個 Liberty API 的 Java API 文件都詳述於線上 IBM Knowledge Center 的程式設計介面 (API) 區段,也以個別的 .zip 檔來提供(其位於 ${wlp.install.dir}/dev 目錄下的其中一個 javadoc 子目錄中)。
WebSphere:feature=channelfw,type=endpoint,name=*
- 管理介面:com.ibm.websphere.endpoint.EndPointInfoMBean
- 註解:系統中每個端點都有一個可用的實例,其中 * 是唯一端點名稱。
WebSphere:feature=dynamicRouting,type=DynamicRouting,name=DynamicRouting
- 管理介面:com.ibm.websphere.dynamic.routing.DynamicRoutingMBean
- 註解:當啟用 Dynamic Routing 特性時,可以使用這個 MBean。
它會提供作業,來產生 Web 伺服器外掛程式配置,以進行動態遞送。
請參閱。
WebSphere:feature=kernel,name=ServerInfo
- 管理介面: com.ibm.websphere.kernel.server.ServerInfoMBean
- 註解:ServerInfoMbean 介面用來擷取執行中伺服器的相關資訊。請搜尋下列目錄,以找出類別與 API 文件:
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
顯現的作業包含一種方法,可用來擷取產品的安裝與使用者目錄位置、預設主機名稱、伺服器名稱、產品版本、Java 規格版本,以及 Java 執行時期版本。
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 檔。
WebSphere:feature=scalingController,type=StackManager,name=StackManager
- 管理介面:com.ibm.websphere.scaling.controller.StackManager
- 註解:StackManager MBean 會控制檔案系統的掃描。堆疊管理程式會掃描 WLP_STACK_GROUPS_DIR 位置
(依預設是 $WLP_USER_DIR/shared/stackGroups),以便新增、修改和刪除控制器。您可以在下列位置找到 MBean 類別和 API 文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.scalingController_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.scalingController_version-javadoc.zip
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
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。
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
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
- 註解:請參閱 新增外掛程式配置至 Web 伺服器中。
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- 管理介面:com.ibm.websphere.application.ApplicationMBean
- 註解:系統中每個應用程式都有一個可用的實例,其中 * 是一個唯一應用程式名稱。
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- 管理介面:com.ibm.websphere.webcontainer.WebModuleMBean
- 註解:系統中的每一個 WebModule 都有一個可用的實例,其中 application=* 是系統中的應用程式名稱,name=* 是該應用程式中的「Web 模組」名稱。
WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- 管理介面:com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- 註解:系統中每一個「連線管理程式」都有一個可用的實例,包括下列環境定義中所建立的那些實例:
- 明確配置在伺服器配置中時
- 因 @DataSourceDefinition 或 @ConnectionFactoryDefinition 註釋,而隱含建立時
- 因伺服器配置中的 Connection Factory 或資料來源而建立時
如果要縮小連線管理程式實例範圍,您可以指定其他的屬性,如下列範例所示:WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=java.module/env/jdbc/ds3,application=MyApp,module=myweb,*
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- 管理介面:com.ibm.websphere.filemonitor.FileNotificationMBean
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 監視。