HP StorageWorks Clustered File System 3.6.
Legal and notice information © Copyright 1999-2008 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents Functional Cross Reference Administrative Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x 1 HP Technical Support HP Storage website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 HP NAS Services website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 HP Clustered File System Commands Overview . . . . . . .
Contents iv mcs select – display events from the cluster event log . . . . . . . . . 8 mpdump.exe – back up membership partition data. . . . . . . . . . . . . 12 mpimport.exe – restore membership partition data . . . . . . . . . . . . . 13 mprepair.exe – repair membership partitions . . . . . . . . . . . . . . . . . . 15 msmtool.exe – diagnose the MSM process. . . . . . . . . . . . . . . . . . . . . 21 mx.exe – administer a cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents registry.exe – dump registry contents . . . . . . . . . . . . . . . . . . . . . . . . . sandiskinfo.exe – show disk or LUN information . . . . . . . . . . . . . . Disk information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options for dynamic volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . scsf.exe – shadow copies of shared folders . . . . . . . . . . . . . . . . . . . . sdmp.exe, sdmp_ctl.exe – protect filesystem integrity . . . . . . . . . . .
Contents mx role – role management commands . . . . . . . . . . . . . . . . . . . . . . mx server – server commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mx service – service monitor commands . . . . . . . . . . . . . . . . . . . . . mx snapshot – snapshot commands . . . . . . . . . . . . . . . . . . . . . . . . . mx vfs – Virtual CIFS Server commands . . . . . . . . . . . . . . . . . . . . . mx vfs_share – Virtual File Share commands . . . . . . . . . . . . . . . . .
Functional Cross Reference Administrative Commands Function Command Page CIFS Manage Cluster File Shares mx mfs 88 Manage Virtual CIFS Servers mx vfs 111 Manage Virtual File Shares mx vfs_share 113 Add a message to the event log mx matrix log mcs log 87 8 Manage event notifier services mx eventnotifier 78 View events in the cluster event log mcs select mx server viewevents Event notification services and event log 8 105 Filesystem Create a filesystem psfsformat mx fs create 35 84 D
Functional Cross Reference Function viii Command Page Matrix Applications, manage mx application 59 Configuration, initial mx config 60 Configuration, membership partitions mx config mp 66 Configuration, snapshot method mx config snapshot 68 Dump configuration information mx matrix dump 87 Verify cluster requirements on server mxcheck 21 Create or repair mprepair mx config mp 15 66 Display status mprepair 15 Restore membership partition data mpimport 13 Save membership partit
Functional Cross Reference ix Function Command Page Dynamic volumes, display information sandiskinfo 44 Dynamic volumes, manage mx dynvolume 75 FC logins, display PSANinfo 28 LUNs, display information sandiskinfo 44 LUNs, display LUNs seen by HBAs hbaapidump 6 Naming database, display PSANinfo 28 Add, update, enable, or disable server mx server 103 License file, read mx server read_license 103 Cluster event file, add message mx matrix log 87 Verify cluster requirements mxche
Functional Cross Reference x Diagnostic Commands Function Command Page Configuration Check status of cluster components mx config list mp config mp list 62 67 Test fencing configuration mx config testfencing 64 Mark server that cannot be fenced as “down” mx server markdown 104 Unfence ports on FC switches PSANcfg 28 Check and repair a filesystem psfscheck 30 Restore quota data psfsrq 42 Collect logs for HP Support mxcollect 22 View events in the cluster event log mcs select mx se
Functional Cross Reference Function xi Command Page FC switch, unfence ports PSANcfg 28 SAN disk information, display sandiskinfo 44 SAN ownership locks, display mxsanlk 23 Server access to SAN, check mxsancheck 23 Unfence ports on FC switches PSANcfg 28 Servers Mark server as down mx server markdown 104 Cluster logs, collect for HP Support mxcollect 22 Cluster requirements, verify mxcheck 21 Server access to SAN, check mxsancheck 23 mx dynvolume import 76 Volumes Recover a
1 HP Technical Support Telephone numbers for worldwide technical support are listed on the following HP website: http://www.hp.com/support. From this website, select the country of origin. For example, the North American technical support number is 800-633-3600. NOTE: For continuous quality improvement, calls may be recorded or monitored.
HP Technical Support 2 HP NAS Services website 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 at http://www.hp.com/hps/storage/ns_nas.html. For the latest documentation, go to http://www.hp.com/support/manuals.
2 HP Clustered File System Commands Overview HP StorageWorks Clustered File System includes several commands that can be helpful for administrators managing an HP Clustered File System cluster. Other HP Clustered File System commands provide diagnostic information and should be used only under the direction of HP personnel. HP Clustered File System also includes commands that are used internally and should not be run directly.
Chapter 2: HP Clustered File System Commands 4 .exe files The remainder of this chapter describes some of the executable commands included in the bin and tools directories. Some of these commands are useful for cluster administration. Other commands 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.
Chapter 2: HP Clustered File System Commands 5 Description This command forces a system reboot when certain error conditions exist during HP Clustered File System startup. It is used internally by HP Clustered File System and should never be run directly. diskupdate.exe – reattempt to access a disk Synopsis bin\diskupdate Description This command should be run only at the request of HP personnel. dismount.
Chapter 2: HP Clustered File System Commands 6 eventlog.exe – dump the contents of the event log Synopsis tools\eventlog Description This command is used internally by the mxcollect utility and should not be run directly. fsprobe.exe – report filesystem information Synopsis tools\fsprobe Description This command should be run only at the request of HP personnel. gcstat.exe – print grpcommd statistics Synopsis tools\gcstat Description This command should be run only at the request of HP personnel.
Chapter 2: 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’s IP address based on its hostname. The command is used internally during cluster configuration and should not be run directly. idfence.
Chapter 2: HP Clustered File System Commands 8 This command is used internally by HP Clustered File System and should not be run directly. (To create membership partitions, use the “Configure Cluster” feature on the HP Management Console.) mcs.exe – manipulate 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 cluster.
Chapter 2: HP Clustered File System Commands 9 -c Do not display column headings in the output. -h [] Display the specified number of events, starting at the beginning of the log. If is omitted, all matching events will be displayed. (If -t is also specified, it will not have any effect.) -h --count Display the number of matching events but not the events themselves. -t [] Tail mode (this is the default). Display the output starting with the most recent event.
Chapter 2: HP Clustered File System Commands severity The severity level such as Alert or Critical. source The component that generated the message. subject The object to which the event relates. subjecttype The description of the subject. subjecttypeid The ID assigned to the subject. 10 subjecttypename Used to identify the object to programs. user The user identified with the event. Audit messages and certain other messages have users.
Chapter 2: HP Clustered File System Commands 11 location The IP address from which the event was generated, specified in dotted-decimal format. processid The process ID of the process that logged the event (an integer between 0 and 65536). eventid The ID assigned to the event (the range of values is 0 to 65536). categoryid The ID assigned to the category for the event.
Chapter 2: HP Clustered File System Commands 12 Filter examples. These examples are logical statements that could be used as a
Chapter 2: HP Clustered File System Commands 13 The options are: -F Send the data to the default membership partition backup file, which is located by default at %SystemDrive%\Program Files\\conf\MP.backup{.prev}. This file can subsequently be used as input to the mpimport utility if needed. If there is an existing backup file, it will be saved as MP.backup.prev. -f Send the data to the specified output file. -v Output the data to both the screen and the file.
Chapter 2: HP Clustered File System Commands 14 NOTE: HP Clustered File System must be stopped on all nodes when mpimport is used. Database corruption can 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 current node; however, it does not check the other nodes.
Chapter 2: HP Clustered File System Commands 15 the psdname indicated in inputfile will be imported. If -s is not specified, disks and dynamic volumes will be imported with alternate names if necessary. The -M option recreates the membership partitions from scratch based on the contents of the input file. mpimport -r | [| ...] Remove the specified disks or dynamic volumes from the existing database.
Chapter 2: HP Clustered File System Commands 16 This command lists the current membership partitions according to the membership file maintained on the server where you are running the utility. Each server in the cluster has a membership partition file, which is called the “local MP list.” Each SAN disk containing a membership partition also has its own list of the membership partitions. Under normal operations, these lists should all match.
Chapter 2: HP Clustered File System Commands 17 RESILVER. The membership partition is valid but its MP list does not match the server’s local MP list. You will need to determine which membership partitions are correct (the partitions specified in the local MP list, or the partition labeled RESILVER) and resilver accordingly. CID_MISMATCH. The Cluster-ID is out-of-sync among the membership partitions and must be reset. See “Reset the Cluster ID” on page 20.
Chapter 2: HP Clustered File System Commands 18 After making 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 select the Configure option on the HP Clustered File System Connect 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.
Chapter 2: HP Clustered File System Commands 19 Search the SAN for Membership Partitions. To search the SAN for all partitions that appear to be membership partitions, type this command: mprepair --search_mps The output includes each membership partition found by the search and specifies whether it is active or inactive. The output also includes the membership list on the disk containing the partition and the database records for the partitions. Resilver Membership Partitions.
Chapter 2: HP Clustered File System Commands 20 UID/PART# indicates the membership partition to be resilvered. UID is the UID for the device and PART# is the number of the partition on the device. The membership partition is resilvered from a known valid membership partition. Without the --force option, the command will fail if mprepair cannot find two valid membership partitions to use as a source for the resilver operation.
Chapter 2: HP Clustered File System Commands 21 mprepair --get_current_mps can also be used to obtain more information about the membership partitions. msmtool.exe – diagnose the MSM process Synopsis tools\msmtool Description This diagnostics tool should be run only under the direction of HP personnel. mx.exe – administer a cluster The mx utility provides a command-line interface for administering a cluster and monitoring its operation.
Chapter 2: HP Clustered File System Commands 22 mxcollect.exe – collect configuration information Synopsis tools\mxcollect Description This utility collects configuration information and log files from the cluster. The utility is typically run under the direction of HP Support. You will need to run the mxcollect utility on each node. The utility is located in the %ProgramFiles%\Hewlett-Packard\HP Clustered File System\tools folder. Go to this location and double-click the file mxcollect.exe.
Chapter 2: HP Clustered File System Commands 23 mxsancheck.exe – check SAN access Synopsis bin\mxsancheck Description The mxsancheck command determines whether a server has SAN access and is ready to mount filesystems. The command is intended to be used in scripts and returns 0 on success and 1 on failure. mxsanconf.exe – configure FibreChannel switches Synopsis bin\mxsanconf Description In general, this command should not be run directly.
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 the SAN. Each SANlock is stored in a membership partition. Before a cluster can begin accessing the SAN, it must first acquire a majority of the SANlocks. The SANlocks are acquired in order. mxsanlk displays the status of the SANlock stored in each membership partition.
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 unable to access it. The membership partition may need to be repaired. • 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 holder.
Chapter 2: HP Clustered File System Commands 26 • lock is corrupt, will repair This transitional state occurs after the SDMP has detected that the SANlock has been corrupted but before it has repaired the SANlock. • trying to lock (lock is corrupt, will repair) The host on which mxsanlk was run is trying to acquire the SANlock. The SANlock was corrupted but will be repaired. • locked (lock is corrupt, will repair) The host on which mxsanlk was run holds the lock.
Chapter 2: HP Clustered File System Commands 27 mxsetsecret.exe – set the 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 Clustered File System and should never be run directly. mxstop.
Chapter 2: HP Clustered File System Commands 28 used, HP Clustered File System runs the partresize command to increase the size of the partition. This command is not intended to be run directly. pathfilter.exe – translate the install path Synopsis tools\pathfilter Description This command is used by the HP Clustered File System install process and should never be run directly. PSANcfg.exe – control port operations Synopsis bin\PSANcfg [-hu] [-[lL] ] [switch ...
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 of logins for a particular FibreChannel switch. The options are: -n Print the contents of the Naming Database. -s Wait seconds between probes of the FC switch. -u Wait microseconds between probes of the FC switch. If no options are specified, PSANinfo displays the status of the switch one time only. Following is a sample snapshot: Switch 10.10.11.
Chapter 2: HP Clustered File System 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 a device, replays transactions that are to be replayed, and either checks or repairs the filesystem.
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 the volume. The options for checking a filesystem 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.
Chapter 2: HP Clustered File System Commands 32 -y Causes psfscheck to answer “yes” to all questions. Enable or disable FZBMs The psfscheck utility also provides options to enable or disable Full Zone Bit Maps (FZBMs). This on-disk filesystem format reduces the amount of data that the filesystem needs to read when allocating a block. It is particularly useful for speeding up allocation times on large, relatively full filesystems.
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 quota on the specified filesystem. The optional modifiers specify that the size is in terabytes (T), gigabytes (G), megabytes (M), or kilobytes (K). If a modifier is not specified, the size will be calculated in bytes. (The default is rounded down to the nearest filesystem block.) --rebuild-quotas Recalculate quota allocations.
Chapter 2: HP Clustered File System Commands 34 --sparse-realcost Quota accounting for sparse files reflects the actual allocation of filesystem space to 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.
Chapter 2: HP Clustered File System Commands 35 The next command restores the data to the filesystem: # psfsrq -f psd1p5.quotadata psd1p5 psfsformat.exe – create a filesystem Synopsis bin\psfsformat [-fq] [-n max-nodes] [-l
Chapter 2: HP Clustered File System Commands 36 create the filesystem will fail because the device contains a volume signature. The -o option has the following parameters: blocksize=# Specify the block size (either 4096 or 8192) for the filesystem. disable-fzbm Create the filesystem without Full Zone Bit Maps (FZBMs). The FZBM on-disk filesystem format reduces the amount of data that the filesystem needs to read when allocating a block.
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 that result in exceeding a user’s hard limit are not logged. logsoftlimit File operations that result in exceeding a user’s soft limit are logged in the system event log. nologsoftlimit File operations that result in exceeding a user’s soft limit are not logged.
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 name. A name such as psd2p2 or psv1 will work. The options are: --feature Report whether the specified feature is enabled in the filesystem indicated by . The command can test for the following features. FZBM – the Full Zone Bit Map feature QUOTA – the disk quota feature If the feature is enabled, the name of the feature will be displayed.
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 disable quotas on a filesystem and to set quota options. device is a psd or psv device and can be specified in several ways: • By the drive letter, such as X: • By the mount point (junction), such as C:\san\vol2 • By the psd or psv name, such as psd2p2 or psv1 You do not need to specify the full path name.
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 option: --staticdq Quota limits for new users are copied from the default quota values set for the filesystem. --dynamicdq Quota limits for new users are linked from the default quota values set for the filesystem. If the default quota values are changed, the users’ quota limits will also change.
Chapter 2: HP Clustered File System Commands 41 --sparse-realcost Quota accounting for sparse files reflects the actual allocation of filesystem space to the files. The following example enables quotas on volume psv1 and sets the default hard limit to 20 gigabytes. psfsquota --enable-quotas --set-dq 20G psv1 psfsresize.
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 the command, is the partition that contains the copied filesystem, and
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 suspend a filesystem, issue a command in the following form on one server that has mounted the filesystem.
Chapter 2: HP Clustered File System Commands 44 registry.exe – dump registry contents Synopsis tools\registry.exe Description This command is used internally by the mxcollect utility and should not be run directly. sandiskinfo.
Chapter 2: HP Clustered File System Commands -a Display all information; for -v, display all known volumes. -l Additionally display host-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. 45 Following are some examples of these options.
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 03: size 16M type (PSMP/Inactive) 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: \\.
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 subdevices that are available for use in constructing a dynamic volume.
Chapter 2: HP Clustered File System Commands 48 Display unimported dynamic volumes The following options can be used to display information about unimported dynamic volumes: --unimported-volumes Lists dynamic volumes that are currently unimported. --importable-volumes Lists unimported dynamic volumes that can be imported into the cluster. --unimportable-volumes Lists unimported dynamic volumes that cannot be imported into the cluster. scsf.
Chapter 2: HP 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 the request of HP personnel. snapctl – manage snapshot operations Synopsis bin\snapctl Description This command is used internally by HP Clustered File System and should not be run directly.
Chapter 2: HP Clustered File System Commands spdebug.exe – obtain SanPulse debugging information Synopsis tools\spdebug Description This command should be run only at the request of HP personnel. spstat.exe – show cluster state information Synopsis tools\spstat Description This command should be run only at the request of HP personnel. wmtest.
3 mx Commands The mx utility provides a command-line interface for administering a cluster and monitoring its operation. The matrixrc file HP Clustered File System can use an optional, external configuration file named .matrixrc to provide authentication information for cluster connections. If the file is configured, it will be used when you connect to a cluster through either the Connect window or the mx command.
Chapter 3: mx Commands 52 • The first field, machine, is either the name or IP address of the server. • The second field, user, is optional. It is the name of a user on that server or the name of a user on a domain to which the server belongs (for example, mydomain\john). • The third field is also optional and contains the HP Clustered File System password for that user. The password is encrypted automatically when you use the HP Clustered File System Connect window to specify the password.
Chapter 3: mx Commands 53 Specify servers in the .matrixrc file If you need to control which server is used for the mx connection, list the servers individually in the matrixrc file or use the mx --matrix command-line option. If any server can be used for the connection, you can group the servers. List servers individually Add a line to the file for each server for which you want mx access and specify the appropriate username and password. This example specifies that srv3 is the default.
Chapter 3: mx Commands 54 Group servers This method allows mx to connect to any available server in the cluster without the need to specify a server name on the command line. To use this method, enclose the server entries in brackets, as in the following example for the prod cluster. # production cluster prod { srv1 administrator secret1 srv2 administrator secret1 srv3 administrator secret1 default } To connect to the cluster, include the option --matrix prod in the mx command.
Chapter 3: mx Commands 55 The mxgenpass.exe command asks for a password and then displays the encrypted version: mxgenpass.exe Enter password: 06c684c5:8cCRCT1aVCjzWb/TL7IHThBmrgY1wkBV6pElkzNr7ZI= Replace the password in the .matrixrc file with the encrypted password.
Chapter 3: mx Commands 56 --prompt Specifies the prompt string that will be printed when mx is ready for another command. This option is useful when you initiate an interactive session with the option --file -. For example, if you invoke an interactive session with the following command, mx will print a % prompt when it completes a command. mx --prompt ’%’ --file – --numeric Causes hosts to be specified by their numeric IP addresses instead of by their hostnames.
Chapter 3: mx Commands Class Cluster Object netif Network interface quota Disk quota role Management roles for cluster operations server Server service Service monitor snapshot Snapshot vfs Virtual CIFS Server vfs_share Virtual File Share vhost Virtual host vsql Virtual SQL Server vsqlinstance Virtual SQL Server instance 57 To specify a command affecting a class, use this syntax: mx For example, this command displays the status of servers that are up:
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 listroles [--form ] [--type ] [--effective] [--noHeaders] [--csv] [--showBorder] [] This command lists the roles to which the account belongs.
Chapter 3: mx Commands 59 This command removes the specified role from a specific user or group account. The user or group will no longer have the cluster authorization assigned to the role. The options are: --type Whether the account is for a user or group, or is unknown. The default is GROUP. --form Whether the account is specified by name or ID. The default is NAME. mx alert – cluster alert commands Use the following command to view HP Clustered File System alerts.
Chapter 3: mx Commands Command Description rename Rename an application status Show the status of applications 60 disable—Disable an application mx application disable enable—Enable an application mx application enable rename—Rename an application mx application rename status—Show status for an application mx application status [--severity OK|WARNING|ERROR] [ ...
Chapter 3: mx Commands Command Description santype Set the SAN storage type secret Set the cluster secret license key testfencing Test the fencing configuration webfencing Configure the web-based fencing module 61 check—Check the cluster configuration mx config check This command specifies whether cluster components are configured or unconfigured. It does not verify that components are configured correctly.
Chapter 3: mx Commands 62 This command can be used only when the cluster is offline. If you set FibreChannel as the fencing method, you must also configure the FibreChannel switches connected to the cluster. This step is optional for web-based fencing. The default SNMP community string for HP Clustered File System is private. If you want to use a custom community string, use the --community option to enter the appropriate value.
Chapter 3: mx Commands 63 [--os] The name of the operating system. [--mps] The current membership partitions. [--protocol] The current administrative traffic 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, RUNNING, STOPPING, or STOPPED).
Chapter 3: mx Commands 64 [--type] The fencing action (reset or shutdown). [--vendor ] The remote management controller vendor (dell, hp, ibm, or ipmi). protocol—Set the administrative traffic protocol: mx config protocol [Multicast|Unicast] This command can be used only when the cluster is offline. Specify Multicast or Unicast as appropriate. santest—Test the switch configuration mx config santest --santype [fc|iscsi] ... This command can be used only when the cluster is offline.
Chapter 3: mx Commands 65 This command can be used only when the cluster is offline. The options are as follows. You will need toHP Clustered File System should identify the Remote Management Controller associated with each server. Use the appropriate option for your site ( [--bladeslot ] For IBM Blade Center only, the blade slot. --hostname The hostname for the Remote Management Controller associated with this server.
Chapter 3: mx Commands 66 --vendor The vendor for your remote management controller (dell, hp, ibm, or ipmi). mxconfig mp – membership partition commands Use the following commands to manage membership partitions on an online or offline cluster. NOTE: If you are performing the initial configuration of a cluster, the mx config, mx config mp, and mp config snapshot commands must be entered in a specific order.
Chapter 3: mx Commands 67 • While the cluster is running, two membership partitions are reported to be corrupt (use the repair command to 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.
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 option allows disks that contain existing volume information to be reused. (The existing data is destroyed.) The --reuse option is available only when the cluster is offline.
Chapter 3: mx Commands Command Description showtype Show available snapshot methods test Test an existing snapshot method configuration 69 add—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 appliance.
Chapter 3: mx Commands 70 --hostname |--controllerA For hpeva, use the --hostname option to specify the hostname for the management appliance. For engenio, use the --controllerA option to specify the hostname or IP address for controllerA on the storage array. list—list all existing snapshot method configurations mx config snapshot list [--noHeaders] [--csv] [--showBorder] The options are: [--noHeaders] Do not display column headers in the output.
Chapter 3: mx Commands Command Description delete Remove a device monitor disable Disable a device monitor dump Dump the device monitor configuration enable Enable a device monitor status Show the status of device monitors update Modify the configuration of a device monitor 71 add—Add a device monitor mx device add --type --servers ,,...
Chapter 3: mx Commands 72 [--parameters ] The available parameters depend on the type of monitor: • DISK device monitor. The parameter is a partition on the disk. The monitor will attempt to read the first block on this partition to determine whether the disk is operating normally. • GATEWAY device monitor. The IP address of the gateway device (such as a router). The IP address must be on a different subnet than the servers in the cluster. • CUSTOM device monitor.
Chapter 3: mx Commands 73 [--stopScript