Page 2
Copyright © 2004-2006 PolyServe, Inc.
Use, reproduction and distribution of this document and the software it describes are subject to the terms of the software license agreement distributed with the product (“License Agreement”). Any use, reproduction, or distribution of this document or the described software not explicitly permitted pursuant to the License Agreement is strictly prohibited unless prior written permission from PolyServe has been received. Information in this document is not guaranteed to be accurate, is subject to change without notice, and does not represent a commitment on the part of PolyServe.
The software this document describes is PolyServe confidential and proprietary.
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 © 2005, ObjectPlanet, Inc.
Copyright © 1992, 1993 Simmule Turner and Rich Salz. All rights reserved.
Copyright © 2000, Emulex Corporation. All rights reserved.
Copyright © 1995-2000, GoAhead Software, Inc. All rights reserved.
Copyright © 1994-2004, Sun Microsystems, Inc. All rights reserved.
Copyright © 1999, 2000, 2001 Lev Walkin <vlm@spelio.net.ru>. 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 © 1999,2000 Boris Fomitchev.
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.
PolyServe and the PolyServe logo are trademarks of PolyServe, Inc.
All other company, brand, and product names are trademarks or registered trademarks of their respective companies and are hereby recognized.
Contents
PolyServe Matrix Server Command Reference
Copyright 2004-2006 PolyServe, Inc
Contents
Contents
Index
Destroypsfs destroy a Psfs filesystem
Opt/polyserve/sbin/destroypsfs
Edquota edit user and group quotas
Diskupdate reattempt to access a disk
Dlmdebug debug DLM problems
Emulex/dfc, emulex/lpedit Emulex utilities
Getfenceidentity get fencing information
Fsprobe report filesystem information
Gcstat print grpcommd statistics
Hbaapidump show LUN information
Mkpsfs create a Psfs filesystem
Lcl-dump show information about LCL locks
Logcollect obtain log files
Userdefault=size groupdefault=size
Disable-fzbm
Enable-quotas
Foutputfile
Mpimport Restore membership partition data
Mpdump Save membership partition data
Opt/polyserve/lib/mpdump mpdump -v-F Mpdump -v-f outputfile
Mpimport -ppsdname uid
Mpimport uid uid
Mpimport --localdevname devname
Mpimport -p psdname --local devname
Mpimport -s-M-finputfile psdnamepsvname
Mx Matrix Server command-line interface
Mxcheck verify Matrix Server requirements
Mpimport --replace olduid newuid
Ttext-file and/or -hhtml-file
Sequence
Help
Mxcollect collect configuration information
Mxconfig configure the matrix
Display a usage message
Mxconsole start the Management Console
Mxfence verify fencing module configuration
Config file
Matrix matrix
Bblade number
Mxfencecfg configure the fence agent
Vvendor
For a blade server, specify the blade number
Mxinit manage Matrix Server processes
IIP address of remote controller
Ppassword
Uusername
Stop
File, --alt-config-file file
Start
Hard
No-monitor
Version
Monitor
Hba-status
Llevel
Mxlogger add a log message
Eentity
Log-text
Repair Menu
Setup Option
Mxmpconf manage membership partitions
Opt/polyserve/bin/mxmpconf # /etc/init.d/pmxs stop
Repair Menu includes the following options
Membership Partition Status
Repair Menu Options
Resilver
Replace
Add
Remove
Display
This option removes all entries from the server registry
Mxmpio monitor or manage Mpio devices
Clear the Host Registry
Timeout value
Enable/disable
Enableall/disableall
Active target
Enable or Disable Failover for a PSD Device
# mxmpio enabledisable PSD-device
An Example of Changing the I/O Path
# /opt/polyserve/sbin/mxmpio active 0 psd2p1
Display Status Information
Set the Timeout Value
Show Number of Transient Errors
Show Load Statistics
Dump I/O Statistics in Raw Format
Syntax is
Display General I/O Statistics
Rawstat interval count
Mxnlmconfig enable or disable NLM
Opt/polyserve/bin/mxnlmconfig -q-e-d
Mxpasswd add users or change passwords
Mxperftool view performance counters
Mxsanlk show SAN ownership locks
Mxsancheck check server’s SAN access
Mxsanconf configure FC switches
# mxsanlk
Matrix Server Commands
Fabric fencing
Mxsetfence configure fencing
Fcsan
Webmgmt
Opt/polyserve/bin/mxsetsecret -f --filename filename secret
Mxsetsecret set the network secret password
Pmxs start or stop Matrix Server or view status
Opt/polyserve/sbin/PSANcfg -hu-lLPort WWN switch
PSANinfo show FC logins, Naming Database
Uswitch
Opt/polyserve/sbin/PSANinfo -n-s-uswitchname
Psdctl manage device bindings
Psfsck check and repair a Psfs filesystem
Rebuild-tree
Check filesystem consistency. This is the default action
Check
Rebuild-quotas
Enable-fzbm
Rebuild-sb
Interactive,-i
Psfsdebug get Psfs filesystem image
Disable the Fzbm feature on the specified filesystem
Disable-quotas
Set-udq sizeTGMK
Psfsinfo report filesystem information
Next command restores the data to the filesystem
Psfsdq save quota data
Display the version of the on-disk filesystem format
Feature Feature
Enable verbose messages
Verbose,-v
Psfsquota manage disk quotas
Psfslabel command adds a label to the specified device
Psfslabel label a Psfs filesystem
Opt/polyserve/tools/psfslabel device label
Psfsresume resume a suspended Psfs filesystem
Opt/polyserve/sbin/psfsrq -f path filesystem
Psfsrq restore quota data
Psfssema manage matrix-wide file locks
Psfssuspend suspend a Psfs filesystem
Opt/polyserve/tools/psfssuspend directorymountpoint
Psvctl manage dynamic volumes
Psfsunpack unpack a Psfs filesystem image
Resizepsfs resize a Psfs filesystem
Quota report quota information for a user
Repquota report quota information for a filesystem
+-sizeKMGT
Resizepsfs -s +1G /dev/psd/psd6p4
# sandiskinfo
Sandiskinfo show SAN disk information
Disk Information
Sandiskinfo -i-u-v-f-alr-U-q
# sandiskinfo -f
# sandiskinfo -a
# sandiskinfo -al
--dynvolumesoption lists all dynamic volumes
Options for Dynamic Volumes
Following sandiskinfo options apply only to dynamic volumes
# sandiskinfo --dynvolumes
Spctl dump the SanPulse trace buffer
Setquota set quotas
Snapctl manage snapshot operations
Warnquota warn users of quota limits
Spdebug obtain SanPulse debug information
Spstat show matrix state information
Wmtest test server-based fencing
Matrix Server Commands
Using the mx utility
Matrixrc file
Mx --matrix srv1 server status
Matrixrc file
Mx server status
Mx --matrix srv8 server status
Prompt prompt
Mx syntax
File file
Mx --prompt ’%’ --file
Class syntax
To specify a command affecting a class, use this syntax
Numeric
Mx server status --up
Application associated with this device monitor
Mx device device monitor commands
Mx application manage applications
RecoveryTimeout seconds
Amount of time to wait for the Recovery script to complete
RecoveryScript script
Parameters parameters
Amount of time to wait for the Start script to complete
Amount of time to wait for the Stop script to complete
Enabled Disabled Primary Backup
Mx device enable devicename server
Mx device disable devicename server
Mx device globalsettings --eventdelay seconds
Mx disk disk commands
Mx dynvolume dynamic volume commands
Mx exportgroup Export Group commands
Add an Export Group
Do not validate the export records
Arguments are the same as the exportgroup add command
Server to be monitored. The default is all servers
ServersALLSERVERS servernameorIP
NoHeaders
Mx fs filesystem commands
Datasetsnumber of data sets Unlimited
Csv
Block size is always 4 KB
Enable quotas on the filesystem
Optional arguments are
Mount options are
Create the directory mount point
Current alert messages appear at the end of the output
Mx matrix matrix commands
Optimize file access for database data files
Mx --continue --file backupfile
To restore the configuration, use this command
Mx matrix dump backupfile
Do not display column headers in the output
Mx netif network interface commands
Network interface must be down
Mx notifier notifier commands
Notifier name can include up to 32 characters
Mx notifier dump notifier
Mx quota filesystem quota commands
Do not display command output
Force
Display the output in comma-separated value format
Range of disk space usage
User ID or range of IDs
Value specified for --nameis a regular expression
MemberOf group name a group name for filtering users
Range of percentages of disk space used
PercentUsedRange #%-#%
Search arguments are
Mx quota showuser search-argumentsALLFILESYSTEMSps device
Mx server server commands
Value specified for --nameis a group name
Mx server dump
Mx service service monitor commands
Mx server enable server
Mx server markdown server
Type type
This argument applies only to Custom monitors
Amount of time to wait for the script to complete
Mx service delete vhostport
Mx service enable vhostport server
Mx service disable vhostport server
Mx service clear vhostport server
Mx snapshot create --terse options volume
Mx snapshot snapshot commands
Mx vhost virtual host commands
Mx snapshot destroy volume
Policy autofailbacknofailback
Activity singleactive
Mx vnfs Virtual NFS Service commands
Sleep command
Arguments are the same as mx vnfs add
Index
Mx vhost
DLM, debug 2 dynamic volume
Global Event Delay, device monitor
Server add Check SAN access 29 delete
Move
Enable
Status information