PolyServe® Matrix Server Administration Guide PolyServe® Matrix Server 3.
Copyright 1999-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 1 HP Technical Support HP Storage Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 HP NAS Services Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Quick Start Checklist Matrix Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 Introduction to Matrix Server Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Overview . . . . .
Contents iv Other Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tested Configuration Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Volume and Filesystem Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Authentication Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . Start the Management Console . . . .
Contents v Move a Server to Another Matrix . . . . . . . . . . . . . . . . . . . . . . . . . Matrix Server License File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Upgrade the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Refresh the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported Matrix Server Features . . . . . . . . . . . . . . . . . . . . . . . . . Limit the Servers That Can Join a Matrix . . . . . . .
Contents vi 8 Configure Dynamic Volumes Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Basic and Dynamic Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Types of Dynamic Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic Volume Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Volume Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents vii Volume Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Features Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quotas Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View Filesystem Status from the Command Line . . . . . . . . . . . Extend a Basic Volume and Its Filesystem . . . . . . . . . . . . . . . . . . . . Suspend a Filesystem for Backups. . . . . . . . . . . .
Contents viii Export or Import Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable or Disable a Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modify a Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rename a Role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete a Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents ix The Applications Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application States. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filter the Applications Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Applications Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . “Drag and Drop” Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Operations . . . . . . . . . . . . . . . .
Contents x Types of Device Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Device Monitors and Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . Device Monitor Activeness Policy . . . . . . . . . . . . . . . . . . . . . . . . Add or Modify a Device Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . Advanced Settings for Device Monitors . . . . . . . . . . . . . . . . . . . . . . Probe Severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents xi Server Cannot Be Fenced. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Server Cannot Be Located . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Insertion of New Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Replacement of a FibreChannel Switch . . . . . . . . . . . . . . . . Replace a Brocade FC Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . Replace a McDATA FC Switch . . . . . . . . . . . . . . . . . . . . . . . . .
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 Quick Start Checklist The following checklist is intended for new installations of Matrix Server and includes typical steps to configure the matrix. Matrix Configuration Steps The following checklist assumes that the installation and configuration steps described in the PolyServe Matrix Server Installation Guide have been completed. Action Description Review administrative considerations and restrictions.
Chapter 2: Quick Start Checklist Action Description Create dynamic volumes. Dynamic volumes can include multiple disks and are used for PSFS filesystems. See “Create a Dynamic Volume” on page 78. Create PSFS filesystems. Select the dynamic volume to be used for the filesystem and configure the appropriate options such as block size and disk quotas. See “Create a Filesystem” on page 99.
Chapter 2: Quick Start Checklist Action Description Configure MxFS for CIFS (optional) Create Matrix File Shares and set up DFS. Matrix File Shares are Windows CIFS shares associated with a MxFS for CIFS health monitor. For high availability, Matrix File Shares can be deployed with DFS. See “Configure MxFS for CIFS with Matrix File Shares” in the MxFS for CIFS administration guide.
Chapter 2: Quick Start Checklist Action Description Configure the shadow If necessary, give CIFS clients access to hardware copy service. snapshots. See “Using Shadow Copies of Shared Folders” on page 134. Prepare for monitoring the matrix Configure event notifier services. The event notifier services (SMTP, email, and scripts) can be configured to send notifications or run scripts when specific matrix events occur. See “Configure Event Notifier Services” on page 156.
3 Introduction to Matrix Server PolyServe Matrix Server provides a matrix structure for managing a group of network servers and a Storage Area Network (SAN) as a single entity. Product Features Matrix Server includes the following features: • Fully distributed data-sharing environment. The PSFS filesystem enables all servers in the matrix to directly access shared data stored on a SAN.
Chapter 3: Introduction to Matrix Server 8 line interface enable you to configure and manage the entire matrix either remotely or from any server in the matrix. • Failover support for network applications. Matrix Server uses virtual hosts to provide highly available client access to mission-critical data for Web, e-mail, file transfer, and other TCP/IP-based applications.
Chapter 3: Introduction to Matrix Server 9 The matrix includes these components: Servers. Each server must be running Matrix Server. Public LANs. A matrix can include up to four network interfaces per server. Each network interface can be configured to support multiple virtual hosts, which provide failover protection for Web, e-mail, file transfer, and other TCP/IP-based applications. Administrative Network. Matrix Server components communicate with each other over a common LAN.
Chapter 3: Introduction to Matrix Server 10 writes to a PSFS filesystem automatically obtain the appropriate locks from the DLM, ensuring filesystem coherency. grpcommd. Manages Matrix Server group communications across the matrix. mxds. Manages the mxds datastore. mxlogd. Manages global error and event messages. The messages are written to the Matrix Server event log on each server. PanPulse.
Chapter 3: Introduction to Matrix Server 11 Volume Manager The Matrix Server Volume Manager can be used to create dynamic volumes consisting of disk partitions that have been imported into the matrix. Dynamic volumes can be configured to use either concatenation or striping. A single PSFS filesystem can be placed on a dynamic volume. The Volume Manager can also be used to extend a dynamic volume and the filesystem located on that volume.
Chapter 3: Introduction to Matrix Server 12 Matrix Server Databases Matrix Server uses the following databases to store matrix information: • Shared Memory Data Store (SMDS). The SANPulse process stores filesystem status information in this database. The database consists of sp_status files that are located in %SystemDrive%\Program Files\Polyserve\MatrixServer\conf on each server. These files should not be changed. • Device database.
Chapter 3: Introduction to Matrix Server 13 After creating virtual hosts, you will need to configure your network applications to recognize them. When clients want to access a network application, they use the virtual host address instead of the address of the server where the application is running. Service and Device Monitors A service is a network service such as HTTP or FTP that is installed and configured on the servers in the matrix.
Chapter 3: Introduction to Matrix Server 14 SNMP Service The Matrix Server SNMP service provides tools that can be used to retrieve all matrix-wide state and status information. The service includes the following: • An SNMP extension agent that is used by the Microsoft SNMP service. (The Microsoft SNMP service must be installed and configured on the servers in the matrix.) • MIBs that can be loaded into the MIB browser tool provided with your Network Management Station (NMS).
Chapter 3: Introduction to Matrix Server 15 Supported Configurations Matrix Server supports multiple FibreChannel switches configured as a single fabric and multiported SAN disks. iSCSI arrays are also supported. The following diagrams show some sample matrix configurations using these components. Single FC Port, Single FC Switch, Single Fabric This is the simplest configuration. Each server has a single FibreChannel port connected to the FibreChannel switch. The SAN includes two RAID arrays.
Chapter 3: Introduction to Matrix Server 16 Single FC Port, Dual FC Switch, Single Fabric In this example, the fabric includes two FibreChannel switches. Servers 1–3 are connected to the first FC switch; servers 4–6 are connected to the second switch. The FC switches are connected to two RAID arrays, which contain multiported disks. If a switch fails, the servers connected to the other switch will survive and access to storage will be maintained.
Chapter 3: Introduction to Matrix Server 17 iSCSI Configuration This example shows an iSCSI configuration. The Microsoft iSCSI initiator is installed on each server. Ideally, a separate network should be used for connections to the iSCSI storage arrays. Server 1 Server 2 Server 3 Server 4 Server 5 Network Switch iSCSI Array iSCSI Array Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
4 Matrix Administration PolyServe Matrix Server can be administered either with the PolyServe Management Console or from the command line. Administrative Considerations and Restrictions You should be aware of the following when managing Matrix Server. Network Hostname Resolution Normal operation of the matrix depends on a reliable network hostname resolution service. If the hostname lookup facility becomes unreliable, this can cause reliability problems for the running matrix.
Chapter 4: Matrix Administration 19 • Certain Microsoft Knowledge Base articles caution that in the case of Exchange SMTP, and possibly other applications, the use of the hosts file can interfere with mail flow (see Microsoft Knowledge Base article 296215). • Although using the hosts file provides immunity to DNS problems, it must be manually updated on each node. For example, if an IP address changes, all of the hosts files must be updated.
Chapter 4: Matrix Administration 20 • If servers from multiple matrices can access the SAN via a shared FC fabric, avoid importing the same disk into more than one matrix. Filesystem corruption can occur when different matrices attempt to share the same filesystem. • Do not delete disk partitions on LUNs accessed by Matrix Server. The Windows operating system renumbers partitions when a lowernumbered partition is deleted.
Chapter 4: Matrix Administration 21 groups for these purposes because they are meaningless to other nodes in the matrix. • Matrix Server nodes should not be used as domain controllers because the two services will compete for resources, resulting in decreased performance. • The DNS servers used by Active Directory and Matrix Server should not reside on Matrix Server nodes. Placing the DNS servers on Matrix Server nodes creates a race condition that prevents Matrix Server from starting.
Chapter 4: Matrix Administration 22 day clocks. An NTP server is one commonly used mechanism for synchronizing system clocks. • The Java Management Extensions (JMX) Remote API is included in the Java Runtime Environment (JRE) provided with the PolyServe Management Console. The password file for JMX stores the password in clear text. PolyServe does not create or use this file and recommends that you do not use it. However, if you do need to use the password file, please be aware of the security risk.
Chapter 4: Matrix Administration 23 Volume and Filesystem Limits The following limits apply to volumes and filesystems: • The maximum volume size is 16 TB. • The maximum filesystem size is 16 TB. • The maximum file size is 2 TB minus one byte. If an I/O operation would cause the size of a file to exceed this limit, the complete I/O operation will fail. • For both dynamic volumes and basic volumes, the maximum number of files/inodes is limited only by the available space.
Chapter 4: Matrix Administration 24 When the PolyServe Management Console is used, credentials are processed in this order: • If a .matrixrc file exists, the user credentials specified in the file for the selected server are used. • If there is not a .matrixrc file or the file does not include user credentials, the credentials provided by single sign-on semantics are used. • If single sign-on fails, the user is prompted for a user name and password.
Chapter 4: Matrix Administration 25 password are automatically encrypted, or can optionally be omitted from the file. Start the Management Console To start the Management Console, select Start > Programs > PolyServe Matrix Server > Management Console. The Matrix Server Connect window asks for connection information and then starts the PolyServe Management Console or opens the Configure Matrix window. Connect to: Type a matrix or server name or select a name from the dropdown list.
Chapter 4: Matrix Administration 26 Authentication Parameters and Bookmarks When you connect to a matrix, you can optionally supply a user name and password. When you click the “As User” button, the Authentication Parameters dialog asks for this information. User: Type the name of the user who will be accessing the matrix. Password: Type the user’s password. If you do not want to be prompted for the password again, click the “Remember this password” checkbox.
Chapter 4: Matrix Administration 27 the server name, the username, and password. The password is automatically encrypted. If you do not check “Remember this password,” only the server and user names are added to the file. NOTE: The default location for the file is %userprofile%\.matrixrc on the server. Manage Bookmarks The Bookmarks display lists the matrix connections that are configured in the .matrixrc file.
Chapter 4: Matrix Administration 28 • Delete. If a matrix is selected, this option removes the bookmark for that matrix. If a server is selected, the option removes just that server from the bookmark. • Rename. If a matrix is selected, this option allows you to rename that matrix. If a server is selected, you can replace that server with a different server in the matrix. After typing the new name, press Enter. • Set Default.
Chapter 4: Matrix Administration 29 matches the list of servers in the matrix to which the connected server belongs. You can then select the matrix, or any server in the matrix, for the connection. If the connection attempt fails, Matrix Server will try to make the connection via another bookmarked server in that matrix. Update an Existing .matrixrc File to Use New Features If your .matrixrc file was used in a Matrix Server release earlier than 3.4.
Chapter 4: Matrix Administration 30 Using a Local Machine Outside the Matrix On a local machine, the management applications download their rendering and application logic from the servers in the matrix. To minimize startup time, the downloaded software is cached on the local machine. The local machine then uses the software from the cache whenever possible.
Chapter 4: Matrix Administration 31 The toolbar can be used to perform matrix operations such as creating filesystems, to perform console operations such as collapsing or expanding entity lists, and to display the online help. “Management Console Icons” on page 269 describes the icons used to represent matrix entries and their status. The tabs on the Console window show different views of the matrix.
Chapter 4: Matrix Administration 32 Virtual Hosts Tab The Virtual Hosts tab shows all virtual hosts in the matrix. For each virtual host, the window lists the network interfaces on which the virtual host is configured, any service monitors configured on that virtual host, and any device monitors associated with that virtual host. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Chapter 4: Matrix Administration 33 Applications Tab This view shows the application monitors configured in the matrix and provides the ability to manage and monitor them from a single screen. The tab uses a table format, with a column for each server in the matrix. The application monitors appear in the rows of the table. You can reorder the information on this tab or limit the information that is displayed.
Chapter 4: Matrix Administration Filesystems Tab The Filesystems tab shows all PSFS filesystems in the matrix. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Chapter 4: Matrix Administration 35 Matrix Alerts The Alerts section at the bottom of the Management Console window lists errors that have occurred in matrix operations. Double click on an alert message to see all of the information about the alert. For alerts affecting matrix components such as servers or monitors, you can double-click in the Source column to highlight the source of the error on the main Management Console window.
Chapter 4: Matrix Administration 36 If you receive an alert telling you to reboot a server, the message will remain in the Alerts section until either Matrix Server is restarted on the rebooted server or the server is removed from the matrix. To view the current Alerts from the command line, use the mx alert status command. Matrix Server Operations Many Matrix Server operations can be run in the background. These operations display a popup window allowing you to send the operation to the background.
Chapter 4: Matrix Administration 37 Use the following command at the Command Prompt to see the software installed on specific servers: mx server listsoftware If the operating system uses the 64-bit architecture, x64 will be specified in the output. Otherwise, the architecture is assumed to be 32-bit. Start Matrix Server By default, Matrix Server starts automatically when the system is booted. This feature is controlled by the Startup dialog.
Chapter 4: Matrix Administration 38 When Matrix Server is started, the mxcheck utility is run to verify that the server meets the configuration requirements needed for Matrix Server. Output from the utility appears on the screen and is also written to the Application Log section of the Event Viewer. Stop Matrix Server Before stopping Matrix Server, be sure to shut down all applications that are accessing PSFS filesystems.
Chapter 4: Matrix Administration 39 NOTE: Be careful not to accidently back up PSFS filesystems multiple times by using both your site-defined drive letter/mount point assignments and the reserved mount points created by Matrix Server. Filter out the reserved mount points from backup jobs, and instead use your own site-defined assignments. (For more information about the reserved mount points, see “Differences Between Matrix Server and Microsoft Utilities for Volumes and Filesystems” on page 96.
Chapter 4: Matrix Administration 40 If the -X option was used to back up the mxds datastore, use the mpimport -X command to restore the datastore to the membership partitions. If the -x option was used for the backup, use mpimport -x to restore the datastore. To restore the device database and volume database to the membership partitions, use the mpimport -f command. The input file is typically conf\MP.backup.
Chapter 4: Matrix Administration 41 Port Transport Type Description 9050 TCP Proprietary connection from the Management Console (configurable, as described below) 9070 TCP HTTP connection from the Management Console (fixed, IANA registration has been applied for) 9071 TCP HTTPS connection from the Management Console (fixed, IANA registration has been applied for) Internal Network Port Numbers The following network port numbers are used for internal, server-toserver communication.
5 Configure Servers Before adding a server to a matrix, verify the following: • The server is connected to the SAN if it will be accessing PSFS filesystems. • The server is configured as a fully networked host supporting the services to be monitored. For example, if you want Matrix Server to provide failover protection for your Web service, the appropriate Web server software must be installed and configured on the servers. • If the hosts file has been modified, it should be consistent with the DNS.
Chapter 5: Configure Servers 43 2. Start the PolyServe Management Console on one node (select Start > Programs > PolyServe Matrix Server > Management Console). On the Matrix Server Connect window, specify the server, click the Connect button, and select Configure. If you are prompted for the user name and password, specify the appropriate values. 3. Select the Storage Configuration tab on the Configure Matrix window. In the SAN Switches section of the tab, click the Add button to configure the new switch.
Chapter 5: Configure Servers 44 server, click the Connect button, and select Configure. If you are prompted for the user name and password, specify the appropriate values. b. When the Configure Matrix window appears, click Import. Then, on the Import window, type the IP address or DNS name of the server from which you want to import the configuration. 4. Add the new server to the matrix. Go to the Matrix Wide Configuration tab. The Address list shows the servers currently in the matrix.
Chapter 5: Configure Servers 45 • Use Windows Disk Manager to change the assignments. If you are using Windows 2000 Terminal Services to make the change, you will need to log out and then log back in before you can use the reassigned drive letters. The log out/log in step is not necessary for Windows 2003 Terminal Services or for Windows 2000/2003 local console use. NOTE: For improved performance, the PolyServe Management Console caches hostname lookups.
Chapter 5: Configure Servers 46 remain on the backup server. (See “Virtual Hosts and Failover” on page 185 for more information.) The Server Severity can be configured on each server. The settings are: AUTORECOVER. This is the default value for Server Severity. When the original server is restored, Matrix Server can automatically fail back virtual hosts to that server, depending on the virtual host’s failback policy. NOAUTORECOVER.
Chapter 5: Configure Servers 47 Servers can be deleted on the Matrix-Wide Configuration tab on the Configure Matrix window. Select the server and then click Remove Server. To delete servers from the command line, use this command: mx server delete ... Disable a Server Select the server to be disabled from the Servers window on the PolyServe Management Console, right-click, and select Disable.
Chapter 5: Configure Servers 48 3. Start Matrix Server on server S2a. The server joins the matrix, which now consists of servers S1, S2, S3, and S2a. Server 2 is down and S1, S2a, and S3 are up. 4. Delete server S2 from the matrix. This step will remove references to the server. 5. Update virtual hosts and any other matrix entities that used server S2 to now include S2a.
Chapter 5: Configure Servers 49 3. Select the server in the Address column and then click Export. The Last Operation Progress column will display status messages as the configuration is exported to the server. 4. Start Matrix Server on the server. The server will still be selected in the Address column. Click Start Service to start Matrix Server. A status message will appear in the Last Operation Progress column. When Matrix Server is running on the server, you can close the window.
Chapter 5: Configure Servers 50 NOTE: If there is a .matrixrc file on the system running mxconsole, you will see a Disconnect dialog instead of the Connection Parameters window. Select “Logon to another matrix server” and then click the Configure button. 2. Select the Matrix Wide Configuration tab and then stop the service on all nodes. 3. Return to the General Settings tab and select Change License File. 4. Type the path to the new license file or browse to it. 5. Click Apply. 6.
Chapter 5: Configure Servers 51 Limit the Servers That Can Join a Matrix The network secret key controls server access to the matrix. When you create a matrix configuration, you will specify a password that is used as the network secret key. Servers must have this password to join the matrix. When you add a new server to the matrix and import the matrix configuration to it, the network secret key will be included. See the PolyServe Matrix Server Installation Guide for more information.
Chapter 5: Configure Servers 52 then access the original server name will actually be served by the virtual host—basically, a failover-protected version of the server, with no difference in appearance to the clients. • Keep the existing name on the server. If you do not rename the server, clients will need to use the new virtual host name to benefit from failover protection. Clients can still access the server by its name, but those requests are not protected by Matrix Server.
Chapter 5: Configure Servers 53 the example, two servers, acmd1 and acmd2, are configured to accept round-robin requests. acmd1 acmd2 Primary: virtual_acmd1 Primary: virtual_acmd2 Backup: virtual_acmd2 Backup: virtual_amcd1 Virtual host traffic The addresses on the name server are virtual_acmd1 and virtual_acmd2. Two virtual hosts have also been created with those names. The first virtual host uses acmd1 as the primary server and acmd2 as the backup.
Chapter 5: Configure Servers 54 Record Type: Always A for address. IP address: The IP addresses for the virtual hosts that you will use for each server in the matrix. These are the IP addresses that the DNS will use to send alternate requests. With this setup, the domain name server sends messages in a roundrobin fashion to the two virtual hosts indicated by the IP addresses, causing them to share the request load.
6 Configure Network Interfaces When you add a server to the matrix, Matrix Server determines whether each network interface on that server meets the following conditions: • The network interface is up and running. • The network interface is multicast-capable. • 802.3x Ethernet flow control is not used. • Each network interface card (NIC) is on a separate network. Network interfaces meeting these conditions are automatically configured into the matrix.
Chapter 6: Configure Network Interfaces 56 performance reasons, we recommend that these networks be isolated from the networks used by external clients to access the matrix. When Matrix Server is started, the PanPulse process selects the administrative network from the available networks. When a new server joins the matrix, the PanPulse process on that server tries to use the established administrative network.
Chapter 6: Configure Network Interfaces 57 Each network interface is labeled “Hosting Enabled” or “Hosting Disabled,” which indicates whether it can be used for virtual hosts. The Management Console uses the following icons to represent the status of each network interface. The network interface allows administrative traffic. A green checkmark indicates the current administrative network. A red X indicates that the interface is down. The network interface discourages administrative traffic.
Chapter 6: Configure Network Interfaces 58 • Networks that discourage administrative traffic. If Matrix Server must use a network that was configured to discourage administrative traffic, it will fail over to a network that allows the traffic as soon as that network becomes available to all servers in the matrix. If multiple interface failures occur on a server and there is not another network available for the administrative network, the server may drop out of the matrix.
Chapter 6: Configure Network Interfaces 59 On the command line, issue the appropriate mx netif command: mx netif allowadmintraffic ... mx netif discourageadmintraffic ... mx netif excludeadmintraffic ... When you configure a network interface to allow, discourage, or exclude administrative traffic, the setting applies to all interfaces within the same subnet on all servers of the cluster.
Chapter 6: Configure Network Interfaces 60 Server: The name or IP address of the server that will include the new network interface. IP: Type the IP address for the network interface. Net Mask: Type the net mask for the network interface. Allow Administrative Traffic: Specify whether the network interface can host administrative traffic for Matrix Server. The options are: • Allow. The default is to allow the traffic. • Discourage.
Chapter 6: Configure Network Interfaces 61 Remove a Network Interface This option can be useful when performing off-line configuration of a server. To remove a network interface, select that interface on the Servers window, right-click, and then select Delete. You cannot delete a network interface that is up. If you need to remove a network interface from an online server, first physically remove the corresponding cable from the server.
7 Configure the SAN SAN configuration includes the following: • Import SAN disks into the matrix. • Deport SAN disks from the matrix. • Display information about SAN disks. Overview SAN Configuration Requirements Be sure that your SAN configuration meets the requirements specified in the PolyServe Matrix Server Installation Guide. Storage Control Layer Module The Storage Control Layer (SCL) module manages shared SAN devices.
Chapter 7: Configure the SAN 63 access the device. Although the identifiers (such as psd2 or psd2p6) appear on certain PolyServe Management Console windows, they are generally only needed for internal use by Matrix Server. Device Identifiers and GPT Disks When the SCL assigns device identifiers to the partitions on GPT disks, it skips the first partition because that partition cannot be used by Matrix Server.
Chapter 7: Configure the SAN 64 The higher-numbered partitions will continue to work correctly; however, you should be aware of the following: • A new volume cannot include subdevices having partition numbers above 31. Existing volumes cannot be extended to include the highernumbered partitions. • You will not be able to take a hardware snapshot of partitions with numbers above 31. • A single Alert will be issued if any disks or volumes in the matrix contain unsupported partitions.
Chapter 7: Configure the SAN 65 This issue occurs because the Windows partition table causes space to be reserved at the start of the LUN, which can cause a misalignment with the array’s storage. If your storage array is affected by this issue, the simplest way to avoid the situation is to create an unused partition at the start of the LUN and then ensure that the second partition starts on an aligned boundary.
Chapter 7: Configure the SAN 66 • Disks containing an active membership partition can be imported; however, the partition containing the active membership partition cannot be used for a filesystem. Before importing the disk, you can run mprepair to inactivate the membership partition (see “The mprepair Utility” on page 247). You will then be able to use the partition when you import the disk into the matrix.
Chapter 7: Configure the SAN 67 To determine the uuid for a disk, run the following command, which prints the uuid, the size, and a vendor string for each unimported SAN disk. mx disk status You can also use the Disk Info window to import a disk. Deport SAN Disks Deporting a disk removes it from matrix control. You cannot deport a disk that contains a membership partition. To deport a disk from the PolyServe Management Console, select Storage > Disk > Deport or click the Deport icon on the toolbar.
Chapter 7: Configure the SAN 68 Local Disk Information The Disk Info window displays disk information from the viewpoint of the local server. It can be used to match the disk names appearing in the Microsoft Disk Management utility (the Local Name) with the disk names that Matrix Server uses (the PSD Name). You can also use this window to import or deport SAN disks.
Chapter 7: Configure the SAN 69 NOTE: Because the first partition on GPT disks cannot be used by Matrix Server, that partition is skipped when Matrix Server assigns device identifiers to the partitions. The first identifier, psdXp1, is assigned to partition 2, the second identifier, psdXp2, is assigned to partition 3, and so on.
Chapter 7: Configure the SAN 70 The window shows the following information for each PSFS filesystem: • The label assigned to the filesystem. • The mount point or drive letter assigned to the filesystem. Click in the cell to see the mount point/drive letter for each server on which the filesystem is configured. • The volume used for the filesystem. Click in the cell to see the properties for the filesystem. • The number of CIFS shares.
Chapter 7: Configure the SAN 71 The options are: -i Display information for imported disks (the default). -u Display information for unimported disks. -v Display available volumes. -f Display PSFS filesystem volumes. -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.
Chapter 7: Configure the SAN 72 Show Local Device Information The -l option displays the local device name for each disk, as well as the default disk information. When combined with -u, it displays local device names for unimported disks. sandiskinfo -al Disk: \\.\Global\psd1 (Membership Disk) Uid: 20:00:00:04:cf:13:38:18::0 SAN info: fcswitch5:7 Vendor: SEAGATE Capacity: 34733M Local Device Paths: \\.
Chapter 7: Configure the SAN 73 Disk=20:00:00:04:cf:13:38:18::0 partition=08 type=(unknown) Volume: \\.\Global\psd2p4 Size: 9220M Disk=20:00:00:04:cf:13:38:3a::0 partition=04 type=(unknown) When combined with -a, the -v option lists all volumes, including those used for PSFS filesystems and membership partitions. Options for Dynamic Volumes The following sandiskinfo options apply only to dynamic volumes.
Chapter 7: Configure the SAN 74 Dynamic Volume: psv2 Size: 490M Stripe=32K/optimal Subdevice: 20:00:00:04:cf:13:38:18::0/7 Size: 490M psd1p7 Dynamic Volume: psv3 Size: 490M Stripe=8K/optimal Subdevice: 20:00:00:04:cf:13:38:18::0/10 Size: 490M psd1p10 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.
8 Configure Dynamic Volumes Matrix Server includes a Matrix Volume Manager that you can use to create, extend, recreate, or delete dynamic volumes. Dynamic volumes allow large filesystems to span multiple disks, LUNs, or storage arrays. Dynamic volumes can be deported from the matrix and later imported back into the original matrix or into another matrix. Overview Basic and Dynamic Volumes Volumes are used to store PSFS filesystems. There are two types of volumes: dynamic and basic.
Chapter 8: Configure Dynamic Volumes 76 Types of Dynamic Volumes Matrix Server supports two types of dynamic volumes: striped and concatenated. The volume type determines how data is written to the volume. • Striping. When a dynamic volume is created with striping enabled, a specific amount of data (called the stripe size) is written to each subdevice in turn. For example, a dynamic volume could include three subdevices and a stripe size of 64 KB.
Chapter 8: Configure Dynamic Volumes 77 Destroying a dynamic volume removes the volume signature from each subdevice associated with the volume, freeing the subdevices for use in other dynamic volumes or filesystems. Configuration Limits The configuration limits for dynamic volumes are as follows: • A maximum size of 16 TB for a dynamic volume. • A maximum of 128 dynamic volumes per matrix. • A maximum of 128 subdevices per dynamic volume.
Chapter 8: Configure Dynamic Volumes 78 Create a Dynamic Volume When you create a dynamic volume, you will need to select the subdevices to be included in the volume. If the volume will be striped, you will also need to select a stripe size. Optionally, Matrix Server can also create a filesystem that will be placed on the dynamic volume.
Chapter 8: Configure Dynamic Volumes 79 If you are creating a filesystem, you can also set various filesystem options. Click the Options button to see the Filesystem Options dialog, which allows you to select the block size for the filesystem and to configure quotas. (See “Filesystem Options” on page 101 for details about this dialog.) Available Subdevices: The display includes all imported subdevices that are not currently in use by another imported volume and that do not have a filesystem in place.
Chapter 8: Configure Dynamic Volumes 80 To create a dynamic volume from the command line, use this command. You can use either spaces or commas to separate the subdevice names. mx dynvolume create [--stripesize <4KB-64MB>] The following command lists the available subdevices: mx dynvolume showcreateopt Dynamic Volume Properties To see the configuration for a dynamic volume, select Storage > Dynamic Volume > Volume Properties and then choose the volume that you want to view.
Chapter 8: Configure Dynamic Volumes 81 The Stripe State reported in the “Dynamic Volume Properties” section will be one of the following: • Unstriped. The volume is concatenated and striping is not in effect. • Optimal. The volume has only one stripeset that includes all subdevices. Each subdevice is written to in turn. • Suboptimal. The volume has been extended and includes more than one stripeset. The subdevices in the first stripeset will be completely filled before writes to the next stripeset begin.
Chapter 8: Configure Dynamic Volumes 82 Extend a Dynamic Volume The Extend Volume option allows you to add subdevices to an existing dynamic volume. When you extend the volume on which a filesystem is mounted, you can optionally increase the size of the filesystem to fill the size of the volume. NOTE: The subdevices used for a striped dynamic volume are called a stripeset. When a striped dynamic volume is extended, the new subdevices form another stripeset.
Chapter 8: Configure Dynamic Volumes 83 Dynamic Volume Properties: The current properties of this dynamic volume. Filesystem Properties: The properties for the filesystem located on this dynamic volume. Available Subdevices: Select the additional subdevices to be added to the dynamic volume. The list includes all available subdevices on imported disks, including subdevices belonging to unimported volumes. Use the arrow keys to reorder those subdevices if necessary.
Chapter 8: Configure Dynamic Volumes 84 to destroy the affected unimported dynamic volume and reuse this subdevice for the volume you are extending. Be sure that you do not need the unimported dynamic volume before doing this. If the unimported volume associated with the subdevice is in a “duplicate” state,the attempt to destroy the volume will fail. See “Unimportable Volumes” on page 90 for more information.
Chapter 8: Configure Dynamic Volumes 85 Recreate a Dynamic Volume Occasionally you may want to recreate a dynamic volume. For example, you might want to implement striping on a concatenated volume or, if a striped dynamic volume has been extended, you might want to recreate the volume to place all of the subdevices in the same stripe set. When a dynamic volume is recreated, the Matrix Volume Manager first destroys the volume and then creates it again using the subdevices and options that you select.
Chapter 8: Configure Dynamic Volumes 86 You can change or reorder the subdevices used for the volume and enable striping if desired. To recreate a volume from the command line, you will first need to use the dynvolume destroy command and then run the dynvolume create command. Convert a Basic Volume to a Dynamic Volume If you have PSFS filesystems that were created directly on an imported disk partition or LUN (a basic volume), you can convert the basic volume to a dynamic volume.
Chapter 8: Configure Dynamic Volumes 87 NOTE: The new dynamic volume is unstriped. It is not possible to add striping to a converted dynamic volume. If you want to use striping, you will need to recreate the volume. To convert a basic volume, select the associated PSFS filesystem on the Filesystems tab of the PolyServe Management Console, right-click, and select Convert to Dynamic Volume. A warning then appears, stating that Matrix Server must unmount the filesystem, which will close any open files.
Chapter 8: Configure Dynamic Volumes 88 Dynamic Volume Recovery The Dynamic Volume Recovery feature provides the ability to rebuild a dynamic volume from the LUNs originally in the volume. This feature can be used for purposes such as the following: • Move dynamic volumes from one cluster to another. Deport the dynamic volumes on the original cluster and then import them on the new cluster. • Recover dynamic volumes from mirrored LUNs for disaster recovery purposes.
Chapter 8: Configure Dynamic Volumes 89 Select the dynamic volumes that you want to deport and click the Deport icon in the toolbar. To deport dynamic volumes from the command line, use this command: mx dynvolume deport ... Import a Dynamic Volume When a dynamic volume is imported, the unimported LUNs associated with the volume will be imported and the psv binding, which Matrix Server uses to control access to the dynamic volume, will be created.
Chapter 8: Configure Dynamic Volumes 90 Select the dynamic volumes that you want to import and click the Import icon in the toolbar. To import dynamic volumes from the command line, first use the following command to list the dynamic volumes that can be imported: mx dynvolume list --importable Locate the entry for the that you want to import. The appears in the first column of the output. Then use the following command to import the volume, specifying the .
Chapter 8: Configure Dynamic Volumes 91 Duplicate. The volume cannot be reassembled because more than one physical device matched a logical subdevice specification. Potential causes of this problem are: • Both sides of a mirror were exposed (that is, lunmasked) to the cluster. • One of the devices is a snapclone of the other. • One of devices is a disk copy or block-level backup/copy of the other. Truncated.
Chapter 8: Configure Dynamic Volumes The mx dynvolume create, mx dynvolume extend, and mx fs create commands include the --reuse option, which causes the operation to proceed even though the specified subdevice may already be in use by another dynamic volume. The operation will destroy the volume previously using the subdevice. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
9 Configure PSFS Filesystems PolyServe Matrix Server provides the PSFS filesystem. This direct-access shared filesystem enables multiple servers to concurrently read and write data stored on shared SAN storage devices. A journaling filesystem, PSFS provides live crash recovery.
Chapter 9: Configure PSFS Filesystems 94 The PSFS filesystem does not migrate processes from one server to another. If you want processes to be spread across servers, you will need to take the appropriate actions. Journaling Filesystem When you initiate certain filesystem operations such as creating, opening, or moving a file or modifying its size, the filesystem writes the metadata, or structural information, for that event to a transaction journal. The filesystem then performs the operation.
Chapter 9: Configure PSFS Filesystems 95 Filesystem Management and Integrity Matrix Server uses the SANPulse process to manage PSFS filesystems. SANPulse performs the following tasks. • Coordinates filesystem mounts, unmounts, and crash recovery operations. • Checks for matrix partitioning, which can occur when matrix network communications are lost but the affected servers can still access the SAN.
Chapter 9: Configure PSFS Filesystems 96 Disk Quotas Disk quotas are enabled or disabled at the filesystem level. When quotas are enabled, the filesystem performs quota accounting to track the disk use of each user having an assigned disk quota. When you create a filesystem and enable quotas, you can also set options including the default hard and soft limits for users on the filesystem. A hard limit specifies the maximum amount of disk space in the filesystem that can be used by files owned by the user.
Chapter 9: Configure PSFS Filesystems 97 The Windows operating system and Windows Disk Management utilities are not fully aware of PSFS filesystems or Matrix Server dynamic volumes. Although these Microsoft utilities can be useful for troubleshooting issues, they cannot display status from the perspective of a Matrix Server volume or filesystem. Dynamic Volumes Dynamic volumes created with the Matrix Server Volume Manager are not the same as Microsoft dynamic volumes.
Chapter 9: Configure PSFS Filesystems 98 NOTE: Be careful not to accidentally back up PSFS filesystems multiple times by using both your site-defined drive letter/mount point assignments and the reserved mount points. Filter out the reserved mount points from backup jobs, and instead use your own site-defined assignments.
Chapter 9: Configure PSFS Filesystems 99 • You do not have to assign the same mount points or drive letters to each filesystem on each node. When you use the PolyServe Management Console to assign a drive letter/mount point, the assignment applies to every node. However, you can use the mx fs assign command or the Windows LDM, mountvol.exe, or diskpart.exe commands to assign drive letters/mount points uniquely on each node. • You can assign multiple mount points to the same filesystem if necessary.
Chapter 9: Configure PSFS Filesystems 100 Create a Filesystem from the Management Console To create a filesystem, select Matrix > Add > Add Filesystem on the PolyServe Management Console, or click the Filesystem icon on the toolbar. Label: Type a label that identifies the filesystem.
Chapter 9: Configure PSFS Filesystems 101 NOTE: The Create a Filesystem window identifies volumes by their Matrix Server names such as psd1p2. To match these names to their local Windows names, open the Disk Info window (select the server on the Servers tab, right-click, and then select View Local Disk Info).
Chapter 9: Configure PSFS Filesystems 102 The Quotas tab allows you to specify whether disk quotas should be enabled on the filesystem. You can enable or disable quotas on a filesystem at any time. (See “Enable or Disable Quotas” on page 121.) When you enable quotas, you can also set default hard and soft quotas and select other quota parameters. To enable quotas on the filesystem, check the “Enable quotas” checkbox. You can then set default hard and soft quotas for users on that filesystem.
Chapter 9: Configure PSFS Filesystems 103 window allows you to specify whether hard limits should be enforced. You can also specify the type of logging that you want to use. (By default, hard limits are not enforced and logging is not performed.) The Quota Assignment Policy tab lets you select a default quota for new users who do not have an explicit quota limit. The users inherit the default setting the first time that they own a file on the filesystem. Copyright © 1999-2007 PolyServe, Inc.
Chapter 9: Configure PSFS Filesystems 104 There are two options: • Static default quota. The default limits are explicitly assigned to the user. Subsequent changes to the default values for the filesystem do not affect the quota limits for the user. This is the default, and matches the NTFS policy. • Dynamic default quota. No explicit default limits are assigned to the user. Instead, the effective limits applied to the user are the default values for the filesystem at the time of each operation.
Chapter 9: Configure PSFS Filesystems 105 If you want to change this option after the filesystem is created, you will need to either disable quotas and then re-enable them with the changed option, or recreate the filesystem. Recreate a Filesystem If you want to reformat a filesystem, select the filesystem on the Filesystems window, right-click, and select Recreate Filesystem. A message then appears stating that the Matrix Server needs to unmount the filesystem and any unsaved files will be lost.
Chapter 9: Configure PSFS Filesystems 106 Create a Filesystem from the Command Line To create a filesystem, use the psfsformat or mx commands. The psfsformat Command Use this syntax: psfsformat[-fq] [-l
Chapter 9: Configure PSFS Filesystems 107 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. It is particularly useful for speeding up allocation times on large, relatively full filesystems.
Chapter 9: Configure PSFS Filesystems 108 • logsoftlimit or nologsoftlimit Whether file operations that result in exceeding a user’s soft limit are logged in the system event log. nologsoftlimit is the default. • enforcehardlimit or noenforcehardlimit Whether file operations that will result in exceeding a user’s hard limit are denied or allowed. noenforcehardlimit is the default.
Chapter 9: Configure PSFS Filesystems 109 • [--defaultUserHardLimit ] The default hard limit on the filesystem. unlimited specifies that there is no default. The optional size modifiers specify that the size is in kilobytes (K), megabytes (M), gigabytes (G), or terabytes (T). If a modifier is not specified, the size will be calculated in bytes. (The default is rounded down to the nearest filesystem block.) • [--defaultUserSoftLimit ] The default soft limit.
Chapter 9: Configure PSFS Filesystems 110 Drive Letters and Mount Paths To provide access to a PSFS filesystem, you will need to associate it with a drive letter or a mount path. Assign Drive Letters or Paths To assign a drive letter or mount path, select the filesystem on the Filesystems tab on the PolyServe Management Console, right-click, and select Assign Path. The assignment is made on all servers in the matrix.
Chapter 9: Configure PSFS Filesystems 111 You can also assign a drive letter or path from the command line: mx fs assignpath --path [--createdir] The --createdir option creates the mount path if it does not already exist on each server. If a server was out of the matrix while the drive assignment was made or you add a new server to the matrix, you can use the above command to add the drive assignment to that server.
Chapter 9: Configure PSFS Filesystems 112 Remove Drive Letter or Path Assignments If you no longer want to associate a filesystem with a particular drive letter or mount path, you can remove the assignment. Before doing this, be sure that applications are not currently accessing the filesystem via the drive letter or mount path. To remove a drive letter or path assignment, select the filesystem on the Filesystems tab, right-click, and then select Unassign Paths.
Chapter 9: Configure PSFS Filesystems 113 Extend a Mounted Filesystem If the Volume allocation display shows that there is space remaining on the volume, you can use the “Extend Filesystem” option on the Properties window to increase the size of the PSFS filesystem to the maximum size of the volume. When you click on the Extend Filesystem button, you will see a warning such as the following. When you click Yes, Matrix Server will extend the filesystem to use all of the available space.
Chapter 9: Configure PSFS Filesystems 114 Features Tab The Features tab shows whether Full Zone Bit Maps (FZBM) or quotas are enabled on the filesystem. Quotas Tab The Quotas tab allows you to enable or disable quotas on the filesystem, to set the default hard and soft limits, and to configure other quota options. See “Filesystem Options” on page 101 for more information about the quota options. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Chapter 9: Configure PSFS Filesystems 115 View Filesystem Status from the Command Line You can use the following mx command to see status information. mx fs status [--verbose] [--standard|--snapshots] The command lists the status of each filesystem. The --verbose option also displays the FS type (always PSFS), the size of the filesystem in KB, and the UUID of the parent disk. The --standard option shows only standard filesystems; the --snapshot option shows only snapshots.
Chapter 9: Configure PSFS Filesystems 116 Extend a Basic Volume and Its Filesystem The PolyServe Management Console provides an option to increase the size of a PSFS filesystem and the basic volume, or partition, on which it is located. NOTE: This option cannot be used to extend filesystems on disks containing a Matrix Server membership partition. Select the filesystem on the Management Console, right-click, and select Extend Volume.
Chapter 9: Configure PSFS Filesystems 117 on the disk that will be deported. Users will not be able to access these filesystems until the resize operation is complete. When you click OK on the Confirm Extend window, Matrix Server deports the disk, resizes the filesystem partition by the specified size, reimports the disk, and then expands the filesystem to fill the additional space in the partition.
Chapter 9: Configure PSFS Filesystems 118 The next example uses a mount path: psfssuspend c:\psfs_mount\ The psfssuspend command prevents modifications to the filesystem and forces any changed blocks associated with the filesystem to disk. The command performs these actions on all servers that have mounted the filesystem and then returns successfully. Any process attempting to modify a suspended filesystem will block until the filesystem is resumed.
Chapter 9: Configure PSFS Filesystems 119 The device 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 psv3 Perform a Filesystem Check If a filesystem is not unmounted cleanly, the journal will be replayed the next time the filesystem is mounted to restore consistency. You should seldom need to check the filesystem.
Chapter 9: Configure PSFS Filesystems 120 For more information about the check, click the Details button. If psfscheck locates errors that need to be repaired, it will display a message telling you to run the utility from the command line. For more information, see the PolyServe Matrix Server Command Reference. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
10 Manage Disk Quotas The PSFS filesystem supports disk quotas, which limit the amount of disk space on a filesystem that can be used for individual user’s files. Hard and Soft Filesystem Limits The PSFS filesystem supports both hard and soft filesystem quotas. A hard quota specifies the maximum amount of disk space on a particular filesystem that can be used by files owned by the user.
Chapter 10: Manage Disk Quotas 122 When you create a PSFS filesystem, you can specify whether quotas should be enabled and you can set quota options on the filesystem. (See “Create a Filesystem” on page 99.) Quotas can also be enabled or disabled on an existing filesystem, using either the PolyServe Management Console or Matrix Server commands. The filesystem will be unmounted briefly during the enable/disable operation.
Chapter 10: Manage Disk Quotas 123 Check or uncheck “Enable quotas” as appropriate. If you are enabling quotas, you can set the default hard and soft quotas for users on that filesystem. To do this, click on “Limit” and then specify the appropriate size in either kilobytes, megabytes, gigabytes, or terabytes. The default is rounded down to the nearest filesystem block. (If you do not want a default limit, click “Unlimited.”) The default quotas apply to all users who do not have individual quotas.
Chapter 10: Manage Disk Quotas 124 Manage User Quotas The mx quota command can be used to manage user quotas from the command line. See the PolyServe Matrix Server Command Reference for details about this command. You can also use Microsoft Windows features such as the following to manage user quotas. Refer to the Windows documentation for more information about these features. Quota GUI. The Windows Quota GUI can be accessed from Microsoft Windows Explorer.
Chapter 10: Manage Disk Quotas 125 The Quota Entries window. This window can be accessed via Microsoft Windows Explorer. Display the Properties for the filesystem, select the Quota tab, and then click the Quota Entries button. When using the Quota Entries window, you should be aware of the following: • The “Amount Used” column includes PSFS metadata as well as the space required for the user data in each user’s files. The space used may be different that it would be on another type of filesystem.
Chapter 10: Manage Disk Quotas 126 Back Up and Restore Quotas The psfsdq and psfsrq commands can be used to back up and restore the quota information stored on the PSFS filesystem. These commands should be run in conjunction with standard filesystem backup utilities, as those utilities do not save the quota limits set on the filesystem. NOTE: We recommend that you use the psfsdq and psfsrq commands instead of the Import and Export options on the Quota Entries window.
Chapter 10: Manage Disk Quotas 127 Examples The following command saves the quota information for the filesystem located on device psd1p5. psfsdq -f psd1p5.quotadata psd1p5 The next command restores the data to the filesystem: psfsrq -f psd1p5.quotadata psd1p5 Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
11 Manage Hardware Snapshots Matrix Server provides support for taking hardware array-based snapshots of PSFS filesystems. The snapshots provide a point-in-time image of a PSFS filesystem. Users or the Administrator can then use the Microsoft Shadow Copies of Shared Folders feature to recover individual files or whole volumes from the appropriate snapshot image. The subdevices containing the PSFS filesystems must reside on one or more storage arrays that are supported for snapshots.
Chapter 11: Manage Hardware Snapshots 129 CommandView EVA software must be installed on your Management Appliance. Be sure that your versions of SSSU and CommandView EVA are consistent. The SSSU utility must be renamed to %Program Files%\Hewlett-Packard\SANworks \Element Manager for StorageWorks HSV\Bridge\sssu.exe. Engenio Storage Arrays To take hardware snapshots on Engenio storage arrays, a supported version of SANtricity Storage Manager client software must be installed on all servers in the cluster.
Chapter 11: Manage Hardware Snapshots 130 HP EVA Array-Based Snapshots The following dialog appears. Label. The label is used to identify the snapshot on the Management Console. Share as Shadow Copy of Shared Folder. Check this box if you want users to be able to use the snapshot as a shadow copy. HP EVA Options. Snapshots initially consume storage space only to store pointers to the data in the source filesystem, growing in size when source filesystem data is changed.
Chapter 11: Manage Hardware Snapshots 131 Engenio Snapshots The dialog asks for the following information: Label. The label is used to identify the snapshot on the Management Console. Share as Shadow Copy of Shared Folder. Check this box if you want users to be able to use the snapshot as a shadow copy. Engenio Options. The first time a snapshot is taken of a particular filesystem, the snapshot process creates a repository on disk that stores pointers to the data in the source filesystem.
Chapter 11: Manage Hardware Snapshots 132 Snapshots appear on the Management Console beneath the entry for the filesystem, while snapclones appear as a separate filesystem. Each snapshot or snapclone is assigned a Matrix Server psd or psv device name. In the following example, the first two filesystem entries are snapclones. The next entry is a regular filesystem, and is followed by snapshots of the filesystem.
Chapter 11: Manage Hardware Snapshots 133 Delete a Snapshot Storage arrays typically limit the number of snapshots that can be taken of a specific filesystem. Before taking an additional snapshot, you will need to delete an existing snapshot. Also, if you want to destroy a filesystem, you will first need to delete all snapshots of that filesystem. To delete a snapshot, select the snapshot on the Management Console, right-click, and select Delete (or use (or select Edit > Filesystem > Create Snapshot).
Chapter 11: Manage Hardware Snapshots 134 To unassign a drive letter or path, type the following: mx fs unassign Using Shadow Copies of Shared Folders When you take a snapshot of a PSFS filesystem, you can specify that it should be shared as a shadow copy. The snapshot provides a point-intime version of the filesystem.
12 Configure Security Features Matrix Server provides the following security features: • Role-Based Security. By default, the machine’s local Administrators group has full cluster rights and can perform all Matrix Server operations. You can use the Role-Based Security feature to create roles that allow or deny other users and groups the ability to perform specific cluster operations.
Chapter 12: Configure Security Features 136 Matrix Server provides a built-in System Administrator role that includes all members of the machine local Administrators group. This group has permission to perform all matrix operations. In general, if a user in the System Administrator role belongs to another role that denies a matrix operation, the deny will override the permission granted to the System Administrator role.
Chapter 12: Configure Security Features 137 Add a New Role To define a new role, click Add to display the Role Properties window. Name: Type a name for the new role. Role names cannot include the forward slash character (/). Enabled: By default, the role will be enabled when it is created. To disable the role, remove the checkmark. Resource: Use this pane to specify the rights that will apply to the new role.
Chapter 12: Configure Security Features 138 • Setup. Manipulate settings that affect the entire matrix configuration, including membership partitions, licensing, snapshot configuration, fencing configuration, servers, notification settings, and security roles. The Event Notification, Security, and Servers resources are subsets of this resource. – Event Notification. Configure event notification settings. Create affects the ability to enable or disable notifiers.
Chapter 12: Configure Security Features 139 – Custom. Manipulate virtual hosts, service monitors, and device monitors. Create affects the ability to create new application objects. Modify affects the ability to change existing application objects, including adding new servers to an object and rehosting objects. Delete affects the ability to delete application objects. – File Serving. Manipulate MxFS for CIFS application objects, including Virtual File Services and Matrix File Shares.
Chapter 12: Configure Security Features 140 Assign Rights Manually Rights can be assigned at different resource levels. If rights are applied to the top-level resource, they apply to all cluster resources. Rights assigned to a second level resource such as Storage apply just to the resources nested in that resource. For example, rights assigned to the Storage resource apply to both the Volumes and Filesystems resources. You can also assign rights to the lowest-level resources.
Chapter 12: Configure Security Features 141 When you select a template, the rights appropriate to that role will be marked with a checkmark to allow the right or an X to deny the right. You can adjust the rights as necessary. Then go to the Members tab to assign group or user accounts to the role. Assign Accounts to a Role The Members tab on the Role Properties window shows the user and group accounts that belong to the role. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Chapter 12: Configure Security Features 142 Click Add to assign accounts to the role. The Enter an Account dialog then asks for the user or group to be added. Enter an account to add. Type the name or ID for the user or group. Type. Specify whether you are adding a user account or a group account. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Chapter 12: Configure Security Features 143 Form. Specify whether you entered a name or an ID for the account. Tips for Specifying Accounts When specifying accounts for a role, you should be aware of the following: • Matrix Server uses the contents of the access token created when you logged into the matrix to determine user and group identities. • To simplify Role-Based Security administration, specify groups instead of users wherever possible.
Chapter 12: Configure Security Features 144 names without domains) will fail if the user account name contains more than 20 characters. This restriction does not apply to group account names. View Effective Rights The My Rights tab on the Role-Based Security Control Panel lists the effective rights that you have on the matrix. Effective rights are the sum of the rights provided by all of the roles to which you belong. Allowed operations are indicated by a checkmark.
Chapter 12: Configure Security Features 145 Other Role-Based Security Procedures Export or Import Roles The import and export features can used if you will be configuring a new matrix and want to use the Role-Based Security settings that you have configured on the existing matrix. Click the Export button to save the current settings to the file of your choice. (The default location is your home directory.) The file is written in XML format.
Chapter 12: Configure Security Features 146 When configuring the new matrix, click Import to import the file containing the Role-Based Security settings. The imported settings will replace any current Role-Based Security settings. To import or export Role-Based Security settings from the command line, use these commands: mx role export [--permissionOnly] mx role import [--permissionOnly] The --permissionOnly option omits the list of role members from the import or export.
Chapter 12: Configure Security Features 147 Properties window. Select the role on the Role-Based Security Control Panel and click Edit to display the Role Properties window. Delete a Role When a role is deleted from the matrix configuration, the accounts belonging to the role will automatically lose their membership in that role. Roles are deleted on the Role Properties window. Select the role on the Role-Based Security Control Panel and click Edit to display the Role Properties window.
Chapter 12: Configure Security Features 148 Remove Roles From an Account Use this command: mx account removerole --form --type ... The --form option specifies whether you are entering the name or ID of the account (NAME is the default). The --type option specifies whether the account is for a user or group or is unknown (GROUP is the default).
13 Configure Event Notifiers and View Events Matrix Server generates an event message when an error condition or failure occurs or when the status of the matrix changes. To provide an audit trail of matrix operations, a message is also generated when a user requests and is granted or denied authorization to perform a task. Event messages are logged and can be viewed either with the Matrix Event Viewer provided with the PolyServe Management Console or with command-line tools.
Chapter 13: Configure Event Notifiers and View Events 150 When an event message is generated, it is written immediately to the Windows event log on the server where the condition occurred. The message is also sent to the Matrix Server mxlogd process, which takes these actions: • Sends the message to the event notifier services configured on the server. If the message has been selected to trigger a notifier service, the appropriate action will take place (send an SNMP trap, send email, or run a script).
Chapter 13: Configure Event Notifiers and View Events 151 • Email Notifier Service. This service sends email to specified addresses when the selected events occur. • Script Notifier Service. This service allows you to specify a script that will be triggered when selected events occur. If you configured notifiers in previous releases of Matrix Server, you can use this service to recreate the notifiers. You will need to configure the services that you want to use with your matrix.
Chapter 13: Configure Event Notifiers and View Events 152 1. Open the Control Panel and select Administrative Tools. 2. Double-click Services. On the Services window, locate the SNMP Service, right-click, and select Properties. 3. Open the Security tab and add the community name. The Microsoft SNMP service is enabled by default and will automatically use the Matrix Server extension agent.
Chapter 13: Configure Event Notifiers and View Events 153 By default, the Event Viewer shows the last 1000 messages in the matrix log. To display a different number of messages, select Viewer > Max Events to Display. Then, on the following dialog, specify the maximum number of events to display on the Event Viewer. You can save the event listing to a file by clicking Save As on the toolbar or by selecting Viewer > Save As.
Chapter 13: Configure Event Notifiers and View Events 154 Filter the Event Output The Event Viewer includes three filters that can be used to limit the events that are displayed: • Search All. This filter allows you to enter text to be matched. The Event Viewer will show only those events that include the text in any of the event fields. • Severity. This filter allows you to select one or more severity levels. The Event Viewer will display only the events having the specified severity levels. • Timestamp.
Chapter 13: Configure Event Notifiers and View Events 155 --timestamp Filter by a particular time range expressed as . --noHeaders Do not display column headers in the output. --csv Display the output in comma-separated value format. --showborder Display borders in the output. The mcs select command can also be used to view the matrix log. See the PolyServe Matrix Server Command Reference for more information about this command.
Chapter 13: Configure Event Notifiers and View Events 156 To insert a message, use this command at the Command Prompt: mx matrix log You can also use the mcs log command to add a log message as described in the PolyServe Matrix Server Command Reference. Configure Event Notifier Services The Event Notification Control Panel allows you to configure the event notifier services (SNMP, email, script) and specify the matrix events that will trigger them.
Chapter 13: Configure Event Notifiers and View Events 157 Use the following command to view all event messages from the command line: mx eventnotifier list Select Events for a Notifier Service The Event Definition tab can be used to select the events that should trigger the appropriate notifier services. By default, messages that appear as Alerts on the PolyServe Management Console are selected for all of the event notifier services.
Chapter 13: Configure Event Notifiers and View Events 158 range of IDs to be added. Use commas to separate the values, for example: 100, 300-400,555. mx eventnotifier addevents [--snmp] [--email] [--script] mx eventnotifier removeevents [--snmp] [--email] [--script] Configure the SNMP Notifier Service To configure the SNMP notifier service, select the SNMP Trap Forwarding Settings tab.
Chapter 13: Configure Event Notifiers and View Events 159 Target. Enter either the hostname or the IP address of the SNMP trap forwarding target. The trap-forwarding destination port is the IANA registered port for snmptrap (162/udp). Community. Enter the community string that is used to access the target. The default is public. Disable the SNMP trap forwarding service. This checkbox can be used to enable or disable the service as necessary.
Chapter 13: Configure Event Notifiers and View Events 160 From Email address. Type the email address that will be specified as the sender of the notification emails. If this option is not included, the server name will be used as the sender. To Email address. Type the email addresses to which event notifier email should be sent. If multiple addresses will be specified, use semicolons to separate the addresses. Subject line.
Chapter 13: Configure Event Notifiers and View Events 161 Omit cluster description. By default, the cluster description assigned to the matrix appears in the source address for the email. For example, if the cluster description is Cluster X and the --from is clust2@company.com, the source address for the email will be Cluster X [clust2@company.com]. When the Omit cluster description option is checked, the cluster description does not appear in the source address.
Chapter 13: Configure Event Notifiers and View Events 162 Script. Enter the full path of the script to be run when events configured to trigger the script occur. If the script does not reside on a shared filesystem, ensure that it is replicated to the specified location on all servers. Disable the Script notifier service. This checkbox can be used to enable or disable the service as necessary. To test the service, click Send Test Message.
Chapter 13: Configure Event Notifiers and View Events 163 Test Notifier Services The configuration tabs for the SNMP, email, and script notification services contain a Test button that verifies that events can be sent to the configured notification service. An error will be reported if the service is disabled or is not configured. Enable or Disable a Notifier Service The tabs used to configure the notifier services also have a checkbox to disable the services.
Chapter 13: Configure Event Notifiers and View Events 164 Import or Export the Notifier Event Settings The import and export features and can used if you will be configuring a new matrix and want to use the notifier event settings that you have configured on the existing matrix. Click the Export Definitions button to save the current settings to the file of your choice. (The default is your home directory.) The exported settings include all of the event notifiers and their event definition assignments.
Chapter 13: Configure Event Notifiers and View Events 165 Script Requirements For the script to work properly, the following requirements must be met: • The script or program must be accessible from each node in the cluster. It is recommended that an identical copy of the script or program be placed on local storage on each node to ensure that it will always be available. • The script must be able to be executed on each node.
Chapter 13: Configure Event Notifiers and View Events Following is an example of the input XML (as with the above, not all elements are required for each event): PAGE 17814 Matrix Operations on the Applications Tab The Applications tab on the Management Console shows all Matrix Server applications, virtual hosts, service monitors, and device monitors configured in the matrix and enables you to manage and monitor them from a single screen. Applications Overview An application provides a way to group associated matrix resources (virtual hosts, service monitors, and device monitors) so that they can be treated as a unit.
Chapter 14: Matrix Operations on the Applications Tab 168 a device monitor, the application will use the same name as the device monitor. The Applications Tab The Management Console lists applications and their associated resources (virtual hosts, service and device monitors) on the Applications tab. The applications and resources appear in the rows of the table. (Double-click on a resource to see its properties.) The servers on which the resources are configured appear in the columns.
Chapter 14: Matrix Operations on the Applications Tab 169 The cells indicate whether a resource is deployed on a particular server, as well as the current status of the resource. If a cell is empty, the resource is not deployed on that server. The icons used on the Applications tab report the status of the servers, applications, and resources. The following icons are used in the server columns to indicate the status of applications and resources.
Chapter 14: Matrix Operations on the Applications Tab 170 The possible states for the application are: Icon Status OK Meaning Clients can access the application. Warning Clients can access the application but not from the primary node. Error Clients cannot access the application. In the following example, the status for most of the applications is OK because clients are accessing the application through the primary server. However, the status of application 99.11.14.
Chapter 14: Matrix Operations on the Applications Tab 171 Filter the Applications Display You can use filters to limit the information appearing on the Application tab. For example, you may want to see only a certain type of monitor, or only monitors that are down or disabled. You can use filters to do this. To add a filter, click the “New Filter” tab and then configure the filter. Name: Specify a name for this filter.
Chapter 14: Matrix Operations on the Applications Tab 172 Click OK to close the filter. The filter then appears as a separate tab and will be available to you when you connect to any cluster. (Filters are stored per user under the registry key.) To modify an existing filter, select that filter, right-click, and select Edit Filter. To remove a filter, select the filter, right-click, and select Delete Filter.
Chapter 14: Matrix Operations on the Applications Tab 173 When you reach a cell that accepts drops, the cursor will change to an arrow. The following drag and drop operations are allowed. Applications These operations are allowed only for applications that include at most only one virtual host. • Assign an application to a server. Drag the application from the Name column to the empty cell for the server.
Chapter 14: Matrix Operations on the Applications Tab 174 • Switch the primary and backup servers (or two backup servers) for a virtual host. Drag the virtual host from one server cell to the cell for the other server. If the virtual host is active, this operation can disconnect existing applications that depend on the virtual host. When the operation is complete, the ordering for failover will be switched. • Remove a virtual host from a server.
Chapter 14: Matrix Operations on the Applications Tab 175 reordered as necessary. If the monitor was multi-active, it will remain active on any other servers on which it is configured. Menu Operations Applications The following operations affect all entities associated with a Matrix Server application. These operations can also be performed from the command line, as described in the PolyServe Matrix Server Command Reference.
Chapter 14: Matrix Operations on the Applications Tab 176 • Add a service monitor. • Enable or disable the virtual host. • View or change the properties for the virtual host. • Delete the virtual host. To perform these procedures, left-click on the cell for the virtual host (click in the Name column). Then right-click and select the appropriate operation from the menu. See “Configure Virtual Hosts” on page 177 for more information about these procedures.
15 Configure Virtual Hosts PolyServe Matrix Server uses virtual hosts to provide failover protection for servers and network applications. Overview A virtual host is a hostname/IP address configured on a set of network interfaces. Each interface must be located on a different server. The first network interface configured is the primary interface for the virtual host. The server providing this interface is the primary server.
Chapter 15: Configure Virtual Hosts 178 Matrix Health and Virtual Host Failover To ensure the availability of a virtual host, Matrix Server monitors the health of the administrative network, the active network interface, and the underlying server. If you have created service or device monitors, those monitors periodically check the health of the specified services or devices.
Chapter 15: Configure Virtual Hosts 179 The failover operation to another network interface has minimal impact on clients. For example, if clients were downloading Web pages during the failover, they would receive a “transfer interrupted” message and could simply reload the Web page. If they were reading Web pages, they would not notice any interruption. If the active network interface fails, only the virtual hosts associated with that interface are failed over.
Chapter 15: Configure Virtual Hosts 180 Add or Modify a Virtual Host To add or update a virtual host from the PolyServe Management Console, select the appropriate option: • To add a new virtual host, select Matrix > Add > Add Virtual Host or click the V-Host icon on the toolbar. Then configure the virtual host on the Add Virtual Host window. • To update an existing virtual host, select that virtual host on either the Server or Virtual Hosts window, right-click, and select Properties.
Chapter 15: Configure Virtual Hosts 181 existing application name, or leave this field blank. However, if you do not assign a name, Matrix Server will use the IP address for the virtual host as the application name. Always active: If you check this box, upon server failure, the virtual host will move to an active server even if all associated service and device monitors are inactive or down.
Chapter 15: Configure Virtual Hosts 182 Network Interfaces: When the “All Servers” box is checked, the virtual host will be configured on all servers having an interface on the network you select for this virtual host. When you add another server to the matrix, the virtual host will automatically be configured on that server. This option can be useful with administrative applications. Available/Members: The Available column lists all network interfaces that are available for this virtual host.
Chapter 15: Configure Virtual Hosts 183 Configure Applications for Virtual Hosts After creating virtual hosts, you will need to configure your network applications to recognize them. For example, if you are using a Web server, you may need to edit its configuration files to recognize and respond to the virtual hosts. By default, FTP responds to any virtual host request it receives.
Chapter 15: Configure Virtual Hosts 184 Rehost a Virtual Host You can use the Rehost option to modify the configuration of a virtual host. For example, you might want to change the primary for the virtual host or reorder the backups. To use this option, select the virtual host, right-click, and then select Rehost. The Virtual Host Rehost window then appears. When you make your changes and click OK, you will see a message warning that this action may cause a disruption of service.
Chapter 15: Configure Virtual Hosts 185 Change the Virtual IP Address for a Virtual Host When you change the virtual IP address of a virtual host, you will also need to update your name server and to configure applications to recognize the new virtual IP address. The order in which you perform these tasks is dependent on your application and the requirements of your site. You can use mx commands to change the virtual IP address of a virtual host. Complete these steps: 1.
Chapter 15: Configure Virtual Hosts 186 When certain events occur on the server where a virtual host is located, the ClusterPulse process will attempt to fail over the virtual host to another server configured for that virtual host. For example, if the server goes down, ClusterPulse will check the health of the other servers and then determine the best location for the virtual host.
Chapter 15: Configure Virtual Hosts 187 • The PanPulse process controls whether a network interface is marked up or down. When PanPulse determines that an interface currently hosting a virtual host is down, ClusterPulse will begin searching for another server on which to locate the virtual host. 3. ClusterPulse narrows the list to those servers without inactive, down, or disabled Matrix Server device monitors. If there are no servers that meet this criteria, the virtual host is not made active anywhere.
Chapter 15: Configure Virtual Hosts 188 Specify Failover/Failback Behavior The Probe Severity setting allows you to specify whether a failure of the service or device monitor probe should cause the virtual host to fail over. For example, you could configure a gateway device monitor to watch a router. The device monitor probe might occasionally time out because of heavy network traffic to the router; however the router is still functioning.
Chapter 15: Configure Virtual Hosts 189 • For service monitors, you can assign a priority to each monitor (the Service Priority setting). If ClusterPulse cannot locate an interface where all services are “up” on the underlying server, it selects an interface where the highest priority service is “up” on the underlying server.
Chapter 15: Configure Virtual Hosts 190 have three up service monitors. The NOFAILBACK policy will not move the virtual host until a healthier server is available. • After the virtual host fails over to node 2, a service monitor probe fails on that node. Now both nodes have a down service monitor. Failback does not occur because the servers are equally healthy. If the failed service is then restored on node 1, that node will now be healthier than node 2 and failback will occur.
16 Configure Service Monitors Service monitors are typically used to monitor a network service such as HTTP or FTP. If a service monitor indicates that a network service is not functioning properly on the primary server, Matrix Server can transfer the network traffic to a backup server that also provides that network service. Overview Before creating a service monitor for a particular service, you will need to configure that service on your servers.
Chapter 16: Configure Service Monitors 192 severity, Start scripts, and Stop scripts) are consistent across all servers configured for a virtual host. Service Monitors and Failover If a monitored service fails, Matrix Server attempts to relocate any virtual hosts associated with the service monitor to a network interface on a healthier server.
Chapter 16: Configure Service Monitors 193 FTP Service Monitor By default the FTP service monitor probes TCP port 21 of the virtual host address. You can change this port number to the port number configured for your FTP server. The default frequency of the probe is every 30 seconds. The default time that the service monitor waits for a probe to complete is five seconds. The probe function attempts to connect to port 21 and expects to read an initial message from the FTP server.
Chapter 16: Configure Service Monitors 194 service if it is not already started. When the service monitor instance becomes inactive, the monitor stops the NT service if the probe type for the monitor is set to Single-Probe. When you configure the monitor, you will need to indicate whether dependent services of the NT service should also be started and stopped.
Chapter 16: Configure Service Monitors 195 TCP Service Monitor The generic TCP service monitor defaults to TCP port 0. You should set the port to the listening port of your server software. The default frequency of the probe is every 30 seconds. The default time that the service monitor waits for a probe to complete is five seconds. Because the service monitor cannot know what to expect from the TCP port connection, it simply attempts to connect to the specified port.
Chapter 16: Configure Service Monitors 196 Add or Modify a Service Monitor Adding a service monitor configures Matrix Server monitoring only. It does not configure the service itself. To add or update a service monitor from the PolyServe Management Console, select the appropriate option: • To add a new service monitor, first select the virtual host for the monitor on either the Servers or Virtual Hosts window, then rightclick and select Add Service Monitor (or click the Service icon on the toolbar).
Chapter 16: Configure Service Monitors 197 Monitor Type: Select the type of service that you want to monitor. Timeout: The maximum amount of time that the monitor_agent process will wait for a probe to complete. For most monitors, the default timeout interval is five seconds. You can use the default setting or specify a new timeout interval. Frequency: The interval of time, in seconds, at which the monitor probes the designated service.
Chapter 16: Configure Service Monitors 198 To add or update a service monitor from the command line, use this command: mx service add|update [--type DNS|FTP|HTTP|HTTPS|IMAP4|NNTP| NTSERVICE|POP3|SMTP|TCP|CUSTOM] [--timeout ] [--frequency ] [] ... NOTE: The --type option cannot be used with the mx service update command. See “Advanced Settings for Service Monitors” for information about the other arguments that can be specified for service monitors.
Chapter 16: Configure Service Monitors 199 Service Monitor Policy The Policy tab lets you specify the failover behavior of the service monitor and set its service priority. Timeout and Failure Severity This setting works with the virtual host policy (either AUTOFAILBACK or NOFAILBACK) to determine what happens when a probe of a monitored service fails.
Chapter 16: Configure Service Monitors 200 monitored resource is not critical, but is important enough that you want to keep a record of its health. AUTORECOVER. This is the default. The virtual host fails over when a monitor probe fails. When the service is recovered on the original node, failback occurs according to the virtual host’s failback policy. NOAUTORECOVER. The virtual host fails over when a monitor probe fails and the monitor is disabled on the original node, preventing automatic failback.
Chapter 16: Configure Service Monitors 201 Probe Type Service monitors can be configured to be either single-probe or multiprobe. A multi-probe monitor performs the probe function on each node where the monitor is configured, regardless of whether the monitor instance is active or inactive. This is the default for the built-in monitors. Single-probe monitors perform the probe function only on the node where the monitor instance is active.
Chapter 16: Configure Service Monitors 202 Scripts Service monitors can optionally be configured with scripts that are run at various points during matrix operation. The script types are as follows: Recovery script. Runs after a monitor probe failure is detected, in an attempt to restore the service. Start script. Runs as a service is becoming active on a server. Stop script. Runs as a service is becoming inactive on a server.
Chapter 16: Configure Service Monitors 203 without considering this to be an error. In both of these cases, the script should exit with a zero exit status. This behavior is necessary because Matrix Server runs the Start and Stop scripts to establish the desired start/stop activity, even though the service may actually have been started by something other than Matrix Server before ClusterPulse was started.
Chapter 16: Configure Service Monitors 204 Event Severity If a Start or Stop script fails or times out, a monitor event is created on the the node where the failure or timeout occurred. Configuration errors can also cause this behavior. You can view these events on the PolyServe Management Console and clear them from the Console or command line after you have fixed the problems that caused them. When an event is created, the ClusterPulse process may initiate failover of the associated virtual host.
Chapter 16: Configure Service Monitors 205 PARALLEL. The strict ordering sequence for Stop and Start scripts is not enforced. The scripts run in parallel across the matrix as a virtual host is in transition. The PARALLEL configuration can speed up failover time for services that do not depend on strict ordering of Start and Stop scripts.
Chapter 16: Configure Service Monitors 206 To disable a service monitor, select it on the Management Console, rightclick, and select Disable. To disable a service monitor from the command line, use this command: mx service disable ... Enable a Previously Disabled Service Monitor From the Management Console, select the service monitor to be enabled, right-click, and select Enable.
17 Configure Device Monitors PolyServe Matrix Server provides built-in device monitors that can be used to watch local disks, gateway devices, or an NT service, or to monitor access to a SAN disk partition containing a PSFS filesystem. You can also create custom device monitors. Overview A device monitor is configured on one or more servers in the matrix. Depending on the type of monitor, it can be active on all servers on which it is configured, or on only one server.
Chapter 17: Configure Device Monitors 208 Type Default Timeout Default Frequency Other Parameters SHARED_FILESYSTEM 5 seconds 30 seconds Filesystem, filename CUSTOM 60 seconds 60 seconds User probe script Activity Types for Device Monitors The activity type specifies where the device monitor can be active. The activity type can be one of the following: • Single-Active. The monitor is active on only one of the selected servers.
Chapter 17: Configure Device Monitors 209 GATEWAY Device Monitor When certain network failures occur, the servers in a matrix can lose communication with each other. This situation can result in a partition, or split, of the matrix. For example, in a two-server matrix, each server would assume that it remained in the matrix and that the other server was down. The gateway device monitor detects the network failure and prevents the matrix from partitioning.
Chapter 17: Configure Device Monitors 210 The monitor probe queries the status of the NT service. If the status is SERVICE_RUNNING, the service status remains Up. If the status does not indicate that the NT service is running, the service status is set to Down. The NTSERVICE monitor is also available as a service monitor. When deciding whether to create a service monitor or a device monitor, consider the effect that you want the monitor to have on the matrix.
Chapter 17: Configure Device Monitors 211 Custom Device Monitor A CUSTOM device monitor can be used if the built-in device types are not sufficient for your needs. Custom device monitors can be particularly useful when integrating Matrix Server with a custom application. When you create a CUSTOM monitor, you will need to supply the probe script. In the script, probe commands should determine the health of the device as necessary.
Chapter 17: Configure Device Monitors 212 The device monitor activeness policy decision is made as follows: 1. If the device monitor on a specific server is disabled, then the device monitor will not be made active on that server. 2. ClusterPulse considers the list of servers that are both up and enabled and that are configured for the device monitor.
Chapter 17: Configure Device Monitors 213 Add or Modify a Device Monitor Select the appropriate option from the PolyServe Management Console: • To add a new device monitor, select the server to be associated with the monitor from the Servers window, right-click, and select Add Device Monitor (or click the Device icon on the toolbar). Then configure the device monitor on the New Device Monitor window.
Chapter 17: Configure Device Monitors 214 Device Type: Select the appropriate device type (DISK, GATEWAY, NTSERVICE, SHARED_FILESYSTEM, or CUSTOM). See “Overview” on page 207 for a description of these monitors. Frequency and Timeout: These fields are set to the default values for the type of device you have selected. Change them as needed. Additional parameters: Depending on the type of monitor you are creating, you will be asked for an additional parameter. • DISK monitor.
Chapter 17: Configure Device Monitors 215 decimal IP address of the hostname for the server, and is the name assigned to the SHARED_FILESYSTEM device monitor. • CUSTOM monitor. Specify the pathname to the probe script to be used with the monitor. The following example shows a device monitor created on the server svr1. To add a device monitor from the command line, use this command: mx device add --servers ,,...
Chapter 17: Configure Device Monitors 216 Probe Severity The Probe Severity tab lets you specify the failover behavior of the monitor. The Probe Severity setting works with the virtual host policy (either AUTOFAILBACK or NOFAILBACK) to determine what happens when a monitored device fails.
Chapter 17: Configure Device Monitors 217 monitored resource is not critical, but is important enough that you want to keep a record of its health. AUTORECOVER. This is the default. The virtual host fails over when a monitor probe fails. When device access is recovered on the original node, failback occurs according to the virtual host’s failback policy. NOAUTORECOVER. The virtual host fails over when a monitor probe fails and the monitor is disabled on the original node, preventing automatic failback.
Chapter 17: Configure Device Monitors 218 Custom Scripts The Scripts tab lets you configure custom Recovery, Start, and Stop scripts for a device monitor. Device monitors can optionally be configured with scripts that are run at various points during matrix operation. The script types are as follows: Recovery script. Runs after a monitor probe failure is detected, in an attempt to restore the device. Start script. Runs as a device is becoming active on a server. Stop script.
Chapter 17: Configure Device Monitors 219 must be robust enough to run when the device is already stopped, without considering this to be an error. In both of these cases, the script should exit with a zero exit status. This behavior is necessary because Matrix Server runs the Start and Stop scripts to establish the desired start/stop activity, even though the device may actually have been started by something other than Matrix Server before the ClusterPulse process was started.
Chapter 17: Configure Device Monitors 220 If you want to reverse this order, preface the Stop script with the prefix [post] on the Scripts tab. Event Severity If a Start or Stop script fails or times out, a monitor event is created on the the node where the failure or timeout occurred. Configuration errors can also cause this behavior. You can view these events on the PolyServe Management Console and clear them from the Console or command line after you have fixed the problems that caused them.
Chapter 17: Configure Device Monitors 221 2. ClusterPulse waits for all Stop scripts to complete. 3. The Start script is run on the server where the virtual host or shared device is becoming active. PARALLEL. The strict ordering sequence for Stop and Start scripts is not enforced. The scripts run in parallel across the matrix as a shared device or virtual host is in transition.
Chapter 17: Configure Device Monitors 222 When a device monitor detects a failure, Matrix Server attempts to fail over the active virtual hosts associated with that monitor. By default, all virtual hosts on the servers used with the device monitor are dependent on the device monitor. However, you can specify that only certain virtual hosts be dependent on the device monitor.
Chapter 17: Configure Device Monitors 223 Probe Type. The servers on which the monitor probe will occur. Select Single-Probe to conduct the probe only on the server where the monitor is active. Select Multi-Probe to conduct the probe on all servers configured for the monitor. Activity Type. Where the monitor can be active. The options are: • Single-Active. The monitor is active on only one of the selected servers.
Chapter 17: Configure Device Monitors 224 Available Servers/Selected Servers. The type of the device monitor affects whether the monitor should be configured on one or multiple servers. • A GATEWAY monitor is multi-active and can be configured on multiple servers. • For SHARED_FILESYSTEM monitors, you should select the servers that mount the monitored filesystem and are running the applications that access data from that filesystem.
Chapter 17: Configure Device Monitors 225 Enable a Device Monitor From the Management Console, select the device monitor to be enabled, right-click, and select Enable. To enable a device monitor from the command line, use this command: mx device enable ... Clear Device Monitor Error Condition To clear a error from a device monitor, select that monitor, right-click, and select Clear Last Error.
18 Advanced Monitor Topics The topics described here provide technical details about Matrix Server operations. This information is not required to use Matrix Server in typical configurations; however, it may be useful if you want to design custom scripts and monitors, to integrate Matrix Server with custom applications, or to diagnose complex configuration problems. The Effect of Monitors on Failover Typically a virtual host has a primary network interface and one or more backup interfaces.
Chapter 18: Advanced Monitor Topics 227 The following examples show state transitions for a service monitor that uses the default values for autorecovery, priority, and serial script ordering. Start and Stop scripts are also defined for the monitor. The virtual host associated with the monitor has a primary interface and two backup interfaces. The first example shows the state transitions that occur at startup from an unknown state. At i1, all instances of the monitor have completed stopping.
Chapter 18: Advanced Monitor Topics 228 When a failure occurs on the Primary, the virtual host needs to fail over to a backup. Matrix Server now looks for the best location for the virtual host. Because the probe status on the first backup is “down,” Matrix Server chooses the second backup, where the probe status is “up.” At i5 in the following example, the probe fails on the Primary. At i6, the virtual host is deconfigured on the Primary. At i7, the monitor stop script begins on the Primary.
Chapter 18: Advanced Monitor Topics 229 Custom Device Monitors A custom device monitor is associated with a list of servers and a list of virtual hosts configured on those servers. A custom device monitor can be active on only one server at a time. On each server, the monitor uses a probe mechanism to determine whether the service is active. The probe mechanism is in one of the following states on each server: Up, Down, Unknown, Timeout. A custom device monitor also has an activity status on each server.
Chapter 18: Advanced Monitor Topics 230 Time Primary t1 active Vhost status inactive Service probe status unknown Service monitor activity active undefined star ting Device probe status unknown Device monitor activity active undefined star ting up inactive down inactive stopping up First Bac kup Vhost status inactive Service probe status unknown Service monitor activity undefined up inactive stopping Device probe status Device monitor activity Sec ond Bac kup Vhost status unknown
Chapter 18: Advanced Monitor Topics 231 Integrate Custom Applications There are many ways to integrate custom applications with Matrix Server: • Use service monitors or device monitors to monitor the application • Use a predefined monitor or your own user-defined monitor • Use Start, Stop, and Recovery scripts Following are some examples of these strategies.
Chapter 18: Advanced Monitor Topics 232 Built-In Monitor or User-Defined Monitor? To decide whether to use a built-in monitor or a user-defined monitor, first determine whether a built-in monitor is available for the service you want to monitor and then consider the degree of content verification that you need.
Chapter 18: Advanced Monitor Topics 233 This script connects to port 2468, sends a string specified by the protocol, and determines whether it has received an expected response. You distribute this script to the same location on all servers on virtual host vh1, and then create a custom service monitor that uses that script. This provides not only verification of the connection, but a degree of content verification.
Chapter 18: Advanced Monitor Topics 234 • MX_SERVER=IP address The primary address of the server that calls the script. The address is specified in dotted decimal format. • MX_TYPE=(SERVICE|DEVICE) Whether the script is for a service or device monitor. • MX_VHOST=IP address The IP address of the virtual host. The address is specified in dotted decimal format. (Applies only to service monitors.) • MX_PORT=Port or name The port or name of the service monitor. (Applies only to service monitors.
19 SAN Maintenance The following information and procedures apply to SANs used with PolyServe Matrix Server. Server Access to the SAN When a server is either added to the matrix or rebooted, Matrix Server needs to take some administrative actions to make the server a full member of the matrix with access to the shared filesystems on the SAN. During this time, the PolyServe Management Console reports the message “Joining matrix” for the server.
Chapter 19: SAN Maintenance 236 • Repeated I/O errors when the server tries to write to a PSFS journal. The server then loses access to the affected filesystem. When the disk experiencing the I/O errors is fixed, the server will automatically regain access to the filesystem. The PolyServe Management Console typically displays an alert message when a server loses access to the SAN. (See Appendix B for more information about these messages.
Chapter 19: SAN Maintenance 237 This can be done either by rebooting the servers after you make the partition table changes, or by manually disabling access to the disks before making the partition table changes and then reenabling access afterwards. If you should later need to repartition a disk containing a membership partition, you will need to stop Matrix Server before you change the layout. While the matrix is stopped, you will not be able to access other disks in the matrix.
Chapter 19: SAN Maintenance 238 mxsanlk This host: 10.10.30.3 This host’s SDMP administrator: 10.10.30.1 Membership Partition -------------------psd1p1 psd2p1 psd3p3 SANlock State ------------held by SDMP administrator held by SDMP administrator held by SDMP administrator Any of these messages can appear in the “SANlock State” column. • held by SDMP administrator The SANlock was most recently held by the SDMP administrator of the matrix to which the host where mxsanlk was run belongs.
Chapter 19: SAN Maintenance 239 • trying to lock, not yet committed by owner The SANlock is either not held or has not yet been committed by its holder. The host on which mxsanlk was run is trying to acquire the SANlock. • unlocked, trying to lock The SANlock does not appear to be held. The host on which mxsanlk was run is trying to acquire the SANlock. • unlocked The SANlock does not appear to be held. If a host holds the SANlock, it has not yet committed its hold.
Chapter 19: SAN Maintenance 240 • locked (lock is corrupt, will repair) The host on which mxsanlk was run holds the lock. The SANlock was corrupted but will be repaired. If a membership partition cannot be accessed, use the mx config mp set command or the mprepair utility to correct the problem. Depending on the status of the SDMP process, when you invoke mxsanlk you may see one of the following messages: Checking for SDMP activity, please wait... Still trying... The SDSMP is inactive at this host.
Chapter 19: SAN Maintenance 241 Online Operations When Matrix Server is running, the Add, Repair, and Replace options on the Storage Settings tab and the mx config mp set and repair commands can be used only in the following circumstances: • A disk containing a membership partition is out-of-service. Use the replace option or mx config mp set to move the partition to another disk. • You need to move one or more membership partitions to different storage.
Chapter 19: SAN Maintenance 242 Membership Partition States The Storage Settings tab reports the state of each membership partition. The possible states are: • OK. The membership partition is functioning correctly. • FENCED. The server has been fenced and cannot access the SAN. Start Matrix Server if it is not running or reboot the server. • NOT_FOUND. Matrix Server cannot find the device containing the membership partition. Check the device for hardware problems.
Chapter 19: SAN Maintenance 243 • RESILVER. The membership partition is not up-to-date. Matrix Server will resilver the membership partition automatically. You can resilver the partition manually if desired. • CORRUPT. The membership partition is not valid. Resilver the partition. • CID_MISMATCH. The Cluster-ID is out-of-sync among the membership partitions and must be reset. See “Reset the Cluster ID” on page 252.
Chapter 19: SAN Maintenance 244 When you select a partition and click Replace, you will see a confirmation message describing the replace operation. A message also appears when the replace operation is complete. NOTE: The Replace option on the Storage Settings tab is available only when Matrix Server is running. Add Membership Partitions When you initially configure the matrix, you can add either one or three membership partitions, as described in the PolyServe Matrix Server Installation Guide.
Chapter 19: SAN Maintenance 245 All of the available partitions on that disk or LUN then appear in the bottom of the window. Select one of these partitions and click Add. (The minimum size for a membership partition is 1 GB.) Repeat this procedure to select one more membership partition. We recommend that the partitions be on different disks. When selecting partitions for use as membership partitions, be sure that they do not contain any needed data.
Chapter 19: SAN Maintenance 246 The mx config mp Commands The mx config mp set and repair commands can be used while Matrix Server is either online or offline; however, only the operations listed under “Online Operations” on page 241 can be performed while Matrix Server is running. For other operations, Matrix Server must be offline on all nodes in the matrix.
Chapter 19: SAN Maintenance 247 --reuse Allow disks that contain existing volume information to be reused. (The existing data is destroyed.) Repair a Membership Partition This command resilvers the specified membership partition. mx config mp repair [--reuse] The --reuse option allows disks that contain existing volume information to be reused. (The existing data is destroyed.) This option is available only when the matrix is offline.
Chapter 19: SAN Maintenance 248 be in the Active state. The mprepair utility can be used to repair any problems if a failure causes servers to have inconsistent views of the membership partitions.
Chapter 19: SAN Maintenance 249 another SAN component. When the problem is repaired, the status should return to OK. CORRUPT. The partition is not valid. You will need to resilver the partition. This step copies the membership data from a valid membership partition to the corrupted partition. NOTE: The membership partition may have become corrupt because it was used by another application. Before resilvering, verify that it is okay to overwrite any existing data on the partition. RESILVER.
Chapter 19: SAN Maintenance 250 Export Configuration Changes When you change the membership partition configuration with mprepair, it updates the membership list on the local server. It also updates the lists on the disks containing the membership partitions specified in the local MP file. After making changes with mprepair, you will need to export the configuration to the other servers in the matrix.
Chapter 19: SAN Maintenance Recid 258: 20:00:00:04:cf:13:3c:92::0 psd2 Host registry entries: Host ID: 10.10.30.4 fencestatus=0 SAN Loc:10:00:00:00:c9:2d:27:7d::0 idstatus=0 Host ID: 10.10.30.3 fencestatus=0 SAN Loc:10:00:00:00:c9:2d:27:78::0 idstatus=0 251 (switch=fcswitch5) (switch=fcswitch5) Search the SAN for Membership Partitions.
Chapter 19: SAN Maintenance 252 The resilver operation synchronizes all other membership partitions and the local membership partition list. Repair a Membership Partition. This command resilvers the specified membership partition. mprepair --repair [--force] indicates the membership partition to be resilvered. is the UUID for the device and is the number of the partition on the device.
Chapter 19: SAN Maintenance 253 you can use the following command to determine whether all membership partitions have a valid Cluster-ID. mprepair --sync-clusterids The command displays the Cluster-IDs found in each membership partition and flags those partitions containing an invalid ID. You can then specify whether you want the command to repair the partitions having a mismatched Cluster-ID. mprepair --get_current_mps can also be used to obtain more information about the membership partitions.
Chapter 19: SAN Maintenance 254 8. Enable Matrix Server and the psd driver: mxservice -install psdcoinst -install 9. Reboot the server to return the psd driver to the driver stack. 10. When the system is rebooted, Matrix Server will still be disabled in the Windows Services Control Panel. Re-enable it for Automatic startup if desired. 11. Start Matrix Server (or wait until the next reboot). net start matrixserver Servers Change the Fencing Method To change the fencing method, complete these steps: 1.
Chapter 19: SAN Maintenance 255 example, because the server has crashed) and you cannot reboot the server. Run the command from a server that is communicating with the matrix, not from the non-responsive server. If none of the servers are responsive, try to execute the command from a client using the Microsoft psexec utility.
Chapter 19: SAN Maintenance 256 markdown command. Filesystem corruption can occur if the server is not actually down and can access the shared storage. • If the server is up but is physically disconnected from the shared storage when the mx server markdown command is run, the server must be rebooted before it is reconnected to shared storage. Failing to reboot the server before connecting it to the storage can cause filesystem corruption.
Chapter 19: SAN Maintenance 257 Online Insertion of New Storage Matrix Server supports online insertion (OLI) of new storage, provided that OLI support is present for your combination of storage device, SAN fabric, HBA vendor-supplied device driver, and the associated HBA vendor-supplied libhbaapi. (Check with your vendors to determine whether OLI is supported.) NOTE: OLI of new storage can cause an interruption of normal operations on your storage device.
Chapter 19: SAN Maintenance 258 If these conditions are not met, you will not be able to perform online replacement of the switch. Instead, you will need to stop the matrix, replace the switch, and use mxconfig to reconfigure the new switch into the matrix. Consult your switch documentation for the appropriate replacement procedure, keeping in mind that the above requirements must be met. However, if this documentation is not available, the following procedures describe a method to replace a switch.
Chapter 19: SAN Maintenance 259 11. Save the clean configuration with the cfgSave command. 12. Configure the new switch. If you saved the original configuration with the configUpload command, use the configDownload command to restore it. Otherwise, use the configure command. (You may need to consult your site’s SAN administrator or your Brocade representative for the correct configuration information.) 13. Connect the FC connectors to the new switch.
Chapter 19: SAN Maintenance 260 show ip ethernet for the IP address. show switch for the fabric operating mode. show zoning for the zone configuration. 3. After the original switch has been powered down, power up the new switch and set the IP address to the old switchʹs address to allow EWS access. The IP address can be set either from the serial port or by connecting to the current, possibly default, IP address. Verify that the new switch responds to the IP address. 4.
20 Other Matrix Maintenance This chapter describes how to perform the following activities: • Collect Matrix Server log files with mxcollect • Check the server configuration • Disable a server for maintenance • Troubleshoot a matrix • Troubleshoot service and device monitors Collect Log Files with mxcollect The mxcollect utility collects error event logs that can be useful for diagnosing technical issues with Matrix Server.
Chapter 20: Other Matrix Maintenance 262 mxcollect_machinename_yyyymmdd_hhmmss_default.zip. This file is placed in the folder %SystemDrive%\Program Files\PolyServe\MatrixServer\conf\mxcollect. Upload mxcollect Files to HP Support After running mxcollect, you can upload the resulting files to HP Support. Contact HP Support for more information. Check the Server Configuration The Matrix Server mxcheck utility can be used to verify that a server meets the configuration requirements for Matrix Server.
Chapter 20: Other Matrix Maintenance 263 2. If you want the virtual host to remain on the backup network interface after the original server is returned to operation but the virtual host is using AUTOFAILBACK as its failback policy, make that network interface the primary network interface. (Choose the virtual host from the Virtual Hosts window, right-click, and select Properties.) 3. Perform the necessary maintenance on the original server and then reenable it.
Chapter 20: Other Matrix Maintenance 264 2. Verify that the network devices and interfaces are properly configured on the server. 3. Ensure that the ClusterPulse process and the service monitor agent (monitor_agent) are running on the server. A Virtual Host Is Inaccessible If a site is inaccessible but Matrix Server indicates that it is okay, verify that the service is running and that the actual data exists on the server providing the network interface currently used by the virtual host.
Chapter 20: Other Matrix Maintenance 265 Matrix Server for any service or device monitor on any server in the matrix. The error or event message provides more status information. “Down” Status The “Down” status indicates that the monitor finished its probe but it did not complete successfully. Depending on the monitor type (such as HTTP or SMTP), the service monitor probe may involve more than being able to connect to the network service.
Chapter 20: Other Matrix Maintenance 266 The status of the monitor may be “Up” even though an event has been reported. This is the case if the error was not serious enough to stop the execution of the script. The events are: CONFIG_ERROR. A script must exist and be executable by root. This condition is checked for probe, Start, Stop, and Recovery scripts each time an attempt is made to execute the script. SCRIPT_SYSERR.
Chapter 20: Other Matrix Maintenance 267 From the command line, use these commands to check the status of monitors: mx service status mx device status Clear an Error After you have determined the cause for a script event, be sure to correct the script on all servers that reported the event. You should then clear the error. On the Management Console, select the monitor, right-click, and select Clear Last Error.
Chapter 20: Other Matrix Maintenance 268 The activity status is not an error condition; it represents the activity of scripts associated with the monitor. However, if the activity status continues to have a value other than Active or Inactive, there may be a script problem that requires attention. Active status indicates that the probe script will be executed at the probe frequency. Inactive status means that the monitor is not the only one currently providing the service.
A Management Console Icons The Management Console uses the following icons. Matrix Server Entities The following icons represent the Matrix Server entities. If an entity is disabled, the color of the icon becomes less intense. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Appendix A: Management Console Icons 270 Additional icons are added to the entity icon to indicate the status of the entity. The following example shows the status icons for the server entity. The status icons are the same for all entities and have the following meanings. Monitor Probe Status The following icons indicate the status of service monitor and device monitor probes. If the monitor is disabled, the color of the icons is less intense. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Appendix A: Management Console Icons 271 On the Applications tab, virtual hosts and single-active monitors use the following icons to indicate the primary and backups. Multi-active monitors use the same icons but do not include the primary or backup indication. Management Console Alerts The Management Console uses the following icons to indicate the severity of the messages that appear in the Alert window. Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
Index A accounts assign to role 141 administrative network allow, discourage or exclude traffic 58 defined 9 failover 57 network topology 56 requirements for 55 select 56 alerts Alerts pane on Management Console 35 display error on Management Console 35 display on Management Console 35 icons on Management Console 271 Applications tab drag and drop operations 172 filter display, filter, on Applications tab 171 icons 169 manage monitors 176 manage resources 172 menu operations 175 modify display 168 rehost vi
Index 273 failover 185 configuration back up 38 device monitor 213 network interface 55 PSFS filesystems 93 SAN disks 62 server 45 service monitor 196 system design guidelines 14 virtual host 180 configurations, supported 15 Connect window authentication parameters 26 bookmarks 26 Clear History button 25 Connect button 25 custom monitors device 211 environment variables for scripts 233 service 195 D device database defined 12 membership partitions 63 device monitor activeness policy 211 activity status 2
Index 274 event log audit trail 148 Events Viewer 152 Windows Event Viewer 155 Event Notification Control Panel 156 event notifier services add events 157 configure 156 custom notifier scripts 164 email notifier service 159 enable or disable 163 import or export event settings 164 remove events 157 restore event settings to defaults 163 script notifier service 161 SNMP notifier service 158 Event Viewer 152 events add to event notifier service 157 alert messages 35 device monitor event severity behavior 22
Index 275 grpcommd process 10 H Host Bus Adapter (HBA) change 253 host registry, clear 252 HP NAS services website 2 storage website 1 technical support 1 HTTP service monitor 193 HTTPS service monitor 193 I Installed Software viewer 36 iSCSI configuration 17 L options on Storage Settings tab 241 repair 243 replace 243 resilver 243, 251 memory, server 14 Microsoft SNMP service, install 151 Microsoft SNMP service, install and configure 151 mount path, filesystem assignment 110 mprepair utility 247 mx s
Index 276 O assign rights manually 140 assign rights with a template 140 delete 147 enable or disable 146 export or import 145 modify 146 rename 146 view from command line 147 view rights 144 OLI, storage 257 online repair 241 P PanPulse process administrative network 56 defined 10 partitions on SAN disks requirement for importing 65 ports, network external 40 internal 40 primary server 13 probe severity, failover 190 psd driver 10 PSFS filesystem.
Index 277 server configuration delete 46 disable 47 DNS load balancing 52 enable 47 modify properties 45 server registry 94 service monitor activity status 267 applications, integrate with 232 custom starting/stopping actions 203 defined 13 troubleshooting 264 service monitor configuration add or update 196 advanced settings probe severity 198 scripts 201 delete 205 disable 205 enable 206 service monitor types custom 195 FTP 193 HTTP 193 HTTPS 193 NTSERVICE 193 SMTP 194 TCP 195 shared disks import 65 SHAR
Index 278 guidelines 179 policy for failback 181 rehost via Applications tab 184 virtual host configuration add or update 180 delete 184 volume database 12 volumes dynamic volume recovery 88 import 89 importable 90 unimportable 90 unimported 90 volumes, basic or dynamic 75 Copyright © 1999-2007 PolyServe, Inc. All rights reserved.
