test

Sun Java System Application Server Platform Edition 9 Quick Start Guide

Using Command-Line Tools

The Application Server software offers a variety of command-line tools for performing administrative functions, in addition to the Admin Console. To launch a tool, type the name of the tool in a command window. This table lists tools by name in the first column and describes them in the second column.

Table 1 Command-Line Tools

Name of Tool 

Description 

appclient

Launches the Application Client Container and invokes the client application packaged in the application Java archive (JAR) file. 

asadmin

Application Server administration tool for configuring the Application Server software. 

asant

Launches the Jakarta Ant tool, so that you can automate repetitive development and deployment tasks. 

asapt

Compiles Java sources with Java EE annotations. The tool automatically invokes the wsimport command.

asupgrade

Application Server administration tool for upgrading the Application Server software. 

capture-schema

Extracts schema information from a database and produces a schema file that the server can use for Container Managed Persistence (CMP). 

jspc

Compiles JSP pages. 

package-appclient

Packages the application client container libraries and JAR files. 

schemagen

Creates a schema file for each namespace referenced in your Java classes. 

verifier

Validates the Java EE deployment descriptors with the DTDs. 

This tool also provides a graphical user interface. To see the GUI, specify the -u option.

Some Windows systems launch a driver verifier utility with the same name. To launch the Application Server verifier, you must be in the install-dir/bin directory.

wscompile

Takes the service definition interface and generates the client stubs or server-side skeletons for JAX-RPC; or generates a Web Services Description Language (WSDL) description for the provided interface. 

wsdeploy

Generates an implementation-specific, ready-to-deploy WAR file for web services applications that use JAX-RPC. 

wsgen

Reads a web service endpoint class and generates all the required artifacts for web service deployment and invocation. 

wsimport

Generates JAX-WS portable artifacts, such as service endpoint interfaces (SEIs), services, exception classes mapped from the wsdl:fault and soap:headerfault tags, asynchronous response beans derived from the wsdl:message tag, and JAXB generated value types.

xjc

Transforms, or binds, a source XML schema to a set of JAXB content classes in the Java programming language. 

ProcedureTo Configure the Windows Environment to Use the Command-Line Tools

  1. From the Explorer window or desktop, right-click My Computer.

  2. Choose Properties to display the System Properties dialog.

  3. Click the Advanced tab.

  4. Click Environment Variables.

  5. In the User variables section, add or update the PATH variable.

    • If a PATH variable exists:

      1. Click Edit.

      2. In Variable Value, enter the path to the server’s bin directory, separated from other entries by a semicolon. For example:

        install-dir/bin;other_entries

    • If a PATH variable is not present:

      1. Click New.

      2. In Variable Name, type PATH.

      3. In Variable Value, type the path to the server’s bin directory:

        install-dir/bin

  6. In the User variables section, add the environment variable AS_ADMIN_USER and set it to the administrative user name that you assigned during installation.

    If you set this variable, you do not need to enter the administrative user name when you run asadmin commands.

    Note –

    If you installed the server with the “Don't Prompt for Admin User Name” option selected, you do not need to create the AS_ADMIN_USER variable.

  7. Click OK to commit the change and close the remaining open windows.