Attributes of sun-appserv-component

The following table describes attributes for the sun-appserv-component task.

Table 3–8 The sun-appserv-component Attributes

Attribute

Default

Description

action

none

The control command for the target server instance.
Valid values are enable and disable.

name

file name without extension

(optional if a component or fileset subelement
is present or the file attribute is specified,
otherwise required) The display name for the component being enabled
or disabled.

file

none

(optional) The component to enable or disable. If this attribute
refers to a file, it must be a valid archive. If this attribute refers
to a directory, it must contain a valid archive in which all components
have been exploded.

user

admin

(optional) The user name used when logging into the GlassFish Server administration
instance. This attribute is inherited by nested server elements.

passwordfile

none

(optional) File containing passwords. The password from this
file is retrieved for communication with the GlassFish Server administration
instance. This attribute is inherited by nested server elements.

host

localhost

(optional) Target server. When enabling or disabling a remote
server, use the fully qualified host name. This attribute is inherited
by nested server elements.

port

4848

(optional) The administration port on the target server. This
attribute is inherited by nested server elements.

(optional) The installation directory for the local GlassFish Server installation,
which is used to find the administrative classes. If not specified,
the command checks to see if the asinstalldir parameter
has been set. Otherwise, administrative classes must be in the system
classpath.

Components can be enabled or disabled on multiple servers in
a single task. This example shows the same three components being
enabled on two different instances of the GlassFish Server. In this example,
the passwords for both instances are the same.