Sun GlassFish Enterprise Server 2.1 Administration Guide

Configuration Commands

The configuration commands allow you to construct IIOP listeners, lifecycle modules, HTTP and IIOP listeners, profilers, and other subsystems.

This section contains the following topics:

HTTP and IIOP Listener Commands

The HTTP and IIOP listener commands help you manage listeners. These commands are supported in remote mode only.

Table C–8 IIOP Listener Commands

Command 

Definition 

create-http-listener

Adds a new HTTP listener socket. 

delete-http-listener

Removes the specified HTTP listener. 

list-http-listeners

Lists the existing HTTP listener. 

create-iiop-listener

Creates an IIOP listener. 

delete-iiop-listener

Removes the specified IIOP listener. 

list-iiop-listeners

Lists the existing IIOP listeners. 

Lifecycle and Audit Module Commands

The lifecycle and audit module commands help you control lifecycle modules and optional plugin modules which implement audit capabilities. The commands are supported in remote mode only.

Table C–9 Lifecycle Module Commands

Command 

Definition 

create-lifecycle-module

Creates a lifecycle module. The lifecycle modules provide a means of running short or long duration Java-based tasks within the application server environment. 

delete-lifecycle-module

Removes the specified lifecycle module. 

list-lifecycle-modules

Lists the existing lifecycle module. 

create-audit-module

Adds the named audit module for the plug-in module that implements the audit capabilities. 

delete-audit-module

Removes the named audit module. 

list-audit-modules

Lists all the audit modules. 

Profiler and SSL Commands

The Profiler and SSL commands allow you to administrate profilers and SSL client configurations. These commands are supported in remote mode only.

Table C–10 Profiler and SSL Commands

Command 

Definition 

create-profiler

Creates the profiler element. A server instance is tied to a particular profiler, by the profiler element in the Java configuration. Changing a profiler requires you to restart the server. 

delete-profiler

Deletes the profiler element you specify. A server instance is tied to a particular profiler by the profiler element in the Java configuration. Changing a profiler requires you to restart the server. 

create-ssl

Creates and configures the SSL element in the selected SIP/ HTTP/ IIOP listener, or IIOP service to enable secure communication on that listener/service. 

delete-ssl

Deletes the SSL element in the selected SIP/ HTTP/ IIOP listener, or IIOP service. 

JVM Options and Virtual Server Commands

The JVM options and Virtual Server commands allow you to control these elements. These commands are supported in remote mode only.

Table C–11 JVM Options and Virtual Server Commands

Command 

Definition 

create-jvm-option

Creates JVM options in the Java configuration or profiler elements of the domain.xml file. If JVM options are created for a profiler, they are used to record the settings needed to get a particular profiler going. You must restart the server for newly created JVM options to take effect.

delete-jvm-option

Removes JVM options from the Java configuration or profiler elements of the domain.xml file.

create-virtual-server

Creates the named virtual server. Virtualization in the Application Server allows multiple URL domains to be served by a single HTTP server process that is listening on multiple host addresses. If the application is available at two virtual servers, they still share the same physical resource pools. 

delete-virtual-server

Removes the virtual server with the specified virtual server ID. 

Threadpool and Auth-Realm Commands

The threadpool and auth-realm commands allow you to control these elements. These commands are supported in remote mode only.

Table C–12 Threadpool and Auth-Realm Commands

Command 

Definition 

create-threadpool

Creates a threadpool with the specified name. You can specify maximum and minimum number of threads in the pool, the number of work queues, and the idle timeout of a thread. The created thread pool can be used for servicing IIOP requests and for resource adapters to service work management requests. A created thread pool can be used in multiple resource adapters. 

delete-threadpool

Removes the threadpool with the named ID. 

list-threadpools

Lists all the thread pools. 

create-auth-realm

Adds the named authentication realm. 

delete-auth-realm

Removes the named authentication realm. 

Transaction and Timer Commands

The transaction and timer commands allow you to control the transaction and timer subsystems; allowing you to suspend any inflight transactions. These commands are supported in remote mode only.

Table C–13 Transaction Commands

Command 

Definition 

freeze-transaction

Freezes the transaction subsystem during which time all the inflight transactions are suspended. Invoke this command before rolling back any inflight transactions. Invoking this command on an already frozen transaction subsystem has no effect. 

unfreeze-transaction

Resumes all the suspended inflight transactions. Invoke this command on an already frozen transaction. 

recover-transactions

Manually recovers pending transactions. 

rollback-transaction

Rolls back the named transaction. 

unpublish-from-registry

 

list-timers

Lists the timers owned by a specific server instance  

Registry Commands

The registry commands allow you to publish or unpublish webservice artifacts.

Table C–14 Transaction Commands

Command 

Definition 

publish-to-registry

Publishes the web service artifacts to registries. 

unpublish-from-registry

Unpublishes the web service artifacts from the registries. 

list-registry-locations