Skip navigation.
Downloads | Product Documentation | Support

WebLogic Server Command Reference

## MulticastTest

The `MulticastTest` utility helps you debug multicast problems when configuring a WebLogic Cluster. The utility sends out multicast packets and returns information about how effectively multicast is working on your network. Specifically, `MulticastTest` displays the following types of information via standard output:

1. A confirmation and sequence ID for each message sent out by the current server.
2. The sequence and sender ID of each message received from any clustered server, including the current server.
3. A missed-sequenced warning when a message is received out of sequence.
4. A missed-message warning when an expected message is not received.

To use `MulticastTest`, start one copy of the utility on each node on which you want to test multicast traffic.

Warning: Do NOT run the `MulticastTest` utility by specifying the same multicast address (the `-a` parameter) as that of a currently running WebLogic Cluster. The utility is intended to verify that multicast is functioning properly before starting your clustered WebLogic Servers.

For information about setting up multicast, see the configuration documentation for the operating system/hardware of the WebLogic Server host machine. For more information about configuring a cluster, see Using WebLogic Server Clusters.

### Syntax

>     $ java utils.MulticastTest -n name -a address [-p portnumber]
>        [-t timeout] [-s send] [-l timetolive]

Argument | Definition
--- | ---
`-n` `name` | Required. A name that identifies the sender of the sequenced messages. Use a different name for each test process you start.
`-a` `address` | The multicast address on which: (a) the sequenced messages should be broadcast; and (b) the servers in the clusters are communicating with each other. (The default is 237.0.0.1.)
`-p` `portnumber` | Optional. The multicast port on which all the servers in the cluster are communicating. (The multicast port is the same as the listen port set for WebLogic Server, which defaults to 7001 if unset.)
`-i interfaceaddress` | Optional. Address of interface card to use. Uses the default NIC if none is specified.
`-t` `timeout` | Optional. Idle timeout, in seconds, if no multicast messages are received. If unset, the default is 600 seconds (10 minutes). If a timeout is exceeded, a positive confirmation of the timeout is sent to `stdout`.
`-s` `sendpause` | Optional. Interval, in seconds, between sends. If unset, the default is 2 seconds. A positive confirmation of each message sent out is sent to `stdout`.
`-l timetolive` | Optional. Sets how many hops a packet can make before being discarded. The default value is 1, which restricts the packet to the subnet.

### Example

>     $ java utils.MulticastTest -N server100 -A 237.155.155.1
>     Set up to send and receive on Multicast on Address 237.155.155.1 on port 7001
>     Will send a sequenced message under the name server100 every 2 seconds.
>     Received message 506 from server100
>     Received message 533 from server200
>        I (server100) sent message num 507
>     Received message 507 from server100
>     Received message 534 from server200
>        I (server100) sent message num 508
>     Received message 508 from server100
>     Received message 535 from server200
>        I (server100) sent message num 509
>     Received message 509 from server100
>     Received message 536 from server200
>        I (server100) sent message num 510
>     Received message 510 from server100
>     Received message 537 from server200
>        I (server100) sent message num 511
>     Received message 511 from server100
>     Received message 538 from server200
>        I (server100) sent message num 512
>     Received message 512 from server100
>     Received message 539 from server200
>        I (server100) sent message num 513
>     Received message 513 from server100