weblogic.Admin Command-Line Reference

WebLogic Server Command Reference

PING

Sends a message to verify that a WebLogic Server instance is listening on a port and is ready to accept WebLogic client requests.

For information on returning a description of all servers in a cluster, refer to CLUSTERSTATE.

If a server instance is in a deadlocked state, it can respond to weblogic.Admin commands only if you have enabled the domain-wide administration port. (A deadlocked server is one in which all threads are struck trying to acquire locks held by other threads.) If you have not already enabled the domain-wide administration port, your only option is to shut down the server instance by killing the Java process that is running the server. You will lose all session data. For information on enabling the domain-wide administration port, refer to "Enabling the Domain-Wide Administration Port" in the Administration Console Online Help.

Syntax

java [ SSL Arguments ] weblogic.Admin 
     [ Connection Arguments ] 
     [ User Credentials Arguments ]
   PING [roundTrips] [messageLength]

Argument	Definition
`roundTrips`	Number of pings.
`messageLength`	Size of the packet (in bytes) to be sent in each ping. Requests for pings with packets larger than 10 MB throw exceptions.

Example

The following command pings a server instance 10 times:

java weblogic.Admin -url AdminHost:7001 -username weblogic 
   -password weblogic PING 10

For more information about the environment in which this example runs, refer to Example Environment.

If the command succeeds, it returns output similar to the following:

Sending 10 pings of 100 bytes.
  RTT = ~46 milliseconds, or ~4 milliseconds/packet

The following command pings a server instance that is running on a host computer named ManagedHost:

java weblogic.Admin -url ManagedHost:8001 -username weblogic 
   -password weblogic PING