2.11.2 create-system-properties

Synopsis

asadmin [asadmin-options] create-system-properties [--help]
    [--target target] [name=value[:name=value]...]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-system-properties subcommand adds or updates system properties that can be referenced elsewhere on the server.

Java EE Server provides hooks where tokens (system properties) can be specified. As Java EE Server does not have multiple server elements, you can specify a particular token at any level. When a domain supports multiple servers, the override potential can be exploited. When a domain is started or restarted, all system-property elements are resolved and available to Java VM by using the System.setProperty() call on each of them (with its name and value derived from the corresponding attributes of the element). This is analogous to sending the elements as -D parameters on the Java command line.

This subcommand is supported in remote mode only.

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

--target target

Specifies the target on which you are creating the system properties.

Type: String

The following values can be specified:

• server

  Creates the properties on the default server instance. This is the default value.

• domain

  Creates the properties for all server instances in the default domain.

• configuration-name

  Creates the properties in the specified configuration.

• cluster-name

  Creates the properties on all the server instances in the specified cluster.

• instance_name

  Creates the properties on a specified server instance.

Default value: server

name=value[:name=value]...]

Specifies the name value pairs of the system properties to be added to the specified target. For name=value operand, multiple system properties must be separated by a colon (:). If a colon (:) appears in the name or value of a system property, it must be escaped with a backslash (\).

Type: String

The following values can be specified:

• Name-value pairs of the system properties

Default value: N/A

asadmin create-system-properties --target myserver http-listener-port=1088

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. When these options are specified, the log configuration (config.properties) of Message Queue is affected.

• java.util.logging.FileHandler.count

• java.util.logging.FileHandler.limit

• java.util.logging.FileHandler.level

• java.util.logging.FileHandler.pattern