HP StorageWorks Clustered File System 3.0 Command Line reference guide *392372-001* *392372–001* Part number: 392372–001 First edition: May 2005 Legal and notice information © Copyright 1999-2005 PolyServe, Inc. Portions © 2005 Hewlett-Packard Development Company, L.P. Neither PolyServe, Inc. nor Hewlett-Packard Company makes any warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Neither PolyServe nor Hewlett-Packard shall be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information is provided “as is” without warranty of any kind and is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Neither PolyServe nor HP shall be liable for technical or editorial errors or omissions contained herein. The software this document describes is PolyServe confidential and proprietary. PolyServe and the PolyServe logo are trademarks of PolyServe, Inc. PolyServe Matrix Server contains software covered by the following copyrights and subject to the licenses included in the file thirdpartylicense.pdf, which is included in the PolyServe Matrix Server distribution. Copyright © 1999-2004, The Apache Software Foundation. Copyright © 1992, 1993 Simmule Turner and Rich Salz. All rights reserved. Copyright © 2000, Emulex Corporation. All rights reserved. Copyright © 1994-2004, Sun Microsystems, Inc. All rights reserved. Copyright © 1999, 2000, 2001 Lev Walkin <[email protected]>. All rights reserved. Copyright © 1996, 1997, 1998, 1999, 2000, 2001 Institut National de Recherche en Informatique et en Automatique (INRIA). All rights reserved. Copyright © 2001 QLogic Corp. All rights reserved. Copyright © 1993-2001 Spread Concepts LLC. All rights reserved. Copyright © 2001 Daniel Barbalace. All rights reserved. Copyright © 2003 Storage Networking Industry Association. All rights reserved. Copyright © 1995-2002 Jean-loup Gailly and Mark Adler. Linux is a U.S. registered trademark of Linus Torvalds Microsoft, Windows, Windows NT, and Windows XP are U.S. registered trademarks of Microsoft Corporation. Oracle® is a registered U.S. trademark of Oracle Corporation, Redwood City, California. UNIX® is a registered trademark of The Open Group. Clustered File System Command Line Reference Guide Contents HP Technical Support HP Storage Web Site . .vi HP NAS Services Web Site . .vi 1 HP Clustered File System Commands clusterpulse – ClusterPulse daemon . 2 destroypsfs – destroy a PSFS filesystem . 2 diskupdate – reattempt to access a disk . 2 dlm – Distributed Lock Manager daemon . 2 dlmdebug – debug DLM problems . 3 emulex/dfc, emulex/lpedit – Emulex utilities . 3 fsprobe – report filesystem information . 3 gcstat – print grpcommd statistics. 3 get_fenceidentity – get fencing information. 4 grpcommd – cluster-wide communications daemon . 4 hbaapidump – show LUN information . 4 lcl-dump – show information about LCL locks. 4 log_collect – obtain log files . 5 mkpsfs – create a PSFS filesystem . 5 mx – HP Clustered File System command-line interface. 6 mxcheck – verify HP Clustered File System requirements . 6 mxcollect – collect configuration information . 6 mxconfig – configure the cluster . 7 mxconsole – start the Management Console . 7 mxfence – verify fencing module configuration . 8 mxfencecfg – configure the fence agent . 8 mxinit – manage HP Clustered File System processes . 9 mxlogd – log daemon . 12 mxlogger – add a log message . 12 mxmpconf – manage membership partitions . 13 Copyright © 1999-2005 PolyServe, Inc. All rights reserved. iii Contents iv Setup Option . 14 Repair Menu . 14 Membership Partition Status . 14 Repair Menu Options. 15 mxmpio – monitor or manage MPIO devices . 17 Enable or Disable Failover for a Server . 18 Enable or Disable Failover for a PSD Device . 19 Specify the Path for I/O . 19 An Example of Changing the I/O Path . 20 Display Status Information . 21 Set the Timeout Value . 21 Show Number of Transient Errors. 22 Show Load Statistics . 22 Display General I/O Statistics. 22 Dump I/O Statistics in Raw Format. 23 mxnlmconfig – enable or disable . 24 mxpasswd – add users or change passwords . 25 mxperftool – view performance counters. 26 mxregd – CFS-Linux daemon. 26 mxregtool – explore the mxreg datastore . 26 mxsancheck – check server’s SAN access . 26 mxsanconf – configure FC switches . 27 mxsanlk – show SAN ownership locks. 27 mxsetfence – configure fencing . 30 mxsetsecret – set the network secret password . 31 panpulse – PanPulse daemon. 31 pmxs – start or stop HP Clustered File System or view status . 31 PSANcfg – manage ports, community string. 32 PSANinfo – show FC logins, Naming Database . 32 psdctl – manage device bindings. 33 psfsck – check and repair a PSFS filesystem . 33 psfsdebug – get PSFS filesystem image . 36 psfslabel – label a PSFS filesystem. 36 psfsresume – resume a suspended PSFS filesystem . 36 psfssema – manage cluster-wide file locks. 37 psfssuspend – suspend a PSFS filesystem . 38 psfsunpack – unpack a PSFS filesystem image . 39 psvctl – manage dynamic volumes . 39 pswebsrv – web server daemon. 39 resizepsfs – resize a PSFS filesystem . 40 Copyright © 1999-2005 PolyServe, Inc. All rights reserved. Contents v sanconfigure – obsolete . 41 sandiskinfo – show SAN disk information . 41 Disk Information . 41 Options for Dynamic Volumes. 43 sanlibmig.sh – migrate the SAN identity . 44 sanpulse – SanPulse daemon . 44 smds – show UI status. 44 snapctl – manage snapshot operations . 45 spctl – dump the SanPulse trace buffer. 45 spdebug – obtain SanPulse debug information. 45 spstat – show cluster state information. 45 wmtest – test server-based fencing . 45 2 mx Commands Using the mx utility . 46 The matrixrc file . 46 mx syntax. 47 Class syntax. 48 mx device – device monitor commands . 49 mx disk – disk commands. 52 mx dynvolume – dynamic volume commands . 53 mx exportgroup – Export Group commands. 54 mx fs – filesystem commands. 56 mx matrix – cluster commands . 58 mx netif – network interface commands . 59 mx notifier – notifier commands . 60 mx server – server commands . 61 mx service – service monitor commands . 62 mx snapshot – snapshot commands . 65 mx vhost – virtual host commands . 65 mx vnfs – Virtual NFS Service commands . 66 sleep command. 67 Index Copyright © 1999-2005 PolyServe, Inc. All rights reserved. HP Technical Support Telephone numbers for worldwide technical support are listed on the following HP web site: http://www.hp.com/support. From this web site, select the country of origin. For example, the North American technical support number is 800-633-3600. NOTE: For continuous quality improvement, calls may.