2.6.6 create-prf

Synopsis

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

Storage location

Application Server installation directory\javaee\glassfish\bin

Function

The create-prf subcommand creates a PRF server in the domain.

This subcommand is supported only in the remote mode.

Execution permission

Standard user account

Precondition

The node has been created.

Files

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

domain_root_directory/domain_name /server_templates/prf

Arguments

--node node_name

Specifies the node in which the PRF server is 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 names and values in pairs with the standard properties or extended properties of the PRF server. The syntax is name=value. You can specify multiple values separated by a colon (:). If the same property name is specified multiple times, then the later-specified property name is used.

name

Type: String

You can specify the following values:

• A PRF standard property or extended property that begins with ex_.

value

You can specify the following values:

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

Default value: For a standard property, which is not specified for this option, the value in the PRF default configuration (the configuration name default-prf-config) is applied.

--template prf_templatedir

Specifies the absolute path of the directory storing the PRF server template.

Type: String

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

The following path is the default value of this attribute:

domain_root_directory/domain_name/server_templates/prf

prf_name

Specifies the name of the PRF server to be created.

Type: String

You can specify a value based on the following conventions:

• Within 31 ASCII characters.

• The name can be contain the following characters:

  Lowercase letters: a to z

  Uppercase letters: A to Z

  Numbers: 0 to 9

  Underscore: _

• The first character can either be an uppercase or a lowercase letter. However, you cannot specify the following values with a combination of both uppercase and lowercase letters:

  TSC

  CTM

• 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 the Java EE server

• 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 PRF server has already been created on the host of the configuration destination node by using another domain, do not create the PRF with the same name.