managedWeblogicRestart

Restarts a comma-separated list of WebLogic servers or clusters. If admin server restart is desired, configure node manager (NODEMANAGER) related properties on Environment Instance. This operation supports rolling restart to make sure applications continue to be available to users during the restart operation.


If admin server and/or WSM servers are included in list of WebLogic servers or clusters, they are processed first. The order of restarts is

  1. Admin server (if included in input)
  2. WSM servers (WLS_WSM1, WLS_WSM2 etc. if included in input), then
  3. the other clusters and servers.

This order is managed as various Fusion Middleware products are dependent on WSM servers.


If FDWLS_INP_USE_ROLLING_MODE is checked, some percentage of servers are restarted individually to make sure that application is available during restart. You can indicate FDWLS_INP_MAX_PERCENT_SIMULTANEOUS to control percentage of cluster members to restart simultaneously. This value will default to 20 percent. Cluster members for restart are selected using its machine name such that all servers on specific machine are eligible first for restart. Basically list or servers within cluster are sorted by machine name and percentage is applied on that list. Maximum percentage allowed for rolling mode is 50, if higher value is specified only 50 will be used. This approach is taken here as session for cluster will be replicated across physical nodes by default.


If FDWLS_INP_USE_ROLLING_MODE is not checked, the selected servers and clusters will all be stopped together and then started. The FDWLS_INP_MAX_PERCENT_SIMULTANEOUS input will NOT be used in this scenario.

Blog Posts

Environment/Instance Properties

Property Name

Property Code

Required

Description

Oracle Weblogic Home (WL_HOME)

FDWLS_WEBLOGIC_HOME

Yes

WebLogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver)

Weblogic Domain Name

FDWLS_DOMAIN_NAME

Yes

WebLogic Domain Name.

Weblogic Admin Listen Address

FDWLS_ADMIN_LISTEN_ADDRESS

Yes

The listener address of the WLS admin server. (e.g. localhost)

Weblogic Admin Listen Port

FDWLS_ADMIN_LISTEN_PORT

Yes

The port of the WLS admin server. (e.g. 7001)

Weblogic Admin SSL Connection

FDWLS_ADMIN_USE_SSL

No

Indicates whether the admin server is using SSL.

Weblogic Admin User

FDWLS_ADMIN_USER

Yes

The user name for the WLS admin server.

Weblogic Admin Password

FDWLS_ADMIN_PASSWORD

Yes

The password for FDWLS_ADMIN_USER.

Weblogic Start Server Timeout

FDWLS_START_SERVER_TIMEOUT

No

Time in milliseconds that the plugin operation will wait for server start. Plugin operation will return as soon as server starts, and if the server fails to start in timeout specified, plugin operation will fail.

Weblogic Stop Server Timeout

FDWLS_STOP_SERVER_TIMEOUT

No

Time in milliseconds that the plugin operation will wait for server stop. Plugin operation will return as soon as server stops, and if the server fails to stop in timeout specified, plugin operation will fail.

Weblogic Admin Domain Director

FDWLS_ADMIN_DOMAIN_DIRECTORY

No

WebLogic Domain Directory for AdminServer. Used when the admin server runs from a different domain folder than managed servers

Weblogic Domain Directory

FDWLS_DOMAIN_DIRECTORY

Yes

WebLogic Domain Directory for managed servers.

Weblogic Node Manager Port

FDWLS_NODEMANAGER_PORT

Yes

The port for the WLS Node Manager.

Weblogic Node Manager User

FDWLS_NODEMANAGER_USER

Yes

The user id for the WLS Node Manager.

Weblogic Node Manager Password

FDWLS_NODEMANAGER_PASSWORD

Yes

The password for FDWLS_NODEMANAGER_USER

Weblogic Node Manager Host

FDWLS_NODEMANAGER_HOST

Yes

Host for Node Manager connection.

Weblogic Node Manager Type

FDWLS_NODEMANAGER_TYPE

No

Node Manager Type. (e.g. ssl, plain, SSH, RSH)

  

Project Properties

Property Name

Property Name

Required

Description

Weblogic Server or Cluster Name(s)

FDWLS_SERVER_OR_CLUSTER_NAMES

No

WebLogic Server or Cluster name to start.

  

Inputs

Input Name

Input Code

Required

Description

Weblogic Server or Cluster Name(s)

FDWLS_INP_SERVER_OR_CLUSTER_NAMES

No

WebLogic Server or Cluster name for start operation. If this is not supplied start operation will use FDWLS_SERVER_OR_CLUSTER_NAMES.

Either FDWLS_INP_SERVER_OR_CLUSTER_NAMES or FDWLS_SERVER_OR_CLUSTER_NAMES must be supplied.

Rolling Mode

FDWLS_INP_USE_ROLLING_MODE

No

If checked, a maximum of 50% of each cluster will be recycled so that application delivery continues through the restart operation.

Max Percent Simultaneous

FDWLS_INP_MAX_PERCENT_SIMULTANEOUS

No

The maximum percentage of cluster members to restart at the same time. Defaults to 20%.

  

Outputs

Output Name

Required

Description




  

Artifacts

This operation doesn't consume or produce any artifacts.


Endpoint Selection

This operation will select all available endpoints associated to the environment instance which have a resource type of WLS Admin Server. Since the admin server only runs on one server, it is expected that for a given domain, there will only be one endpoint with a resource type set to WLS Admin Server.


Endpoint Execution

This operation will execute on the Admin Server endpoint selected using the WLS Admin Server resource type.