ConfigurationMBean
, DescriptorBean
, javax.management.DynamicMBean
, javax.management.MBeanRegistration
, javax.management.NotificationBroadcaster
, SettableBean
, WebLogicMBean
public interface ServerStartMBean extends ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
Modifier and Type | Method | Description |
---|---|---|
java.lang.String |
getArguments() |
The arguments to use when starting this server.
|
java.lang.String |
getBeaHome() |
Deprecated.
12.1.3.0 replaced by ServerStartMBean.getMWHome
|
java.lang.String |
getClassPath() |
The classpath (path on the machine running Node Manager) to use
when starting this server.
|
java.lang.String |
getJavaHome() |
The Java home directory (path on the machine running Node
Manager) to use when starting this server.
|
java.lang.String |
getJavaVendor() |
The Java Vendor value to use when starting this server.
|
java.lang.String |
getMWHome() |
|
java.lang.String |
getPassword() |
The password of the username used to boot the server and perform
server health monitoring.
|
byte[] |
getPasswordEncrypted() |
The encrypted password of the username used to boot the server and perform
server health monitoring.
|
java.lang.String |
getRootDirectory() |
The directory that this server uses as its root directory.
|
java.lang.String |
getSecurityPolicyFile() |
The security policy file (directory and filename on the machine
running Node Manager) to use when starting this server.
|
java.lang.String |
getUsername() |
The user name to use when booting this server.
|
void |
setArguments(java.lang.String classpath) |
Set the value of the Arguments attribute.
|
void |
setBeaHome(java.lang.String path) |
Deprecated.
12.1.3.0 replaced by ServerStartMBean.setMWHome
|
void |
setClassPath(java.lang.String classpath) |
Sets the value of the ClassPath attribute.
|
void |
setJavaHome(java.lang.String path) |
Sets the value of the JavaHome attribute.
|
void |
setJavaVendor(java.lang.String vendor) |
Sets the value of the JavaVendor attribute.
|
void |
setMWHome(java.lang.String path) |
Sets the value of the MWHome attribute.
|
void |
setOutputFile(java.lang.String fileName) |
Sets the value of the OutputFile attribute.
|
void |
setPassword(java.lang.String password) |
Sets the value of the Password attribute.
|
void |
setPasswordEncrypted(byte[] bytes) |
Encrypts the user password and sets the value of the
PasswordEncrypted attribute.
|
void |
setRootDirectory(java.lang.String path) |
Sets the value of the RootDirectory attribute.
|
void |
setSecurityPolicyFile(java.lang.String filePath) |
Sets the value of the SecurityPolicy attribute.
|
void |
setUsername(java.lang.String username) |
Sets the value of the Username attribute.
|
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
getAttribute, getAttributes, invoke, setAttribute, setAttributes
postDeregister, postRegister, preDeregister, preRegister
addNotificationListener, getNotificationInfo, removeNotificationListener
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent
java.lang.String getJavaVendor()
The Java Vendor value to use when starting this server.
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.
This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.JavaVendor property.
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.
void setJavaVendor(java.lang.String vendor) throws javax.management.InvalidAttributeValueException
Sets the value of the JavaVendor attribute.
vendor
- The new javaVendor valuejavax.management.InvalidAttributeValueException
getJavaVendor()
java.lang.String getJavaHome()
The Java home directory (path on the machine running Node Manager) to use when starting this server.
Specify the parent directory of the JDK's bin
directory. For example,
c:\bea\jdk141
.
This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.JavaHome or property.
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.
void setJavaHome(java.lang.String path) throws javax.management.InvalidAttributeValueException
Sets the value of the JavaHome attribute.
path
- The new javaHome valuejavax.management.InvalidAttributeValueException
getJavaHome()
java.lang.String getClassPath()
The classpath (path on the machine running Node Manager) to use when starting this server.
At a minimum you will need to specify the following values for
the class path option:
WL_HOME/server/lib/weblogic_sp.jar;WL_HOME/server/lib/weblogic.jar
where WL_HOME
is the directory in which you
installed WebLogic Server on the Node Manager machine.
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 (:).
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.
void setClassPath(java.lang.String classpath) throws javax.management.InvalidAttributeValueException
Sets the value of the ClassPath attribute.
classpath
- The new classPath valuejavax.management.InvalidAttributeValueException
getClassPath()
@Deprecated java.lang.String getBeaHome()
The BEA home directory (path on the machine running Node Manager) to use when starting this server.
Specify the directory on the Node Manager machine under which
all of Oracle's BEA products were installed. For example,
c:\bea
.
@Deprecated void setBeaHome(java.lang.String path) throws javax.management.InvalidAttributeValueException
Sets the value of the BeaHome attribute.
path
- The new beaHome valuejavax.management.InvalidAttributeValueException
getBeaHome()
java.lang.String getMWHome()
The MWHome directory (path on the machine running Node Manager) to use when starting this server.
Specify the directory on the Node Manager machine under which
all of Oracle's Middleware products were installed. For example,
c:\bea
.
This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.MWHome property.
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.
void setMWHome(java.lang.String path) throws javax.management.InvalidAttributeValueException
Sets the value of the MWHome attribute.
path
- The new MWHome valuejavax.management.InvalidAttributeValueException
getMWHome()
java.lang.String getRootDirectory()
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.
void setRootDirectory(java.lang.String path) throws javax.management.InvalidAttributeValueException
Sets the value of the RootDirectory attribute.
path
- The new rootDirectory valuejavax.management.InvalidAttributeValueException
getRootDirectory()
java.lang.String getSecurityPolicyFile()
The security policy file (directory and filename on the machine running Node Manager) to use when starting this server.
This value can also be specified conveniently in the nodemanager .properties file using the weblogic.startup.SecurityPolicyFile property .
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=
void setSecurityPolicyFile(java.lang.String filePath) throws javax.management.InvalidAttributeValueException
Sets the value of the SecurityPolicy attribute.
filePath
- The new securityPolicyFile valuejavax.management.InvalidAttributeValueException
getSecurityPolicyFile()
java.lang.String getArguments()
The arguments to use when starting this server.
These are the first arguments appended immediately after
java
portion of the startup command. For example, you
can set Java heap memory or specify any
weblogic.Server
option.
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.
Separate arguments with a space.
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.
void setArguments(java.lang.String classpath) throws javax.management.InvalidAttributeValueException
Set the value of the Arguments attribute.
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.
classpath
- The new arguments valuejavax.management.InvalidAttributeValueException
getArguments()
void setOutputFile(java.lang.String fileName)
Sets the value of the OutputFile attribute.
fileName
- The new outputFile valuegetOutputFile()
java.lang.String getUsername()
The user name to use when booting this server.
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.
void setUsername(java.lang.String username) throws javax.management.InvalidAttributeValueException
Sets the value of the Username attribute.
username
- The new username valuejavax.management.InvalidAttributeValueException
getUsername()
java.lang.String getPassword()
The password of the username used to boot the server and perform server health monitoring.
As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:
PasswordEncrypted
attribute.When you set the value of this attribute, WebLogic Server does the following:
PasswordEncrypted
attribute to the
encrypted value.Using this attribute (Password
) 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.
Instead of using this attribute, use PasswordEncrypted
.
getPasswordEncrypted()
void setPassword(java.lang.String password) throws javax.management.InvalidAttributeValueException
Sets the value of the Password attribute.
password
- The new password valuejavax.management.InvalidAttributeValueException
getPassword()
byte[] getPasswordEncrypted()
The encrypted password of the username used to boot the server and perform server health monitoring.
To set this attribute, use weblogic.management.EncryptionHelper.encrypt()
to encrypt the value. Then set this attribute to the output of the encrypt() method.
To compare a password that a user enters with the encrypted
value of this attribute, go to the same WebLogic Server instance
that you used to set and encrypt this attribute
and use weblogic.management.EncryptionHelper.encrypt()
to encrypt the user-supplied password. Then compare the encrypted values.
void setPasswordEncrypted(byte[] bytes) throws javax.management.InvalidAttributeValueException
Encrypts the user password and sets the value of the PasswordEncrypted attribute.
bytes
- The new password value as a byte arrayjavax.management.InvalidAttributeValueException
getPasswordEncrypted()