29/29

# A Subcommands for the `asadmin` Utility

This appendix lists the `asadmin` subcommands that are included with this release of the Oracle GlassFish Server 3.1.2 software.

- General Administration Subcommands

- Connectivity Subcommands

- Domain Subcommands

- Internet Connectivity Subcommands

- JavaMail Subcommands

- JMS Subcommands

- JNDI Subcommands

- JVM Subcommands

- Life Cycle Module Subcommands

- Logging and Monitoring Subcommands

- ORB Subcommands

- Thread Pool Subcommands

- Transaction Service Subcommands

For information and instructions on using the `asadmin` application deployment subcommands, see the Oracle GlassFish Server Application Deployment Guide.

Online help for the `asadmin` subcommands can be invoked on the command line, for example, `asadmin create-domain` `help`. The Oracle GlassFish Server Reference Manual also provides a collection of these help pages.

Note:

The common options used with remote subcommands are described in the `asadmin`(1M) help page.

## General Administration Subcommands

`add-resources`

  Creates the resources named in the specified XML file. Supported in remote mode only. For procedural information in this guide, see To Add Resources From an XML File.

`asadmin`

  Describes how the `asadmin` utility works.

`create-service`

  Configures the starting of a domain administration server (DAS) on an unattended boot. On Oracle Solaris 10, this subcommand uses the Service Management Facility (SMF). For procedural information in this guide, see To Configure a DAS or an Instance for Automatic Restart on Oracle Solaris.

`create-system-properties`

  Creates or updates system properties. Supported in remote mode only. For procedural information in this guide, see To Create System Properties.

`delete-system-property`

  Deletes system properties of a domain or configuration, or server instance. Supported in remote mode only. For procedural information in this guide, see To Delete a System Property.

`get`

  Gets an attribute of an element in the `domain.xml` file. With the `-m` option, gets the names and values of the monitorable or configurable attributes. For procedural information in this guide, see Guidelines for Using the `list` and `get` Subcommands for Monitoring.

`list`

  Lists the configurable element. On Oracle Solaris, quotes are needed when running subcommands with `*` as the option value or operand. For procedural information in this guide, see Guidelines for Using the `list` and `get` Subcommands for Monitoring.

`list-commands`

  Lists all the `asadmin` subcommands, local subcommands first, then remote subcommands. You can specify that only remote subcommands or only local subcommands be displayed. Supported in remote mode only. For procedural information in this guide, see To List Subcommands.

`list-containers`

  Lists application containers and the status of each container. Supported in remote mode only. For procedural information in this guide, see To List Containers.

`list-modules`

  Lists modules that are accessible to the GlassFish Server subsystem. The status of each module is included. Supported in remote mode only. For procedural information in this guide, see To List Modules.

`list-system-properties`

  Lists the system properties of a domain or configuration Supported in remote mode only. For procedural information in this guide, see To List System Properties.

`list-timers`

  List the timers owned by a specific server instance. Supported in remote mode only. For procedural information in this guide, see To List Timers.

`multimode`

  Provides an `asadmin>` prompt for running multiple subcommands while preserving options and environment settings. Supported in local mode only. For procedural information, see Using the `asadmin` Utility.

`set`

  Sets the values of one or more configurable attributes. For procedural information in this guide, see Configuring Monitoring.

`show-component-status`

  Lists the status of existing components. Supported in remote mode only. For procedural information in this guide, see To Show Component Status.

`start-database`

  Starts the Java DB server. Use this subcommand only for working with applications deployed to the GlassFish Server. For procedural information in this guide, see To Start the Database.

`stop-database`

  Stops a process of the Java DB database server. For procedural information in this guide, see To Stop the Database.

`version`

  Displays the version information for the option specified in archive or folder format. Supported in remote mode only. For procedural information in this guide, see To Display the GlassFish Server Version.

## Connectivity Subcommands

`create-admin-object`

  Creates an administered object. For procedural information in this guide, see To Create an Administered Object.

`create-connector-connection-pool`

  Adds a new connector connection pool with the specified connection pool name. For procedural information in this guide, see To Create a Connector Connection Pool.

`create-connector-resource`

  Creates a connector resource. For procedural information in this guide, see To Create a Connector Resource.

`create-connector-security-map`

  Creates a connector security map for the specified connector connection pool. For procedural information, see To Create a Connector Security Map.

`create-connector-work-security-map`

  Creates a connector work security map for the specified resource adapter. Supported in remote mode only. For procedural information in this guide, see To Create a Connector Work Security Map.

`create-jdbc-resource`

  Creates a new JDBC resource. Supported in remote mode only. For procedural information in this guide, see To Create a JDBC Resource.

`create-jdbc-connection-pool`

  Registers a new JDBC connection pool with the specified JDBC connection pool name. Supported in remote mode only. For procedural information in this guide, see To Create a JDBC Connection Pool.

`create-resource-adapter-config`

  Creates configuration information for the connector module. Supported in remote mode only. For procedural information in this guide, see To Create Configuration Information for a Resource Adapter.

`delete-admin-object`

  Deletes an administered object. For procedural information in this guide, see To Delete an Administered Object.

`delete-connector-connection-pool`

  Removes the connector connection pool specified using the `connector_connection_pool_name` operand. For procedural information in this guide, see To Delete a Connector Connection Pool.

`delete-connector-resource`

  Deletes connector resource. For procedural information in this guide, see To Delete a Connector Resource.

`delete-connector-security-map`

  Deletes a specified connector security map. Supported in remote mode only. For procedural information in this guide, see To Delete a Connector Security Map.

`delete-connector-work-security-map`

  Deletes a specified connector work security map. Supported in remote mode only. For procedural information in this guide, see To Delete a Connector Work Security Map.

`delete-jdbc-connection-pool`

  Deletes the specified JDBC connection pool. Supported in remote mode only. For procedural information in this guide, see To Delete a JDBC Connection Pool.

`delete-jdbc-resource`

  Deletes a JDBC resource. The specified JNDI name identifies the resource to be deleted. Supported in remote mode only. For procedural information in this guide, see To Delete a JDBC Resource.

`delete-resource-adapter-config`

  Deletes configuration information for the connector module. Supported in remote mode only. For procedural information in this guide, see To Delete a Resource Adapter Configuration.

`flush-connection-pool`

  Reintializes all connections established in the specified connection. For procedural information in this guide, see To Reset (Flush) a Connection Pool.

`list-admin-objects`

  Lists administered objects. For procedural information in this guide, see To List Administered Objects.

`list-connector-connection-pools`

  Lists the connector connection pools that have been created. For procedural information in this guide, see To List Connector Connection Pools.

`list-connector-resources`

  Creates connector resources. For procedural information in this guide, see To List Connector Resources.

l`list-connector-security-maps`

  Lists the connector security maps belonging to a specified connector connection pool. For procedural information in this guide, see To List Connector Security Maps.

`list-connector-work-security-maps`

  Lists the existing connector work security maps for a resource adapter. Supported in remote mode only. For procedural information in this guide, see To List Connector Work Security Maps.

`list-jdbc-connection-pools`

  Lists the existing JDBC connection pools. Supported in remote mode only. For procedural information in this guide, see To List JDBC Connection Pools.

`list-jdbc-resources`

  Lists the existing JDBC resources. Supported in remote mode only. For procedural information in this guide, see To List JDBC Resources.

`list-resource-adapter-configs`

  Lists configuration information for the connector modules. Supported in remote mode only. For procedural information in this guide, see To List Resource Adapter Configurations.

`ping-connection-pool`

  Tests if a JDBC connection pool is usable. Supported in remote mode only. For procedural information in this guide, see To Contact (Ping) a Connection Pool.

`update-connector-security-map`

  Modifies a security map for the specified connector connection pool. For procedural information in this guide, see To Update a Connector Security Map.

`update-connector-work-security-map`

  Modifies a work security map that belongs to a specific resource adapter (connector module). For procedure information in this guide, see To Update a Connector Work Security Map.

## Domain Subcommands

`backup-domain`

  Describes how to back up a domain. Supported in local mode only. For procedural information in this guide, see To Back Up a Domain.

`create-domain`

  Creates the configuration of a domain. A domain can exist independent of other domains. Any user who has access to the `asadmin` utility on a given host can create a domain and store its configuration in a location of choice. For procedural information in this guide, see To Create a Domain.

`delete-domain`

  Deletes the specified domain. The domain must be stopped before it can be deleted. For procedural information in this guide, see To Delete a Domain.

`list-backups`

  Lists the existing domain backups. Supported in local mode only. For procedural information in this guide, see To List Domain Backups.

`list-domains`

  Lists the existing domains and their statuses. If the domain directory is not specified, the domains in the domain-root-dir, the default for which is as-install`/domains`, are displayed. For procedural information in this guide, see To List Domains.

`login`

  Allows you to log in to a domain. For procedural information in this guide, see To Log In to a Domain.

`restart-domain`

  Restarts the Domain Administration Server (DAS) of the specified domain. Supported in remote mode only. For procedural information in this guide, see To Restart a Domain.

`restore-domain`

  Recovers and domain from a backup file. Supported in local mode only. For procedural information in this guide, see To Restore a Domain.

`start-domain`

  Starts a domain. If the domain directory is not specified, the default `domain1` in the default domain-root-dir directory is started. If there are two or more domains, the domain_name operand must be specified. For procedural information in this guide, see To Start a Domain.

`stop-domain`

  Stops the domain administration server (DAS) of the specified domain. Supported in remote mode only. For procedural information in this guide, see To Stop a Domain.

`uptime`

  Displays the length of time that the domain administration server (DAS) has been running since the last restart. Supported in remote mode only. For procedural information in this guide, see To Display Domain Uptime.

## Internet Connectivity Subcommands

`create-http`

  Creates a set of HTTP parameters for a protocol, which in turn configures one or more network listeners. Supported in remote mode only. For procedural information in this guide, see To Create an HTTP Configuration.

`create-http-listener`

  Creates a new HTTP listener socket. Supported in remote mode only. For procedural information in this guide, see To Create an Internet Connection.

`create-network-listener`

  Creates a new HTTP listener socket. Supported in remote mode only. For procedural information in this guide, see To Create an Internet Connection.

`create-protocol`

  Creates a protocol for a listener. Supported in remote mode only. For procedural information in this guide, see To Create a Protocol.

`create-transport`

  Creates a transport for a listener. Supported in remote mode only. For procedural information in this guide, see To Create a Transport.

`create-virtual-server`

  Creates the specified virtual server element. Supported in remote mode only. For procedural information in this guide, see To Create a Virtual Server.

`create-ssl`

  Creates and configures the SSL element in the selected HTTP listener to enable secure communication on that listener/service. Supported in remote mode only. For procedural information in this guide, see To Configure an HTTP Listener for SSL.

`delete-http`

  Deletes an existing HTTP configuration. Supported in remote mode only. For procedural information in this guide, see To Delete an HTTP Configuration.

`delete-http-listener`

  Deletes the specified HTTP listener. Supported in remote mode only. For procedural information in this guide, see To Delete an HTTP Network Listener.

`delete-network-listener`

  Deletes the specified HTTP listener. Supported in remote mode only. For procedural information in this guide, see To Delete an HTTP Network Listener.

`delete-protocol`

  Deletes and existing HTTP protocol. Supported in remote mode only. For procedural information in this guide, see To Delete a Protocol.

`delete-ssl`

  Deletes the SSL element in the selected HTTP listener. Supported in remote mode only. For procedural information in this guide, see To Delete SSL From an HTTP Listener.

`delete-transport`

  Deletes and existing HTTP transport. Supported in remote mode only. For procedural information in this guide, see To Delete a Transport.

`delete-virtual-server`

  Deletes the specified virtual server element. Supported in remote mode only. For procedural information in this guide, see To Delete a Virtual Server.

`list-http-listeners`

  Lists the existing HTTP listeners. Supported in remote mode only. For procedural information in this guide, see To List HTTP Network Listeners.

`list-network-listeners`

  Lists the existing HTTP listeners. Supported in remote mode only. For procedural information in this guide, see To List HTTP Network Listeners.

`list-protocols`

  Lists the existing HTTP protocols. Supported in remote mode only. For procedural information in this guide, see To List Protocols.

`list-transports`

  Lists the existing HTTP transports. Supported in remote mode only. For procedural information in this guide, see To List Transports.

`list-virtual-servers`

  Lists the existing virtual servers. Supported in remote mode only. For procedural information in this guide, see To List Virtual Servers.

## JavaMail Subcommands

`create-javamail-resource`

  Creates a JavaMail session resource. Supported in remote mode only. For procedural information in this guide, see To Create a JavaMail Resource.

`delete-javamail-resource`

  Deletes a JavaMail session resource. Supported in remote mode only. For procedural information in this guide, see To Delete a JavaMail Resource.

`list-javamail-resources`

  Creates JavaMail session resources. Supported in remote mode only. For procedural information in this guide, see To List JavaMail Resources.

## JMS Subcommands

`create-jmsdest`

  Creates a JMS physical destination. Along with the physical destination, you use the `create-jms-resource` subcommand to create a JMS destination resource that has a `Name` property that specifies the physical destination. Supported in remote mode only. For procedural information in this guide, see To Create a JMS Physical Destination.

`create-jms-host`

  Creates a JMS host within the JMS service. Supported in remote mode only. For procedural information in this guide, see To Create a JMS Host.

`create-jms-resource`

  Creates a JMS connection factory resource or JMS destination resource. Supported in remote mode only. Supported in remote mode only. For procedural information in this guide, see To Create a Connection Factory or Destination Resource.

`delete-jmsdest`

  Removes the specified JMS destination. Supported in remote mode only. For procedural information in this guide, see To Delete a JMS Physical Destination.

`delete-jms-host`

  Deletes a JMS host within the JMS service. Supported in remote mode only. For procedural information in this guide, see To Delete a JMS Host.

`delete-jms-resource`

  Deletes a JMS connection factory resource or JMS destination resource. Supported in remote mode only. For procedural information in this guide, see To Delete a Connection Factory or Destination Resource.

`flush-jmsdest`

  Purges the messages from a physical destination in the specified JMS Service configuration of the specified target. Supported in remote mode only. For procedural information in this guide, see To Purge Messages From a Physical Destination.

`jms-ping`

  Checks if the JMS service (also known as the JMS provider) is up and running. Supported in remote mode only. For procedural information in this guide, see Troubleshooting the JMS Service.

`list-jmsdest`

  Lists the JMS physical destinations. Supported in remote mode only. For procedural information in this guide, see To List JMS Physical Destinations.

`list-jms-hosts`

  Lists the existing JMS hosts. Supported in remote mode only. For procedural information in this guide, see To List JMS Hosts.

`list-jms-resources`

  Lists the existing JMS connection factory or destination resources. Supported in remote mode only. For procedural information in this guide, see To List JMS Resources.

## JNDI Subcommands

`create-custom-resource`

  Creates a custom JNDI resource. Supported in remote mode only. For procedural information in this guide, see To Create a Custom JNDI Resource.

`create-jndi-resource`

  Creates an external JNDI resource. Supported in remote mode only. For procedural information in this guide, see To Register an External JNDI Resource.

`delete-custom-resource`

  Deletes a custom JNDI resource. Supported in remote mode only. For procedural information in this guide, see To Delete a Custom JNDI Resource.

`delete-jndi-resource`

  Deletes an external JNDI resource. Supported in remote mode only. For procedural information in this guide, see To Delete an External JNDI Resource.

`list-custom-resources`

  Lists the existing custom JNDI resources. Supported in remote mode only. For procedural information in this guide, see To List Custom JNDI Resources.

`list-jndi-entries`

  Lists the entries in the JNDI tree. Supported in remote mode only. For procedural information in this guide, see To List External JNDI Entries,

`list-jndi-resources`

  Lists the existing external JNDI resources. Supported in remote mode only. For procedural information in this guide, see To List External JNDI Resources.

## JVM Subcommands

`create-jvm-options`

  Creates a JVM option in the Java configuration or profiler elements of the `domain.xml` file. Supported in remote mode only. For procedural information in this guide, see To Create JVM Options.

`create-profiler`

  Creates a profiler element. Supported in remote mode only. For procedural information in this guide, see To Create a Profiler.

`delete-jvm-options`

  Deletes the specified JVM option from the Java configuration or profiler elements of the `domain.xml` file. Supported in remote mode only. For procedural information in this guide, see To Delete JVM Options.

`delete-profiler`

  Deletes the specified profiler element. Supported in remote mode only. For procedural information in this guide, see To Delete a Profiler.

`generate-jvm-report`

  Generates a report showing the threads, classes, and memory for the virtual machine that runs GlassFish Server. For procedural information in this guide, see To Generate a JVM Report.

`list-jvm-options`

  Lists the command-line options that are passed to the Java application launcher when GlassFish Server is started. Supported in remote mode only. For procedural information in this guide, see To List JVM Options.

## Life Cycle Module Subcommands

`create-lifecycle-module`

  Creates a new life cycle module. Supported in remote mode only. For procedural information in this guide, see To Create a Life Cycle Module.

`list-lifecycle-modules`

  Lists life cycle modules. Supported in remote mode only. For procedural information in this guide, see To List Life Cycle Modules.

`delete-lifecycle-module`

  Deletes an existing life cycle module. Supported in remote mode only. For procedural information in this guide, see To Delete a Life Cycle Module.

## Logging and Monitoring Subcommands

`collect-log-files`

  Collects all available log files and creates a ZIP archive. Supported in remote mode only. For procedural information in this guide, see To Collect Log Files into a ZIP Archive.

`disable-monitoring`

  Disables the monitoring service. Supported in remote mode only. For procedural information in this guide, see To Disable Monitoring.

`enable-monitoring`

  Enables the monitoring service. Supported in remote mode only. For procedural information in this guide, see To Enable Monitoring.

`list-log-attributes`

  Lists log file attributes. Supported in remote mode only. For procedural information in this guide, see Configuring the Logging Service.

`list-log-levels`

  Lists the existing loggers. Supported in remote mode only. For procedural information in this guide, see To List Log Levels.

`monitor`

  Displays monitoring information for the common GlassFish Server resources. Supported in remote mode only. For procedural information in this guide, see To View Common Monitoring Data.

`rotate-log`

  Rotates the `server.log` file and stores the old data in a time-stamped file. Supported in remote mode only. For procedural information in this guide, see To Rotate Log Files Manually.

`set-log-attributes`

  Sets log file attributes. Supported in remote mode only. For procedural information in this guide, see Configuring the Logging Service.

`set-log-levels`

  Sets the log level for a module. Supported in remote mode only. For procedural information in this guide, see Setting Log Levels.

## ORB Subcommands

`create-iiop-listener`

  Creates an IIOP listener. Supported in remote mode only. For procedural information in this guide, see To Create an IIOP Listener.

`delete-iiop-listener`

  Deletes an IIOP listener. Supported in remote mode only. For procedural information in this guide, see To Delete an IIOP Listener.

`list-iiop-listeners`

  Lists the existing IIOP listeners. Supported in remote mode only. For procedural information in this guide, see To List IIOP Listeners.

## Thread Pool Subcommands

`create-threadpool`

  Creates a new thread pool. Supported in remote mode only. For procedural information in this guide, see To Create a Thread Pool.

`delete-threadpool`

  Deletes the specified thread pool. Supported in remote mode only. For procedural information in this guide, see To Delete a Thread Pool.

`list-threadpools`

  Lists the existing thread pools. Supported in remote mode only. For procedural information in this guide, see To List Thread Pools.

## Transaction Service Subcommands

`freeze-transaction-service`

  Freezes the transaction subsystem during which time all the in-flight transactions are suspended. Supported in remote mode only. For procedural information, see To Stop the Transaction Service.

`recover-transactions`

  Manually recovers pending transactions. Supported in remote mode only. For procedural information, see To Manually Recover Transactions.

`rollback-transaction`

  Rolls back the named transaction. Supported in remote mode only. For procedural information, see To Roll Back a Transaction.

`unfreeze-transaction-service`

  Resumes all the suspended in-flight transactions. Invoke this subcommand on an already frozen transaction. Supported in remote mode only. For procedural information, see To Restart the Transaction Service.