Part IV Appendixes

Appendix A Subcommands for the `asadmin` Utility

This appendix lists the asadmin subcommands that are included with this release of the Sun GlassFish^TM Enterprise Server v3 software.

For information and instructions on using the asadmin application deployment subcommands, see Sun GlassFish Enterprise Server v3 Application Deployment Guide.

Online help for the asadmin subcommands can be invoked on the command line, for example, asadmin create-domain --help. The Sun GlassFish Enterprise Server v3 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(1): 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(1M): Describes how the asadmin utility works.
create-service(1): Configures the starting of a domain administration server (DAS) on an unattended boot. On Solaris 10, this subcommand uses the Service Management Facility (SMF). For procedural information in this guide, see To Automatically Restart a Domain on Solaris 10.
create-system-properties(1): Creates or updates system properties. Supported in remote mode only. For procedural information in this guide, see To Create System Properties.
delete-system-property(1): 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(1): 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(1): Lists the configurable element. On 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(1): 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(1): 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(1): Lists modules that are accessible to the Enterprise 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(1): 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(1): 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(1): 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(1): Sets the values of one or more configurable attributes. For procedural information in this guide, see Configuring Monitoring.
show-component-status(1): Lists the status of existing components. Supported in remote mode only. For procedural information in this guide, see To Show Component Status.
start-database(1): Starts the Java DB server. Use this subcommand only for working with applications deployed to the Enterprise Server. For procedural information in this guide, see To Start the Database.
stop-database(1): Stops a process of the Java DB database server. For procedural information in this guide, see To Stop the Database.
version(1): 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 Enterprise Server Version.

Connectivity Subcommands

create-admin-object(1): Creates an administered object. For procedural information in this guide, see To Create an Administered Object.
create-connector-connection-pool(1): 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(1): Creates a connector resource. For procedural information in this guide, see To Create a Connector Resource.
create-connector-security-map(1): 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(1): 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(1): 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(1): 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(1): 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(1): Deletes an administered object. For procedural information in this guide, see To Delete an Administered Object.
delete-connector-connection-pool(1): 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(1): Deletes connector resource. For procedural information in this guide, see To Delete a Connector Resource.
delete-connector-security-map(1): 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(1): 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(1): 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(1): 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(1): 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(1): Reintializes all connections established in the specified connection. For procedural information in this guide, see To Reset (Flush) a Connection Pool.
list-admin-objects(1): Lists administered objects. For procedural information in this guide, see To List Administered Objects.
list-connector-connection-pools(1): Lists the connector connection pools that have been created. For procedural information in this guide, see To List Connector Connection Pools.
list-connector-resources(1): Creates connector resources. For procedural information in this guide, see To List Connector Resources.
llist-connector-security-maps(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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

create-domain(1): 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(1): 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-domains(1): Lists the existing domains and their statuses. If the domain directory is not specified, the domains in the default as-install/domains directory is displayed. For procedural information in this guide, see To List Domains.
login(1): Allows you to log in to a domain. For procedural information in this guide, see To Log In to a Domain.
restart-domain(1): 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.
start-domain(1): Starts a domain. If the domain directory is not specified, the default domain1 in the default as-install/domains 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): Creates a protocol for a listener. Supported in remote mode only. For procedural information in this guide, see To Create a Protocol.
create-transport(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): Deletes and existing HTTP protocol. Supported in remote mode only. For procedural information in this guide, see To Delete a Protocol.
delete-ssl(1): 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(1): Deletes and existing HTTP transport. Supported in remote mode only. For procedural information in this guide, see To Delete a Transport.
delete-virtual-server(1): 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(1): 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(1): Lists the existing HTTP listeners. Supported in remote mode only. For procedural information in this guide, see To List HTTP Network Listeners.
list-protocols(1): Lists the existing HTTP protocols. Supported in remote mode only. For procedural information in this guide, see To List Protocols.
list-transports(1): Lists the existing HTTP transports. Supported in remote mode only. For procedural information in this guide, see To List Transports.
list-virtual-servers(1): 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(1): 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(1): 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(1): Creates JavaMail session resources. Supported in remote mode only. For procedural information in this guide, see To List JavaMail Resources.

JMS Subcommands

create-jmsdest(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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 JMS.
list-jmsdest(1): 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(1): Lists the existing JMS hosts. Supported in remote mode only. For procedural information in this guide, see To List JMS Hosts.
list-jms-resources(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): 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(1): Creates a profiler element. Supported in remote mode only. For procedural information in this guide, see To Create a Profiler.
delete-jvm-options(1): 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(1): Deletes the specified profiler element. Supported in remote mode only. For procedural information in this guide, see To Delete a Profiler.
generate-jvm-report(1): Generates a report showing the threads, classes, and memory for the virtual machine that runs Enterprise Server. For procedural information in this guide, see To Generate a JVM Report.
list-jvm-options(1): Lists the command-line options that are passed to the Java application launcher when Enterprise 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(1): 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(1): Lists life cycle modules. Supported in remote mode only. For procedural information in this guide, see To List Life Cycle Modules.
delete-lifecycle-module(1): 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

disable-monitoring(1): Disables the monitoring service. Supported in remote mode only. For procedural information in this guide, see To Disable Monitoring.
enable-monitoring(1): Enables the monitoring service. Supported in remote mode only. For procedural information in this guide, see To Enable Monitoring .
monitor(1): Displays monitoring information for the common Enterprise Server resources. Supported in remote mode only. For procedural information in this guide, see To View Common Monitoring Data.
list-logger-levels(1): Lists the existing loggers. Supported in remote mode only. For procedural information in this guide, see To Set Module Logger Levels.
rotate-log(1): 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 a Log File Manually.
set-log-level(1): Sets the log level for a module. Supported in remote mode only. For procedural information in this guide, see To Set Module Logger Levels.

ORB Subcommands

create-iiop-listener(1): Creates an IIOP listener. Supported in remote mode only. For procedural information in this guide, see To Create an IIOP Listener.
delete-iiop-listener(1): Deletes an IIOP listener. Supported in remote mode only. For procedural information in this guide, see To Delete an IIOP Listener.
list-iiop-listeners(1): Lists the existing IIOP listeners. Supported in remote mode only. For procedural information in this guide, see To List IIOP Listeners.

Security Subcommands

change-admin-password(1): Modifies the administration password. You are prompted for the old and new admin password (with confirmation). For procedural information in this guide, see To Change the Administration Password.
change-master-password(1): Changes the administration master password. This password is used to access the secure store where primary keys are stored. This subcommand will not work unless the server is stopped. For procedural information in this guide, see To Change the Master Password.
configure-ldap-for-admin(1): Configures the authentication realm named admin-realm for the given LDAP. Supported in remote mode only.
create-audit-module(1): Adds the named audit module for the plug-in that implements the audit capabilities. Supported in remote mode only. For procedural information in this guide, see To Create an Audit Module.
create-message-security-provider(1): Creates a provider-config subelement for the given message layer (the message-security-config element of domain.xml, the file that specifies parameters and properties). Supported in remote mode only. For procedural information in this guide, see To Create a Message Security Provider.
create-password-alias(1): Creates an alias for a password; aliases are not stored as clear text in the domain.xml file. Supported in remote mode only. For procedural information in this guide, see To Create a Password Alias.
delete-audit-module(1): Removes the named audit module. Supported in remote mode only. For procedural information in this guide, see To Delete an Audit Module.
delete-message-security-provider(1): Deletes a provider-config subelement for the given message layer. Supported in remote mode only. For procedural information in this guide, see To Delete a Message Security Provider.
delete-password-alias(1): Deletes an alias for a password. Supported in remote mode only. For procedural information in this guide, see To Delete a Password Alias.
list-audit-modules(1): Lists all audit modules. Supported in remote mode only. For procedural information in this guide, see To List Audit Modules.
list-message-security-providers(1): Lists the security message providers for the given message layer. Supported in remote mode only. For procedural information in this guide, see To List Message Security Providers.
list-password-aliases(1): Lists existing password aliases. Supported in remote mode only. For procedural information, see To List Password Aliases.
update-password-alias(1): Changes the alias for a specified password. Supported in remote mode only. For procedural information, see To Update a Password Alias.

Thread Pool Subcommands

create-threadpool(1): Creates a new thread pool. Supported in remote mode only. For procedural information in this guide, see To Create a Thread Pool.
delete-threadpool(1): Deletes the specified thread pool. Supported in remote mode only. For procedural information in this guide, see To Delete a Thread Pool.
list-threadpools(1): 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(1): 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(1): Manually recovers pending transactions. Supported in remote mode only. For procedural information, see To Manually Recover Transactions.
rollback-transaction(1): Rolls back the named transaction. Supported in remote mode only. For procedural information, see To Roll Back a Transaction.
unfreeze-transaction-service(1): 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.

User Management Subcommands

create-auth-realm(1): Adds the specified authentication realm. Supported in remote mode only. For procedural information in this guide, see To Create an Authentication Realm.
create-file-user(1): Creates a file user in a given file-based authentication realm. An entry is added to the keyfile with the specified user name, password, and groups. Multiple groups can be created by separating each one with a colon (:). Supported in remote mode only. For procedural information in this guide, see To Create a File User.
delete-auth-realm(1): Deletes the specified authentication realm. Supported in remote mode only. For procedural information in this guide, see To Delete an Authentication Realm.
delete-file-user(1): Deletes the specified user entry in the keyfile. Supported in remote mode only. For procedural information in this guide, see To Delete a File User.
list-auth-realms(1): Lists the existing authentication realms. Supported in remote mode only. For procedural information in this guide, see To List Authentication Realms.
list-file-users(1): Lists the file users supported by the file realm authentication method. Supported in remote mode only. For procedural information in this guide, see To List File Users.
list-file-groups(1): Lists groups for a file user, or all groups if the --name option is not specified. For procedural information in this guide, see To List File Groups.
update-file-user(1): Updates an existing entry in the keyfile using the specified user name, password, and groups. Supported in remote mode only. For procedural information in this guide, see To Update a File User.

Previous: Part III Resources and Services Administration