Using SAMBA Toolkit in a Serviceguard Cluster README Revision: B.06.00

ManualsBrandsHP ManualsSoftwareHP Serviceguard Enterprise Cluster Master Toolkit

Using SAMBA Toolkit in a Serviceguard Cluster

========================================================================

Revision: B.06.00

CONTENTS:

A. HP CIFS Server Package Configuration Overview

B. Setting Up the Application

C. Setting Up the Package

D. Setting Up the Toolkit

D.1 Toolkit Overview

D.2 Toolkit User Configuration

E. CIFS Server Maintenance Mode

F. Special Notes

PREFACE:

This README file describes the High Availability SAMBA Toolkit for use

in the Serviceguard environment. The README file is intended for

users who want to install and configure the SAMBA toolkit in a

Serviceguard cluster. It assumes that readers are already familiar

with Serviceguard configuration as well as HP CIFS Server application

concepts and installation/configuration procedures.

NOTE: This toolkit supports:

- HP Serviceguard versions

* A.11.19

* A.11.20

- the version of HP CIFS Server included with HPUX and,

- HP-UX 11i v2 and HP-UX 11i v3

At time of publication, this version supports the above mentioned SG,

application and HPUX versions. More recent versions of these

products may be certified with B.06.00. For the latest information,

see the compatibility matrix located at:

http://docs.hp.com/en/ha.html

NOTE:

This version of the toolkit supports both, legacy and modular style

packages.

NOTE:

Unless otherwise stated, this toolkit supports all filesystems,

storage and volume managers that Serviceguard supports.

NOTE:

This toolkit includes support for the following:

- HP Serviceguard A.11.19 with VERITAS Cluster File System (CFS)

Summary of content (17 pages)

PAGE 1
Using SAMBA Toolkit in a Serviceguard Cluster ======================================================================== Revision: B.06.00 CONTENTS: A. B. C. D. HP CIFS Server Package Configuration Overview Setting Up the Application Setting Up the Package Setting Up the Toolkit D.1 Toolkit Overview D.2 Toolkit User Configuration E. CIFS Server Maintenance Mode F. Special Notes PREFACE: This README file describes the High Availability SAMBA Toolkit for use in the Serviceguard environment.
PAGE 2
5.0 on HP-UX 11i v2, and HP-UX 11i v3. - HP Serviceguard A.11.19 with CFS 5.0.1 on HP-UX 11i v3. - HP Serviceguard A.11.20 with CFS 5.1 SP1 on HP-UX 11i v3 To use CFS, you must install the Serviceguard Storage Management Suite. appropriate version of HP For more details please refer to the Serviceguard Release Notes at: http://docs.hp.com/en/ha.html The SAMBA Toolkit for Serviceguard consists of a set of shell scripts for configuring, starting, halting, and monitoring the HP CIFS Server application.
PAGE 3
email ID must be created and specified for this parameter. When an email ID is not specified for this parameter, the script does not send out this email. The following files are located in /etc/cmcluster/scripts/ecmt/samba after installation. File Name -------------tkit_module.sh and Description -----------------------------------------------------This script is called by the Master Control Script acts as an interface between the Master Control Script and the Toolkit interface script (toolkit.sh).
PAGE 4
using a combination of shared and local storage, or using shared storage only. The choice of local or shared storage is left to the user's discretion. However, shared storage is recommended, as it is easier to maintain. Local Configuration In a typical local configuration, identical copies of the HP CIFS Server configuration files reside in exactly the same locations on the local file system on each node. All HP CIFS Server file systems are shared between the nodes.
PAGE 5
1. When the CIFS Server is installed, the default HP CIFS Server may be automatically configured to start during system startup. If the Server is already installed and configured, simply stop it with the /opt/samba/bin/stopsmb command. 2. Ensure the RUN_SAMBA parameter in the /etc/rc.config.d/samba file is set to 0 on all nodes. This disables Automatic Startup when the machine boots. Here is a simple example of a multiple-instance configuration.
PAGE 6
storage. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Shared Configuration a. Using LVM ~~~~~~~~~~~~~ To configure a shared file system managed by LVM, you need to create volume group(s) and logical volume(s) on the shared disks, then construct a new file system for each logical volume for the HP CIFS Server file system (and HP CIFS Server configuration files). Please refer to the manual "Managing Serviceguard" for information on configuring LVM and creating a file system.
PAGE 7
need to be running in order for the Samba package to access CFS mounted file systems. Please refer to your Serviceguard Manual for information on how to configure SG CFS packages. Create a directory /shared/smb1 on all cluster nodes. Mount the CFS filesystem on /shared/smb1 using the CFS packages. Use /shared/smb1 to hold the necessary files and configuration information. NOTE: CIFS supports CFS with a limitation.
PAGE 8
configuration, including cluster name, node addresses, etc. Refer to the manual "Managing specific details on cluster configuration. names, heartbeat IP Serviceguard" for Note: To increase the number of packages that may be added to this cluster, please modify the cluster configuration file and set the variable MAX_CONFIGURED_PACKAGES to reflect the number of packages to be added to the cluster. After the edit, apply the change to the cluster via "cmapplyconf -C cluster_config_file".
PAGE 9
DEPENDENCY_LOCATION SAME_NODE 2. Create a package control file with command "cmmakepkg -s". The package control file must be edited as indicated by the comments in that file. The package control file must be customized to your environment.
PAGE 10
{ # Stop the HP CIFS Server. /etc/cmcluster/smb1/toolkit.sh stop test_return 51 } 5. Configure the user configuration file "hasmb.conf" as explained in the next section and customize it for your environment. 6. Copy this nodes. package configuration directory to all other package You can use the same procedure to create multiple HP CIFS Server packages (multiple HP CIFS Server instances) that will be managed by Serviceguard. D. Setting Up the Toolkit D.
PAGE 11
Monitor Script (hasmb.mon) This script contains a list of internal-use variables and functions for monitoring an HP CIFS Server server instance. This script will be called by the toolkit main script (hasmb.sh) and will constantly monitor two HP CIFS Server daemons, smbd and nmbd. Interface Script (toolkit.sh) This script is an interface between a package the toolkit main script (hasmb.sh). control script and D.
PAGE 12
(MAINTENANCE_FLAG=yes) This variable will enable or disable maintenance mode for the Samba package. By default this is set to "yes". In order to disable this feature MAINTENANCE_FLAG should be set to "no". When Samba needs to be maintained then a file "/samba.debug" needs to be touched. During this maintenance period Samba process monitoring is paused. Even if Samba is brought down, its package will not be failed over to the standby node.
PAGE 13
LOG_DIRECTORY=/var/opt/samba/${NETBIOS_NAME}/logs SMBD_PID_FILE=/var/opt/samba/${NETBIOS_NAME}/locks/smbd.pid NMBD_PID_FILE=/var/opt/samba/${NETBIOS_NAME}/locks/nmbd.pid 2. Copy the entire package directory configured for the package. at the same path on all nodes For this example, each package node must have the in the package directory: smb_pkg.conf smb_pkg.cntl hasmb.conf hasmb.mon hasmb.sh toolkit.sh 3. E.
PAGE 14
$ cd /etc/cmcluster/pkg/SMB_1/ $ $PWD/toolkit.sh stop - Perform maintenance actions (Example: changing the configuration parameters. If files are changed, please 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.
PAGE 15
* Print Jobs If a failover occurs when a print job is in process, the job may be printed twice or not at all, depending on the job state at the time of the failover. * Symbolic Links Symbolic links in the shared directory trees may point to files outside of any shared directory. If symbolic links point to files that are not on shared file systems, after a failover occurs, the symbolic links may point to different files or to no file.
PAGE 16
support parameter is set to "yes"), /var/opt/samba/locks/browse.tdb will be stored. the database If this file is not on a shared file system, when a failover occurs, there will be a short period of time when all the WINS clients update the CIFS WINS server with their address. However, if this short period of time to restore the WINS database is not acceptable, you can reduce the period of time to restore the full WINS service. To do so, configure /var/opt/samba/locks/browse.
PAGE 17
-H /etc/cmcluster/smb1/lmhosts Please refer to the manpage on lmhosts for more information. © Copyright 2010 Hewlett-Packard Development Company, L.P. Confidential computer software.Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data forCommercial Items are licensed to the U.S. Government under vendor's standard commercial license.