Hitachi

Hitachi Application Server V10 Command Reference Guide (For UNIX® Systems)


2.8.8 list-applications

Lists the deployed applications.

Synopsis

asadmin [asadmin-options] list-applications [--help]
    [--long={false|true}] [--resources] [--subcomponents]
    [--type type] [target]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The list-applications subcommand lists the deployed Java EE applications and the type of each application that is listed. If multiple versions of a module or application are deployed, this subcommand lists all the versions. This subcommand is supported in remote mode only.

If the --type option is not specified, all the applications are listed. If the --type option is specified, you must specify a type.

Precondition

Domain Administration Server (DAS) is running.

Arguments

--help | -?

Displays the help text for the subcommand.

--long={false|true}

Displays whether each module or application listed is enabled, if this value is set to true.

Type: Boolean

The following values can be specified:

  • true

  • false

Default value: false

--resources

Lists the application-scoped resources for each application.

If the --subcomponents option is also used, this subcommand lists the application-scoped resources for each component within the application.

Type: N/A

Default value: N/A

--subcomponents

Lists the subcomponents of each application.

The subcomponents listed depend on the application type. For example, for a Java EE application (EAR file), modules are listed. For a web application, servlets and JSP pages are listed. For an EJB module, EJB subcomponents are listed.

Type: N/A

Default value: N/A

--type type

Specifies the type of the applications that are to be listed.

Type: String

The following values can be specified:

  • application

  • appclient

  • connector

  • ejb

  • web

  • webservice

Default value: If no type is specified, all applications are listed

target

Specifies the name of the target upon which the subcommand operates.

Type: String

The following values can be specified:

  • server

    Lists the applications for the default server instance server and is the default value.

  • domain

    Lists the applications for the domain.

  • cluster_name

    Lists the applications for the cluster.

  • instance_name

    Lists the applications for a particular stand-alone server instance.

Default value: server

Examples

The following example lists the Web Applications.

asadmin list-applications --type web

Exit Status

Exit Status

Explanation

0

subcommand executed successfully.

1

error in executing the subcommand.

Notes

As a result of running this subcommand, it displays the GUI and online help that Java EE Server provides. Do not perform operations such as undeploying applications because these are necessary for operating the product. When you undeploy __internal_admin, you cannot access the Administration Console. To recover, execute the following subcommand from the Command Prompt.

asadmin deploy --name __internal_admin --contextroot
admin "Application Server installation directory\javaee\glassfish\admin\admin"

When you undeploy __internal_manual, it does not display the online help and message ID in the Administration Console. To recover, execute the following subcommand from the Command Prompt.

asadmin deploy --name __internal_manual --contextroot
manual "Application Server installation directory\common\docs"