Sun GlassFish Enterprise Server v2.1.1 Upgrade Guide

Command Line Interface: asadmin

The following sections describe changes to the command line utility asadmin:

For more information about the asadmin commands, see the Sun GlassFish Enterprise Server 2.1.1 Reference Manual.

asadmin Subcommands

Subcommands are backward compatible except as noted below.

The reconfigsubcommand is deprecated and ignored.

The following subcommands are not supported in Enterprise Server:

show-instance-status (use list-instances)
restart-instance (use stop-instance followed by start-instance)
configure-session-persistence (renamed to configure-ha-persistence)
create-session-store (renamed to create-ha-store)
clear-session-store (renamed to clear-ha-store)

The following subcommands are no longer supported in Enterprise Server. The software license key and web core were removed, and Enterprise Server no longer supports controlled functions from web server features.

install-license
display-license
create-http-qos
delete-http-qos
create-mime
delete-mime
list-mime
create-authdb
delete-authdb
list-authdbs
create-acl
delete-acl
list-acls

Error Codes for Start and Stop Subcommands

For Application Server 8, the error codes for the start and stop subcommands of the asadmin command were based on the desired end state. For example, for asadmin start-domain, if the domain was already running, the exit code was 0 (success). If domain startup failed, the exit code was 1 (error).

For Enterprise Server, the exit codes are based on whether the commands execute as expected. For example, the asadmin start-domain command returns exit code 1 if the domain is already running or if domain startup fails. Similarly, asadmin stop-domain returns exit code 1 if the domain is already not running or cannot be stopped.

Deprecated and Unsupported Options

Options in the following table are deprecated or no longer supported.

Table 1–3 Deprecated and Unsupported asadmin Options


Option	Deprecated or Unsupported in Subcommands
`--acceptlang`	Deprecated for the `create-virtual-server` subcommand.
`--acls`	Deprecated for the `create-virtual-server` subcommand.
`--adminpassword`	Deprecated for all relevant subcommands. Use `--passwordfile` instead.
`--blockingenabled`	Deprecated for the `create-http-listener` subcommand.
`--configfile`	Deprecated for the `create-virtual-server` subcommand.
`--defaultobj`	Deprecated for the `create-virtual-server` subcommand.
`--domain`	Deprecated for the `stop-domain` subcommand.
`--family`	Deprecated for the `create-http-listener` subcommand.
`--instance`	Deprecated for all remote subcommands. Use `--target` instead.
`--mime`	Deprecated for the `create-virtual-server` subcommand.
`--optionsfile`	No longer supported for any commands.
`--password`	Deprecated for all remote subcommands. Use `--passwordfile` instead.
`--path`	Deprecated for the `create-domain` subcommand. Use `--domaindir` instead.
`--resourcetype`	Deprecated for all relevant subcommands. Use `--restype` instead.
`--storeurl`	No longer supported for any commands.
`--target`	Deprecated for all `jdbc-connection-pool`, `connector-connection-pool`, `connector-security-map`, and `resource-adapter-config` subcommands.
`--type`	Deprecated for all relevant subcommands.

Dotted Names

The following use of dotted names in asadmin get and set subcommands are not backward compatible:

The default server name is server instead of server1.
server_instance.resource becomes domain.resources.resource.
server_instance.app-module becomes domain.applications.app-module.
Attributes names format is different. For example,poolResizeQuantity is now pool-resize-quantity.
Some aliases supported in Application Server 8 are not supported in Enterprise Server .

In Enterprise Server, the --passwordfile option of the asadmin command does not read the password.conf file, and the upgrade tool does not upgrade this file. For information about creating a password file in Enterprise Server, see the Sun GlassFish Enterprise Server v2.1.1 Administration Guide.

This table displays a one-to-one mapping of the incompatibilities in dotted names between Application Server 8 and v2.1.1. The compatible dotted names are not listed in this table.

Table 1–4 Incompatible Dotted Names Between Versions


Application Server 7 Dotted Names	2.1 Dotted Names
`server_instance.http-listener.listener_idserver_instance.http-service.http-listener.listener_id`	`server_instance.http-service.http-listener.listener_idconfig_name.http-service.http-listener.listener_id`
`server_instance.orbserver_instance.iiop-service`	`server_instance.iiop-serviceconfig_name.iiop-service`
`server_instance.orblistenerserver_instance.iiop-listener`	`server_instance.iiop-service.iiop-listener.listener_idconfig_name.iiop-service.iiop-listener.listener_id`
`server_instance.jdbc-resource.jndi_name`	`server_instance.resources.jdbc-resource.jndi_namedomain.resources.jdbc-resource.jndi_name`
`server_instance.jdbc-connection-pool.pool_id`	`server_instance.resources.jdbc-connection-pool.pool_iddomain.resources.jdbc-connection-pool.pool_id`
`server_instance.external-jndi-resource.jndi_nameserver_instance.jndi-resource.jndi_name`	`server_instance.resources.external-jndi-resource.jndi_namedomain.resources.external.jndi-resource.jndi_name`
`server_instance.custom-resource.jndi_name`	`server_instance.resources.custom-resource.jndi_namedomain.resources.custom-resource.jndi_name`
`server_instance.web-container.logLevel` (see note below)	`server_instance.log-service.module-log-levels.web-containerconfig_name.log-service.module-log-levels.web-container`
`server_instance.web-container.monitoringEnabled` (see note below)	`server_instance.monitoring-service.module-monitoring-levels.web-containerconfig_name.monitoring-service.module-monitoring-levels.web-container`
`server_instance.j2ee-application.application_nameserver_instance.application.application_name`	`server_instance.applications.j2ee-application.application_namedomain.applications.j2ee-application.application_name`
`server_instance.ejb-module.ejb-module_name`	`server_instance.applications.ejb-module.ejb-module_namedomain.applications.ejb-module.ejb-module_name`
`server_instance.web-module.web-module_name`	`server_instance.applications.web-module.web-module_namedomain.applications.web-module.web-module_name`
`server_instance.connector-module.connector_module_name`	`server_instance.applications.connector-module.connector_module_namedomain.applications.connector-module.connector_module_name`
`server_instance.lifecycle-module.lifecycle_module_name`	`server_instance.applications.lifecycle-module.lifecycle_module_namedomain.application.lifecycle-module.lifecycle_module_name`
`server_instance.virtual-server-class`	N/A*
`server_instance`.`virtual-server`.`virtual-server_id`	`server_instance.`http-service.virtual-server.virtual-server_id`config_name`.http-service.virtual-server.virtual-server_id
`server_instance.mime`.`mime_id`	N/A*
`server_instance`.`acl`.`acl_id`	N/A*
`server_instance`.`virtual-server`.`virtual-server_id`.`auth-db`.`auth-db_id`	N/A*
`server_instance`.`authrealm`.`realm_idserver_instance`.`security-service.authrealm`.`realm_id`	`server_instance.security-service.auth-realm.realm_idconfig_name.security-service-auth-realm.realm_id`
`server_instance.persistence-manager-factory-resource.jndi_nameserver_instance.resources.persistence-manager-factory-resource.jndi_name`	`server_instance.resources.persistence-manager-factory-resource.jndi_namedomain.resources.persistence-manager-factory-resource.jndi_name`
`server_instance.http-service.acl.acl_id`	N/A*
`server_instance.mail-resource.jndi_name`	`server_instance.resources.mail-resource.jndi_namedomain.resources.mail-resource.jndi_name`
`server_instance.profiler`	`server_instance.java-config.profilerconfig_name.java-config.profiler`

Tokens in Attribute Values

The asadmin get command shows raw values in Enterprise Server instead of resolved values as in Application Server 8. These raw values may be tokens. For example, execute the following command:

asadmin get domain.log-root

The preceding command displays the following value:

${com.sun.aas.instanceRoot}/logs

Nulls in Attribute Values

In Application Server 8, attributes with no values contained null. This caused problems in attributes that specified paths. In Enterprise Server, attributes with no values contain empty strings, as they did in Application Server.