weblogic.Admin Command-Line Reference

WebLogic Server Command Reference

LOCK

(Deprecated) Locks a WebLogic Server instance against non-privileged logins. Any subsequent login attempt initiates a security exception which may contain an optional string message.

Note: This command is privileged. It requires the password for the WebLogic Server administrative user.

Instead of using the LOCK command, start a server in the STANDBY state. In this state, a server instance responds only to administrative requests over the domain-wide administration port. See "Server Life Cycle" in Configuring and Managing WebLogic Server.

Syntax

java [ SSL Arguments ]
     weblogic.Admin 
     [ -url [protocol://]listen-address:listen-port ] 
     [ User Credentials Arguments ]
   LOCK ["stringMessage"]

Argument	Definition
-url [`protocol://`]`listen-address:listen-port`	Specify the listen address and listen port of the server instance that you want to lock. If you specify a secure listen port, you must also specify a secure protocol. If you do not specify a value, the command assumes `t3://localhost:7001`. For more information, refer to the -url entry in Table 1-3 on page 11 and Protocol Support.
`"stringMessage"`	Message, in double quotes, to be supplied in the security exception that is thrown if a non-privileged user attempts to log in while the WebLogic Server instance is locked.

Argument

Definition

-url [protocol://]listen-address:listen-port

Specify the listen address and listen port of the server instance that you want to lock.

If you specify a secure listen port, you must also specify a secure protocol.

If you do not specify a value, the command assumes t3://localhost:7001.

For more information, refer to the -url entry in Table 1-3 on page 11 and Protocol Support.

"stringMessage"

Message, in double quotes, to be supplied in the security exception that is thrown if a non-privileged user attempts to log in while the WebLogic Server instance is locked.

Example

In the following example, a Managed Server named MedRecManagedServer is locked.

java weblogic.Admin -url ManagedHost:8001 -username weblogic
   -password weblogic 
   LOCK "Sorry, WebLogic Server is temporarily out of service."

Any application that subsequently tries to log into the locked server with a non-privileged username and password receives the specified message: Sorry, WebLogic Server is temporarily out of service.