2.11.1 create-jvm-options

Synopsis

asadmin [asadmin-options] create-jvm-options [--help] [--target target]
    [--profiler={true|false}]
    option-name[=option-value][:option-name[=option-value]]...

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-jvm-options subcommand creates command-line options that are passed to Java VM when Java EE Server is started. The options that this command creates are in addition to the options that are preset with Java EE Server. Java VM options are stored in the Java configuration java--config element or the profiler element of the domain.xml file. The options are sent to the command line in the order they appear in the java--config element or the profiler element in the domain.xml file.

This command can be used to create the following types of options:

• Java system properties: These options are set through the -D option of Java VM.

• Startup parameters for Java VM. These options are preceded by the dash character (-).

If an inappropriate value is specified for an option for Java VM of the Domain Administration Server (DAS), you might need to reconfigure the domain without starting the DAS. To avoid this problem, we recommend that before changing options for Java VM on the DAS, use the backup-domain command to back up the domain.

This subcommand is supported in remote mode only.

Precondition

DAS has to be in a running state.

Files

Java VM options are stored in the Java configuration java--config element or the profiler profiler element of the domain.xml file.

Arguments

--help | -?

Displays the help text for the subcommand.

--target target

Specifies the target on which you are creating Java VM options.

Type: String

The following values can be specified:

• server

  Specifies the DAS (default).

• configuration-name

  Specifies a named configuration.

• cluster-name

  Specifies a cluster.

• instance-name

  Specifies a server instance.

Default value: server

--profiler={true|false}

Indicates whether the Java VM options are for the profiler.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

option-name[=option-value][:option-name[=option-value]]...

Indicates one or more options delimited by a colon (:). The format of an option depends on the following:

• If the option has a name and a value, the format is option-name=value.

• If the option has only a name, the format is option-name.

Type: String

The following values can be specified:

• Specify the jvm-option name or name with value

Default value: N/A

asadmin create-jvm-options --target instance1 -Dunixlocation=/root/example:
-Dvariable=\$HOME:-Dwindowslocation=d\:\\sun\\appserver:-Doption1=-value1

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.

Notes

Do not specify the following system properties for the options of this command. If specified, the log configuration (config.properties) of the Message Queue is affected.

• java.util.logging.FileHandler.count

• java.util.logging.FileHandler.limit

• java.util.logging.FileHandler.level

• java.util.logging.FileHandler.pattern