blob: f6bf27e089f07a4dbe75564b373dbff99b70a6ac [file] [log] [blame]
type=page
status=published
title=list-components
next=list-configs.html
prev=list-commands.html
~~~~~~
list-components
===============
[[list-components-1]][[GSRFM00155]][[list-components]]
list-components
---------------
lists deployed components
[[sthref1391]]
Synopsis
[source,oac_no_warn]
----
asadmin [asadmin-options] list-components [--help]
[--long={false|true}] [--resources] [--subcomponents]
[--type type] [target]
----
[[sthref1392]]
Description
[NOTE]
=======================================================================
The `list-components` subcommand is deprecated. Use the
`list-applications` subcommand instead.
=======================================================================
The `list-components` subcommand lists all deployed Java EE components.
If the `--type` option is not specified, all components are listed. If
the type option is specified, you must specify a type. The possible
types are listed in the Options section in this help page.
If multiple versions of a module or application are deployed, this
subcommand lists all versions. To list which version is enabled, set the
`--long` option to `true`. For more information about module and
application versions, see "link:../application-deployment-guide/overview.html#GSDPG00324[Module and Application
Versions]" in GlassFish Server Open Source Edition Application
Deployment Guide.
This subcommand is supported in remote mode only.
[[sthref1393]]
Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--long`::
If `true`, displays whether each module or application listed is
enabled. The default is `false`.
`--resources`::
Lists the application-scoped resources for each component. If the
`--subcomponents` option is also used, lists the application-scoped
resources for each component within an application.
`--subcomponents`::
Lists the subcomponents of each component. The subcomponents listed
depend on the component 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`::
Specifies the type of the components that are to be listed. The
options are as follows: +
* `application`
* `appclient`
* `connector`
* `ejb`
* `web`
* `webservice` +
If no type is specified, all components are listed.
[[sthref1394]]
Operands
target::
This is the name of the target upon which the subcommand operates. The
valid values are: +
`server`;;
Lists the components for the default server instance `server` and is
the default value.
`domain`;;
Lists the components for the domain.
cluster_name;;
Lists the components for the cluster.
instance_name;;
Lists the components for a particular stand-alone server instance.
[[sthref1395]]
Examples
[[GSRFM647]][[sthref1396]]
Example 1   Listing Components
This example lists the connector components. (`cciblackbox-tx.rar` was
deployed.)
[source,oac_no_warn]
----
asadmin> list-components --type connector
cciblackbox-tx <connector>
Command list-components executed successfully
----
[[sthref1397]]
Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref1398]]
See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:list-applications.html#list-applications-1[`list-applications`(1)],
link:show-component-status.html#show-component-status-1[`show-component-status`(1)]
link:../application-deployment-guide/toc.html#GSDPG[GlassFish Server Open Source Edition Application Deployment
Guide]