list-nodes

lists all GlassFish Server nodes in a domain

Synopsis

list-nodes [--help] [--long={false|true}]

Description

The list-nodes subcommand lists all GlassFish Server nodes in a domain.

By default, the subcommand displays the following information for each node that is listed:

  • The name of the node

  • The type of the node, which is one of the following types:

    CONFIG

    The node does not support remote communication.

    DCOM

    The node supports communication over the Distributed Component Object Model (DCOM) remote protocol.

    SSH

    The node supports communication over secure shell (SSH).

  • The name of the host that the node represents

The --long option of the subcommand specifies whether the nodes are listed in long format. In long format, the following additional information about each node is displayed:

  • The path to the parent of the base installation directory of GlassFish Server on the host that the node represents

  • A comma-separated list of the names of the GlassFish Server instances that reside on the node

If the --terse option of the asadmin(1M) utility is true and the --long option of the subcommand is false, the subcommand lists only the name of each node.

This subcommand is supported in remote mode only.

Options

--help
-?

Displays the help text for the subcommand.

--long
-l

Specifies whether the nodes are listed in long format.

Possible values are as follows:

true

The nodes are listed in long format.

false

The nodes are listed in short format (default).

Examples

Example 1   Listing GlassFish Server Nodes

This example displays the name, type, and host for all GlassFish Server nodes in the domain domain1.

asadmin> list-nodes
localhost-domain1  CONFIG  localhost
sj02  SSH  sj02.example.com
sj01  SSH  sj01.example.com
devnode  CONFIG  localhost
Command list-nodes executed successfully.
Example 2   Listing Only the Names of GlassFish Server Nodes

This example uses the --terse option of the asadmin utility to list only the names of the GlassFish Server nodes in the domain domain1.

asadmin> list-nodes --terse=true
localhost-domain1
sj02
sj01
devnode
Example 3   Listing GlassFish Server Nodes in Long Format

This example lists the GlassFish Server nodes in the domain domain1 in long format.

asadmin> list-nodes --long=true
NODE NAME           TYPE     NODE HOST          INSTALL DIRECTORY     REFERENCED BY
localhost-domain1   CONFIG   localhost          /export/glassfish3                 
sj02                SSH      sj02.example.com   /export/glassfish3    pmd-i2, yml-i2
sj01                SSH      sj01.example.com   /export/glassfish3    pmd-i1, yml-i1
devnode             CONFIG   localhost          /export/glassfish3    pmdsa1
Command list-nodes executed successfully.

Exit Status

0

command executed successfully

1

error in executing the command

See Also

create-node-config(1), create-node-dcom(1), create-node-ssh(1), delete-node-config(1), delete-node-dcom(1), delete-node-ssh(1), list-nodes-config(1), list-nodes-dcom(1), list-nodes-ssh(1)

asadmin(1M)