list-nodes-dcom

list-nodes-dcom

Lists all Eclipse GlassFish nodes that support communication over DCOM in a domain

Synopsis

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

Description

The list-nodes-dcom subcommand lists all Eclipse GlassFish nodes that support communication over the Distributed Component Object Model (DCOM) remote protocol. The DCOM protocol is available only on Windows systems.

To list all nodes in a domain regardless of the type of the node, run the list-nodes(1) subcommand.

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 DCOM

  • 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 Eclipse GlassFish on the host that the node represents

  • A comma-separated list of the names of the Eclipse GlassFish 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

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin(1M) help page.

--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 Eclipse GlassFish Nodes

This example displays the name, type, and host for all Eclipse GlassFish nodes that support communication over DCOM in a domain.

asadmin> list-nodes-dcom
xkyd  DCOM  xkyd.example.com
wpmdl2  DCOM  wpmdl2.example.com
wpmdl1  DCOM  wpmdl1.example.com
Command list-nodes-dcom executed successfully.

Example 2   Listing Only the Names of Eclipse GlassFish Nodes

This example uses the --terse option of the asadmin utility to list only the names of the Eclipse GlassFish nodes that support communication over DCOM in a domain.

asadmin> list-nodes-dcom --terse=true
xkyd
wpmdl2
wpmdl1

Example 3   Listing Eclipse GlassFish Nodes in Long Format

This example lists the Eclipse GlassFish nodes that support communication over DCOM in a domain in long format.

asadmin> list-nodes-dcom --long=true
NODE NAME    TYPE   NODE HOST            INSTALL DIRECTORY   REFERENCED BY
xkyd         DCOM   xkyd.example.com     C:\glassfish7
wpmdl2       DCOM   wpmdl2.example.com   C:\glassfish7       wdi2
wpmdl1       DCOM   wpmdl1.example.com   C:\glassfish7       wdi1
Command list-nodes-dcom executed successfully.

Exit Status

0

command executed successfully

1

error in executing the command

See Also

asadmin(1M)

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(1), list-nodes-config(1), list-nodes-dcom(1)