ルート・スキーマ: Server Start
タイプ: object
ソースを表示
- arguments(optional): string
このサーバーを起動する際に使用される引数。
これらは、起動コマンドのJava
部分の直後に付加する最初の引数です。たとえば、Javaヒープ・メモリーを設定したり、任意のweblogic.Server
オプションを指定したりできます。
このプロパティは、weblogic.management.usernameやweblogic.management.passwordの指定には使用しないようにします。これらの値はサーバーの起動時に無視されるためです。かわりに、ユーザー名およびパスワードのプロパティを設定する必要があります。また、こうすることで、ノード・マネージャにおいてこれらの値を管理対象サーバーのマシン上で適切に暗号化できるようになります。
引数はスペースで区切ります。
この値は、weblogic.startup.Argumentsプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。ノード・マネージャは、JAVA_OPTIONS環境変数を使用してこの値を起動スクリプトに渡します。サーバーを起動するJavaコマンド・ラインを発行する際、ノード・マネージャは引数をオプションとして渡します。
- classPath(optional): string
このサーバーの起動時に使用するクラスパス(ノード・マネージャを実行しているマシン上のパス)。
クラスパス・オプションには最低限、次の値を指定する必要があります。WL_HOME/server/lib/weblogic_sp.jar;WL_HOME/server/lib/weblogic.jar
WL_HOME
は、ノード・マネージャ・マシン上のWebLogic Serverをインストールしたディレクトリです。
パス要素を区切るために使用する文字はシェル環境によって決まります。Windowsでは通常、セミコロン(;)を使用します。BASHシェルでは通常、コロン(:)を使用します。
この値は、weblogic.startup.ClassPathプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。ノード・マネージャは、CLASSPATH環境変数を使用してこの値を起動スクリプトに渡します。Javaコマンド・ラインを発行してサーバーを起動する場合、ノード・マネージャは-Djava.class.pathを渡します。
- dynamicallyCreated(optional): boolean
読取り専用: true
デフォルト値: false
MBeanが動的に作成されたか、config.xmlに対して永続化されているかが返されます
- id(optional): integer(int64)
- javaHome(optional): string
このサーバーの起動時に使用するJavaのホーム・ディレクトリ(ノード・マネージャを実行しているマシン上のパス)。
JDKのbin
ディレクトリの親ディレクトリを指定します。たとえば、c:\bea\jdk141
です
この値は、weblogic.startup.JavaHomeプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。
ノード・マネージャは、JAVA_HOME環境変数を使用して、この値を起動スクリプトに渡します。サーバーを起動するJavaコマンド・ラインを発行する際、ノード・マネージャは指定した場所からJava実行可能ファイルを使用します。
- javaVendor(optional): string
このサーバーの起動時に使用するJavaベンダー値。
サーバーがクラスタの一部で、異なるベンダーのJDKを使用する別のプラットフォームにまたがって自動移行するように構成されている場合は、このプロパティを使用するかわりに、生成された構成ファイルでJavaVendorとJavaHomeの両方を設定する必要があります。
この値は、weblogic.startup.JavaVendorプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。
ノード・マネージャは、サーバーを起動するためのJavaコマンドラインを起動してこの値を渡すことはありません。この値は、環境変数JAVA_VENDORで起動スクリプトに渡されます。
- MWHome(optional): string
このサーバーの起動時に使用するMWHomeディレクトリ(ノード・マネージャを実行しているマシン上のパス)。
すべてのOracleのMiddleware製品がインストールされた、ノード・マネージャ・マシン上のディレクトリを指定します。たとえば、c:\bea
です
この値は、weblogic.startup.MWHomeプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。
この値は、ノード・マネージャから起動スクリプトに渡されません。サーバーを起動するためのJavaコマンド・ラインを呼び出すときに、-Dbea.homeが指定されます。
- name(optional): string
読取り専用: true
このMBeanインスタンスのユーザー定義の名前。
この名前は、MBeanのjavax.management.ObjectName
に、主要なプロパティとして含まれています
Name=user-specified-name
制約
- notes(optional): string
この構成の説明として任意に入力できる情報。
WebLogic Serverは、ドメインの構成ファイル(config.xml
)に、このノートをXML PCDATAとして保存します。すべての左山カッコ(<)はXMLエンティティ<に変換されます。キャリッジ・リターンとライン・フィードは維持されます。)>
ノート: 管理コンソールからノートを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- password(optional): string(password)
サーバーの起動時およびサーバー状態監視の実行時に使用するユーザー名のパスワード。
8.1 sp4以降、この属性の値を取得する際、WebLogic Serverは次の処理を行います。
PasswordEncrypted
属性の値を取得します。
値を復号化し、暗号化されていないパスワードをString型で戻します。
この属性の値を設定すると、WebLogic Serverは次の処理を実行します。
値を暗号化します。
PasswordEncrypted
属性の値を、暗号化した値に設定します。
この属性(Password
)を使用すると、暗号化されていないパスワードを格納するString型のオブジェクトが、ガベージ・コレクションによって削除され、メモリーの再割当てが行われるまでJVMのメモリー内に留まるため、潜在的なセキュリティ上のリスクにつながります。JVM内でメモリーがどのように割り当てられているかによっては、この暗号化されていないデータがメモリーから削除されるまでに、かなりの時間が経過する可能性があります。
この属性を使用するかわりに、PasswordEncrypted
を使用します
- rootDirectory(optional): string
このサーバーがルート・ディレクトリとして使用するディレクトリ。このディレクトリは、ノード・マネージャをホストするコンピュータ上に存在している必要があります。ルート・ディレクトリ値を指定しない場合は、デフォルトでドメイン・ディレクトリが使用されます。
- securityPolicyFile(optional): string
このサーバーの起動時に使用するセキュリティ・ポリシー・ファイル(ノード・マネージャを実行しているマシン上のディレクトリおよびファイル名)。
この値は、weblogic.startup.SecurityPolicyFileプロパティを使用してnodemanager.propertiesファイルで簡単に指定することもできます。
ノード・マネージャが起動スクリプトを使用する際、セキュリティ・ポリシー・ファイルは環境変数SECURITY_POLICYで定義されます。また、ノード・マネージャがJavaコマンドを使用して直接プロセスを起動する際、セキュリティ・ポリシー・ファイルは-Djava.security.policy=とともに定義されます。
- tags(optional): array Items
- type(optional): string
- username(optional): string
デフォルト値:
このサーバーを起動する際に使用されるユーザー名。
管理コンソールは、指定したユーザー名をコンソールにログインしたときに挿入します。ドメイン構成ウィザードは、定義したユーザー名をドメイン作成時に挿入します。
{
"type":"object",
"properties":{
"MWHome":{
"type":"string",
"description":"<p></p><p>The MWHome directory (path on the machine running Node Manager) to use when starting this server.</p><p>Specify the directory on the Node Manager machine under which all of Oracle's Middleware products were installed. For example, <code>c:\\bea</code></p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.MWHome property.</p><p> Node Manager does not pass this value to start scripts. It does specify -Dbea.home when invoking a Java command line to start the server.</p>"
},
"arguments":{
"type":"string",
"description":"<p>The arguments to use when starting this server.</p><p>These are the first arguments appended immediately after <code>java</code> portion of the startup command. For example, you can set Java heap memory or specify any <code>weblogic.Server</code> option.</p><p>This property should not be used to specify weblogic.management.username or weblogic.management.password as these values will be ignored during server startup. Instead the username and password properties should be set. This will also enable Node Manager to properly encrypt these values on the Managed Server's machine.</p><p>Separate arguments with a space.</p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.Arguments property. Node Manager will pass this value to a start script using the JAVA_OPTIONS environment variable. When issuing a Java command line to start the server, Node Manager will pass the arguments as options.</p>"
},
"classPath":{
"type":"string",
"description":"<p>The classpath (path on the machine running Node Manager) to use when starting this server.</p><p>At a minimum you will need to specify the following values for the class path option: <code>WL_HOME/server/lib/weblogic_sp.jar;WL_HOME/server/lib/weblogic.jar</code></p><p>where <code>WL_HOME</code> is the directory in which you installed WebLogic Server on the Node Manager machine.</p><p>The shell environment determines which character you use to separate path elements. On Windows, you typically use a semicolon (;). In a BASH shell, you typically use a colon (:).</p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.ClassPath property. Node Manager will pass this value to a start script using the CLASSPATH environment variable. When issuing a Java command line to start the server, Node Manager will pass -Djava.class.path.</p>"
},
"dynamicallyCreated":{
"readOnly":true,
"default":false,
"type":"boolean",
"description":"<p>Return whether the MBean was created dynamically or is persisted to config.xml</p>"
},
"id":{
"readOnly":true,
"type":"integer",
"format":"int64",
"description":"<p>Return the unique id of this MBean instance</p>"
},
"javaHome":{
"type":"string",
"description":"<p>The Java home directory (path on the machine running Node Manager) to use when starting this server.</p><p>Specify the parent directory of the JDK's <code>bin</code> directory. For example, <code>c:\\bea\\jdk141</code></p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.JavaHome or property.</p><p>Node Manager will pass this value to a start script using the JAVA_HOME environment variable. When issuing a Java command line to start the server, Node Manager will use the Java executable from the specified location. </p>"
},
"javaVendor":{
"type":"string",
"description":"<p>The Java Vendor value to use when starting this server. </p><p> If the server is part of a cluster and configured for automatic migration across possibly different platforms with different vendors providing the JDKs, then, both JavaVendor and JavaHome should be set in the generated configuration file instead.</p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.JavaVendor property.</p><p>Node Manager does not pass this value invoking a Java command line to start the server. It does pass this value in the environment variable JAVA_VENDOR to the start script. </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>"
},
"password":{
"type":"string",
"format":"password",
"description":"<p>The password of the username used to boot the server and perform server health monitoring.</p><p>As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:</p><ol><li><p>Retrieves the value of the <code>PasswordEncrypted</code> attribute.</p></li><li><p>Decrypts the value and returns the unencrypted password as a String.</p></li></ol><p>When you set the value of this attribute, WebLogic Server does the following:</p><ol><li><p>Encrypts the value.</p></li><li><p>Sets the value of the <code>PasswordEncrypted</code> attribute to the encrypted value.</p></li></ol><p>Using this attribute (<code>Password</code>) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.</p><p>Instead of using this attribute, use <code>PasswordEncrypted</code></p>"
},
"rootDirectory":{
"type":"string",
"description":"<p>The directory that this server uses as its root directory. This directory must be on the computer that hosts Node Manager. If you do not specify a Root Directory value, the domain directory is used by default. </p>"
},
"securityPolicyFile":{
"type":"string",
"description":"<p>The security policy file (directory and filename on the machine running Node Manager) to use when starting this server.</p><p>This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.SecurityPolicyFile property .</p><p>When Node Manager is using a start script, the security policy file will be defined in an environment variable, SECURITY_POLICY. Additionally, when Node Manager is launching the process directly using a Java command, the security policy file will be defined with -Djava.security.policy= </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>"
},
"username":{
"default":"",
"type":"string",
"description":"<p>The user name to use when booting this server.</p><p>The Administration Console inserts the user name that you supplied when you logged in to the console. The Domain Configuration Wizard inserts the user name that you defined when you created the domain.</p>"
}
},
"description":""
}