The sun-appserv-admin Task
Enables arbitrary administrative commands and scripts to be
executed on the Application Server. This is useful for cases where a specific
Ant task has not been developed or a set of related commands are in
a single script.
Attributes of sun-appserv-admin
The following table describes attributes for the sun-appserv-admin task.
Table 3–7 The
sun-appserv-admin Attributes
|
Attribute
|
Default
|
Description
|
|
command
|
none
|
(exactly one of these is required: command or explicitcommand) The command to execute. If the user, passwordfile, host, or port attributes
are also specified, they are automatically inserted into the command
before execution. If any of these options are specified in the command
string, the corresponding attribute values are ignored.
|
|
explicitcommand
|
none
|
(exactly one of these is required: command or explicitcommand) The exact command to execute. No command
processing is done, and all other attributes are ignored.
|
|
user
|
admin
|
(optional) The user name used when logging into the application
server.
|
|
passwordfile
|
none
|
(optional) File containing passwords. The password from this
file is retrieved for communication with the application server.
|
|
host
|
localhost
|
(optional) Target server. If it is a remote server, use the
fully qualified host name.
|
|
port
|
4848
|
(optional) The administration port on the target server.
|
|
asinstalldir
|
see description
|
(optional) The installation directory for the local Application Server installation,
which is used to find the administrative classes. If not specified,
the command checks if the asinstalldir parameter
has been set. Otherwise, administrative classes must be in the system
classpath.
|
Examples of sun-appserv-admin
Here is an example of executing the create-jms-dest command:
<sun-appserv-admin command="create-jms-dest --desttype topic">
Here is an example of using explicitcommand to
execute the create-jms-dest command:
<sun-appserv-admin command="create-jms-dest --user adminuser --host localhost
--port 4848 --desttype topic --target server1 simpleJmsDest">