HP Enterprise Cluster Master Toolkit User Guide (5900-2131, December 2011)

CIFS Server Maintenance Mode
There might be situations, when a CIFS Server instance has to be taken down for maintenance
purposes like changing configuration, without having the instance to migrate to standby node. The
following procedure should be implemented:
NOTE: The example assumes that the package name is SMB_1, package directory is /etc/
cmcluster/pkg/SMB_1.
• Disable the failover of the package through cmmodpkg command.
$ cmmodpkg -d SMB_1
• Pause the monitor script.
Create an empty file /etc/cmcluster/pkg/SMB_1/samba.debug as shown below:
$ touch /etc/cmcluster/pkg/SMB_1/samba.debug
Toolkit monitor scripts which continuously monitors Samba daemon processes, would now
stop monitoring these daemon processes. A message, "Samba toolkit pausing, monitoring
and entering maintenance mode" appears in the Serviceguard Package Control script log.
• If required stop the CIFS Server instance and as shown below:
$ cd /etc/cmcluster/pkg/SMB_1/
$ $PWD/toolkit.sh stop
• Perform maintenance actions (for example, changing the configuration parameters. If files are
changed, remember to distribute the new file to all cluster nodes as needed).
• Start the CIFS Server instance again, if you stopped it as below:
$ cd /etc/cmcluster/pkg/SMB_1/
$ $PWD/toolkit.sh start
• Allow monitoring scripts to continue normally as shown below:
$ rm -f /etc/cmcluster/pkg/SMB_1/samba.debug
A message "Starting Samba toolkit monitoring again after maintenance" appears in the
Serviceguard Package Control script log.
• Enable the package failover.
$ cmmodpkg -e SMB_1
NOTE: If the package fails during maintenance (for example, the node crashes), the package
will not automatically fail over to an adoptive node. It is the responsibility of the user to start
the package up on an adoptive node. See the manual Managing ServiceGuard manual
available at http://www.hp.com/go/hpux-serviceguard-docs —>HP Serviceguard for more
details.
This feature is enabled only when the configuration variable, MAINTENANCE_FLAG, is set to
"yes" in the Samba toolkit configuration file.
Special Notes
Please consider the following areas when implementing HP CIFS Server in the Serviceguard HA
framework.
• Client Applications
HA CIFS Server cannot guarantee that client applications with open files on a CIFS Server
share or applications launched from CIFS Server share, will recover from a switchover. In
134 Using SAMBA Toolkit in a Serviceguard Cluster