domainRestart

This operation restarts entire WebLogic domain. Servers in the FDWLS_STOP_SERVER_ EXCLUDE_LIST property are not stopped, and servers in the FDWLS_START_SERVER_EXCLUDE_LIST property are not started. If admin server restart is desired, configure node manager (NODEMANAGER) related properties on environment instance. This operation supports rolling restart to make sure application is available to users during restart operation.


Order of restarts is:

  1. admin server (if not skipped by FDWLS_INP_SKIP_ADMIN),
  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. This order applies for both modes of restarts.


If FDWLS_INP_USE_ROLLING_MODE is checked, some percentage of servers within cluster 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 servers within cluster are sorted by machine name and percentage is applied on that list. Maximum percentage allowed for this 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. Once admin server and WSM servers are restarted, all remaining clusters of WebLogic domain are stopped and started in parallel with each cluster started in rolling manner.


If FDWLS_INP_USE_ROLLING_MODE is not checked, entire domain is stopped and started. Managed servers on various machines are stopped and started in parallel. You can control what percent of the servers of each cluster are stopped and started together with the FDWLS_INP_MAX_PERCENT_SIMULTANEOUS input.

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 Server Name

FDWLS_ADMIN_SERVER_NAME

No

WebLogic Admin Server Name. Defaults to AdminServer.

Weblogic Admin Domain Directory

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)

Weblogic Start Server Exclude List

FDWLS_START_SERVER_EXCLUDE_LIST

No

Provide comma-separated names of managed servers (not clusters), which you do not want started during start operation.

Weblogic Stop Server Exclude ListFDWLS_STOP_SERVER_EXCLUDE_LISTNoProvide comma-separated names of managed servers (not clusters), which you do not want stopped or restarted. They will be started at the end if not also in FDWLS_START_SERVER_
EXCLUDE_LIST.

  

Project Properties

Property Name

Property Code

Required

Description





  

Inputs


Input Name

Required

Description

Rolling Mode

FDWLS_INP_USE_ROLLING_MODE

No

If checked, servers will be restarted so that application delivery continues through the restart operation.

Skip Admin Server

FDWLS_INP_SKIP_ADMIN

No

If checked, the Admin server will not be restarted.

Max Parallel Percentage

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.