create-deployment-group

Creates a Payara Server deployment group.

Synopsis

asadmin [asadmin-options] create-deployment-group [--help]
name

Description

The create-deployment-group subcommand creates a Payara Server deployment group. Initially the deployment group contains no Payara Server instances, applications, or resources.

To add instances to the cluster, use the add-instance-to-deployment-group.

  • Deploying applications by using the deploy subcommand

  • Creating resources by using subcommands such as create-jdbc-resource

  • Creating references to applications that are already deployed in other targets by using the create-application-ref subcommand

  • Creating references to resources that are already created in other targets by using the create-resource-ref subcommand

This subcommand is supported in remote mode only.

Options

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin help page.

--help
-?

Displays the help text for the subcommand.

Operands

name

The name of the deployment group.

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

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

Examples

Example 1 Creating a Deployment Group

This example creates a deployment group that is named test-dgroup:

asadmin create-deployment-group test-dgroup
Command create-deployment-group executed successfully.