test

Sun Java System Application Server Platform Edition 8.2 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. This section explains what command-line tools are available.

To launch a tool, type the name of the tool in a command window. This table lists tools in the first column and describes them in the second column.

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. 

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

deploytool

Creates deployment descriptors for J2EE applications, packages them into JAR, Web archive (WAR), and enterprise archive (EAR) files, and deploys them on the server. 

This tool also provides a graphical user interface. 

jspc

Compiles JSP pages. 

package-appclient

Packages the application client container libraries and JAR files. 

verifier

Validates the J2EE 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. 

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.

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