PolyServe® Matrix Server Command Reference PolyServe® Matrix Server 3.
Copyright © 2004-2007 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.
Contents Functional Cross Reference Administrative Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x 1 HP Technical Support HP Storage website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 HP NAS Services website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Matrix Server Commands Overview . . . . . . . . . . . .
Contents iv mcs select – display events from the matrix 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 matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 mxcheck.
Contents v 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 vi Commands for groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mx role – role management commands . . . . . . . . . . . . . . . . . . . . . . mx server – server commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mx service – service monitor commands . . . . . . . . . . . . . . . . . . . . . mx snapshot – snapshot commands . . . . . . . . . . . . . . . . . . . . . . . . . mx vfs – Virtual CIFS Server commands . . . . . . . . . . . . . . . . . . . . .
Functional Cross Reference Administrative Commands Function Command Page CIFS Manage Matrix File Shares mx mfs 87 Manage Virtual CIFS Servers mx vfs 110 Manage Virtual File Shares mx vfs_share 113 Add a message to the event log mx matrix log mcs log 86 8 Manage event notifier services mx eventnotifier 77 View events in the matrix event log mcs select mx server viewevents Event notification services and event log 8 105 Filesystem Create a filesystem psfsformat mx fs create Destroy a
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 86 Verify matrix 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 partiti
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 102 License file, read mx server read_license 102 Matrix event file, add message mx matrix log 86 Verify matrix requirements mxcheck
Functional Cross Reference x Diagnostic Commands Function Command Page Configuration Check status of matrix 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 matrix event log mcs select mx serv
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 Matrix logs, collect for HP Support mxcollect 22 Matrix requirements, verify mxcheck 21 Server access to SAN, check mxsancheck 23 mx dynvolume import 76 Volumes Recover a d
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.
2 Matrix Server Commands Overview PolyServe Matrix Server includes several commands that can be helpful for administrators managing a Matrix Server cluster. Other Matrix Server commands provide diagnostic information and should be used only under the direction of HP personnel. Matrix Server also includes commands that are used internally and should not be run directly.
Chapter 2: Matrix Server 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 matrix administration. Other commands are used internally by Matrix Server or should be run only at the request of HP personnel when diagnosing problems on your system.
Chapter 2: Matrix Server Commands 5 Description This command forces a system reboot when certain error conditions exist during Matrix Server startup. It is used internally by Matrix Server 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: Matrix Server 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: Matrix Server 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 matrix configuration and should not be run directly. idfence.
Chapter 2: Matrix Server Commands 8 This command is used internally by Matrix Server and should not be run directly. (To create membership partitions, use the “Configure Matrix” feature on the PolyServe Management Console.) mcs.exe – manipulate the matrix log This utility provides several commands that are used internally by Matrix Server; however the following commands may be useful when administering a matrix.
Chapter 2: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server Commands 12 Filter examples. These examples are logical statements that could be used as a
Chapter 2: Matrix Server 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\Polyserve\ matrixserver\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: Matrix Server Commands 14 NOTE: Matrix Server must be stopped on all nodes when mpimport is used. Database corruption can occur if the utility is executed while Matrix Server is running on a node. mpimport fails if Matrix Server is running on the current node; however, it does not check the other nodes.
Chapter 2: Matrix Server 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: Matrix Server 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 matrix 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: Matrix Server 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: Matrix Server Commands 18 After making changes with mprepair, you will need to export the configuration to the other servers in the matrix. To do this, start Matrix Server on the server where you ran mprepair and then select the Configure option on the Matrix Server Connect window. When the Configure Matrix window appears, select the Matrix Wide Configuration tab. Select the other servers in the Address column and then click Export.
Chapter 2: Matrix Server 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: Matrix Server 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: Matrix Server 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 matrix The mx utility provides a command-line interface for administering a matrix and monitoring its operation.
Chapter 2: Matrix Server Commands 22 mxcollect.exe – collect configuration information Synopsis tools\mxcollect Description This utility collects configuration information and log files from the matrix. 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%\PolyServe\MatrixServer\tools folder. Go to this location and double-click the file mxcollect.exe.
Chapter 2: Matrix Server 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: Matrix Server Commands 24 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 matrix 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. It can be used to determine whether any of the membership partitions need to be repaired.
Chapter 2: Matrix Server 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: Matrix Server 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. The SANlock was corrupted but will be repaired.
Chapter 2: Matrix Server Commands 27 mxsetsecret.exe – set the network secret password Synopsis bin\mxsetsecret Description This command is used during matrix configuration and should be run manually only at the request of HP personnel. mxstart.exe – start Matrix Server processes Synopsis bin\mxstart Description This command is used internally by Matrix Server and should never be run directly. mxstop.
Chapter 2: Matrix Server Commands 28 pathfilter.exe – translate the install path Synopsis tools\pathfilter Description This command is used by the Matrix Server install process and should never be run directly. PSANcfg.exe – control port operations Synopsis bin\PSANcfg [-hu] [-[lL] ] [switch ...] Description The PSANcfg command can be used to add or remove local HBA port information in the Matrix Server configuration and to unfence ports on FibreChannel switches.
Chapter 2: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server Commands 33 --set-dq [T|G|M|K] Set the default hard 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.) --set-sdq [T|G|M|K] Set the default soft quota on the specified filesystem.
Chapter 2: Matrix Server Commands 34 --no-log-softlimit File operations that result in exceeding a user’s soft limit are not logged. --sparse-fullcost Quota accounting for sparse files reflects the virtual size of the files. --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: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server 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: Matrix Server 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.exe – resize a filesystem Synopsis bin\psfsresize Description The PolyServe Management Console includes an option to increase the size of a PSFS filesystem and the partition on which it is located.
Chapter 2: Matrix Server 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: Matrix Server 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 matrix. To suspend a filesystem, issue a command in the following form on one server that has mounted the filesystem.
Chapter 2: Matrix Server 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: Matrix Server 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 PolyServe Management Console. This option is used internally by Matrix Server and does not produce human-readable output. -q Suppress output of all log messages. 45 Following are some examples of these options.
Chapter 2: Matrix Server 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: Matrix Server 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: Matrix Server 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 matrix. --unimportable-volumes Lists unimported dynamic volumes that cannot be imported into the matrix. scsf.
Chapter 2: Matrix Server Commands 49 sentinels.exe – show service dependencies Synopsis bin\sentinels Description This command is used internally by Matrix Server 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 Matrix Server and should not be run directly.
Chapter 2: Matrix Server Commands 50 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 matrix state information Synopsis tools\spstat Description This command should be run only at the request of HP personnel. sqlreg.exe – create a registry file Synopsis bin\sqlreg Description This command is used internally by the MxDB for SQL Server Solution Pack and should never be run directly.
3 mx Commands The mx utility provides a command-line interface for administering a matrix and monitoring its operation. The matrixrc file Matrix Server can use an optional, external configuration file named .matrixrc to provide authentication information for matrix connections. If the file is configured, it will be used when you connect to a matrix through either the Matrix Server 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 Matrix Server password for that user. The password is encrypted automatically when you use the Matrix Server Connect window to specify the password.
Chapter 3: mx Commands 53 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 method, enclose the server entries in brackets, as in the following example for the prod matrix. # production cluster prod { srv1 administrator secret1 srv2 administrator secret1 srv3 administrator secret1 default } To connect to the matrix, include the option --matrix prod in the mx command. mx first attempts to access srv3, the default. If that server is not available, the command tries the other servers in the group.
Chapter 3: mx Commands 55 Files\PolyServe\ManagementConsole\bin on servers where the Console is installed.) 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 Matrix Object netif Network interface quota Disk quota role Management roles for matrix 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: m
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 – matrix alert commands Use the following command to view Matrix Server 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 matrix secret license key testfencing Test the fencing configuration webfencing Configure the web-based fencing module 61 check—Check the matrix configuration mx config check This command specifies whether matrix 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 matrix is offline. If you set FibreChannel as the fencing method, you must also configure the FibreChannel switches connected to the matrix. This step is optional for web-based fencing. The default SNMP community string for Matrix Server 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 matrix. [--snapshots] The snapshots currently in the matrix. [--status] The current status of the matrix (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 matrix 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 matrix is offline.
Chapter 3: mx Commands 65 This command can be used only when the matrix is offline. The options are as follows. You will need to specify how Matrix Server should identify the Remote Management Controller associated with each server. Use the appropriate option for your site (--hostname, --hostsuffix, or --ipdelta). [--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). mx config mp – membership partition commands Use the following commands to manage membership partitions on an online or offline matrix. NOTE: If you are performing the initial configuration of a matrix, the mx config, mx config mp, and mp config snapshot commands must be entered in a specific order. See Appendix A in the PolyServe Matrix Server Installation Guide for more information.
Chapter 3: mx Commands 67 • While the matrix 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, Matrix Server must be offline on all servers in the matrix.
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 matrix 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 matrix. • CUSTOM device monitor.
Chapter 3: mx Commands 73 [--stopScript
