2.6.6 create-prf

The create-prf subcommand creates a Performance Tracer (PRF) server in the domain.

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

General user

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.)

Examples

The following example creates a PRF server named PRF1:

asadmin create-prf --node localhost-domain1 PRF1

The following example creates a PRF server by specifying a standard property:

asadmin create-prf --node localhost-domain1 --properties trace-file-size=65536 
PRF1

The following example creates a PRF server by specifying the directory of the server template:

asadmin create-prf --node localhost-domain1 --template C:\temp\PRF1 PRF1

Exit Status

Exit Status	Explanation
`0`	Normal termination.
`1`	Abnormal termination.

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.

To Page Top