HP ProLiant DL380G5-WSS HP StorageWorks Clustered File System 3.6.0 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.6.0 Windows St - Page 1
HP StorageWorks Clustered File System 3.6.0 Windows Storage Server Edition command reference guide Part Number: 403105-005 Fifth edition: January 2008 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 2
and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft® is a U.S. registered trademark of Microsoft Corporation. HP Clustered File System 3.6.0 Windows Storage Server - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 3
x 1 HP Technical Support HP Storage website 1 HP NAS Services website 2 2 HP Clustered File letters and mount points 5 dlmdebug.exe - debug DLM problems 5 eventlog.exe - dump the contents of the event exe - determine a server's IP address 7 idfence.exe - fence a server during a fencing test - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 4
.exe - container for cluster components 26 mxsetsecret.exe - set the network secret password 27 mxstart.exe - start HP Clustered File System processes 27 mxstop.exe - stop HP Clustered File System processes 27 partresize.exe - grow a partition 27 pathfilter.exe - translate the install path 28 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 5
sdmp.exe, sdmp_ctl.exe - protect filesystem integrity 48 sentinels.exe - show service dependencies 49 smds.exe - show UI status 49 snapctl - manage snapshot .exe - test server-based fencing 50 3 mx Commands The matrixrc file 51 Format of the .matrixrc file 51 Specify servers in the .matrixrc - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 6
Contents vi mx role - role management commands 101 mx server - server commands 103 mx service - service monitor commands 106 mx snapshot - snapshot commands 109 mx vfs - Virtual CIFS Server commands 111 mx vfs_share - Virtual File Share commands 113 mx vhost - virtual host commands 117 mx - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 7
Administrative Commands Function CIFS Manage Cluster File Shares Manage Virtual CIFS Servers Manage Virtual File Shares Event notification services and event log Add a message to the event log Manage event notifier services View events in the cluster event log Filesystem Create a filesystem Destroy - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 8
configuration information Verify cluster requirements on server Membership partitions Create or repair Display mxcheck mprepair mx config mp mprepair mpimport mpdump mpimport -X mpdump -X mx device mx service psfsquota mx quota psfsrq psfsdq mx account mx role sandiskinfo mx disk mx disk status - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 9
Manage dynamic volume Recover a dynamic volume Command sandiskinfo mx dynvolume PSANinfo sandiskinfo hbaapidump PSANinfo Page 44 75 28 44 6 28 mx server 103 mx server read_license 103 mx matrix log 87 mxcheck 21 mx snapshot 109 mx snapshot showcreateopt 110 mx mni 90 mx vsql 119 mx - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 10
Check and repair a filesystem Restore quota data Log files Collect logs for HP Support View events in the cluster event log Matrix Alert messages, display Cluster requirements, verify on server Restore configuration from dump file Membership partitions Create or repair membership partitions Restore - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 11
, unfence ports SAN disk information, display SAN ownership locks, display Server access to SAN, check Unfence ports on FC switches Servers Mark server as down Cluster logs, collect for HP Support Cluster requirements, verify Server access to SAN, check Volumes Recover a dynamic volume Command - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 12
error messages • Operating system type and revision level • Detailed, specific questions HP Storage website The HP website 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 website - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 13
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 at http://www.hp.com/hps/storage/ns_nas.html. For the latest documentation, go to http://www.hp.com/support/manuals. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 14
The bin directory includes several .dll libraries that are used by the HP Clustered File System tools. These libraries should not be removed or files should not be executed manually. Scripts The bin and tools directories contain scripts that are used by HP Clustered File System programs. These - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 15
are used internally by HP Clustered File System or should be run only at the request of HP personnel when diagnosing problems on your system. HP Clustered File System Role-Based Security feature described in the HP StorageWorks Clustered File System Administration Guide. These users should use the HP - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 16
bin\dledit Description This command assigns drive letters and mount points to PSFS filesystems. It is used internally by HP Clustered File System and should never be run directly. dlmdebug.exe - debug DLM problems Synopsis tools\dlmdebug Description This utility should be run only at the request of - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 17
be run only at the request of HP personnel. get_fenceidentity.exe - retrieve fencing information Synopsis bin\get_fenceidentity Description This command is used internally during HP Clustered File System configuration and should not be run manually. hbaapidump.exe - display LUN information Synopsis - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 18
HP Clustered File System Commands 7 Description This tool displays information about the LUNs seen by the HBA drivers and can be used to verify that the HBA libraries are working correctly. hn2ip.exe - determine a server's IP address Synopsis bin\hn2ip Description This command determines a server - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 19
the cluster log This utility provides several commands that are used internally by HP Clustered File System; however the following commands may be useful when administering a display events from the cluster event log on the local server. The options are: -b Display the output in XML format. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 20
Chapter 2: HP Clustered File System Commands 9 -c Do not display column headings in the output. -h processid The category assigned to the event. Categories group related events (for example, SAN and Server are categories). The ID assigned to a category. The ID assigned to the event. The time - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 21
Chapter 2: HP Clustered File System Commands 10 severity The severity level such as Alert or Critical. source The component that generated the message. subject The object to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 22
Chapter 2: HP Clustered File System Commands 11 location processid eventid The text included with the message. This field has the same restrictions as the subject field. Operations. The supported filter operations are: = Test if a filter event field is equal. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 23
Chapter 2: HP Clustered File System Commands 12 Filter examples. These examples are logical statements that could be used as a in an mcs select command. postedtime > - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 24
Chapter 2: HP Clustered File System Commands 13 The options are: -F Send the data to the default membership partition backup file, which is a dynamic volume.) The utility can also be used to deport disks or dynamic volumes from the SCL database or to replace a specific UID with a different UID. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 25
occur if the utility is executed while HP Clustered File System is running on a node. mpimport fails if HP Clustered File System is running on the devices to be imported even if they are not physically visible on the server. Consequently, successfully completion of the utility does not mean that the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 26
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 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 27
is the normal status. FENCED. The server has been fenced and cannot access the SAN. Start HP Clustered File System if it is not running or reboot the server. NOT_FOUND. The mprepair utility cannot find the device containing the membership partition. There may be a problem with the disk or with - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 28
2: HP Clustered File System Commands 17 RESILVER. The membership partition is valid but its MP list does not match the server's local import a disk that was previously used by another cluster. To fix this problem, use the --inactivate_mp option (described under "mprepair Options" below) to change - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 29
window. When the Configure Cluster window appears, select the Cluster Wide Configuration tab. Select the other servers in the Address column and then click Export. mprepair Options HP Clustered File System can operate with either one membership partition or three membership partitions. To ensure - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 30
database records for the partitions. Resilver Membership Partitions. Typically, HP Clustered File System writes data to one membership partition and , in certain situations you may need to perform the resilver operation manually. For example, a membership partition might become corrupt or a local - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 31
that contains an active membership partition. Clear the Host Registry. The --clear_hr option removes all entries from the server registry. This command should be used only under the direction of HP Support. Reset the Cluster ID. When a cluster is created, it is assigned a cluster ID that is used - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 32
File System. The utility is run automatically whenever HP Clustered File System is booted. You can also run mxcheck manually. The utility performs the following checks on the server: • System check: hardware, operating system version, service pack version, available physical memory. • Network check - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 33
the cluster. The utility is typically run under the direction of HP Support. You will need to run the mxcollect utility on each node. from either a cluster server or a local machine outside the cluster. See the HP StorageWorks Clustered File System Administration Guide for more information about - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 34
HP Clustered File System Commands 23 mxsancheck.exe - check SAN access Synopsis bin\mxsancheck Description The mxsancheck command determines whether a server before HP Clustered File System is started. be managed by HP Clustered File System Description HP Clustered File System uses a - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 35
Chapter 2: HP Clustered File System Commands 24 into two or more network partitions, the SANlocks ensure that only one of the resulting network partitions has access to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 36
Chapter 2: HP Clustered File System Commands 25 • trying to lock, cannot access The host on which mxsanlk was run is trying to acquire the SANlock but is - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 37
it. This step should restart the SDMP process. If you continue to have problems, contact HP Support. mxservice.exe - container for cluster components Synopsis bin\mxservice Description This single service controls the starting, stopping, and failure detection for all of the operational components - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 38
network secret password Synopsis bin\mxsetsecret Description This command is used during cluster configuration and should be run manually only at the request of HP personnel. mxstart.exe - start HP Clustered File System processes Synopsis bin\mxstart Description This command is used internally by - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 39
PSANcfg [-hu] [-[lL] ] [switch ...] Description The PSANcfg command can be used to add or remove local HBA port information in the HP Clustered File System configuration and to unfence ports on FibreChannel switches. The options are: -l, -L The -l command adds the specified HBA port to the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 40
Chapter 2: HP Clustered File System Commands 29 Description The PSANinfo command can be used to print the Naming Database or to get a snapshot 1 Poll time: 0.37 psdcoinst.exe - manage the psd process Synopsis bin\psdcoinst Description psdcoinst is an internal process and should not be run manually. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 41
Commands 30 psdctl.exe - display device bindings Synopsis bin\psdctl Description This command should be run only at the request of HP personnel. psfscheck.exe - check or repair a filesystem Synopsis bin\psfscheck [options] device Description The psfscheck utility looks for a PSFS filesystem on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 42
Chapter 2: HP Clustered File System Commands 31 NOTE: The psfscheck utility requires exclusive access to the device. If it cannot obtain this access, it will forcibly dismount - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 43
the FZBM feature on the specified filesystem. The upgrade-fs and --downgrade-fs options are obsolete. Enable sparse files As of the 3.4 release, HP Clustered File System provides support for sparse files. To enable sparse files on a PSFS filesystem that was created under an earlier version of - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 44
Chapter 2: HP Clustered File System Commands 33 calculated in bytes. (The default is rounded down to the nearest filesystem block.) --set-sdq [T|G|M|K] Set the default soft - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 45
the files. psfsdebug.exe - obtain a filesystem image Synopsis tools\psfsdebug Description This command should be run only under the direction of HP personnel. psfsdq.exe - save quota data Synopsis bin\psfsdq [-f ] Description The psfsdq command prints a quota summary for all users - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 46
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 maximum number of nodes that can mount a filesystem. This option is for internal HP Clustered File System use only. It should not be specified on the psfsformat - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 47
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." enable-quotas Enable quotas on the filesystem. The following options can be used - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 48
Chapter 2: HP Clustered File System Commands 37 loghardlimit File operations that result in exceeding a user's hard limit are logged in the system event log. nologhardlimit File operations - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 49
Chapter 2: HP Clustered File System Commands 38 • By the psd or psv name, such as psd2p2 or psv1 You do not need to specify the full path - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 50
Chapter 2: HP Clustered File System Commands 39 psfsquota.exe - manage disk quotas Synopsis bin\psfsquota [] Description The psfsquota command can be used to enable or - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 51
Chapter 2: HP Clustered File System Commands 40 --rebuild-quotas Recalculate quota allocations. -y Answer "yes" to all questions. The following options can be used with the --enable-quotas - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 52
and the partition on which it is located. When this option is used, HP Clustered File System runs the psfsresize command to grow the PSFS filesystem on the the specified filesystem on all servers where it is mounted; however, the utilities should be executed on only one server in the cluster. When - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 53
Chapter 2: HP Clustered File System Commands 42 NOTE: If an attempt to mount the copied filesystem fails with an "FSID conflict" error, run the following command. In - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 54
Chapter 2: HP Clustered File System Commands 43 The psfsresume utility restores a suspended filesystem. The psfssuspend and psfsresume utilities affect the specified filesystem on all servers where it is mounted; however, the utilities should be executed on only one server in the cluster. To - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 55
Chapter 2: HP Clustered File System Commands 44 registry.exe - dump registry contents and also for dynamic volumes. Under normal operations, the sandiskinfo output should be the same on all servers in the cluster. Disk information With no options, sandiskinfo displays the UID, vendor, model, and - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 56
local device name. -r Additionally display local device route information. -U Display output in the format used by the HP Management Console. This option is used internally by HP Clustered File System and does not produce human-readable output. -q Suppress output of all log messages. Following - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 57
Chapter 2: HP Clustered File System Commands 46 Local Device Paths: \\.\Global\PhysicalDrive3 partition 01: size 16M type (PSMP/Active) partition 02: size 9398M type (PSMP/Inactive) partition - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 58
Chapter 2: HP Clustered File System Commands 47 Options for dynamic volumes The following sandiskinfo options apply only to dynamic volumes. Show available subdevices The --subdevices option lists - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 59
shared folders Synopsis bin\scsf Description This command is used internally by HP Clustered File System and should never be run directly. sdmp.exe, failure causes some servers in a cluster to be unable to communicate with other servers. These processes are used internally by HP Clustered File System - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 60
Clustered File System Commands 49 sentinels.exe - show service dependencies Synopsis bin\sentinels Description This command is used internally by HP Clustered File System and should never be run directly. smds.exe - show UI status Synopsis tools\smds Description This command should be run only at - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 61
. spstat.exe - show cluster state information Synopsis tools\spstat Description This command should be run only at the request of HP personnel. wmtest.exe - test server-based fencing Synopsis tools\wmtest Description This command is used for testing purposes and should be run only at the request of - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 62
administering a cluster and monitoring its operation. The matrixrc file HP Clustered File System can use an optional, external configuration file server if you add the connection to your bookmarks. If you use only the Connect window to connect to the cluster, you should not need to do any manual - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 63
file" on page 54.) • The fourth field, default, specifies that this server will be connected to by default if a server name is not specified on the command line. Specifying a default server is optional in HP Clustered File System 3.2.x and later releases. Blank lines and lines beginning with - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 64
specifies that srv3 is the default. srv1 administrator srv2 administrator srv3 administrator secret1 secret1 secret2 default When you issue a mx command without specifying a server name, as in the following example, it connects to the machine specified as the default in the .matrixrc file. mx - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 65
servers in the order that they are specified in the list. # production cluster prod administrator secret1 default { srv1 srv2 srv3 administrator secret1 default srv4 administrator secret2 } Encrypted passwords in the .matrixrc file Passwords are encrypted automatically when you use the HP Clustered - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 66
you want to connect with. cluster can be any node in the cluster. --config Specifies an alternate configuration file to be consulted for server, user, and password information. The file must have the same format as matrixrc. --file Executes the commands from the specified file. If you - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 67
mfs mni Cluster Object Operating system accounts specified in management roles HP Clustered File System alert messages A grouping of HP Clustered File System resources (virtual hosts, service and device monitors) Initial cluster configuration Membership partition configuration Snapshot method - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 68
operations Server Service monitor Snapshot Virtual CIFS Server Virtual File Share Virtual host Virtual SQL Server Virtual SQL Server instance To |USER> ... This command associates a role with a specific user or group account. The user or group will be granted the cluster authorization assigned - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 69
Chapter 3: mx Commands 58 The options are: --form Whether the account is specified by name or ID. The default is NAME. --type Whether the account is for a user or group, or is unknown. The default is GROUP. listroles-List the role memberships of an account mx account - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 70
Commands 59 This command removes the specified role from a specific user or group account. The user or group will no is NAME. mx alert - cluster alert commands Use the following command to view HP Clustered File System alerts. alert-Display all outstanding alerts mx alert status [--severity < - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 71
disable enable-Enable an application mx application enable rename-Rename an commands must be entered in a specific order. See Appendix A in the HP StorageWorks Clustered File System Installation Guide for more information. Command check - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 72
mx config dump This command can be used when the cluster is either online or offline. export-Export the cluster configuration mx config export ... This command can be used when the cluster is either online or offline. fcfencing-Set FibreChannel as the fencing method mx config fcfencing - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 73
option to enter the appropriate value. The SNMP community string must be set to the same value on HP Clustered File System and on the SAN switches. import-Import the cluster configuration mx config import This command can be used when the cluster is either online or offline. license-Set the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 74
protocol (either Multicast or Unicast). Multicast is the default. [--santype] The current storage type (either FibreChannel or iSCSI). [--servers] The servers currently in the cluster. [--snapshots] The snapshots currently in the cluster. [--status] The current status of the cluster (STARTING - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 75
shutdown). [--vendor ] The remote management controller vendor (dell, hp, ibm, or ipmi). protocol-Set the administrative traffic protocol: mx anything you want. testfencing-Test the fencing configuration mx config testfencing ... This command can be used when the cluster is either - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 76
Remote Management Controller. [--sharedlogin yes|no] Whether the login is shared by all servers. --type reset|shutdown When a server needs to be restricted from the SAN, HP Clustered File System can either power-cycle the server or shut it down. Select the method that you want to use (either reset - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 77
be entered in a specific order. See Appendix A in the HP StorageWorks Clustered File System Installation Guide for more information. time). • In a cluster with three membership partitions, when HP Clustered File System started on a server, it reported that a single membership partition was corrupt ( - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 78
resilver the partitions or use set to replace the partitions). When performing other operations with the set or repair commands, HP Clustered File System must be offline on all servers in the cluster. dump-Dump the membership partition configuration to stdout mx config mp dump list-List the current - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 79
Chapter 3: mx Commands 68 [--showborder] Display borders in the output. repair-Repair a membership partition mx config mp repair [--reuse] This command can be used to resilver a corrupt membership partition. is the disk UID of the membership partition to be repaired. The --reuse - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 80
add a new snapshot method configuration mx config snapshot add --method [--options ] The options are: --method The supported types are hpeva and engenio. [--options ] For hpeva, specify the following: --hostname The hostname for the management - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 81
configuration mx config snapshot test --method --hostname | --controllerA The options are: --method The supported types are hpeva and engenio. --hostname |--controllerA For hpeva, use the --hostname option to specify the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 82
] --type specifies the type of device monitor to be created: CUSTOM, DISK, GATEWAY, SHARED_FILESYSTEM, or NTSERVICE. --servers specifies the server or servers that use the monitored device. The can include up to 32 characters. The optional arguments are: [--application - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 83
address must be on a different subnet than the servers in the cluster. • CUSTOM device monitor. The parameter services to be started, you can also specify the number of attempts that should be made. Use a semicolon to separate the values (for example, Yes;3). [--ordering serial|parallel] Whether HP - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 84
and device monitors are down. With always, 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. With multiple, the monitor is active simultaneously on all selected - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 85
monitors. update-Modify a device monitor mx device update [arguments] ... The arguments are the same as the device add command; however, the --servers argument is not required and the monitor type cannot be changed. mx disk - disk commands Use the following mx disk commands to import - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 86
Chapter 3: mx Commands 75 dump-Dump disk configuration to stdout mx disk dump import-Import a disk into the cluster mx disk import ... Use the disk status command to determine the uuid for the disk. This command does not display an error message if the import fails. To verify that the disk - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 87
before doing this. deport-Deport a dynamic volume mx dynvolume deport ... destroy-Delete a dynamic volume mx dynvolume destroy ... A filesystem cannot be mounted on the volume that will be deleted. dump-Dump dynamic volume configuration to stdout mx dynvolume dump - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 88
Chapter 3: mx Commands 77 Show all dynamic volumes that are available to be imported. [--unimportable] Show all dynamic volumes that cannot be imported. [--imported] Show all dynamic volumes that are currently imported. [--unimported] Show all dynamic volumes that are currently unimported. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 89
in the event catalog Remove cluster event definitions from a notification service Restore event definitions to the HP Clustered File System defaults Test an event notification service View configuration of event notification services addevents-Add cluster event definitions to a notification - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 90
will be added to all notification services. configureemail-Configure the email notification service mx eventnotifier configureemail --to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 91
not reside on a shared filesystem, ensure that it is replicated to the specified path on all servers. configuresnmp-configure the SNMP trap event notification service mx eventnotifier configuresnmp [--addtarget|--removetarget] [--community ] The is the hostname or IP address - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 92
will be disabled. enable-Enable an event notifier service mx eventnotifier enable [--snmp] [--email] [--script] [--snmp] Enable the SNMP notification service. [--email] Enable the email notification service. [--script] Enable the script notification service. If none of the options are specified, all - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 93
System defaults mx eventnotifier restoreevents [--snmp] [--email] [--script] By default, HP Clustered File System configures the notification services with certain event IDs. You can then use addevents or removeevents to customize the notification services with the events that you want to track. The - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 94
Chapter 3: mx Commands 83 [--email] Restore the email notification service configuration to the HP Clustered File System default settings. [--script] Restore the script notification service configuration to the HP Clustered File System default settings. If none of the options are specified, the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 95
, the output will include the configuration of all event notification services. mx fs - filesystem commands Use the following mx fs mx fs assignpath --path [--createdir] ALL_SERVERS | ... If a mount path is specified, the --createdir option can be used to - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 96
Chapter 3: mx Commands 85 [--reuse] Reuse a psd device. If you will be creating a filesystem on a psd device that is associated with an unimported dynamic volume, the -reuse option must be used to tell the command to reuse the device. Without this option, the attempt to create the filesystem will - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 97
the files. dump-Dump filesystem configuration to stdout mx fs dump getdriveletters-Display drive letters in use on a server mx fs getdriveletters --server | ALL_SERVERS queryassignments-Display drive letter or path assignments for a filesystem mx fs queryassignments ALL_SERVERS - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 98
may need to perform the reconfiguration manually. dump-Dump cluster configuration information The following command dumps configuration information to stdout. The information includes the configuration of servers, network interfaces, virtual hosts, service and device monitors, notifiers, disks, and - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 99
letter or path assigned to the PSFS filesystem that will be accessed via this share. Following is an example: mx mfs add --path y:\myshared --servers ALL_SERVERS mymfs1 The options are: [--timeout ] The maximum amount of time to wait for a probe of the file share to complete. The default - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 100
-based Enumeration feature provided with Windows 2003 Service Pack 1. This feature allows users to manual | documents | programs | none>] Enables or disables offline caching. The arguments are: • manual File Share mx mfs disable [ALL_SERVERS]| ...] dump-Dump the Cluster File Share - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 101
instances installed on the cluster List all product definitions created with the setproduct command List SQL Server versions that are supported with MxDB for SQL Server Remove a product definition Create or modify a product definition install-Install or upgrade one or more SQL instances on one - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 102
option dumps the product definitions in XML format. listversions-List the SQL Server versions that are supported with MxDB for SQL Server mx mni listversions Use base to list base products, sp to list service packs, and hf to list hotfixes. removeproduct-Remove a product definition mx - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 103
Server product type. base is a base product, sp is a service pack, and hf is a hotfix. --version The SQL Server version (either SQL2000 or SQL2005). --location For a SQL Server Do not use the network interface for HP Clustered File System administrative traffic Do not - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 104
93 add-Add a network interface mx netif add --server --netmask [--adminTraffic ] --adminTraffic specifies whether the network interface should be available for HP Clustered File System administrative traffic. allow is the default - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 105
Chapter 3: mx Commands 94 [--allowadmintraffic|--discourageadmintraffic| --excludeadmintraffic] [--active|--inactive] [--noHeaders] [--csv] [ ...] The options are: [--up|--down] Select network interfaces that are either operational or down. [--enabled|--disabled] Select network - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 106
more filesystems mx quota enable [opt-args] ALL_FILESYSTEMS| ... Quotas can be enabled on all PSFS filesystems or on specific psd or psv devices. The optional arguments are: [--defaultUserHardLimit ] The default hard limit for the filesystem. unlimited means that - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 107
Chapter 3: mx Commands 96 kilobytes. (The default is rounded down to the nearest filesystem block.) If this option is not used, the default will be unlimited. [--defaultUserSoftLimit ] The default soft limit for users on the filesystem who not have not been assigned an - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 108
Chapter 3: mx Commands 97 The default hard limit for all users on the filesystem. unlimited means that the default is unlimited. The size modifiers are K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). If a modifier is not specified, the size is calculated in kilobytes. (The default - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 109
Chapter 3: mx Commands 98 Whether the output should be in bytes, kilobytes, megabytes, gigabytes, or terabytes. [--force] Continue with the command even if some specified filesystems do not have quotas enabled. [--noHeaders] Do not display column headers in the output. [--csv] Display the output - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 110
Chapter 3: mx Commands 99 The soft limit to be applied to the specified users. The size modifiers are K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). If a modifier is not specified, the size is calculated in kilobytes. [--force] Continue with the command even if some of the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 111
Chapter 3: mx Commands 100 [--name ] One or more user names. You can also enter a regular expression. [--regex] The value specified for --name is a regular expression. [--unit ] Whether the output should be in bytes, kilobytes, megabytes, gigabytes, or terabytes. [-- - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 112
Chapter 3: mx Commands 101 The value specified for --name is a regular expression. [--hardLimitRange -] A range of hard limits. [--spaceUsedRange -] A range of disk space usage. [--percentUsedRange - - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 113
Chapter 3: mx Commands 102 Command import list listmembers Description Import role definitions from a file List cluster roles List members of a cluster role delete-Delete a cluster role mx role delete This command deletes a role from the cluster. Accounts belonging to the role will - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 114
one or more previously disabled servers List the servers in a cluster List the operating system and HP software installed on the server Mark a server as down Read the license file on a server Start HP Clustered File System on one or more servers Display server status Stop HP Clustered File System on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 115
list This command can be used when the cluster is either running or offline. listsoftware-List the operating system and HP software installed on the server mx server listsoftware [ ...] If the operating system uses the 64-bit architecture, x64 will be specified in the output. Otherwise, the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 116
Cannot Be Fenced" in Chapter 17 of the HP StorageWorks Clustered File System Administration Guide. CAUTION: Be sure to verify that the server is physically down or physically disconnected from the shared storage before running the mx server markdown command. Filesystem corruption can occur is the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 117
106 Filter the output, displaying only those events that match the specific . If this option is not specified, all events will Display borders in the output. mx service - service monitor commands Use the following mx service commands to configure service monitors or to display their status. - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 118
No). If you want the services to be started, you can also specify the number of attempts that should be made. Use a semicolon to separate the values (for example, Yes;3) • CUSTOM monitor. The parameter is a probe script. [--ordering SERIAL|PARALLEL] Whether HP Clustered File System enforces a strict - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 119
to complete. [--startScript ] When HP Clustered File System selects the active server for a monitored service, the Start script runs on that server. [--stopScript ] A script that runs on all other servers configured for the service monitor to ensure that the service is not active on - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 120
disable ... dump-Dump the service monitor configuration to stdout mx service dump enable-Enable a service monitor mx service enable ... status-Display the status of a service monitor mx service status [arguments] [] The arguments are: [--up - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 121
Chapter 3: mx Commands 110 --method The method can be hpeva or engenio. This option must always be specified for engenio snapshots. For hpeva snapshots, the option is needed only if more than one snapshot method is configured on the system. --terse On success, only the name of the snapshot - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 122
configured with ALL_SERVERS, any new nodes added to the cluster are also added automatically to the Virtual CIFS Server. The HP Management Console does not specify whether a Virtual CIFS Server has been configured with ALL_SERVERS. In addition, you cannot use the Properties or Rehost options on the - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 123
which point the Virtual CIFS Server fails over to that node. (On a "healthier" node, more of the services associated with the Virtual CIFS Server will be up than on the node currently hosting the Virtual CIFS Server.) [--application ] The HP Clustered File System application associated - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 124
command allows you to add or remove interfaces from the Virtual CIFS Server configuration and to reorder the interfaces. If you specify a different primary need to use the vfs move command shown below to move the service. mx vfs_share - Virtual File Share commands Use the following mx vfs_share - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 125
service is restored, fails the Virtual CIFS Server back to the original network interface. noautorecover fails over the Virtual CIFS Server but does not fail it back after the service is restored. autorecover is the default. For more information, see the FS Option for Windows Administration Guide - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 126
lower priorities. If multiple failures prevent ClusterPulse from placing a Virtual CIFS Server on a node where all of its associated services are available, ClusterPulse next looks for a node where the associated service with the highest priority is available. The default priority is 0. [--ordering - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 127
] Enables the Access-based Enumeration feature provided with Windows 2003 Service Pack 1. This feature allows users to see only the files and folders to which they have access on a file share. [--caching ] Enables or disables offline caching. The arguments - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 128
host rehost, or move, a virtual host to another server show status for a virtual host modify an existing virtual are: [--application ] The HP Clustered File System application associated with this provides equal or greater services than the backup node; nofailback fails back only - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 129
Chapter 3: mx Commands 118 [--activitytype single|always] Whether, upon server failure, the virtual host will move to an active server if all associated service and device monitors are inactive or down. If always is specified, the failover will occur. If single is specified, the failover will not - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 130
change the arguments or the ordering of the network interfaces for failover. mx vsql - Virtual SQL Server commands Use the following mx vsql commands to configure Virtual SQL Servers or to display their status. Command add delete disable dump enable maintain move operate status update Description - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 131
There is one MSDTC service on each machine. This option enables transactions that span one or more Virtual SQL Servers. However, the following limitations exist when using a Virtual SQL Server with MSDTC: • Because only one MSDTC resource exists per machine, you can define MSDTC support for only one - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 132
sure to specify the --msdtc option if MSDTC should be virtualized. If this option is omitted, MSDTC will not be virtualized. operate-Return a Virtual SQL Server from maintenance mode to operation mode mx vsql operate status-View status for a Virtual SQL - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 133
monitor runs the probe. The default is 10 seconds. [--restarts ] The number of attempts that should be made to restart the SQL service instead of immediately failing over the Virtual SQL Server. If you do not - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 134
of time to wait for the script to complete. [--startScript ] When HP Clustered File System selects the active server for the SQL service, the Start script runs on that server. [--stopScript ] A script that runs on all other servers configured for the monitor to ensure that the SQL - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 135
If multiple failures preventHP Clustered File System from placing a Virtual SQL Server on a node where all of its associated services are available, HP Clustered File System next looks for a server where the associated service with the highest priority is available. The default is 0. [--revirtualize - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 136
Chapter 3: mx Commands 125 The arguments are the same as vsqlinstance add, with the exception that the --vpath, --revirtualize, and --port arguments do not apply. If you need to change the port assignment, first delete the Virtual SQL Instance and then recreate it using the new port number. sleep - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 137
eventnotifier 78 mx fs 84 mx matrix 86 mx mfs 88 mx mp 66 mx netif 92 mx quota 94 mx role 101 mx server 103 mx service 106 mx snapshot 109 mx vfs 111 mx vfs_share 113 mx vhost 117 mx vsql 119 mx vsqlinstance 122 mxcheck 21 mxcollect 22 mxconsole - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 138
47 properties 78 recreate 78 E email event notifier 79 event log add a message 8, 87 display events 8 view with mcs select 8 view with mx server viewevents 105 event notifier services email 79 enable or disable 81 import or export settings 81 manage 78 script 80 snmp 80 test 83 events, clear device - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 139
Bit Map (FZBM) enable or disable 32 G getting help 1 H HBA ports add or remove 28 host registry, clear 20 HP NAS services website 2 storage website 1 technical support 1 L license file 105 LUNs display HBA's view of LUNs 6 display information with sandiskinfo 44 128 M Management Console, start 22 - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 140
information 101 R reg files 3 resilver specific partition 19 roles assign users or 23 status of 105 view events 105 service monitor add 106 delete 109 enable or support, HP 1 U users display quotas 99 remove quotas 100 set quotas 98 users or groups manage role assignments 57 V Virtual CIFS Server - HP ProLiant DL380G5-WSS | HP StorageWorks Clustered File System 3.6.0 Windows St - Page 141
disable 118 status of 118 Virtual SQL Instance add 122 delete 124 disable 124 dump configuration 124 enable 124 status 124 update 124 Virtual SQL Server 130 add 119 delete 120 disable 121 dump configuration 121 enable 121 maintenance mode 121 rehost 121 status 121 update 121 W websites
HP StorageWorks
Clustered File System 3.6.0
Windows Storage Server Edition
command reference guide
Part Number: 403105–005
Fifth edition: January 2008