|
BEA Systems, Inc. | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The AdminServicesDef defines the interface for administrative services in WebLogic.
Method Summary | |
java.lang.String |
cancelShut()
Cancels a pending shutdown of a WebLogic Server. |
void |
disableWatchDog()
Disables this T3Client as an administrative WatchDog. |
void |
enableWatchDog(int intervalSecs)
Enables a T3Client as an administrative WatchDog. |
java.lang.String |
licenses()
Gets information about the licenses of a WebLogic Server. |
java.lang.String |
lockServer(java.lang.String message)
Locks the Server against all non-privileged logins. |
java.lang.String |
ping(byte[] echo)
Pings a WebLogic Server with the specified array of bytes as a ping message. |
java.lang.String |
shut()
Shuts down a WebLogic Server from a T3Client immediately. |
java.lang.String |
shut(int waitSecs)
Shuts down a WebLogic Server from a T3Client after a certain period of time. |
java.lang.String |
shut(java.lang.String message,
int waitSecs)
Shuts down the WebLogic Server with the specified message after the specified time interval. |
void |
threadDump()
|
java.lang.String |
unlockServer()
Unlocks the Server after a lock operation, to make it available for logins by all users. |
java.lang.String |
version()
Gets the version of a WebLogic Server from a T3Client. |
Method Detail |
public java.lang.String ping(byte[] echo) throws java.lang.Exception
echo
- Byte array to ping the server withpublic java.lang.String shut(int waitSecs) throws java.lang.Exception
This is a privileged method that can only be invoked on a T3Client that has specified the T3User "system".
waitSecs
- Number of seconds to wait before shutting downpublic java.lang.String shut() throws java.lang.Exception
This is a privileged method that can only be invoked on a T3Client that has specified the T3User "system".
public java.lang.String shut(java.lang.String message, int waitSecs) throws java.lang.Exception
message
- Message to include in the exception for
subsequent login attemptswaitSecs
- Number of seconds to wait before shutting downpublic java.lang.String cancelShut() throws java.lang.Exception
This is a privileged method that can only be invoked by a T3Client that has connected with the T3User "system" and the system user's password.
public java.lang.String lockServer(java.lang.String message) throws java.lang.Exception
message
- Message string to include in the exception
for subsequent login attemptspublic java.lang.String unlockServer() throws java.lang.Exception
public java.lang.String licenses() throws java.lang.Exception
public java.lang.String version() throws java.lang.Exception
public void enableWatchDog(int intervalSecs) throws java.lang.Exception
When a client is a WatchDog, the client is responsible for invoking the ping() method every intervalSecs seconds. The ping() will check that the WebLogic Server is still alive and reset the WebLogic Server's internal WatchDog timer. If the WebLogic Server fails to receive a ping within this interval, it will restart itself.
It is bad form to only call ping() every intervalSecs. If there is a transient network problem, then you will have squandered your only chance to restart the server. In practice, a WatchDog should send a ping three or four times per intervalSecs. So, if intervalSecs is 60, you probably want to invoke ping() every 15-20 seconds.
Note that the T3Administrator can (and probably should) invoke T3Client.setSoftDisconnectTimeoutMins(int minutes) to some number greater than intervalSecs*60, and then periodically T3Client.disconnect(), and then instantiate a new T3Client with the same workspaceID. This will permit the WatchDog to not only test the existing socket to the WebLogic Server, but also the ability of T3Clients to connect to WebLogic.
This is a privileged method, and can only be invoked on a T3Client that has specified a T3User of "system" and supplies the system password.
int
- Seconds between pingpublic void disableWatchDog() throws java.lang.Exception
This is a privileged method, and can only be invoked on a T3Client that has specified a T3User of "system".
public void threadDump() throws java.lang.Exception
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs81b |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |