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