提供的 MBean 清單
Liberty 提供一份 MBean 及對應管理介面的清單,可用來操作及監視伺服器。當使用 MBean Proxy 時,請在 ${wlp.install.dir}/dev/api/ibm 中的 .jar 檔內,尋找您需要編譯的類別。
- 名稱是 javax.management.ObjectName 值,用來唯一識別 MBean 或 MXBean。 當 MBean 或 MXBean 有多重實例時,ObjectName 值可以包含這個主題的註解項目所說明的萬用字元 (*)。
- 管理介面項目指定可依照「存取 MBean 屬性和作業」範例中所說明,用來建構 MBean 或 MXBean 的虛擬物件之 Java 介面的名稱。如需管理介面的相關資訊,請參閱 Liberty 的 Java API 文件。每一個 Liberty API 的 Java API 說明文件都詳述於線上 IBM® Knowledge Center 的程式設計介面 (Javadoc) 一節,也以個別的 .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 說明文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
顯現的作業包含一種方法,可用來擷取產品的安裝與使用者目錄位置、預設主機名稱、伺服器名稱、產品版本、Java 規格版本,以及 Java 執行時期版本。
![[18.0.0.1 以及更新版本]](../ng_v18001plus.gif)
WebSphere:feature=kernel,name=ServerEndpointControl
- 管理介面: com.ibm.websphere.kernel.server.ServerEndpointControlMBean
- 註解:ServerEndpointControlMBean 介面用來暫停、回復和取得伺服器端點的狀態。MBean 可從核心取得,因此您不必啟用特殊特性。您可以在下列位置找到 MBean 類別和 API 文件:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
如需您可以暫停的端點類型清單,請參閱從指令行暫停及回復 Liberty 伺服器。
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:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- 管理介面:com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- 註解:系統中每一個「連線管理程式」都有一個可用的實例,包括下列環境定義中所建立的那些實例:
- 明確配置在伺服器配置中時
- 因 @DataSourceDefinition 或 @ConnectionFactoryDefinition 註釋,而隱含建立時
- 因伺服器配置中的 Connection Factory 或資料來源而建立時
如果要縮小連線管理程式實例範圍,您可以指定其他的屬性,如下列範例所示:WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:type=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 監視。