2.6.3 copy-config

Synopsis

asadmin [asadmin-options] copy-config [--help]
    [--systemproperties name=value[:name=value]...]
    source-configuration-name destination-configuration-name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The copy-config subcommand of asadmin creates a configuration in the DAS by copying an existing configuration.

The new configuration is identical to the copied configuration, except for any properties that are specified in the --systemproperties option. The default-config configuration is copied when either a standalone sever instance or a standalone cluster is created.

This command is supported in remote mode only.

Precondition

• The DAS whose configuration is to copied must be running.

• The source configuration must exist before executing the copy-config subcommand.

Arguments

--help | -?

Displays the help text for the subcommand.

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

Displays the optional attribute name-value pairs for the configuration. These properties override the port settings in the configuration. The specification format is name=value. Use a colon (:) to separate property names. If you specify the same property name more than once, the property value specified last is valid.

On UNIX, creating sockets that listen on ports in the range of 1 to 1024 requires superuser privileges.

Type: String

The following values can be specified:

• ASADMIN_LISTENER_PORT=value

  This property specifies the port number of the HTTP or HTTPS ports through which the DAS connects to the instance to manage the instance. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• HTTP_LISTENER_PORT=value

  This property specifies the port number of the port that is used to listen for HTTP requests. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• HTTP_SSL_LISTENER_PORT=value

  This property specifies the port number of the port that is used to listen for HTTPS requests. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• IIOP_LISTENER_PORT=value

  This property specifies the port number of the port that is used for IIOP connections. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• IIOP_SSL_LISTENER_PORT=value

  This property specifies the port number of the port that is used for secure IIOP connections. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• IIOP_SSL_MUTUALAUTH_PORT=value

  This property specifies the port number of the port that is used for secure IIOP connections with client authentication. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• JAVA_DEBUGGER_PORT=value

  This property specifies the port number of the port that is used for connections to the Java Platform Debugger Architecture (JPDA) http://java.sun.com/javase/technologies/core/toolsapis/jpda/ debugger. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• JMS_PROVIDER_PORT=value

  This property specifies the port number for the Java Message Service provider. The valid values are in the range of 1 - 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

• JMX_SYSTEM_CONNECTOR_PORT=value

  This property specifies the port number on which the JMX connector listens. The valid values are in the range of 1 to 65535.

  Type: Integer

  Default value: N/A

  Range Value: 1 to 65535

Default value: N/A

source-configuration-name

Displays the name of the configuration that you are copying.

Type: String

The following values can be specified:

• Name of a source configuration to be copied

Default value: N/A

destination-configuration-name

Displays the name of the configuration that you are creating by copying the source configuration.

The value for destination-configuration-name must meet the following conditions:

The name may contain only ASCII characters.

The name must start with a letter, a number, or an underscore.

The name may contain only the following characters:

• Lowercase letters

• Uppercase letters

• Numbers

• Hyphen

• Period

• Underscore

The name must be unique in the domain and must not be the name of another node, a cluster, a named configuration, or a server instance.

The name must not be domain, server, or any other keyword that is reserved by Java EE Server.

Default value: None

Type: String

The following values can be specified:

• Name of a destination configuration to be created

asadmin copy-config default-config clusterpresets-config

Exit Status

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