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 Reference Manual.
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
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.
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. |
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 2.1 Administration Guide.
This table displays a one-to-one mapping of the incompatibilities in dotted names between Application Server 8 and . 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_idconfig_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 |
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
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.