Intelligent Management: maintenance mode administrative tasks

We can use the server maintenance mode commands to view or edit the maintenance mode of the servers without using the administrative console. To set maintenance mode on a node, we can use the NodeGroupManager MBean .

Use the following commands to set, disable, and check maintenance mode for the servers:

• setMaintenanceMode

• unsetMaintenanceMode

• checkMode

To set, disable, and check maintenance mode for a node:

• Node maintenance mode

setMaintenanceMode

The setMaintenanceMode command puts a server into maintenance mode.

Required parameters

-name

Name of the server to put into maintenance mode.

Optional parameters

-mode

Optional parameter. If we do not specify a value, then the default is used.

Possible values:

• false: This value disables the maintenance mode.

• break: Stops any traffic from being routed to the server.

• affinity: Default value. This value routes only traffic with affinity to the server.

• stop: Stops the server, and persistently sets it in break mode.

Return value

The command returns void.

Batch mode example

• Jacl:
  $AdminTask setMaintenanceMode xdnode1 {-name test1 -mode break}

• Jython string...
  AdminTask.setMaintenanceMode ('xdnode1','[-name test1 -mode affinity]')

Interactive mode

• Jacl:
  AdminTask setMaintenanceMode {-interactive}

• Jython string...
  AdminTask.setMaintenanceMode ('[-interactive]')

unsetMaintenanceMode

The unsetMaintenanceMode command takes the server out of maintenance mode.

Required parameters

-name

Name of the server to take out of maintenance mode.

Return value

The command returns void.

Batch mode example

• Jacl:
  $AdminTask unsetMaintenanceMode xdnode1 {-name test1}

• Jython string...
  AdminTask.unsetMaintenanceMode ('xdnode1','[-name test1]')

Interactive mode

• Jacl:
  AdminTask unsetMaintenanceMode {-interactive}

• Jython string...
  AdminTask.unsetMaintenanceMode ('[-interactive]')

checkMode

The checkMode command checks whether a server is in maintenance mode.

Required parameters

-name

Name of the server to check.

Return value

The command returns a string value that indicates the server mode.

Batch mode example

• Jacl:
  $AdminTask checkMode xdnode1 {-name test1}

• Jython string...
  AdminTask.checkMode ('xdnode1','[-name test1]')

Interactive mode

• Jacl:
  AdminTask checkMode {-interactive}

• Jython string...
  AdminTask.checkMode ('[-interactive]')

Node maintenance mode

We can use the NodeGroupManager MBean to enable or disable maintenance mode for a node. For more information, read about NodeGroupManager MBean.

We can use the following example in wsadmin to set maintenance mode for a node:

set ngmMbean [$AdminControl queryNames WebSphere:*,type=NodeGroupManager,process=dmgr] $AdminControl invoke $ngmMbean setMaintenanceMode {nodeName true true}

Related concepts

Health management

Related tasks

Set maintenance mode

Create health policies

Intelligent Management: health policy administrative tasks

Related information:

NodeGroupManager MBean