ルート・スキーマ: JMX
タイプ: object
ソースを表示
- compatibilityMBeanServerEnabled(optional): boolean
デフォルト値: true
JMXクライアントで非推奨のMBeanHome
インタフェースを使用できるようにします。
9.0より前では、WebLogic ServerはJMXレイヤーに対して、型付きAPIレイヤーをサポートしていました。使用するJMXアプリケーション・クラスでは、WebLogic Server MBeanの型保障インタフェースをインポートしたり、weblogic.management.MBeanHome
インタフェースを介してMBeanの参照を取得したり、MBeanメソッドを直接呼び出すことができました。
- domainMBeanServerEnabled(optional): boolean
デフォルト値: true
ドメイン内のすべての実行時MBeanおよび読取り専用構成MBeanへのフェデレーテッド・アクセスを提供するドメインMBeanサーバーを管理サーバーが初期化するかどうかを指定します。これにより、JMXクライアントは、1つの接続でドメイン内のすべてのMBeanにアクセスできます。
管理コンソールおよびWebLogic Scripting Toolは、多くの(すべてではない)読取り操作にこのMBeanサーバーを使用します。
MBeanサーバーは、管理サーバー上にのみ存在します。JMXクライアントが初めて接続を要求したときに、管理サーバーによって初期化されます。この属性をfalse
に設定した場合、管理サーバーはこのMBeanサーバーを起動しないため、JMXクライアントは接続できません。
このMBeanサーバーはゆっくりと(要求された場合にのみ)初期化されますが、一度初期化されると、いくらかのメモリーとネットワーク・トラフィックを使用します。このMBeanサーバーを無効にすると、リソースの量を最小限に抑えることができますが、JMXクライアントはWebLogic Serverの実行時MBeanサーバーごとに個別の接続を保持する必要があります。
- dynamicallyCreated(optional): boolean
読取り専用: true
デフォルト値: false
MBeanが動的に作成されたか、config.xmlに対して永続化されているかが返されます
- editMBeanServerEnabled(optional): boolean
デフォルト値: true
ドメインの構成の変更に使用されるMBeanの階層を含む編集MBeanサーバーを管理サーバーが初期化するかどうかを指定します。JMXクライアント(管理コンソールやWebLogic Scripting Toolなどのユーティリティを含む)は、編集MBeanサーバーを使用してドメインの構成を変更します。
MBeanサーバーは、管理サーバー上にのみ存在します。デフォルトでは、管理サーバーは、起動時に編集MBeanサーバーを起動します。EditMBeanServerEnabled
属性をfalse
に設定した場合、管理サーバーはこのMBeanサーバーを起動しません。このMBeanサーバーを無効にすると、JMXクライアントはドメインの構成を変更できません。ただし、WebLogic Scripting Toolのオフライン編集機能を使用してドメイン構成を変更することはできます。
- ノート:
編集MBeanサーバーを無効にしただけでは、ドメイン構成の変更を防止できません。WebLogic Serverデプロイメント・サービスではJMXを使用しないため、編集MBeanサーバーを無効にしても、管理コンソールおよびWLSTはアプリケーションをデプロイまたはアンデプロイできます。
- id(optional): integer(int64)
- invocationTimeoutSeconds(optional): integer(int32)
最小値: 0
最大値: 2147483647
デフォルト値: 0
WebLogic Serverの内部プロセスがMBeanサーバーへの接続、MBeanサーバー・メソッドの呼び出し、呼出し結果の返送を待機する秒数。MBeanサーバー・メソッドがタイムアウト期間内に完了(返送)しない場合、WebLogic Serverはその呼出しの試行を破棄します。
WebLogic Serverの内部的な管理プロセスの中には、サーバー・インスタンスが他のMBeanサーバーに接続してMBeanサーバー・メソッドを呼び出す必要があるものもあります。タイムアウト期間は、MBeanサーバーがメソッド呼出しを正常に戻せない場合に、内部プロセスが停止するのを防ぎます。
(ゼロ)の値を指定すると、メソッド呼出しはタイムアウトされません。その場合、内部プロセスは、MBeanサーバーのメソッドから結果が戻されるまで無限に待機します。
- managedServerNotificationsEnabled(optional): boolean
デフォルト値: true
管理対象サーバーおよび管理サーバー上のフェデレーテッド実行時MBeanサーバーからの通知をWebLogic Serverドメインの実行時MBeanサーバーでサポートするかどうかを指定します。
通知のサポートには、大量のメモリー・リソースが必要です。オブジェクト名のリストは、実行時MBeanサーバーからMBeanごとに保持されます。このドメインに通知が必要ない場合は、無効にするとCPUおよびメモリー・リソースを節約できます。これは、実行時MBeanの数やサーバーの数が多い場合に特に重要です。
- managementAppletCreateEnabled(optional): boolean
デフォルト値: false
WebLogic Server MBeanサーバーが管理アプレット(MLet) MBeanの作成をサポートするかどうかを指定します。
MLet MBeanでは、ユーザーがリモート・サーバーからMBean実装をアップロードできます。環境およびセキュリティ・マネージャによってアクセスが信頼性のあるJMXクライアントに制限される場合のみ、これを有効にする必要があります。
- managementEJBEnabled(optional): boolean
デフォルト値: true
Java EE管理API (JSR-77)の一部である管理EJB (Management EJB: MEJB)へのアクセスを有効化します。
管理APIの仕様では、Java EE Webアプリケーション・サーバーの一般的なリソースに対して標準化された管理データ・モデルを提供しています。
MEJBは、一般的なJava EEリソースを記述するJava EE管理対象オブジェクト(JMO)へのアクセスを提供します。この属性をfalse
に設定すると、WebLogic ServerはJNDIツリーにMEJBを登録せず、ドメインのJava EE管理APIを効果的に無効化します。
- name(optional): string
読取り専用: true
このMBeanインスタンスのユーザー定義の名前。
この名前は、MBeanのjavax.management.ObjectName
に、主要なプロパティとして含まれています
Name=user-specified-name
制約
- notes(optional): string
この構成の説明として任意に入力できる情報。
WebLogic Serverは、ドメインの構成ファイル(config.xml
)に、このノートをXML PCDATAとして保存します。すべての左山カッコ(<)はXMLエンティティ<に変換されます。キャリッジ・リターンとライン・フィードは維持されます。)>
ノート: 管理コンソールからノートを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- platformMBeanServerEnabled(optional): boolean
デフォルト値: false
各WebLogic ServerインスタンスでJDKのプラットフォームMBeanサーバーを初期化するかどうかを指定します。このオプションとisPlatformMBeanServerUsed
を同時に有効にすると、プラットフォームMBeanサーバーがWebLogic Serverの実行時MBeanサーバーとして使用されます。
JDK 1.5以降、JVMでは、ローカル・プロセスがインスタンス化できるプラットフォームMBeanサーバーを提供しています。プラットフォームMBeanサーバーのインスタンスは、各JVMにつき1つのみ存在できます。あるプロセスでこのMBeanサーバーがインスタンス化されると、JVMは、JVM自身のモニター・データを提供するプラットフォームMXBeanをいくつか作成します。
この属性をtrue
に設定すると、各WebLogic Serverインスタンスはjava.lang.management.ManagementFactory.getPlatformMBeanServer()
メソッドを呼び出し、JVMのMXBeanを初期化します。
- platformMBeanServerUsed(optional): boolean
プラットフォームMBeanサーバーをWebLogic Serverの実行時MBeanサーバーとして使用するかどうかを指定します。以前は、プラットフォームMBeanサーバーを有効にすると、デフォルトでWebLogic Serverの実行時MBeanサーバーとして使用されていました。この属性を使用すると、プラットフォームMBeanサーバーの有効化とは別に、プラットフォームMBeanサーバーをWebLogic ServerのMBeanサーバーとして使用するかどうかを指定できます。
この属性のデフォルト値は、DomainMBean
の属性に基づいています。ドメインのバージョンが10.3.3.0よりも前の場合、この属性のデフォルト値はfalse
で、プラットフォームMBeanサーバーは使用されません。ドメインのバージョンが10.3.3.0以降の場合、この属性のデフォルト値はtrue
で、プラットフォームMBeanサーバーが使用されます。
この場合、java.lang.management.ManagementFactory.getPlatformMBeanServer()
メソッドによって戻されたMBeanServer
がサーバーの実行時MBeanサーバーのMBeanサーバーとして使用されます。これによって単一のMBeanサーバーからWebLogic Server MBeanおよびJVMプラットフォームMXBeanにアクセスできるようになります。また、実行時MBeanサーバーをプラットフォームMBeanサーバーとして有効にすると、JVMのローカル処理はjava.lang.management.ManagementFactory.getPlatformMBeanServer()
によって戻されるMBeanServer
を通じて、このMBeanサーバーに直接アクセスできます。
- runtimeMBeanServerEnabled(optional): boolean
デフォルト値: true
ドメイン内の各サーバー・インスタンスで、サーバーの実行時MBeanおよび読取り専用構成MBeanへのアクセスを提供する実行時MBeanサーバーを初期化するかどうかを指定します。
管理コンソールおよびWebLogic Scripting Toolは、一部の(すべてではない)読取り操作にこのMBeanサーバーを使用します。
RuntimeMBeanServerEnabled
がtrue
の場合、各サーバーはサーバーの起動サイクル中に実行時MBeanサーバーを起動します。この属性がfalse
の場合、ドメイン内のサーバー・インスタンスは実行時MBeanサーバーを起動しません。
- tags(optional): array Items
- type(optional): string
{
"type":"object",
"properties":{
"compatibilityMBeanServerEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Enables JMX clients to use the deprecated <code>MBeanHome</code> interface.</p><p>Prior to 9.0, WebLogic Server supported a typed API layer over its JMX layer. Your JMX application classes could import type-safe interfaces for WebLogic Server MBeans, retrieve a reference to the MBeans through the <code>weblogic.management.MBeanHome</code> interface, and invoke the MBean methods directly.</p>"
},
"domainMBeanServerEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Specifies whether the Administration Server initializes the Domain MBean Server, which provides federated access to all run-time MBeans and read-only configuration MBeans in the domain. Through it, JMX clients can access all MBeans in a domain through a single connection.</p><p>The Administration Console and the WebLogic Scripting Tool use this MBean server for many (but not all) of their read operations.</p><p>This MBean server exists only on the Administration Server. The Administration Server initializes it the first time a JMX client requests a connection to it. If you set this attribute to <code>false</code>, the Administration Server will not start this MBean server and JMX clients cannot connect to it.</p><p>While this MBean server is instantiated lazily (only when requested), once it is instantiated it does use some memory and network traffic. Disabling this MBean server can conserve a minimal amount of resources, but the trade off is that JMX clients must maintain separate connections for each WebLogic Server's Runtime MBean Server.</p>"
},
"dynamicallyCreated":{
"readOnly":true,
"default":false,
"type":"boolean",
"description":"<p>Return whether the MBean was created dynamically or is persisted to config.xml</p>"
},
"editMBeanServerEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Specifies whether the Administration Server initializes the Edit MBean Server, which contains the hierarchy of MBeans used to make modifications to the domain's configuration. All JMX clients, including utilities such as the Administration Console and the WebLogic Scripting Tool, use the Edit MBean Server to modify a domain's configuration.</p><p>This MBean server exists only on the Administration Server. By default, when the Administration Server starts, it starts the Edit MBean Server. If you set the <code>EditMBeanServerEnabled</code> attribute to <code>false</code>, the Administration Server will not start this MBean server. If you disable this MBean server, JMX clients cannot modify the domain's configuration. You can, however, modify the domain configuration through the offline editing feature of WebLogic Scripting Tool.</p><dl><dt>Note:</dt><dd><p>Disabling the Edit MBean Server is not sufficient to prevent changes to a domain configuration. Because the WebLogic Server deployment service does not use JMX, the Administration Console and WLST can deploy or undeploy applications even if you have disabled the Edit MBean Server.</p></dd></dl>"
},
"id":{
"readOnly":true,
"type":"integer",
"format":"int64",
"description":"<p>Return the unique id of this MBean instance</p>"
},
"invocationTimeoutSeconds":{
"default":0,
"minimum":0,
"maximum":2147483647,
"type":"integer",
"format":"int32",
"description":"<p>The number of seconds that internal WebLogic Server processes wait to connect to an MBean server, invoke an MBean server method, and return the results of the invocation. If the MBean server method does not complete (return) within the timeout period, WebLogic Server abandons its invocation attempt.</p><p>Some internal management processes within WebLogic Server require a server instance to connect to MBean servers in other WebLogic Server instances and invoke an MBean server method. The timeout period prevents the internal process from locking up if an MBean server cannot successfully return a method invocation.</p><p>A value of <code></code> (zero) prevents the method invocation from timing out. With such a value, the internal process will wait indefinitely until the MBean server's method returns. </p>"
},
"managedServerNotificationsEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Specifies whether the WebLogic Server Domain Runtime MBean Server will support notifications from the federated Runtime MBean Servers on the managed and administration servers.</p><p>Supporting notifications requires a significant amount of memory resources. A list of ObjectNames is maintained for each MBean from the Runtime MBean Servers. If notifications are not required for this domain, then disabling them will save on CPU and memory resources. This is particularly critical if there are large numbers of runtime MBeans and/or large numbers of servers.</p>"
},
"managementAppletCreateEnabled":{
"default":false,
"type":"boolean",
"description":"<p>Specifies whether the WebLogic Server MBean Servers will support creation of management applet (MLet) MBeans.</p><p>MLet MBeans allow a user to upload the MBean implementation from a remote server and should only be enabled if the environment and security manager restrict access to trusted JMX clients.</p>"
},
"managementEJBEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Enables access to the Management EJB (MEJB), which is part of the Java EE Management APIs (JSR-77). </p><p>The Management API specification provides a standardized management data model for common resources on Java EE Web application servers.</p><p>The MEJB provides access to Java EE Managed Objects (JMOs), which describe the common Java EE resources. If you set this attribute to <code>false</code>, WebLogic Server does not register the MEJB in the JNDI tree, and effectively disables the Java EE Management APIs for the domain.</p>"
},
"name":{
"readOnly":true,
"x-weblogic-legalNull":true,
"type":"string",
"description":"<p>The user-specified name of this MBean instance.</p><p>This name is included as one of the key properties in the MBean's <code>javax.management.ObjectName</code></p><p><code>Name=<i>user-specified-name</i></code></p><p><h5>Constraints</h5></p><ul><li>legal null</li></ul>"
},
"notes":{
"type":"string",
"description":"<p>Optional information that you can include to describe this configuration.</p><p>WebLogic Server saves this note in the domain's configuration file (<code>config.xml</code>) as XML PCDATA. All left angle brackets (<) are converted to the XML entity <code><</code>. Carriage returns/line feeds are preserved.</p><p>Note: If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.</p>"
},
"platformMBeanServerEnabled":{
"default":false,
"type":"boolean",
"description":"<p>Specifies whether each server instance initializes the JDK's platform MBean server. Enabling it, along with <code>isPlatformMBeanServerUsed</code>, causes WebLogic Server to use the platform MBean server as its Runtime MBean Server.</p><p>As of JDK 1.5, JVMs provide a platform MBean server that local processes can instantiate. There can be only one instance of the platform MBean server for each JVM. When a process instantiates this MBean server, the JVM creates several platform MXBeans that provide monitoring data for the JVM itself.</p><p>If you set this attribute to <code>true</code>, each WebLogic Server instance invokes the method <code>java.lang.management.ManagementFactory.getPlatformMBeanServer()</code> and thus causes the initialization of the JVM's MXBeans.</p>"
},
"platformMBeanServerUsed":{
"type":"boolean",
"description":"<p>Specifies whether WebLogic Server will use the platform MBean server for its Runtime MBean Server. Previously, WebLogic Server used the platform MBean server by default if it was enabled. This attribute provides a separation between enabling the platform MBean server and using it for WebLogic Server MBeans.</p><p>The default value for this attribute is based on the <code>DomainVersion</code> attribute of the DomainMBean. If the domain version is prior to 10.3.3.0, then the default value of this attribute is <code>false</code> and the platform MBean server is not used. If the domain version is 10.3.3.0 or higher, then the default value of this attribute is <code>true</code> and the platform MBean server is used. </p><p>In this case, the server's Runtime MBean Server uses the <code>MBeanServer</code> returned by <code>java.lang.management.ManagementFactory.getPlatformMBeanServer()</code> method as its MBean Server. This makes it possible to access the WebLogic Server MBeans and the JVM platform MXBeans from a single MBean server. In addition, if you enable the Runtime MBean Server to be the Platform MBean Server, local processes in the JVM can directly access this MBean server through the <code>MBeanServer</code> interface that <code>java.lang.management.ManagementFactory.getPlatformMBeanServer()</code> returns.</p>"
},
"runtimeMBeanServerEnabled":{
"default":true,
"type":"boolean",
"description":"<p>Specifies whether each server instance in the domain initializes its Runtime MBean Server, which provides access to a server's run-time MBeans and read-only configuration MBeans.</p><p>The Administration Console and the WebLogic Scripting Tool use this MBean server for some (but not all) of their read operations.</p><p>If <code>RuntimeMBeanServerEnabled</code> is <code>true</code>, each server starts its Runtime MBean Server during the server's startup cycle. If this attribute is <code>false</code>, no server instance in the domain will start its Runtime MBean Server.</p>"
},
"tags":{
"title":"Items",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"<p>Return all tags on this Configuration MBean</p>"
},
"type":{
"readOnly":true,
"x-weblogic-unharvestable":true,
"type":"string",
"description":"<p>Returns the type of the MBean.</p><p><h5>Constraints</h5></p><ul><li>unharvestable</li></ul>"
}
},
"description":""
}