Oracle GlassFish Server 3.1 Section 1: asadmin Utility Subcommands
create-connector-connection-pool(1)
create-connector-security-map(1)
create-connector-work-security-map(1)
create-jdbc-connection-pool(1)
create-message-security-provider(1)
create-resource-adapter-config(1)
delete-connector-connection-pool(1)
delete-connector-security-map(1)
delete-connector-work-security-map(1)
delete-jdbc-connection-pool(1)
delete-message-security-provider(1)
delete-resource-adapter-config(1)
disable-http-lb-application(1)
disable-secure-admin-internal-user(1)
disable-secure-admin-principal(1)
enable-secure-admin-internal-user(1)
enable-secure-admin-principal(1)
list-connector-connection-pools(1)
list-connector-security-maps(1)
list-connector-work-security-maps(1)
list-message-security-providers(1)
list-resource-adapter-configs(1)
list-secure-admin-internal-users(1)
list-secure-admin-principals(1)
list-supported-cipher-suites(1)
unfreeze-transaction-service(1)
update-admin-server-coordinates(1)
update-admin-server-local-coordinates(1)
update-connector-security-map(1)
update-connector-work-security-map(1)
Oracle GlassFish Server 3.1 Section 1M: Utility Commands
Oracle GlassFish Server 3.1 Section 5ASC: GlassFish Server Concepts
- creates options for the Java application launcher
create-jvm-options [--help] [--target target] [--profiler={true|false}] (jvm-option-name=jvm-option-value) [:jvm-option-name=jvm-option-value*]
The create-jvm-options subcommand creates command-line options that are passed to the Java application launcher when GlassFish Server is started. The options that this subcommand creates are in addition to the options that are preset with GlassFish Server. Java application launcher options are stored in the Java configuration java—config element or the profiler 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 profiler element in the domain.xml file.
Profiler options are used to record the settings that are required to start a particular profiler. The profiler must already exist. If necessary, use the create-profiler(1) subcommand to create the profiler.
This subcommand can be used to create the following types of options:
Java system properties. These options are set through the -D option of the Java application launcher. For example:
-Djava.security.manager
-Denvironment=Production
Startup parameters for the Java application launcher. These options are preceded by the dash character (-). For example:
--XX:PermSize=size
-Xmx1024m
-d64
If the subcommand specifies an option that already exists, the command does not re-create the option.
Note - Ensure that any option that you create is valid. The subcommand might allow you to create an invalid option, but such an invalid option can cause startup to fail.
An option can be verified by examining the server log after GlassFish Server starts. Options for the Java application launcher are written to the server.log file before any other information when GlassFish Server starts.
The addition of some options requires a server restart for changes to become effective. Other options are set immediately in the environment of the domain administration server (DAS) and do not require a restart. Whether a restart is required depends on the type of option.
Restart is not required for Java system properties whose names do not start with -Djava. or -Djavax. (including the trailing period). For example, restart is not required for the following Java system property:
-Denvironment=Production
Restart is required for the following options:
Java system properties whose names start with -Djava. or -Djavax. (including the trailing period). For example:
-Djava.security.manager
Startup parameters for the Java application launcher. For example:
-client
-Xmx1024m
-d64
To restart the DAS, use the restart-domain(1) command.
This subcommand is supported in remote mode only.
Displays the help text for the subcommand.
Specifies the target on which you are creating Java application launcher options.
Valid values are as follows:
Specifies the DAS (default).
Specifies a GlassFish Server instance.
Specifies a cluster.
Specifies a named configuration.
Indicates whether the Java application launcher options are for the profiler. The profiler must exist for this option to be true. Default is false.
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. For example, -Xmx2048m.
Note - If an option name or option value contains a colon, the backslash (\) must be used to escape the colon in the name or value. Other characters might also require an escape character. For more information about escape characters in subcommand options, see the asadmin(1M) man page.
Example 1 Setting Java System Properties
This example sets multiple Java system properties.
asadmin> create-jvm-options -Dunixlocation=/root/example: -Dvariable=\$HOME:-Dwindowslocation=d\:\\sun\\appserver:-Doption1=-value1 created 4 option(s) Command create-jvm-options executed successfully.
Example 2 Setting a Startup Parameter for the Java Application Launcher
This example sets the maximum available heap size to 1024.
asadmin> create-jvm-options -Xmx1024m created 1 option(s) Command create-jvm-options executed successfully.
Example 3 Setting Multiple Startup Parameters for the Java Application Launcher
This example sets the maximum available heap size to 1024 and requests details about garbage collection.
asadmin> create-jvm-options "-Xmx1024m:-XX\:+PrintGCDetails" created 1 option(s) Command create-jvm-options executed successfully.
In this case, one of the two parameters already exists, so the subcommand reports that only one option was set.
Example 4 Setting a JVM Startup Parameter for the Profiler
This example sets a JVM startup parameter for the profiler.
asadmin> create-jvm-options --profiler=true -XX:MaxPermSize=192m created 1 option(s) Command create-jvm-options executed successfully.
subcommand executed successfully
error in executing the subcommand
delete-jvm-options(1), list-jvm-options(1), create-profiler(1), restart-domain(1)
For more information about the Java application launcher, see the reference page for the operating system that you are using:
Oracle Solaris and Linux: java - the Java application launcher
Windows: java - the Java application launcher