Intelligent Management: maintenance mode administrative tasks

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

Use the following commands to set, disable, and check maintenance mode for your 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: Specifies the name of the server that you want to put into maintenance mode.

Optional parameters

-mode

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

Possible values:

false: This value disables the maintenance mode.
break: This value stops any traffic from being routed to the server.
affinity: Default value. This value routes only traffic with affinity to the server.
stop: This value stops the server, and persistently sets it in break mode.

Return value

The command returns void.

Batch mode example usage

Using Jacl:

$AdminTask setMaintenanceMode xdnode1 {-name test1 -mode break}

Using Jython string:

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

Interactive mode example usage

Using Jacl:

AdminTask setMaintenanceMode {-interactive}

Using Jython string:

AdminTask.setMaintenanceMode ('[-interactive]')

unsetMaintenanceMode

The unsetMaintenanceMode command takes the server out of maintenance mode.

Required parameters

-name: Specifies the name of the server that you want to take out of maintenance mode.

Return value

The command returns void.

Batch mode example usage

Using Jacl:

$AdminTask unsetMaintenanceMode xdnode1 {-name test1}

Using Jython string:

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

Interactive mode example usage

Using Jacl:

AdminTask unsetMaintenanceMode {-interactive}

Using Jython string:

AdminTask.unsetMaintenanceMode ('[-interactive]')

checkMode

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

Required parameters

-name: Specifies the name of the server that you want to check.

Return value

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

Batch mode example usage

Using Jacl:

$AdminTask checkMode xdnode1 {-name test1}

Using Jython string:

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

Interactive mode example usage

Using Jacl:
```
AdminTask checkMode {-interactive}
```
Using Jython string:
```
AdminTask.checkMode ('[-interactive]')
```

Node maintenance mode

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

You 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}