2.6.7 create-webserver

Synopsis

asadmin [asadmin_options] create-webserver --node node_name
    [--properties name=value[:name=value]...]
    [--template webserver_templatedir]
    [--prf prf_name] webserver_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-webserver subcommand creates a web server in the domain.

This subcommand is supported only in the remote mode.

Execution permission

General user

Precondition

The node has been created.

Files

Server template file for the web server (available for the --template option)

domain_root_directory/domain_name/server_templates/webserver

Arguments

--node node_name

Specifies the node in which the web server to be created.

Type: String

You can specify the following values:

• Name of a node that exists in the domain

Default value: (None. You must specify a value.)

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

Specifies the property name and value in pairs for the standard properties or extended properties of the web server.

The specified syntax is name=value. You can specify multiple values separated by a colon (:). If the same property name is specified multiple times, then the property name that is specified later is used.

name

Type: String

You can specify the following values:

• Web standard property or extended property that begins with ex_.

Default value: For a standard property, which is not specified in this option, the value of the web server default configuration (the configuration name default-webserver-config) is applied.

value

You can specify the following values:

• A value in the range of properties defined for the name option.

--template webserver_templatedir

Specifies the absolute path of the directory where the web server template is stored.

Type: String

Default value: The path that is set in the following attribute is applied: hitachi-webserver-configs.hitachi-webserver-config.default-webserver-config.hitachi-manage-info.template-path. The following path is the default value of this attribute:

domain_root_directory/domain_name/server_templates/webserver

--prf prf_name

Specifies the name of the PRF server used by the web server.

Type: String

You can specify the following values:

• Name of a PRF server that exists in the node specified by the --node option.

Default value: (None. No default value is specified.)

webserver_name

Specifies the name of the web server to be created.

Type: String

You can specify a value based on the following conventions.

• Within 128 ASCII characters.

• The name can contain the following characters:

  Lowercase letters: a to z

  Uppercase letters: A to Z

  Numbers: 0 to 9

  Hyphen: -

  Underscore: _

• The first character can either be an uppercase or a lowercase letter.

• The following names that exist in the domain cannot be specified:

  Node name

  Java EE server name

  Web server name

  PRF server name

  Cluster name

  Name of a dependency relation between servers

  Configuration name of Java EE servers

• The following names cannot be specified because they are either used by the system or are reserved words:

  domain

  server

  default

  server-config

  default-config

  default-webserver-config

  default-prf-config

  javaee

  webserver

  prf

  cluster

  redirect

  prf-relation

  Name that begins with HJES_

  pre_built_web_server_name-config

  pre_built_PRF_name-config

Default value: (None. You must specify a value.)

Exit Status

Notes

• If a web server is already created on the host of the configuration destination node by using another domain, do not create a web server with the same name.