HP ProLiant DL380G5-WSS HP StorageWorks Clustered File System 3.2.1 Windows St
HP ProLiant DL380G5-WSS Manual
View all HP ProLiant DL380G5-WSS manuals
Add to My Manuals
Save this manual to your list of manuals |
HP ProLiant DL380G5-WSS manual content summary:
- HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 1
HP StorageWorks Clustered File System 3.2.1 Windows Storage Server Edition administration guide *403103-002* *403103-002* Part Number: 403103-002 Second edition: February 2006 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 2
warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein file thirdpartylicense.pdf, which is included in the PolyServe Matrix Server distribution. Copyright © 2000-2003 Microsoft Corporation. All rights reserved - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 3
Devices 8 Volume Manager 8 PSFS Filesystems 8 HP Clustered File System Databases 9 Virtual Hosts and Failover Protection 9 Service and Device Monitors 10 Event Notification 11 Cluster Design Guidelines 11 Server Memory 11 Supported Configurations 12 3 Cluster Administration Administrative - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 4
License File 32 Upgrade the License File 32 Refresh the License File 32 Supported HP Clustered File System Features 32 Migrate Existing Servers to HP Clustered File System 33 Configure Servers for DNS Load Balancing 34 5 Configure Network Interfaces Overview 37 Administrative Traffic 37 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 5
60 Recreate a Dynamic Volume 61 Convert a Basic Volume to a Dynamic Volume 63 8 Configure PSFS Filesystems Overview 65 Filesystem Features 65 Server Registry 66 Filesystem Management and Integrity 67 Filesystem Synchronization and Device Locking 67 Crash Recovery 68 Create a Filesystem 68 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 6
the Virtual Host 101 11 Configure Service Monitors Overview 104 Service Monitors and Virtual Hosts 104 Service Monitors and Failover 105 Types of Service Monitors 105 Add or Modify a Service Monitor 108 Advanced Settings for Service Monitors 110 Service Monitor Policy 111 Custom Scripts 113 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 7
Contents vii Delete a Service Monitor 117 Disable a Service Monitor on a Specific Server 117 Enable a Previously Disabled Service Monitor 117 View Service Monitor Errors 118 Clear Service Monitor Errors 118 12 Configure Device Monitors Overview 119 Multi-Active Device Monitors 119 DISK - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 8
Servers 142 Test Failure and Reintegration of Service Service Monitors 146 Custom Device Monitors 149 Integrate Custom Applications 152 Device Monitor or Service Servers That Can Join a Cluster 155 16 SAN Maintenance Server a Host Bus Adapter or Driver 166 Server Cannot Be Located 167 Online - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 9
Cluster Alerts 176 Check the Server Configuration 176 Disable a Server for Maintenance 177 Troubleshoot Cluster Problems 177 HP Clustered File System Fails to Start 177 The Server Status Is "Down 178 HP Clustered File System Considers a Running Service Down178 A Virtual Host Is Inaccessible - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 10
error messages • Operating system type and revision level • Detailed, specific questions HP Storage Web Site The HP web site has the latest information on this product, as well as the latest drivers. Access the storage site at: http://www.hp.com/country/us/eng/prodserv/storage.html. From this web - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 11
HP Technical Support 2 HP NAS Services Web Site The HP NAS Services site allows you to choose from convenient HP Care Pack Services packages or implement a custom support solution delivered by HP ProLiant Storage Server specialists and/or our certified service partners. For more information see us - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 12
scalable, highly recoverable, and highly available. • Availability and reliability. Servers and SAN components (FC switches and RAID subsystems) can be added impact, as long as the operation is supported by the underlying operating system. HP Clustered File System includes failover mechanisms that - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 13
-based applications. If a problem occurs with a network application, with the network interface used by the virtual host, or with the underlying server, HP Clustered File System automatically switches network traffic to another server to provide continued service. • Administrative event notification - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 14
LAN) RAID Subsyst e m FC Switch RAID Subsyst e m Servers. Each server must be running HP Clustered File System. Public LANs. A cluster can include up to four network interfaces per server. Each network interface can be configured to support multiple virtual hosts, which provide failover protection - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 15
from there. After a disk is imported, you can create PSFS filesystems on it. Software Components The HP Clustered File System software is installed on each server in the cluster and includes the following major components. Processes Management Console ClusterPulse Distributed Lock Manager SDMP - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 16
of virtual hosts and devices, handles communications with the HP CFS Management Console, and manages device monitors, service monitors, and event notification. Distributed Lock Manager (DLM) process. Provides a locking mechanism to coordinate server access to shared resources in the cluster. All - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 17
over access to the disk. During the import, the disk is given a unique global device name. The servers in the cluster use this name when they need to access the disk. Volume Manager The HP Clustered File System Volume Manager can be used to create dynamic volumes consisting of disk partitions that - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 18
operations can be performed with the HP CFS Management Console or from the command line. • Support for existing applications. The PSFS %\Program Files\Hewlett-Packard\HP Clustered File System\conf on each server. These files should not be changed. • Device database. HP Clustered File System uses - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 19
the application is running. Service and Device Monitors A service is a network service such as HTTP or FTP that is installed and configured on the servers in the cluster. HP Clustered File System can be configured to watch specific services with service monitors. A service monitor is created on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 20
Guidelines Be sure to consider the following guidelines when planning the physical configuration of your HP Clustered File System cluster. Server Memory Memory resources are consumed on each cluster server to manage the state necessary to preserve the coherency of shared filesystems. For this reason - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 21
File System supports multiple FibreChannel switches configured as a single fabric and multiported SAN disks. The following diagrams show some sample cluster configurations using these components. Single FC Port, Single FC Switch, Single Fabric This is the simplest configuration. Each server has - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 22
FC switches are connected to two RAID arrays, which contain multiported disks. If a switch fails, the servers connected to the other switch will survive and access to storage will be maintained. Server 1 Server 2 Server 3 Server 4 Server 5 Server 6 FC Switch RAID Array FC Switch RAID Array - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 23
should be aware of the following when managing HP Clustered File System: Normal operation of the cluster depends on a reliable network hostname resolution service. If the hostname lookup facility becomes unreliable, this can cause reliability problems for the running cluster. Therefore, you should - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 24
- Although using the hosts file provides immunity to DNS problems, it must be manually updated on each node. For example, if an IP address from a separate administrative station rather than from a server in the cluster. The HP CFS Management Console can be installed on Windows systems outside - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 25
interface via the Device Manager. - Update network drivers. - Hot-swapping of PCI cards. • If servers from multiple clusters can access the SAN via Server service accounts and roles. Do not use local users and groups for these purposes because they are meaningless to other nodes in the cluster. • HP - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 26
17 Tested Configuration Limits HP has tested HP Clustered File System configurations up to the following limits: • 16 servers per cluster • 256 imported LUNs per cluster • 128 filesystems per cluster • 2048 filesystem mounts per cluster • 64 virtual hosts per cluster • 64 service and/or device - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 27
hostname. Start the Management Console To start the Management Console, select Start > Programs > HP Clustered Gateway > HP CFS Management Console. The Login window is then displayed. Server: Type the name or IP address of a server in the cluster. If you are creating a new cluster, type the name or - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 28
Clustered File System Command Reference Guide for more information. The HP CFS Management Console When you connect to the cluster, the HP CFS Management Console appears. The Management Console window has five tabs that show different views of the cluster. Following is the Servers tab. This tab lists - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 29
toolbar at the top of the window can be used to connect or disconnect from a cluster, to add new cluster entities (servers, virtual hosts, notifiers, device monitors, service monitors, and filesystems), to import or deport disks, to collapse or expand the entity lists, and to display the online help - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 30
shows all virtual hosts in the cluster. For each virtual host, the window lists the network interfaces on which the virtual host is configured, any service monitors configured on that virtual host, and any device monitors associated with that virtual host. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 31
Chapter 3: Cluster Administration 22 Notifiers Tab The Notifiers tab shows all notifiers configured in the cluster. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 32
Chapter 3: Cluster Administration 23 Filesystems Tab The Filesystems tab shows all PSFS filesystems in the cluster. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 33
single screen. The tab uses a table format, with a column for each server in the cluster. The application monitors appear in the rows of the table. You the configuration of a virtual host or to move a virtual host to another server. You can also enable, disable, or delete a monitor, view or clear - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 34
. Double click an alert to view the error in the cluster tree structure. If you receive an alert telling you to reboot a server, the message will remain in the Alert section until either HP Clustered File System is restarted on the rebooted server or the server is removed from the cluster. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 35
Settings tab. If the cluster is running, you will need to change the password individually on each server. If you stop HP Clustered File System on all of the servers, you can change the password on one server and then export the new configuration (on the Cluster Wide Configuration tab) to the other - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 36
File System to start when the system is booted, use the Startup dialog to change the service from Automatic to Manual. To start HP Clustered File System on a particular server, use one of these methods: • Issue the command net start matrixserver from a CMD prompt. • Use the Microsoft Management - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 37
is configured as a fully networked host supporting the services to be monitored. For example, if you want HP Clustered File System to provide failover protection for your Web service, the appropriate Web server software must be installed and configured on the servers. • If the hosts file has been - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 38
address of the server. Server Severity: When a server fails completely because of a power failure or other serious event, HP Clustered File System attempts to move any virtual hosts from the network interfaces on the failed server to backup network interfaces on healthy servers in the cluster. When - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 39
recovery and before the server is made available to host services provided by virtual hosts. After adding a new server, it appears on the Servers window. In the following example, two servers have been added to a cluster. NOTE: For improved performance, the HP CFS Management Console caches hostname - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 40
in the same manner as virtual hosts and device monitors. To disable servers from the command line, use this command: mx server disable ... Enable a Server Select the server to be enabled from the Servers window on the HP CFS Management Console, right-click, and select Enable. To enable - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 41
use the following command: mx server read_license Supported HP Clustered File System Features HP Clustered File System provides device monitors, service monitors, and notifiers. The license agreement for each server determines which features are supported on that server. You can use the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 42
be different from the names of the virtual hosts they support. A virtual host can then respond regardless of the state of any one of the servers. In some cases, the name of an existing server may have been published as a network host before HP Clustered File System was configured. You can either - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 43
new virtual hostname are automatically redirected by HP Clustered File System to a backup server. Configure Servers for DNS Load Balancing HP Clustered File System can provide failover protection for servers configured to provide domain name service (DNS) load balancing. DNS load balancing allows - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 44
virtual host uses acmd2 as the primary and acmd1 as the backup. The DNS server is configured for round robin using the following A records: Address www.acmd.com. www.acmd.com. Time to Live 60 60 Service IN IN Record Type A A IP Address 10.1.1.1 10.1.1.2 Address: The virtual hostnames that - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 45
on which it performs its work; the other server is a backup in case the primary goes down or is taken offline for maintenance. Depending on your needs, more complicated combinations of DNS round robin and HP Clustered File System can be used, including cluster configurations with multiple failover - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 46
When you add a server to the cluster, HP Clustered File System determines whether each network interface on that server meets the following conditions: the requirements specified in the HP StorageWorks Clustered File System Setup Guide. Administrative Traffic HP Clustered File System uses a local - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 47
interface if you do not want it to carry virtual host traffic. Network Interfaces and the Management Console When HP Clustered File System is started, the ClusterPulse process probes the servers in the cluster to locate network interfaces and then adds the interfaces to its configuration file. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 48
interface discourages administrative traffic. Administrative Network Failover An administrative network failure occurs when the interface on a particular server is no longer receiving HP Clustered File System administrative traffic. Some possible causes of the failure are a bad cable or network - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 49
on that server. Then make your change and restart HP Clustered File System. • Add or delete a network interface from the operating system. • Change network properties on the Network Control Panel. • Disable or re-enable a network interface via the Device Manager. • Update network drivers. • Hot - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 50
select that interface, rightclick, and select Properties. The network interface must be down; you cannot modify an "up" network interface. Server: The name or IP address of the server that will include the new network interface. IP: Type the IP address for the network interface. Net Mask: Type the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 51
administrative traffic on a network interface, select that network interface on the Servers window, right-click, and then select either "Allow Admin. Traffic" line, use the following command to allow administrative traffic on specific network interfaces: mx netif admin ... Use - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 52
configuration meets the requirements specified in the HP StorageWorks Clustered File System Setup Guide. Storage Control Layer Module The Storage Control each server in the cluster and is created by the SANPulse process. The primary function of the SCL module is to ensure that when a server drops - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 53
servers in the cluster use to access the device. Although the identifiers (such as psd2 or psd2p6) appear on certain HP use the mprepair utility to fix any problems with the membership partitions. Import SAN can be imported. Dynamic disks are not supported. • Shared disks must be partitioned before - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 54
and the underlying partition, you can use the Extend option provided on the HP CFS Management Console. To make other changes to the partition table after a on the mx disk import command line. To import disks using the HP CFS Management Console, select Storage > Disk > Import or click the Import - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 55
SAN Disks Deporting a disk removes it from cluster control. You cannot deport a disk that contains a membership partition. To deport a disk from the HP CFS Management Console, select Storage > Disk > Deport or click the Deport icon on the toolbar. The Deport Disks window, which appears next, lists - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 56
Management utility (the Local Name) with the disk names that HP Clustered File System uses (the PSD Name). You can also use this window to import or deport SAN disks. To see the disk information, select the server on the Servers tab on the HP CFS Management Console, right-click, and then select View - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 57
command can display information for both imported and unimported SAN disks. Under normal operations, the sandiskinfo output should be the same on all servers in the cluster. With no options, sandiskinfo shows the UID, vendor, model, and capacity of each imported disk and specifies the FC switch - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 58
Chapter 6: Configure the SAN 49 sandiskinfo Disk: \\.\Global\psd2 Uid: 20:00:00:04:cf:13:38:3a::0 Vendor: SEAGATE SAN info: fcswitch5:7 Capacity: 34733M The command syntax is as follows: sandiskinfo [-i|-u|-v] [-al] The default is -i, which produces the output shown earlier for imported - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 59
Chapter 6: Configure the SAN 50 partition 04: size 9421M type partition 05: size 16M type partition 06: size 9421M type (PSFS Filesystem) partition 07: size 1028M type partition 08: size 1028M type (unknown) Disk: \\.\Global\psd2 Uid: 20:00:00:04:cf:13:38:3a::0 SAN info: fcswitch5:7 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 60
7 Configure Dynamic Volumes HP Clustered File System includes a CFS Volume Manager that you can use to create, extend, recreate, or destroy dynamic volumes, if you have purchased the separate - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 61
HP Clustered File System supports two types of dynamic volumes: striped and concatenated. The volume type determines how data is written to the volume. • Striping. When a dynamic volume is created with striping enabled, a specific These names form the pathnames that servers use to access shared data. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 62
to select the subdevices to be included in the volume. If the volume will be striped, you will also need to select a stripe size. Optionally, HP Clustered File System can also create a filesystem that will be placed on the dynamic volume. To create a dynamic volume from the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 63
Chapter 7: Configure Dynamic Volumes 54 Filesystem: If you want HP Clustered File System to create a filesystem that will be placed on the dynamic volume, enter a label to identify the filesystem. If you do not want a - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 64
to create the volume. (APPLY keeps the window open, allowing you to create additional dynamic volumes.) When the dynamic volume has been created, the HP CFS Management Console reports the psv name assigned to the volume. On the Management Console, filesystems are identified with the psv name of the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 65
Chapter 7: Configure Dynamic Volumes 56 The following command lists the available subdevices: mx dynvolume showcreateopt Dynamic Volume Properties To see the configuration for a dynamic volume, select Storage > Dynamic Volume > Volume Properties and then choose the volume that you want to view. If - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 66
with no options from the Command Prompt. The command is in the directory Program Files\Hewlett-Packard\HP Clustered File System\bin on the drive where you installed HP Clustered File System. Following is some sample output. Current Product MP Version: 2 Membership Partition Version: 2 Membership - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 67
Chapter 7: Configure Dynamic Volumes 58 Extend a Dynamic Volume The Extend Volume option allows you to add subdevices to an existing dynamic volume. When you extend the volume on which a filesystem is mounted, you can optionally increase the size of the filesystem to fill the size of the volume. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 68
Chapter 7: Configure Dynamic Volumes 59 Dynamic Volume Properties: The current properties of this dynamic volume. Filesystem Properties: The properties for the filesystem located on this dynamic volume. Available Subdevices: Select the additional subdevices to be added to the dynamic volume. Use - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 69
be sure that the filesystem is no longer needed or has been copied or backed up to another location. To destroy a dynamic volume from the HP CFS Management Console, select Storage > Dynamic Volume > Destroy Volume. On the Destroy Dynamic Volume window, select the volume that you want to destroy and - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 70
been copied or backed up to another location. The filesystem must be unmounted when you recreate the volume. To recreate a dynamic volume on the HP CFS Management Console, select Storage > Dynamic Volume > Recreate and then choose the volume that you want to recreate. If a filesystem is mounted on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 71
Chapter 7: Configure Dynamic Volumes 62 You can change or reorder the subdevices used for the volume and enable striping if desired. To recreate a volume from the command line, you will first need to use the dynvolume destroy command and then run the dynvolume create command. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 72
recreate the volume. To convert a basic volume, select the associated PSFS filesystem on the HP CFS Management Console, right-click, and select Convert to Dynamic Volume. A warning then appears, stating that HP Clustered File System must unmount the filesystem, which will close any open files. Also - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 73
Chapter 7: Configure Dynamic Volumes 64 To convert a basic volume to a dynamic volume from the command line, use the following command: mx dynvolume convert - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 74
Features Concurrent Access by Multiple Servers After a PSFS filesystem has been created, all cluster servers having access to the device via across the cluster with the HP CFS Management Console or from the command line. The PSFS filesystem also supports existing applications. It uses standard - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 75
that the structure of the filesystem is consistent. Users on other servers will experience only a slight delay in filesystem operations during the recovery. Server Registry HP Clustered File System uses a registry to control server access to PSFS filesystems on the SAN disks imported into the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 76
occur when cluster network communications are lost but the affected servers can still access the SAN. If this situation occurs, HP Clustered File System determines which servers should continue to have SAN access and excludes the other servers from the SAN. This step prevents data corruption from - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 77
volume (a psd device) or a dynamic volume (a psv device). You can create a filesystem from one server in the cluster using either the HP CFS Management Console or the command line. The filesystem can then be monted on all servers in the cluster that can access it via the SAN. NOTE: The minimum size - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 78
Configure PSFS Filesystems 69 Create a Filesystem from the Management Console To create a filesystem, select Storage > Filesystem > Add Filesystem on the HP CFS Management Console, or click the Filesystem icon on the toolbar. Label: Type a label that identifies the filesystem. Available Volumes - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 79
HP Clustered File System names such as psd1p2. To match these names to their local Windows names, open the Disk Info window (select the server on the Servers select Recreate Filesystem. A message then appears stating that the HP Clustered File System needs to unmount the filesystem and any unsaved - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 80
> The psfsformat Command Use this syntax: psfsformat[-fq] [-l ] [-n max-nodes] [-o option ...] The options are: • -f The -f option (format) can be used if HP Clustered File System is not running or the disk is not imported. Before using this option, be sure that the volume is not in - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 81
allocation times on large, relatively full filesystems. For details about FZBM, see the HP Knowledge Base article "Using the FZBM On-Disk Filesystem Format." The device can be on the Filesystems tab on the HP CFS Management Console, right-click, and select Assign Path. The assignment is made on all - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 82
Filesystems 73 Assign Drive Letter: HP Clustered File System queries the servers in the cluster to determine the drive letters that are currently unused on all of the servers. You can assign any of these drive letters to the filesystem. NOTE: If, on a cluster server, the drive letter you selected - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 83
the assignments for a filesystem, use this command: mx fs queryassignments To see the assignments on specific servers, use this command: mx fs getdriveletter --server Remove Drive Letter or Path Assignments If you no longer want to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 84
In the Windows operating system, a filesystem is automatically mounted on a server the first time the server attempts to access it. When the server is shut down, the filesystem is automatically unmounted. Although the HP CFS Management Console includes options to mount or unmount filesystems and to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 85
maximum size of the volume. When you click on the Extend Filesystem button, you will see a warning such as the following. When you click Yes, HP Clustered File System will extend the filesystem to use all of the available space. If the filesystem is on a dynamic volume, you can use the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 86
Chapter 8: Configure PSFS Filesystems 77 Features Tab The Features tab shows whether Full Zone Bit Maps (FZBM) are enabled on the filesystem. View Filesystem Status from the Command Line You can use the following mx command to see status information. mx fs status [--verbose] The command lists the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 87
to the filesystem and forces any changed blocks associated with the filesystem to disk. The command performs these actions on all servers that have mounted the filesystem and then returns successfully. Any process attempting to modify a suspended filesystem will block until the filesystem - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 88
Chapter 8: Configure PSFS Filesystems 79 NOTE: If an attempt to mount the copied filesystem fails with an "FSID conflict" error, run the following command. In the command, is the partition that contains the copied filesystem, and is the name that should be used to identify the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 89
Chapter 8: Configure PSFS Filesystems 80 The options are as follows: • --rebuild-tree Rebuilds the filesystem tree using leaf nodes found on the device. Normally you should use this option only if psfscheck reports errors that can be fixed only by --rebuild-tree. We strongly recommend that you - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 90
when allocating a block. It is particularly useful for speeding up allocation times on large, relatively full filesystems. For details about FZBM, see the HP Knowledge Base article "Using the FZBM On-Disk Filesystem Format." The options are: • --enable-fzbm Enable the FZBM feature on the specified - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 91
tab on the Management Console shows all HP Clustered File System applications, virtual hosts, service monitors, and device monitors configured in applications. If a problem occurs, you can drill-down the affected application to locate the resource experiencing the problem. Create Applications When - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 92
same name as the device monitor. The Applications Tab The Management Console lists applications and their associated resources (virtual hosts, service and device monitors, CIFS virtual servers) on the Applications tab. The applications and resources appear in the rows of the table. (Double-click on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 93
the servers, applications, and resources. The following icons are used in the server columns to indicate the status of applications and resources. Servers an application to locate resources that are down or experiencing problems. The application icon and its corresponding status indicate the state - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 94
Chapter 9: Cluster Operations on the Applications Tab 85 column, all clients can access the application. If the status is Error or Warning, at least one resource in the application has that status. The possible states for the application are: Icon Status OK Meaning Clients can access the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 95
on the Applications Tab 86 On the Type tab shown above, select the types of virtual hosts, service monitors, and device monitors that you want to see. Click on the State tab to select specific states that you are interested in viewing. (The Applications tab will be updated immediately.) Click OK - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 96
the command line, as described in the HP StorageWorks Clustered File System Command Reference Guide. Rename an application: Right-click on such as a service or device monitor from a server, left-click in the cell for that server and resource, right-click, and select Remove From Server. Virtual Hosts - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 97
tab as are available when right-clicking on a service monitor or device monitor on the other tabs. The procedures are as follows: • Delete the monitor • Modify the configuration of the monitor • Enable or disable the monitor on a specific server • View or clear the last error • Remove from - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 98
do not need to be dedicated to these activities; all servers can support other independent functions. The network interface currently receiving the network traffic is the active interface and is labeled as "Active" on the HP CFS Management Console. This interface is typically the primary interface - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 99
administrative network, the active network interface, and the underlying server. If you have created service or device monitors, those monitors periodically check the health of the specified services or devices. If any of these checks fail, HP Clustered File System can transfer the virtual host to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 100
hosts are independent of specific servers, and their names should be independent as well. • Use an IP address that is on the same subnet as the network interfaces where it will be configured. • Update the hosts file (%SystemRoot%\system32\drivers\etc\hosts) or the DNS name service with the virtual - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 101
an existing virtual host, select that virtual host on either the Server or Virtual Hosts window, right-click, and select Properties. Then make way to group virtual hosts and related service and device monitors on the Applications tab. All of the HP Clustered File System resources associated with the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 102
, if you do not assign a name, HP Clustered File System will use the IP address for the virtual host as the application name. Always active: If you check this box, upon server failure, the virtual host will move to an active server even if all associated service and device monitors are inactive or - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 103
will then be moved to the Members column automatically. If you are configuring the virtual host only on certain servers, move the appropriate network interfaces for those servers to the Members column. The first interface you select will be the primary interface. The other interfaces you select - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 104
applications to recognize them. For example, if you are using a Web server, you may need to edit its configuration files to recognize and respond to configure operating system software or files to respond to the virtual host; HP Clustered File System does that configuration for you. For example, do - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 105
10: Configure Virtual Hosts 96 Delete a Virtual Host Select the virtual host to be deleted on either the Servers window or the Virtual Hosts window, right-click, and select Delete. Any service monitors configured on that virtual host are also deleted. To delete a virtual host from the command line - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 106
virtual host can be located. The interfaces are placed in order: primary, backup #1, backup #2, and so on. The ClusterPulse process considers the "health" of the servers providing those interfaces when determining where to place a virtual host. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 107
10: Configure Virtual Hosts 98 The status and enablement of the service and device monitors associated with the virtual host also contribute to a server's health calculation. When a server is completely "healthy," all of the services associated with the virtual host are up and enabled. When - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 108
configured for the virtual host. 6. If there are no servers with completely healthy services, ClusterPulse picks a server that has at least one service up and enabled. If the services have different priorities, ClusterPulse uses a server where a service with the highest available priority is up. If - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 109
is down or the monitored device cannot be accessed, ClusterPulse will fail over the associated virtual host to another server where the monitored service or device is up. You can customize this behavior using the Advanced monitor settings. Specify Failover/Failback Behavior The Probe Severity - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 110
Priority setting). If ClusterPulse cannot locate an interface where all services are "up" on the underlying server, it selects an interface where the highest priority service is "up" on the underlying server. Specify Failback Behavior of the Virtual Host When you configure a virtual host, you - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 111
if the virtual host policy was AUTOFAILBACK, failback would occur when the probe failed on node 2 because both servers were equally healthy.) • After the virtual host fails over to node 2, all service monitor probes fail on that node. Node 1, with one down monitor, is now healthier than node 2, with - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 112
Virtual Hosts 103 Virtual Host Policy Monitor Probe Severity AUTORECOVER NOAUTORECOVER Behavior When Probe Reports DOWN Failover occurs. The virtual host remains on the backup server until a "healthier" server is available. Failover occurs and monitor is disabled on the original - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 113
HTTP service and then create a service monitor for HTTP. A service can run regardless of HP Clustered File System monitoring. Service Monitors and Virtual Hosts A service monitor is associated with a specific virtual host; the monitored service must be configured on all servers supporting that - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 114
there is a healthy server configured and available, but sometimes it may not be possible in a multiple-failure scenario. Types of Service Monitors HP Clustered File System supports the following service monitors. When you configure a monitor, you will need to supply the following information. Type - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 115
server. The default frequency for the probe is every 30 seconds; the default time that the service monitor waits for a probe to complete is five seconds. You can also supply server, the service status is set to Down. (You can view the reply code from the HP CFS Management Console; select the service - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 116
server. If there are no errors, the service status remains Up. If an error occurs, the status is set to Down. TCP Service Monitor The generic TCP service not need to specify an IP address because a service monitor is associated with a virtual host. HP Clustered File System uses that virtual host IP - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 117
only. It does not configure the service itself. To add or update a service monitor from the HP CFS Management Console, select the appropriate option: • To add a new service monitor, first select the virtual host for the monitor on either the Servers or Virtual Hosts window, then rightclick - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 118
monitor is assigned to this virtual host. Server Port: HP Clustered File System supplies the default port number for the service you select. If your service uses a port other than the default, type that port number here. Monitor Type: Select the type of service that you want to monitor. Timeout: The - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 119
for the probe script to be used with the monitor. When you complete the Add Service Monitor form, the new monitor appears on the Management Console. In this example, the service monitor is active on server owl, which provides the active network interface for the virtual host. To add or update - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 120
the virtual host and AUTORECOVERY for the monitor) cause ClusterPulse to fail over the associated virtual host to a backup network interface on another server. When the service is recovered on the original node, the virtual host fails back to that node. You can use the Timeout and Failure Severity - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 121
integrating HP Clustered File System with a custom application where certain application-specific actions HP Clustered File System from placing a virtual host on a server where all of its associated services are available, HP Clustered File System next looks for a server where the associated service - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 122
original node becomes inactive and the probe is no longer run on that node. HP Clustered File System activates the virtual host on the new node, which causes the Custom Scripts The Scripts tab lets you customize a service monitor with Start, Stop, and Recovery scripts. You can also configure the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 123
is starting or the configuration has changed), HP Clustered File System chooses the best server to make the service active. The Start script is run on this server. On all other servers configured for the monitor, the Stop script is run to ensure that the service is not active. Start scripts must be - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 124
and exit non-zero. The service could then become active on another server, causing the Stop script to run on the original server even though the Start script events on the HP CFS Management Console and clear them from the Console or command line after you have fixed the problems that caused them. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 125
Chapter 11: Configure Service Monitors 116 To configure event severity from the command line, use this option: --eventSeverity consider|ignore Script Ordering Script ordering determines the order in which Start and Stop scripts are run when a virtual host moves from one server to another. If you - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 126
to be deleted, right-click, and select Delete. To delete a service monitor from the command line, use this command: mx service delete Disable a Service Monitor on a Specific Server When a monitor is disabled, the health of the server is affected in the same manner as a failure of the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 127
monitor on the Management Console, right-click, and select View Last Error. Clear Service Monitor Errors From the Management Console, select the service monitor where the event occurred, right-click, and select Clear Last Event. To clear a monitor event from the command line, use this command - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 128
HP Clustered File System provides the following types of device monitors. To configure a device monitor, you will need to specify the probe timeout and frequency and a monitor-specific -active. This means that they are active on multiple servers at the same time. This configuration allows the device - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 129
monitor detects the network failure and prevents the cluster from partitioning. A gateway device monitor is multi-active and can be configured on multiple servers. When you configure the monitor, you will be asked for the network address of a router or other gateway probe device. The IP address - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 130
any active virtual hosts on the server will become inactive and fail over to another server. Custom Device Monitor A CUSTOM device HP Clustered File System with a custom application. HP Clustered File System treats custom monitors just as it does the builtin DISK monitor, except that you must supply - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 131
because of a problem with the server or with the disk itself. If the monitor probe succeeds on another server assigned to the monitor, HP Clustered File System specific server is disabled, then the device monitor will not be made active on that server. 2. ClusterPulse considers the list of servers - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 132
monitor. 5. If there are no servers with completely healthy services, ClusterPulse picks a server that has at least one service up and enabled. If ClusterPulse finds a server meeting these conditions, it will use it, preferring services earlier in the list of servers for this device monitor. 6. If - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 133
32 alphanumeric characters. Application name: Specify the name of the HP Clustered File System application to be associated with this device monitor. HP Clustered File System applications are used to group related virtual hosts, service monitors, and device monitors on the Applications tab. If you - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 134
for a partition on a shared SAN disk, you can also use the HP Clustered File System name for the partition, such as \\.\psd2p2. Using this such as a router). The IP address must be on a different subnet than the servers in the cluster. • CUSTOM. Specify the pathname to the probe script to be - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 135
the monitor probe fails. When the device is restored, ClusterPulse fails back the virtual hosts to the network interface on the original server. You can use the Probe Severity attribute to change this behavior. There are three settings for Probe Severity: NOFAILOVER, AUTORECOVER, and NOAUTORECOVER - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 136
occurs according to the virtual host's failback policy. The NOAUTORECOVER option is useful when integrating HP Clustered File System with a custom application where certain application-specific actions must be taken before failback can occur. For more information on the interaction between the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 137
(because the ClusterPulse process is starting or the configuration has changed), HP Clustered File System chooses the best server to make the device active. The Start script is run on this server. The Stop script is run on all other servers configured for the monitor to ensure that the device is not - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 138
The device could then become active on another server, causing the Stop script to run on the original server even though the Start script did not complete these events on the HP CFS Management Console and clear them from the Console or command line after you have fixed the problems that caused them. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 139
scripts are run when a shared device or virtual host moves from one server to another. If you do not configure a monitor with Start and Stop host is in transition. The PARALLEL configuration can speed up failover time for services and devices that do not depend on strict ordering of Start and Stop - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 140
for a disk containing Web and FTP files. If the disk fails, you want HP Clustered File System to fail over the virtual hosts for these services. The server might also provide mail service; however, the virtual host for this service is not dependent on the disk and should not fail over if the disk - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 141
: • Single-Active. The monitor is active on only one of the selected servers. Upon server failure, the monitor will fail over to an active server unless all associated service and device monitors are down. ("Associated" service and device monitors are those monitors that are associated with the same - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 142
-Always-Active. The monitor is active on only one of the selected servers. Upon server failure, the monitor will fail over to an active server even if all associated service and device monitors are down. ("Associated" service and device monitors are those monitors that are associated with the same - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 143
Chapter 12: Configure Device Monitors 134 Disable a Device Monitor From the Management Console, select the device monitor to be disabled, right-click, and select Disable. To disable a device monitor from the command line, use this command: mx device disable ... Enable a Device Monitor - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 144
notifiers that define how the events should be handled. Overview HP StorageWorks Clustered File System uses notifiers to enable you to view event information generated by servers, network interfaces, virtual hosts, service monitors, device monitors, and filesystems. Notifiers send events from these - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 145
will need to specify a name for the notifier and to supply the script to be run when an event is triggered that accept the event message. Add or Modify a Notifier Select the Notifier tab on the HP CFS Management Console to display the Notifiers window and then choose the appropriate option: • - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 146
script> [--event {STATE|INFO| WARN|ERROR},...] [--entity {SERVERS|IFACES|VHOSTS| SERVICEMONITORS|DEVICEMONITORS|FILESYSTEMS}] The --script Other Configuration Procedures These procedures can be performed from either the HP CFS Management Console or the command line. Delete a Notifier - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 147
source IP address of the server that generated the global event, or the string "LOCAL" for events generated locally on that server. Event: One of State, The full text description of the event. The text can include specific Cluster information that can cause the format to vary significantly. Sample - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 148
send e-mail when notifier events are generated. @echo off set TMPDIR=C:\WINNT\tmp set MAILFILE=%TMPDIR%\mailit set SUBJECT="HP Clustered File System Event Notifier" set [email protected] echo %SUBJECT% > %MAILFILE% echo Command Line: %0 %1 %2 %3 %4 %5 %6 %7 %8 %9 >> %MAILFILE% - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 149
test of your specific requirements to validate that HP Clustered File System HP Clustered File System is to verify that your SAN hardware configuration, operating system configuration, and HP Clustered File System software configuration correctly support PSFS filesystems shared across the servers - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 150
HP CFS Management Console, log into one of the cluster servers. server and then reboot it. Verify that the server, upon rebooting, is able to mount the shared filesystem. Verify that all servers are able to access the shared filesystem. 6. Power off one of the servers. Verify that the other servers - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 151
host and that the first backup server becomes inactive. Test Failure and Reintegration of Service Monitors The following procedure tests the failure and reintegration of a service monitor: 1. From the HP CFS Management Console, log into a backup server. 2. Add a service monitor to the virtual host - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 152
failure. The virtual host should be inactive on the primary server and active on the first backup server. 6. Start the service that you are testing on the primary server. 7. Verify that HP Clustered File System detects that the service has become active. 8. Verify that the virtual host is active - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 153
when it rejoins the cluster. 1. From the HP CFS Management Console, log into one of the servers in the cluster. 2. Pull the LAN network connection(s) from a server that you are not logged onto. 3. Verify that HP Clustered File System detects that the server is down and that the backup for this - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 154
LANs. Configure the Linux network software to enable the interfaces to these networks on each of the cluster servers. 2. From the HP CFS Management Console, log into one of the cluster servers. 3. Observe on the Management Console which of your LANs is currently being used for cluster administrative - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 155
On the servers supplying the interfaces, the state of the virtual host is either active or inactive. When HP Clustered File System needs to fail over a virtual host, it looks for the healthiest backup server. To make this determination, HP Clustered File System considers the state of any service or - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 156
15: Advanced Topics 147 The probe mechanism is in one of the following states on each server: Up, Down, Unknown, Timeout. A service monitor also has an activity status on each server. The status can be one of the following: Starting, Active, Suspended, Stopping, Inactive, Failure. The following - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 157
Probe status unknown Monitor activity undefined stopping up inactive When a failure occurs on the Primary, the virtual host needs to fail over to a backup. HP Clustered File System now looks for the best location for the virtual host. Because the probe status on the first backup is "down - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 158
device monitor is associated with a list of servers and a list of virtual hosts configured on those servers. A custom device monitor can be active on only one server at a time. On each server, the monitor uses a probe mechanism to determine whether the service is active. The probe mechanism is in - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 159
and the device monitor probe reports an Up status. If HP Clustered File System cannot locate a server where the device is active and the probe status is a Primary network interface and two backup interfaces. There is also a service monitor defined on the virtual host. It uses the default values for - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 160
activity undefined active star ting t1 inactive down inactive stopping First Bac kup Vhost status inactive up Service probe status unknown Service monitor activity Device probe status Device monitor activity undefined stopping unknown up undefined stopping inactive inactive Sec - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 161
IP address provided to the outside world to access your services. For example, one common use of HP Clustered File System is to increase the availability of Web servers. The availability of the HTTP service is best modeled by a service monitor associated with the virtual host to which outside users - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 162
port and is also producing reasonable output, you should use a user-defined service monitor. You will need to write a probe script that connects to the of the time that the application is functioning. However, a problem might occur that causes the application to continue accepting connections but - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 163
will be sent to the database and from there to the backup server before connections are directed to the backup server. Script Environment Variables When you specify a script for a custom service or device monitor, HP Clustered File System sets the following environment variables for that script - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 164
. (Applies only to service monitors.) MX_NAME=name The name of the device monitor. (Applies only to device monitors.) HP Clustered File System does not set any other variables. If a script requires a variable such as a pathname, it will need to set it. Limit the Servers That Can Join a Cluster - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 165
to all or part of the SAN for several reasons: • Network problems. Cluster partitioning can occur when cluster network communications are lost but the affected server can still access the SAN. HP Clustered File System then removes the server's access to the SAN to protect the integrity of the shared - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 166
the server will automatically regain access to the filesystem. The HP CFS Management Console typically displays an alert message when a server loses Locks HP Clustered File System uses a set of disk-based data structures called SANlocks to protect filesystem integrity. If a problem causes - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 167
Chapter 16: SAN Maintenance 158 mxsanlk displays the status of the SANlock stored in each membership partition. It can be used to determine whether any of the membership partitions need to be repaired. Also, if a network partition occurs, mxsanlk can be used to determine which network partition - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 168
Chapter 16: SAN Maintenance 159 • locked, cannot access The host on which mxsanlk was run held the SANlock but is now unable to access it. The membership partition may need repair. • trying to lock, not yet committed by owner The SANlock is either not held or has not yet been committed by its - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 169
the cluster and then restart it. This step should restart the SDMP process. If you continue to have problems, contact HP Technical Support. Manage Membership Partitions with mprepair Each server in the cluster has a membership partition file, which is called the "local MP list." This file specifies - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 170
161 mprepair Utility The mprepair utility can be used to repair any problems if a failure causes servers to have inconsistent views of the membership partitions. This utility is invoked from the operating system prompt. NOTE: HP Clustered File System cannot be running when you use mprepair. To stop - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 171
server's local MP list. If the status is NOT FOUND or INACCESSIBLE, there may be a problem with the disk or with another SAN component. When the problem is you then add another partition in its place. When the disk access problem is corrected, the old membership partition will still be on the disk - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 172
changes with mprepair, you will need to export the configuration to the other servers in the cluster. To do this, start HP Clustered File System on the server where you ran mprepair and then connect to the HP CFS Management Console. Select File > Configure to display the Configure Cluster window and - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 173
164 The output shows the local membership partition list on the server where you are running mprepair. It then compares this list and the database records for the partitions. Resilver Membership Partitions. Typically, HP Clustered File System writes data to one membership partition and then copies, - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 174
Chapter 16: SAN Maintenance 165 However, in certain situations you may need to perform the resilver operation manually. For example, a membership partition might become corrupt or a local membership list might become out of date. To resilver from a particular partition, type the following command: - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 175
System: net stop matrixserver 2. Disable the HP Clustered File System service: mxservice -uninstall 3. Remove the psd driver from the driver stack: psdcoinst -uninstall 4. Reboot the server. The server will come up without HP Clustered File System and the psd driver. 5. Make the necessary change to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 176
be operating properly, contact HP Technical Support. Online Insertion of New Storage HP Clustered File System supports online insertion (OLI) of new storage, provided that OLI support is present for your combination of storage device, SAN fabric, HBA vendor-supplied device driver, and the associated - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 177
, the FC connector that was plugged into port 1 on the original switch must be plugged into port 1 on the new switch. • HP Clustered File System must be stopped on any servers that are connected only to the switch to be replaced. If these conditions are not met, you will not be able - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 178
or from another switch in the fabric. Use the cfgShow command and record its output. 5. Connect the power and either the Ethernet or the serial console cable to the new switch. 6. Log on to the rest of the fabric. Verify that the HBAs on the servers log into the new switch in the expected locations. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 179
McDATA FibreChannel switch, complete these steps: 1. Stop HP Clustered File System on any servers that are connected only to the original switch. 2. zoning for the zone configuration. 3. After the original switch has been powered down, power up the new switch and set the IP address to the old switch - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 180
log into the new switch in the expected locations. To ensure a highly available configuration after the switch has been replaced, verify that all servers have eligible I/O paths through the replaced switch. You can use the PowerPath powermt command or the Secure Path spmgr command to do this. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 181
need to perform the following activities: • Maintain the HP Clustered File System event log • Disable a server for maintenance • Troubleshoot a cluster • Troubleshoot service and device monitors Maintain the HP Clustered File System Event Log HP Clustered File System stores its log messages in the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 182
to see the log messages. You can use the options on the Action menu to manipulate the event log. HP CFS Management Console You can also use the HP CFS Management Console to view or maintain the event log on each server. The changes you make affect only the event log for the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 183
Chapter 17: Other Cluster Maintenance 174 View the Event Log To view the event log for a specific server, select that server, right-click, and then select View Log. The Server Log window displays the most recent messages from the event log. You can select the types of messages that you want to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 184
be enabled or disabled; by default, it is enabled. To disable auditing on a particular server, you will need to edit the registry. Locate the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP Clustered File System\mxservice\Started Processes\mxlogd ProgramArguments Set the key to -a to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 185
can also run mxcheck manually. It is located in the installation directory, which is typically C:\Program Files\HewlettPackard\HP Clustered File System\bin. The utility performs the following checks on the server: • System check: hardware, operating system version, service pack version, available - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 186
. • Storage check: Host Bus Adapters, drivers, and settings. • Miscellaneous check: other server and then reenable it. Troubleshoot Cluster Problems HP Clustered File System Fails to Start If the HP Clustered File System service fails to start on a server, check that the domain name of the server - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 187
the ClusterPulse process is running on the server. 4. Verify that the same version of HP Clustered File System is installed on all servers in the cluster. HP Clustered File System Considers a Running Service Down If HP Clustered File System indicates that a service is down even though it is running - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 188
properly on the server or the main Ethernet interface is not installed. To check this, consult the Networks applet (located in the Control Panel) and the %WINDIR%\system32\drivers\etc\hosts file. Troubleshoot Monitor Problems You may encounter the following problems with service and device monitors - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 189
completed because of a script configuration problem or because HP Clustered File System is still attempting error occurred while HP Clustered File System was trying to probe the service. To see details and does not support the version of HP Clustered File System running on the server. "Event" Status - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 190
exit status. ILLEGAL TRANSITION. The ClusterPulse process gave instruction to the monitor_agent process, which is considered to be an illegal state transition for a monitor. This indicates an internal error and should be reported to HP Technical Support. The event is written into the system event - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 191
Maintenance 182 Because the error is server-specific, you must clear it on each server in the cluster (just as you had to correct the script on each server that reported a problem). NOTE: An error on a monitor may still be indicated after correcting the problem with the Start, Stop, Recovery, or - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 192
. It also uses a different set of network ports for internal, or server-to-server communications. External Network Port Numbers The following port numbers are used for external connections to HP Clustered File System. If HP Clustered File System is behind a firewall, it may be necessary to change - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 193
184 Internal Network Port Numbers The following network port numbers are used for internal, server-toserver communication. You should need to change the firewall rules for these ports only if you have HP Clustered File System nodes firewalled from each other. Port 7659 7659 7660 7661 8940 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 194
A Management Console Icons The Management Console uses the following icons. HP Clustered File System Entities The following icons represent the HP Clustered File System entities. If an entity is disabled, the color of the icon becomes less intense. 185 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 195
186 Additional icons are added to the entity icon to indicate the status of the entity. The following example shows the status icons for the server entity. The status icons are the same for all entities and have the following meanings. Monitor Probe Status The following icons indicate the status - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 196
Appendix A: Management Console Icons 187 On the Applications tab, virtual hosts and single-active monitors use the following icons to indicate the primary and backups. Multi-active monitors use the same icons but do not include the primary or backup indication. Management Console Alerts The - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 197
errors occur, HP Clustered File System writes messages to the HP CFS Management Console. Other error messages are written to the HP Clustered File System Ensure that the server can access the membership partitions and also has write access to them. Also check for hardware problems that can limit - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 198
that the disk is not experiencing hardware problems. Then attempt a reboot. If the same error occurs after one reboot, contact HP Technical Support. Error adding : I/O error sending to server Error disabling : I/O error sending to server Error enabling : I/O error sending to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 199
that the ClusterPulse process is not running; restart HP Clustered File System on the server. Error connecting to server: I/O error Error connecting to server An error occurred when HP Clustered File System tried to connect to the specified server through the Connect to Cluster window. Error getting - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 200
has failed. The server should be rebooted as soon as possible. Internal error: unable to initialize security Internal error: unable to initialize security. Java program problem. Contact service. If you receive one of these messages, report it to HP Technical Support at your earliest opportunity - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 201
deports can not be performed. HP Clustered File System is unable to exclude servers that have become unresponsive, or to verify the fencing of servers that were previously fenced and have Also check for other networking or SAN hardware problems. The servers should be rebooted as soon as possible. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 202
access the membership partitions and have write access to them, and that the servers can communicate with the FibreChannel switch. If no problems are found, contact HP Technical Support. Membership partition XXXX is unwritable, possibly due to a SAN or storage hardware failure. If other membership - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 203
majority of the membership partitions are either inaccessible or corrupt. HP Clustered File System cannot allow access to the PSFS filesystems resort, reboot the server to clear the problem. Server closed connection connection to the server was lost Either the server has closed the communication - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 204
the rest of the cluster. This monitor does not appear to be living on any particular server. This is a UI bug. If you receive this message, report it to HP Technical Support at your earliest opportunity. Unknown user - NO_SUCH_USER Unknown user - SYSTEM_ERROR Unknown user - SYSTEM_ERROR: Unable to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 205
server YYY The monitor_agent process is reporting status on a device monitor with device name XXX on server HP Clustered File System process received an unknown action or context reply from the agent monitor_agent: [STATUS, EVENT,UNDEF] [SERVICE more information about the problem. For example, it may - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 206
?] with errno of N The ClusterPulse process received a system error. Report this error to HP Technical Support at your earliest opportunity. License error -- LICENSE ERROR ON SERVER %s: %s; clusterpulse WILL BE TERMINATED IN %d HOURS %d MINUTES The ClusterPulse process has recognized a license - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 207
Network error -- set_writeable called with unknown socket N If you receive this message, notify HP Technical Support at your earliest convenience. Object not found -- could not find service monitor instance: IP X.X.X.X port N The ClusterPulse process received a status message from the monitor_agent - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 208
create a FIFO has failed because system resources are at their limits. Script error -- HP Clustered File System spawn a monitor process failed monitor_agent on server X.X.X.X in order to write Script error -- HP Clustered File System failed to launch agent monitor_agent An attempt to create - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 209
. PSFS Filesystem Messages If you receive a panic message from the PSFS filesystem, report it to HP Technical Support at your earliest convenience. Then reboot the affected server to recover from the error condition. Distributed Lock Manager Messages The Distributed Lock Manager (DLM) generates - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 210
server or the server is removed from the cluster. SCL Messages If messages such as the following appear in the HP Clustered File System event log, the cluster may not be able to start up properly. Consult HP Technical Support indicate that there is a problem with the specified network interfaces. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 211
If PanPulse determines that the interfaces are down or unavailable on another server, it will report the following: No interfaces are responding on host for a network interface are not met. IPv-4 Only IPv4 is supported. If another address family is specified for the network, PanPulse will report - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 212
Appendix B: Error and Event Log Messages 203 Port 8940 Only one instance of PanPulse can be running on port 8940 on a server. If another application is using that port or another instance of PanPulse is started, the following error will be reported. Unable to bind on port - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 213
device monitor 123 network interface 37 notifier 136 PSFS filesystems 65 SAN disks 43 server 28 service monitor 108 system design guidelines 11 virtual host 92 configurations, supported 12 custom monitors device 121 service 108 D device database defined 9 membership partitions 44 device monitor 204 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 214
-active 119 troubleshooting 179 device monitor configuration add or update 123 advanced settings probe severity 126 script ordering 130 servers 132 virtual 25 defined 11 device monitor event severity behavior 129 view 134 service monitor clear from Console 118 event severity behavior 115 view 118 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 215
service monitor 106 G GATEWAY device monitor 120 getting help 1 grpcommd process 8 H HP storage web site 1 technical support 1 HTTP service monitor 106 HTTPS service 162 display 164 inactivate 165 inactive 162 resilver 164 memory, server 11 mount path, filesystem assignment 72 mprepair utility 160 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 216
ports, network external 183 internal 183 primary server 10 probe severity, failover 102 psd driver 7 PSFS filesystem. See filesystem, PSFS server registry 66 service monitor activity status 182 applications, integrate with 153 defined 10 events 118 failover, test 142 troubleshooting 179 service - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.2.1 Windows St - Page 217
(Shared Memory Data Store) 9 SMTP service monitor 107 Start scripts device monitor 128 service monitor 113 Stop scripts device monitor 128 service monitor 113 subdevices, for dynamic volumes 51 T TCP service monitor 107 technical support, HP 1 troubleshooting monitors 179 V virtual host activeness
*403103-002*
*403103–002*
HP StorageWorks
Clustered File System 3.2.1
Windows Storage Server Edition
administration guide
Part Number: 403103–002
Second edition: February 2006