Sun Java System Application Server Platform Edition 9 Developer's Guide

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">