2.6.30 validate-multicast

Synopsis

asadmin [asadmin-options] validate-multicast
    [--help] [--multicastport multicastport]
    [--multicastaddress multicastaddress] [--bindaddress bindaddress]
    [--sendperiod sendperiod] [--timeout timeout]
    [--timetolive timetolive] [--verbose={false|true}]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The validate-multicast subcommand of asadmin validates that the multicast transport is available for clusters. You must run this subcommand at the same time on each of the hosts to be validated. As long as all machines see each other, multicast is validated to be working properly across the machines. If the machines are not seeing each other, set the --bindaddress option explicitly to ensure that all machines are using interface on same subnet, or increase the --timetolive option. If these changes fail to resolve the multicast issues, ask the network administrator to verify that the network is configured so the multicast messages can be seen between all the machines used to run the cluster. This subcommand is supported in local mode only.

Do not run the validate-multicast subcommand using the DAS and cluster's multicast address and port values while the DAS and cluster are running. Doing so results in an error.

Arguments

--help | -?

Displays the help text for the subcommand.

--multicastport multicastport

Specifies the port for the multicast socket on which the Group Management Service (GMS) listens for group events. Specify a standard UDP port number in the range 2048 to 32000.

Type: Integer

The following values can be specified:

• 2048 to 32000

Default value: 2048

--multicastaddress multicastaddress

Specifies the address for the multicast socket on which the GMS listens for group events. Specify a class D IP address. Class D IP addresses are in the range 224.0.0.0 to 239.255.255.255, inclusive. The address 224.0.0.0 is reserved and must not be used.

Type: IP

The following values can be specified:

• 224.0.0.0 to 239.255.255.255

Default value: 228.9.3.1

--bindaddress bindaddress

Specifies the local interface to receive multicast datagram packets for the GMS.

Type: String

The following values can be specified:

• Local network interface IP address

Default value: all available binding interfaces

--sendperiod sendperiod

Specifies the number of milliseconds between test messages sent between nodes.

Type: Integer

The following values can be specified:

• 0 to 2147483647

Default value: 2000

--timeout timeout

Specifies the number of seconds before the subcommand times out and exits. The default is 20. You can also exit this subcommand using Ctrl+C.

Type: Integer

The following values can be specified:

• 0 to 2147483647

Default value: 20

--timetolive timetolive

Specifies the default time-to-live for multicast packets sent out on the multicast socket in order to control the scope of the multicasts. The time-to-live value must be between 0 and 255 inclusive. The default is the JDK default or a minimum defined by a constant in the GMS subsystem, whichever is lower.

Type: Integer

The following values can be specified:

• 0 to 255

Default value: lower of JDK default or a constant in the GMS subsystem.

--verbose={false|true}

Provides additional debugging information (If used without a value or set to true).

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

Exit Status