com.sun.enterprise.v3.admin.cluster.copy-config.1 Maven / Gradle / Ivy

Go to download
copy-config(1)            asadmin Utility Subcommands           copy-config(1)

NAME
       copy-config - copies an existing named configuration to create another
       configuration

SYNOPSIS
           copy-config [--help]
           [--systemproperties (name=value)[:name=value]*]
           source-configuration-name destination-configuration-name

DESCRIPTION
       The copy-config subcommand creates a named configuration in the
       configuration of the domain administration server (DAS) by copying an
       existing configuration. The new configuration is identical to the
       copied configuration, except for any properties that you specify in the
       --systemproperties option.

       The default-config configuration is copied when a standalone sever
       instance or standalone cluster is created.

       This subcommand is supported in remote mode only.

OPTIONS
       --help, -?
           Displays the help text for the subcommand.

       --systemproperties
           Optional attribute name-value pairs for the configuration. These
           properties override port settings in the configuration.

           The following properties are available:

           ASADMIN_LISTENER_PORT
               This property specifies the port number of the HTTP port or
               HTTPS port through which the DAS connects to the instance to
               manage the instance. Valid values are 1-65535. On UNIX,
               creating sockets that listen on ports 1-1024 requires superuser
               privileges.

           HTTP_LISTENER_PORT
               This property specifies the port number of the port that is
               used to listen for HTTP requests. Valid values are 1-65535. On
               UNIX, creating sockets that listen on ports 1-1024 requires
               superuser privileges.

           HTTP_SSL_LISTENER_PORT
               This property specifies the port number of the port that is
               used to listen for HTTPS requests. Valid values are 1-65535. On
               UNIX, creating sockets that listen on ports 1-1024 requires
               superuser privileges.

           IIOP_LISTENER_PORT
               This property specifies the port number of the port that is
               used for IIOP connections. Valid values are 1-65535. On UNIX,
               creating sockets that listen on ports 1-1024 requires superuser
               privileges.

           IIOP_SSL_LISTENER_PORT
               This property specifies the port number of the port that is
               used for secure IIOP connections. Valid values are 1-65535. On
               UNIX, creating sockets that listen on ports 1-1024 requires
               superuser privileges.

           IIOP_SSL_MUTUALAUTH_PORT
               This property specifies the port number of the port that is
               used for secure IIOP connections with client authentication.
               Valid values are 1-65535. On UNIX, creating sockets that listen
               on ports 1-1024 requires superuser privileges.

           JAVA_DEBUGGER_PORT
               This property specifies the port number of the port that is
               used for connections to the Java Platform Debugger Architecture
               (JPDA)
               (https://docs.oracle.com/en/java/javase/17/docs/specs/jpda/jpda.html)
               debugger. Valid values are 1-65535. On UNIX, creating sockets
               that listen on ports 1-1024 requires superuser privileges.

           JMS_PROVIDER_PORT
               This property specifies the port number for the Java Message
               Service provider. Valid values are 1-65535. On UNIX, creating
               sockets that listen on ports 1-1024 requires superuser
               privileges.

           JMX_SYSTEM_CONNECTOR_PORT
               This property specifies the port number on which the JMX
               connector listens. Valid values are 1-65535. On UNIX, creating
               sockets that listen on ports 1-1024 requires superuser
               privileges.

           OSGI_SHELL_TELNET_PORT
               This property specifies the port number of the port that is
               used for connections to the Apache Felix Remote Shell
               (http://felix.apache.org/site/apache-felix-remote-shell.html).
               This shell uses the Felix shell service to interact with the
               OSGi module management subsystem. Valid values are 1-65535. On
               UNIX, creating sockets that listen on ports 1-1024 requires
               superuser privileges.

OPERANDS
       source-configuration-name
           The name of the configuration that you are copying.

       destination-configuration-name
           The name of the configuration that you are creating by copying the
           source configuration.

           The name must meet the following requirements:

           *   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 a another named configuration, a cluster, a GlassFish Server
               instance , or a node.

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

EXAMPLES
       Example 1, Copying a Configuration
           This example copies the default-config configuration to the
           pmdsaconfig configuration, overriding the settings for the
           following ports:

           *   HTTP listener port

           *   HTTPS listener port

               asadmin> copy-config
               --systemproperties HTTP_LISTENER_PORT=2000:HTTP_SSL_LISTENER_PORT=3000
               default-config pmdsaconfig

               Command copy-config executed successfully.

EXIT STATUS
       0
           command executed successfully

       1
           error in executing the command

SEE ALSO
       delete-config(1), list-configs(1)

       asadmin(1M)

Jakarta EE 10                         21 Aug 2017                   copy-config(1)