Sun GlassFish Enterprise Server v2.1.1 Quick Start Guide

Administration Tools

To enable administrators to manage server instances and clusters running on multiple hosts, Enterprise Server provides these tools:

The Admin Console, a browser-based graphical user interface (GUI). You can launch the Admin console by opening http:// hostname:4848 in your browser.
Command-line tools, such as the asadmin utility. See Table 1–1 for the complete list of command-line tools. The asadmin utility is at as-install/bin.
Programmatic Java Management Extensions (JMX^TM) APIs

These tools connect to a server called the Domain Administration Server, a specially designated instance that intermediates in all administrative tasks. The Domain Administration Server (DAS) provides a single secure interface for validating and executing administrative commands regardless of which interface is used.

A domain is a collection of configuration data, deployed applications, and machines with a designated administrator. The domain definition describes and can control the operation of several applications, stand-alone instances, and clusters, potentially spread over multiple machines. When the DAS is installed, a default domain called domain1 is always installed. You work with the default domain in this guide.

Enterprise Server 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. Table 1–1 lists tools by name in the first column and describes them in the second column.

Table 1–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`	Launches the Enterprise Server administration tool that provides a set of subcommands for configuring the Enterprise 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`	Enterprise Server administration tool for upgrading the Enterprise 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 Enterprise Server verifier, you must be in the `as-install/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.

Note –

To run these command-line tools on Windows, ensure that you have an environment variable called PATH that points to the as-install/bin/ directory.
You can run the asadmin subcommands by prefixing asadmin with every sub command or by entering the asadmin prompt (type asadmin and hit Return) in the as-install/bin/ directory.