en.help.ref-clusternew.html Maven / Gradle / Ivy
Show all versions of console-cluster-plugin Show documentation
New Cluster
Use the New Cluster page to create a cluster.
The New Cluster page contains the following options.
- Cluster Name
The name of the cluster.
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 cluster, a named configuration, a GlassFish Server instance , or a node.
The name must not be domain, server, or any other keyword that is reserved by GlassFish Server.
- Configuration
Drop-down list of existing named configurations that the cluster can use. A cluster requires a named configuration that defines the configuration of all instances that are added to the cluster. One configuration must be selected from the list. The cluster will use the selected configuration when the cluster is created.
- Make a Copy of the Selected Configuration
If this option is selected, the selected configuration is copied when the cluster is created. The copy of the configuration is assigned the name cluster-name-config, where cluster-name is the name of the cluster as typed in the Cluster Name field.
If default-config is selected from the Configuration drop-down list, you must select this option. The default-config configuration can only be copied, not referenced.
- Reference the Selected Configuration
If this option is selected, the cluster will use the specified existing named configuration.
If default-config is selected from the Configuration drop-down list, you must not select this option. The default-config configuration cannot be referenced, only copied.
- Server Instances to be Created
A list of GlassFish Server instances that are to be created when the cluster is created. For each instance, the following information is provided:
- Instance Name
The name of the instance.
- Weight
An integer that represents the load-balancing weight of the instance.
The load-balancing weight determines the proportion of all requests to the cluster that the instance should process.
For example, in a two-instance cluster, you might require one instance to process one out of four requests, and the other instance to process three out of four requests. In this situation, set the weight of the instance that is process one out of four requests to 1 and set the weight of the other instance to 3. If you prefer to use percentages, set the weights of the instances to 25 and 75 respectively.
The default weight is 100.
- Node
Drop-down list of existing nodes where the instance can reside. One node must be selected from the list. The instance will reside on the selected node when the cluster is created.
The Server Instances to be Created table also contains the following options.
- New
Button to create an instance. Clicking this button adds a row to the Server Instances to be Created table.
- Delete
Button to delete an instance.
Related Tasks
Equivalent asadmin Subcommand
Copyright © 2005, 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices