![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Setting maintenance mode
Set maintenance mode before you perform diagnostic tests, maintenance, or tuning on a node or server. Maintenance mode can prevent the disruption of client requests by routing client traffic that is targeted for a server or node that is in maintenance mode to another server or node.
Before you begin
- You can set maintenance mode on a server or a node that is represented in the administrative console.
- To view the nodes that are configured, click . To view all of the servers that are configured, click .
- You can use maintenance mode when you route requests with on demand routers (ODR) or proxy servers. If you are using a web server to route requests, maintenance mode is not recognized.
- ODR maintenance mode is supported when the ODR is fronted by a web server plug-in. The plugin-cfg.xml file generator generates the plug-in appropriately to enforce the various modes of node and server maintenance mode. You can use node and server maintenance mode to apply service to the ODR tier in the same way that you use maintenance mode to apply service to the application server tier.
- Setting a server into maintenance mode is a persistent change.
A server remains in maintenance mode even if the server is restarted,
until the mode is explicitly changed. The maintenance mode of a server
is stored persistently as a server custom property. The name of the
custom property is server.maintenancemode.The server.maintenancemode property values can be:
- false: This value disables the maintenance mode.
- break: This value stops any traffic from being routed to the server.
- affinity: This value routes only traffic with affinity to the server.
- stop: This value stops the server, and persistently sets it in break mode.
About this task
When a node or server is in running state, the dynamic operations environment considers that node or server to be available for servicing application requests. When problems occur, you must perform diagnostics, maintenance, or tuning on the node or server. Use maintenance mode to stop routing traffic to the node or server while you determine the problem.
When a server is in maintenance mode, the application placement controller cannot control that server. The server does not count toward the minimum or maximum running instances setting for the dynamic cluster. For vertical stacking, the configured maximum minus the number of servers in maintenance mode on the node is used to determine if any servers need to be created on the node. By using this method, the dynamic operations environment does not create or destroy server instances to support the configured maximum number of instances as the dynamic cluster instances move in and out of maintenance mode.
You can use maintenance mode to perform node-level maintenance mode for the ODR nodes just as you can perform node-level maintenance mode for application server nodes. Similarly, you can use server maintenance mode for your ODRs just as you can for application servers.
Two routing policies, the permitMM and permitstickyMM routing policies, are work class match actions that you can use to route HTTP traffic only to servers in maintenance mode. For more information, read about routing and service policies.
Procedure
Results
HTTP and Session Initiation Protocol (SIP) traffic is no longer routed to the nodes or servers that you have in maintenance mode. Enterprise JavaBeans (EJB) affinity is not broken. Requests with EJB affinity and Java™ Message Service (JMS) traffic are still routed to the server that is in maintenance mode.