command reference hp surestore nas 8000 command reference Edition March 2002 Printed in U.S.A.
Notice Trademark Information © Hewlett-Packard Company, 2002. All rights reserved. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.
contents 1 Overview 3 Using the Command Line Interface 4 Command Syntax 5 Scripting 6 2 Command Reference7 Network Card Settings 7 Network Card Bonding 10 Network Settings 13 Domain Name Service (DNS) Settings 13 Network Host Settings 13 Network NIS Settings 14 Network SNMP Settings 15 Network Client Settings 17 Misc.
High Availability Cluster Settings 66 Cluster Package Commands 70 Cluster Operation 74 Disaster Recovery 79 Boot Partition Settings 80 3 2 Index i
Overview 1 While most of the HP NAS 8000 administrative tasks can be accomplished with the Command View NAS web interface, the HP NAS 8000 also includes a command line interface that allows you to manually enter commands or to run batch commands and scripts using either a serial connection or telnet.
Using the Command Line Interface To access the NAS 8000 command line interface, you must first log in to the NAS server using a serial connection or telnet. First, connect to the system. To connect using a serial connection, use a terminal emulator with the following settings: ■ Bits per second: 9600 ■ Data bits: 8 ■ Parity: None ■ Stop bits: 1 ■ Flow control: None To connect using telnet, enter the following command on a remote computer: ■ telnet xxx.xxx.xxx.xxx where xxx.xxx.xxx.
Command Syntax To execute text commands, execute the commands at the command prompt as shown in the following sections, where: ■ % represents the system prompt and is not part of the command to be entered. ■ Input parameters (inParam[#]) are entered at the end of the command and are separated by spaces. ■ Output parameters (outParam[#]) are displayed on screen or returned to the command script.
Scripting The HP NAS 8000 text command interface is based on Tcl 8.0 (http://www.scriptics.cXom/software/tcltk/8.0.html), which allows for powerful scripting commands such as the following example. Table 2 Example Command Script % for each i [getNetworkCardList] { % puts “Network Card Info: $i” % puts “ip address = [getNetworkCardIpAddress $i]” % puts “subnet mask = [getNetworkCardSubnetMask $i]” %} Network Card Info: bond0 ip address = 0.0.0.0 subnet mask = 0.0.0.
Command Reference 2 Network Card Settings The HP NAS 8000 has one Network Interface Card (NIC) port on the motherboard and supports two additional slots for NICs. These cards can be either dual-port 10/100 cards or single-port gigabit cards. This support gives the system up to five NIC ports (one on the motherboard and the capacity for a maximum of two dual-port 10/100 NICs). When you initially set up your HP NAS 8000, you need to configure the primary NIC.
getNetworkCardDhcpEnabled Identifies whether the specified NIC is DHCP enabled. When DHCP is enabled, NIC configuration occurs automatically. Depending on your configuration, the DHCP server provides any or all of the following parameters: IP Address, Subnet Mask, Gateway Address, Broadcast Address. ■ inParam[0] = Network card name ■ outParam[0] = T (Enabled) or F (Disabled) setNetworkCardDhcpEnabled Enables or disables DHCP for the specified NIC.
setNetworkCardIpAddress Sets the IP address for the specified NIC. The IP address and subnet mask for the primary NIC must be defined before you can access the HP Command View NAS web interface from a client system. ■ inParam[0] = Network card name ■ inParam[1] = IP address getNetworkCardMacAddress Returns the MAC address for the specified NIC. ■ inParam[0] = Network card name ■ outParam[0] = MAC address getNetworkCardMtu Returns the Maximum Transmissible Unit (MTU) for the specified gigabit NIC.
getNetworkCardSubnetMask Returns the subnet mask for the selected NIC. ■ inParam[0] = Network card name ■ outParam[0] = Subnet mask setNetworkCardSubnetMask Sets the subnet mask for the selected NIC. ■ inParam[0] = Network card name ■ inParam[1] = Subnet mask getNetworkCardTransmitBytes Returns the number of bytes transmitted by the specified NIC since any NIC configuration changes were made.
getNetworkCardBondSlaveEnabled Identifies whether the specified NIC is a bond slave. ■ inParam[0] = Network card name ■ outParam[0] = T (Enabled) or F (Disabled) bondEnslaveNetworkCard Sets the specified NIC to be a bond slave of the specified master NIC. ■ inParam[0] = Network card name ■ inParam[1] = Bond master card handle bondReleaseNetworkCard Releases the specified NIC from bonds.
setNetworkCardBondDownDelay Sets the time (in milliseconds) for the specified NIC to delay after bondRelease before taking the bond link down. ■ inParam[0] = Network card name ■ inParam[1] = Bond down delay getNetworkCardBondMasterInterfaceName Returns the interface name assigned to the specified bond master NIC.
Network Settings Domain Name Service (DNS) Settings Domain Name Servers convert system names that people can remember (such as nas8000.fc.hp.com) to IP addresses (such as 123.45.67.89) that are used by packet-routing software. The following commands can be used to enter and edit DNS information. getNetworkDnsDomainName Returns the DNS domain name. ■ outParam[0] = DNS domain name setNetworkDnsDomainName Sets the DNS domain name. The HP NAS 8000 can belong to only one domain.
Network NIS Settings The HP NAS 8000 supports Network Information System (NIS). NIS maintains a central database of names and locations of resources on a network. NIS was formerly known as Yellow Pages. To enable or disable NIS, use the following commands. getNetworkNisDomainName Returns the NIS domain name. ■ outParam[0] = NIS domain name setNetworkNisDomainName Sets the NIS domain name for the HP NAS 8000.
Network SNMP Settings If you are using a Simple Network Management Protocol (SNMP) tool, you can define the names or IP addresses of hosts to receive notification in case of an event. This information is optional and does not affect the functionality of the device. In the event of a hardware failure or system alert, messages are sent via SNMP traps, email (SMTP), and logged in the system log.
getNetworkSnmpTrapDestDomain Returns the Domain for this Trap Destination (currently only “UDP” is supported). ■ inParam[0] = Destination number ■ outParam[0] = Value setNetworkSnmpTrapDestDomain Sets the Domain for this Trap Destination (currently only “UDP” is supported). ■ inParam[0] = Destination number ■ inParam[1] = Value getNetworkSnmpTrapDestAddress Returns the address for this Trap Destination.
getNetworkSnmpTrapDestList Returns the complete list of Trap Destination Addresses. ■ outParam[0:N] = List of trap destination hostnames or IP addresses setNetworkSnmpTrapDestList Sets the complete list of Trap Destination Addresses. Deletes all current Trap Destinations, and creates new ones based on this list of addresses. (Status is set to “active”; all other parameters are not created, and will return defaults).
getNetworkClientInfoPath Returns the path used by the specified client (that is, what part of the storage are they using). ■ inParam[0] = Network client ID ■ outParam[0] = Path used by client (if applicable) getNetworkClientInfoVolume Returns the name of the file volume being used by the specified client. ■ inParam[0] = Network client ID ■ outParam[0] = Volume used by client (if applicable) getNetworkClientInfoVolumeDir Returns the name of the sub-directory being used by the specified client.
Storage Settings Storage settings allow you to control Direct Access Storage Devices (DASDs) connected to the HP NAS 8000 solution. DASDs include disk drives and storage arrays. getStorageDasdList Returns a list of Direct Access Storage Devices attached to the HP NAS 8000 system. ■ outParam[0:N] = DASD name list getStorageDasdType Returns the DASD type of the specified device.
getStorageDasdDeviceFile Returns the name of the device file used to access the specified DASD. ■ inParam[0] = DASD name ■ outParam[0] = DASD device file getStorageDasdScsiList Returns a list of the storage devices attached to or allocated for use with the NAS 8000. ■ outParam[0:N] = SCSI DASD name getStorageDasdScsiGenericDeviceFile Returns the absolute path to the SCSI generic device file for a DASD.
getStorageDasdScsiVA7xxxList Returns a list of disk arrays attached to the system. ■ outParam[0:N] = SCSI DASD Va7xxx name list getStorageDasdScsiVa7xxxManagementSoftwareRunning Informs whether Array Management Software is running. ■ outParam[0] = T (running) or F (not running) getStorageDasdScsiVa7xxxAlias Returns the alias for the specified storage array. ■ inParam[0] = SCSI VA7xxx DASD name ■ outParam[0] = Alias setStorageDasdScsiVa7xxxAlias Sets the alias for the specified storage array.
getStorageDasdScsiVa7xxxCapacities Returns the capacity and other configurations of the specified storage array.
getStorageDasdScsiVa7xxxAllocatedCapacity Returns the allocated capacity – that is, space included in volume groups – for the specified storage array. ■ inParam[0] = SCSI VA7xxx DASD name ■ inParam[1] = Units (B,MB,GB) ■ outParam[0] = Device capacity (MB - unless overridden by inParam[1]) getStorageDasdScsiVa7xxxActiveSpareCapacity Returns the capacity of the active spare on the specified storage array.
shutdownStorageDasdScsiVa7xxx Shuts down the specified storage array. ■ inParam[0] = SCSI VA7xxx DASD name restartStorageDasdScsiVa7xxx Restarts the specified storage array. ■ inParam[0] = SCSI VA7xxx DASD name getStorageDasdScsiVa7xxxLunList Returns a list of LUNs on the specified storage array. ■ inParam[0] = SCSI VA7xxx DASD name ■ outParam[0:N] = LUN number list getStorageDasdScsiVa7xxxLunMinimumCapacity Returns the minimum size that can be used to create a LUN.
removeStorageDasdScsiVa7xxxLun Deletes the specified LUN from the specified storage array. All data will be lost. ■ inParam[0] = SCSI VA7xxx DASD name ■ inParam[1] = LUN number getStorageDasdScsiVa7xxxLunCapacity Returns the capacity of the specified LUN on the specified storage array.
getStorageDasdScsiPerDriveLunList Returns a list of LUNs available on the specified array or device. ■ inParam[0] = SCSI DASD name ■ outParam[0:N] = SCSI DASD LUN list getStorageDasdScsiLunList Returns a list of LUNs that are being used in volume groups. ■ outParam[0:N] = SCSI LUN name list getStorageDasdScsiInternalLunList Returns a list of SCSI DASD LUNs that are on internally-mounted DASDs. Internal DASD LUNs are used for system functions. They are never used to store user data.
getStorageDasdScsiLunRedundancygroup Returns the redundancy group number that this DASD LUN is on. This command should only be used on LUNs that are on an HP VA7xxx storage array. ■ inParam[0] = SCSI LUN name ■ outParam[0] = Redundancy group number getStorageDasdScsiLunNumber Returns the number of the specified LUN. ■ inParam[0] = SCSI LUN name ■ outParam[0] = LUN number getStorageDasdScsiLunCapacity Returns the capacity of the specified LUN.
Volume Group Settings A volume group is the aggregation of one or more LUNs. Volume groups combine the space from LUNs and make the space accessible to the file system for creating file volumes and directories, which can then be made accessible to users. The following text commands are used to create and manage volume groups. getStorageVolumegroupSystemList Returns a list of existing system-data volume group names.
addStorageVolumegroupLuns Adds the specified LUNs to an existing volume group. ■ inParam[0] = Volume group name ■ inParam[1:N] = LUN names deleteStorageVolumegroup Deletes the specified volume group. All data will be lost. ■ inParam[0] = Volume group name deleteStorageVolumegroupLuns Removes the specified LUNs from an existing volume group. All data will be lost. ■ inParam[0] = Volume group name ■ inParam[1:N] = LUN names setStorageVolumegroupName Renames an existing volume group.
getStorageVolumegroupVolumeMaximumCapacity Returns the maximum size that can be used to create a file volume or snapshot on the specified volume group. ■ inParam[0] = Volume group name ■ inParam[1] = Units (B,MB,GB) ■ outParam[0] = Maximum Volume Capacity (MB - unless overridden by inParam[1]) getStorageVolumegroupVolumeCapacityIncrement Returns the size increment that can be used to create a file volume or snapshot on the specified volume group. Currently 32MB.
deleteStorageVolume Deletes the specified file volume. All data will be lost. ■ inParam[0] = Volume name setStorageVolumeName Renames an existing file volume. ■ inParam[0] = Existing Volume name ■ inParam[1] = New Volume name getStorageVolumeExists Identifies whether or not the specified file volume exists. Answers: Is there a volume with name? ■ InParam[0] = Volume name ■ outParam[0] = T (true) or F (false) getStorageVolumeNumber Returns the number of the specified file volume.
getStorageVolumeMountPath Returns the mount path, if any, that is defined for UNIX® sharing of the specified file volume. ■ inParam[0] = Volume name ■ outParam[0] = Volume mount path getStorageVolumeDeviceFile Returns the name of the device file that is used to access the specified file volume. ■ inParam[0] = Volume name ■ outParam[0] = Volume device file getStorageVolumeRootPath Returns the path to the location where user data is stored on the specified file volume.
getStorageVolumeFileUserList Returns a list of existing user-data file volume names. ■ outParam[0:N] = Volume name list getStorageVolumeFileType Returns the file volume type. ■ inParam[0] = File volume name ■ outParam[0] = File volume type Where type can be one of: ■ Unknown ■ System ■ User addStorageVolumeFile Creates a new file volume in the specified volume group.
Snapshot Settings A snapshot is a read-only picture of a file volume at a specific point in time. When you create a file volume, the snapshot of that file volume is of zero length. However, as you modify the file volume, the snapshot tracks changes between the original file volume and the modified file volume. If an error occurs and you want to revert to the previous version, you can use the snapshot data and the unmodified parts of the original file volume to quickly and easily construct the file volume.
getStorageVolumeSnapshotVolumeFile Returns the name of the file volume associated with the specified snapshot. ■ inParam[0] = Snapshot name ■ outParam[0] = Volume name getStorageVolumeSnapshotExpiration Returns the expiration date and time for the specified snapshot.
Storage Quota Settings Quotas are set on a per file volume basis. You can have a quota larger than the available space on the file volume. The following commands are used to manage storage quotas. For information on setting quotas, see User and Group Quota Settings on page User and Group Quota Settings. getStorageQuotaEnabled Identifies whether quotas are enabled for the specified file volume.
Share Settings Before network users can access the NAS server, you must give them permission. This is a security concern. Each platform grants permission differently: ■ Windows: Windows Shares are permissions that let you control Microsoft Windows users' access to data. You can create shares for any directory within a file volume, including the root. Once a share is created, users may attach to the share via the Network Neighborhood in Windows and store and retrieve files and directories.
removeStorageShare Removes the specified share/export from the specified file volume. ■ inParam[0] = Volume name ■ inParam[1] = Share path OR (see getStorageShareList). getStorageShareList This facilitates webFilter usage. ■ inParam[0] = Volume name:_*_:Share path getStorageSharePath Returns the path to the specified share/export. ■ inParam[0] = Volume name ■ inParam[1] = Share path ■ outParam[0:N] = Host allow list for this share OR (see getStorageShareList).
SMB Settings SMB/CIFS, the Windows protocol for sharing files, lets client applications read and write to files. CIFS is a proposed standard protocol that lets programs request files and services on remote computers on the internet. CIFS uses the client/server programming model. A client program makes a request of a server program (usually running on another computer) for access to a file or to pass a message to a program that runs on the server computer.
getStorageShareSmbComment Returns the Windows SMB comment associated with the specified share. ■ inParam[0] = Volume name ■ inParam[1] = Share path ■ outParam[0] = Comment OR (see getStorageShareList). getStorageShareList This facilitates webFilter usage. ■ inParam[0] = Volume name:_*_:Share path ■ outParam[0] = Comment setStorageShareSmbComment Sets the Windows SMB comment associated with the specified share.
getStorageShareSmbRoPassword Returns the Windows SMB read-only password for the specified share. ■ inParam[0] = Volume name ■ inParam[1] = Share path ■ outParam[0] = Read-only password OR (see getStorageShareList). getStorageShareList This facilitates webFilter usage. ■ inParam[0] = Volume name:_*_:Share path ■ outParam[0] = Read-only Password setStorageShareSmbRoPassword Sets the Windows SMB read-only password for the specified share.
getNetworkSmbSecurityMode There are two Windows NT security modes: Share-Level Security: The HP NAS 8000 handles its own security. Shares may be passwordprotected and may limit your access (read-only and/or read/ write) to data. You may define a password when you create the share. User-Level Security: A domain controller is used to authenticate users when they access the HP NAS 8000. This requires specifying the domain name. Returns the current SMB security mode.
getNetworkSmbDomainStatus This call is only applicable when in user (domain) SMB security mode. The result is true only if the NAS 8000 is still a valid member of the domain. Technically this makes sure the shared secret between the NAS 8000 and domain controller is valid. ■ outParam[0] = T or F NFS Settings Network File System (NFS) settings are optional.
getStorageShareNfsName Returns the UNIX NFS share name for the specified share. ■ inParam[0] = Volume name ■ inParam[1] = Share path ■ outParam[0] = NFS name OR (see getStorageShareList). getStorageShareList This facilitates webFilter usage. ■ inParam[0] = Volume name:_*_:Share path ■ outParam[0] = NFS name getStorageShareNfsReadOnly Informs whether the specified share is set for UNIX NFS read-only or read/ write access.
getNetworkNfsMaxConnections Returns the maximum allowed number of simultaneous Network File System Daemons (NFSD) processes. Maximum allowed value is 128. ■ outParam[0] = Maximum simultaneous NFS connections allowed setNetworkNfsMaxConnections Sets the maximum number of simultaneous Network File System Daemons (NFSD) processes. This controls the number of simultaneous NFS requests processed. The more NFSD processes you have, the more resources are used.
Admin Settings The NAS server can be password protected. This prevents unauthorized access to the Command View NAS web interface. The NAS server ships without password protection, and the password must be set using the text or web interface. Additional admin settings are described in this section. importSystemPasswdFile Imports the specified file of system passwords. ■ inParam[0] = Path name importSystemGroupFile Imports the specified file of system groups.
setSystemAdminPassword Sets the system admin password. ■ inParam[0] = Admin password Local Admin Settings These informational settings allow you to specify contact information and information about the physical location of your NAS 8000 solution. getSystemLocalAdminAssetNumber Returns the asset number assigned to the HP NAS 8000. ■ outParam[0] = Asset number setSystemLocalAdminAssetNumber Defines the asset number assigned to the HP NAS 8000.
getSystemLocalAdminContactPager Returns the pager number of the primary IT contact responsible for the HP NAS 8000. ■ outParam[0] = Contact pager setSystemLocalAdminContactPager Defines the pager number of the primary IT contact responsible for the HP NAS 8000. ■ inParam[0] = Contact pager getSystemLocalAdminLocation Returns a description of the physical location of the HP NAS 8000 system.
System Settings The commands in this section are used to defined general system descriptions and settings for the NAS 8000. System Description getSystemOid Returns the OID for the NAS device (.1.3.6.1.4.1.11.10.2.1.9.1) ■ outParam[0] = .1.3.6.1.4.1.11.10.2.1.9.1 getSystemGlobalUniqueId Returns the Global Unique ID for this device (a string of characters that uniquely identifies this unit) ■ outParam[0] = Global unique ID - per SEMI 1.
clearSystemEvent Clears a System Event. The Master Event Daemon (hpMed) will then handle things properly, sending e-mail as well as the SNMP traps to the various targets. getSystemEventNum Get the event number for a given event name. ■ inParam[0] = Event name ■ outParam[0] = Event number getSystemEventName Get the name of a given event number. ■ inParam[0] = Event number ■ outParam[0] = Event name CPU settings getSystemCpuList Returns a list of the CPUs installed in the NAS server.
Time and Date Settings The HP NAS 8000 uses the information on this screen to keep track of the date and time for operations such as time stamps for file generation and modification. Failure to set the proper date and time may lead to confusing behavior or misleading time stamping of files and log messages. getSystemTimestamp Returns the system timestamp. ■ inParam[0] = Optional format string ■ outParam[0] = Date & Time according to format Common formats follow. Default format is “%m/%d/%Y %T”.
setSystemDate Sets the system date. ■ inParam[0] = Date [MM/DD/YYYY] or “NOW” getSystemTime Displays the current system time. ■ inParam[0] = optional format string ■ outParam[0] = Time according to format (default is “%T”) Common formats follow. Default format is “%m/%d/%Y %T”.
getSystemTimezoneCurrentCountry Displays the current time zone country. ■ inParam[0] = Time zone name ■ outParam[0] = Time zone country getSystemTimezoneList Displays the available time zone names. ■ outParam[0:N] = Time zone names getSystemTimezoneCurrentName Displays the current system time zone. ■ inParam[0] = Time zone name getSystemTimezoneCurrentGmt Displays the offset from GMT for the current system time zone.
Email Settings The HP NAS 8000 lets you automatically notify individuals via email if there is a hardware failure or a critical system alert. Note Email settings are optional. In the event of a hardware failure or system alert, messages are sent through the network management tool or they are logged in the system log. getSystemEmailRecipientAddressList Returns a list of the email addresses for the recipients of any system alert messages that may be sent.
getSystemUIDEmailAddress Returns the email address for the user with the specified ID. ■ inParam[0] = UID ■ outParam[0] = Email address setSystemNameEmailAddress Sets the email address for the specified user. ■ inParam[0] = User name ■ inParam[1] = Email address setSystemUidEmailAddress Sets the email address for the user with the specified ID. ■ inParam[0] = UID ■ inParam[1] = Email address Log Settings You can redirect a copy of the system log to a server you choose.
getSystemLogEntrySeverity Returns the severity level associated with the specified log entry. ■ inParam[0] = Log entry handle ■ outParam[0] = Log entry severity Values: ■ E = Error ■ W = Warn ■ I = Info ■ U = Unknown getSystemLogEntryTimestamp Returns the time that the event triggering the specified log entry occurred. ■ inParam[0] = Log entry handle ■ inParam[1] = Optional format string ■ outParam[0] = Log entry date/time Default format is “%m/%d/%Y %T”.
getSystemSyslogServerName Returns the name of the remote syslog server. ■ outParam[0] = Syslog server name setSystemSyslogServerName Defines the remote server to which system log entries will be sent. ■ inParam[0] = Syslog server name UPS Settings If you connected the optional APC Symmetra UPS to your HP NAS 8000 during installation, the NAS server attempts to communicate with the UPS through a serial connection. The APC UPS has only one serial port. The NAS server, however, has two ports.
getSystemUpsTitle Returns the system title of the specified UPS. ■ inParam[0] = Name of UPS ■ outParam[0] = Title of UPS General System Settings These commands are used to review general system information and to reboot or shut down the NAS server. getSystemManufacturer Returns the system manufacturer name (Hewlett-Packard). ■ outParam[0] = Manufacturer getSystemOsBuildNumber Returns the build number of the operating system in the active boot partition.
getSystemShortProductName Returns the short version of the product name. ■ outParam[0] = Short product name getSystemUptime Returns the amount of time the system has been functioning since the last power up. ■ outParam[0] = System uptime doSystemReboot Reboots the NAS server. doSystemShutdown Shuts down the NAS server.
Software Module Settings You can enable/disable the following software modules for use with the HP NAS 8000: ■ Data snapshots ■ Virus protection ■ Tape backup Before use, software modules must be installed, authorized and enabled. The following commands install, uninstall, enable and disable these software modules. getSystemPackageAuthorized Determines whether the specified add-on software modules is installed and unlocked on the NAS server.
getSystemPackageVersion Returns the version of the specified add-on software module. ■ inParam[0] = Package name ■ outParam[0] = Package version getSystemPackageWebpage Returns the URL for accessing the web page with information about the specified add-on software module. ■ inParam[0] = Package name ■ outParam[0] = Package Web page setSystemPackageWebpage Sets the URL for accessing the web page with information about the specified add-on software module.
User and Group Settings The following commands allow you to map users of the Server Message Block Protocol/ Common Internet File System protocol (SMB/CIFS - Windows) to users of the Network File System protocol (NFS - UNIX). The HP NAS 8000 maintains a mapping of users between the two protocols. If a Windows user is not mapped to an existing UNIX user ID, a new UNIX user ID is generated and the Windows user is mapped to it when the Windows user accesses the HP NAS 830 for the first time.
getSystemWindowsUserNamesFromDomainList Returns a list of users’ Windows IDs for users on the specified Windows domain. ■ inParam[0] = Domain ■ outParam[0:N] = Windows user getSystemWindowsGroupNamesFromDomainList Returns a list of mapped users, with both Windows and UNIX user IDs listed, for the specified Windows domain.
User and Group Quota Settings Quotas allow you to restrict the space usage on the HP NAS 8000 for both users and groups. You also can enable default quotas for users and/or groups. The default quota applies to all users or groups who do not have a specific quota assigned to them. A user or group goes beyond their defined space usage cannot write additional data to the system. Each user can have one quota on a file volume. Quotas are set on a per file volume basis.
setSystemUserQuota Sets the quota settings for the specified user on the specified file volume. ■ inParam[0] = User name ■ inParam[1] = Volume name ■ inParam[2] = Soft limit ■ inParam[3] = Hard limit getSystemUserQuotaList Returns a list of user quotas for the specified file volume. ■ inParam[0] = Volume name ■ outParam[0:N] = Quota getSystemGroupQuotaList Returns a list of group quotas for the specified file volume.
High Availability Cluster Settings The following commands let you create and control a high-availability cluster. setSystemHostsFileEntry Adds an entry to the system hosts file list. ■ inParam[0] = Host name ■ inParam[1] = IP address ■ inParam[2] = Domain name deleteSystemHostsFileEntry Removes the designated entry from the system hosts file list. ■ inParam[0] = Host name applyClusterConfiguration Creates a cluster using either default values or values set by other setCluster* commands.
stopClusterNode Takes a node out of the cluster and transfers all it’s running packages to an alternate node. ■ InParam[0] = Node name getClusterName Gets the name of the cluster stored in the registry. ■ OutParam[0] = Cluster name setClusterName Stores the name in the registry. Does not take effect until applyClusterConfiguration is called. ■ InParam[0] = Cluster name getClusterStatus Gets status information about the cluster, nodes, and packages.
getClusterHeartbeatNetworkCardList Gets the list of network card interfaces used for heartbeats as they are stored in the registry. ■ OutParam[0:N] = Network card interface list setClusterHeartbeatNetworkCardList Stores the list in the registry. Is required before calling applyClusterConfiguration. applyClusterConfiguration ■ InParam[0:N] = List of heartbeat network cards For example: ■ setClusterHeartbeatNetworkCardList eth0 eth1 getClusterQsPollingInterval Gets the interval from the registry.
setClusterAutoStartTimeout Stores the timeout in the registry. (How long to wait, in seconds, before timeout occurs.) ■ InParam[0] = Interval, in seconds getClusterNetworkPollingInterval Gets the timeout from the registry. ■ OutParam[0] = Time period, in seconds, before polling occurs setClusterNetworkPollingInterval Stores the timeout in the registry: how long to wait, in seconds, before polling.
Cluster Package Commands The following commands let you configure and control failover packages. addClusterPackage Creates a default package configuration and a placeholder in the registry. This must be called before other calls to setClusterPackageXYZ text commands. The package is defined in the registry, with some default values, but not defined in the cluster.
failbackClusterPackag Stops the package on the current node and starts it up on the Primary owning node. ■ InParam[0] = Package name setClusterPackageEnabled Enables or disables the package from running on the given node. If a package is disabled from running on an alternate node, then it cannot failover to that node.
setClusterPackageVirtualIpAddressList Required. Sets the given VirtualIpAddress/Subnet list for the given package. ■ InParam[0] = Package name ■ InParam[1:N] = VirtualIpAddress/Subnet entries For example: ■ setClusterPackageVirtualIpAddressList pkg1 192.168.100.21/192.168.100.0 getClusterPackageVolumegroupList Gets from the registry, the list of volume groups managed by this package. ■ InParam[0] = Package name ■ OutParam[0:N] = Volume group list setClusterPackageVolumegroupList Required.
getClusterPackageAutoRun Gets from the registry, value of AutoRun for this package. ■ InParam[0] = Package name ■ OutParam[0] = T or F setClusterPackageAutoRun Sets in the registry, the AutoRun value for the given package. The default is T. ■ InParam[0] = Package name ■ InParam[1] = T or F getClusterPackageNodeFailFastEnabled Gets from the registry, value of NodeFailFastEnabled for this package.
setClusterPackageServiceHaltTimeout Sets in the registry, the ServiceHaltTimeout value for the given package. The default is 30 seconds. ■ InParam[0] = Package name ■ InParam[1] = Time, in seconds Cluster Operation The following text commands are available for cluster operations. These operations are largely a simple “wrapping” of the basic text command, but allow administration to be done from one machine and the operations mirrored on other nodes in the cluster.
setClusterNetworkSmbWinsServerAddress Executes setNetworkSmbWinsServerAddress on all cluster nodes. If no address is provided, the current WINS server address is cleared. ■ InParam[0] = WINS server name | WINS server IP address setClusterNetworkSmbSecurityMode Executes setNetworkSmbSecurityMode on all cluster nodes. ■ InParam[0] = SHARE or DOMAIN setClusterNetworkSmbDomainControllerList Executes setNetworkSmbDomainControllerList on all cluster nodes.
setClusterNetworkNisDomainName Executes setNetworkNisDomainName on all cluster nodes. ■ InParam[0] = NIS domain name setClusterNetworkNisEnabled Executes setNetworkNisEnabled on all cluster nodes. ■ InParam[0] = T (enabled), or F (disabled) setClusterNetworkNisServerName Executes setNetworkNisServerName on all cluster nodes. ■ InParam[0] = NIS server name setClusterNetworkNfsTrustedHostList Executes setNetworkNfsTrustedHostList on all cluster nodes.
importClusterSystemPasswdFile Executes importSystemPasswdFile on all cluster nodes. The import file on the execution machine is rsync’d to other cluster nodes and imported locally on all nodes. ■ InParam[0] = Local pathname of import file importClusterSystemGroupFile Executes importSystemGroupFile on all cluster nodes. The import file on the execution machine is rsync’d to other cluster nodes and imported locally on all nodes.
setClusterSystemLocalAdminContactEmail Executes setSystemLocalAdminContactEmail on all cluster nodes. ■ InParam[0] = Administrator contact email setClusterSystemLocalAdminLocation Executes setClusterSystemLocalAdminLocation on all cluster nodes. ■ InParam[0] = Administrator contact location setClusterSystemLocalAdminRackId Executes setSystemLocalAdminRackId all cluster nodes. ■ InParam[0] = Rack ID setClusterSystemLocalAdminRackPosition Executes setSystemLocalAdminRackPosition all cluster nodes.
Disaster Recovery Disaster can occur if the NAS head, storage array, or multiple devices are destroyed, or sustain critical hardware failures. The following text commands are provided to implement the recovery process. For detailed information on performing Disaster Recovery tasks, see the HP NAS 8000 Users Guide. At a minimum, the recovery process requires a working NAS head with access to the DRF. The recovery process attempts to restore the NAS head and the storage array based on the contents of the DRF.
Boot Partition Settings Use the following commands when you install a new version of the NAS OS or perform disaster recovery operations. toggleSystemBootPartitions Makes the active partition the one currently inactive, and vice-versa. getSystemBootPartitionActive Returns the name of the active boot partition. ■ inParam[0] = Boot partition name ■ outParam[0] = Partition active setSystemBootPartitionActive Sets the specified partition as the active boot partition.
index A addClusterPackage 70 addClusterSystemNtpServer 75 addStorageDasdScsiVa7xxxLun 24 addStorageShare 37 addStorageVolumeFile 33 addStorageVolumegroup 28 addStorageVolumegroupLuns 29 addStorageVolumegroupUser 28 addStorageVolumeSnapshot 34 addSystemNtpServer 53, 75 Alerts settings SMTP/Email 54 SNMP/Network management 15 Syslog 55 appendSystemLogEntry 56 applyClusterConfiguration 66, 67, 68 applyClusterPackageConfiguration 70 B bondEnslaveNetworkCard 11 bondReleaseNetworkCard 11 C Configuration date a
getClusterPackageVolumegroupList 72 getClusterQsHost 67 getClusterQsPollingInterval 68 getClusterStatus 67 getNetworkCardBondActiveSlaveList 12 getNetworkCardBondDownDelay 11 getNetworkCardBondMasterEnabled 10 getNetworkCardBondMasterInterfaceName 12 getNetworkCardBondMasterList 12 getNetworkCardBondMonitorInterval 11 getNetworkCardBondSlaveEnabled 11 getNetworkCardBondSlaveList 12 getNetworkCardBondUpDelay 11 getNetworkCardBroadcastAddress 7 getNetworkCardDhcpEnabled 8 getNetworkCardEnabled 8 getNetworkCar
getStorageDasdScsiVa7xxxRedundancygroupMinimum Number 22 getStorageDasdScsiVa7xxxRedundantCapacity 23 getStorageDasdScsiVa7xxxTotalCapacity 22 getStorageDasdScsiVa7xxxUnallocatedCapacity 22 getStorageDasdScsiVa7xxxUnincludedCapacity 23 getStorageDasdScsiVa7xxxUniqueName 21 getStorageDasdSerialNumber 19 getStorageDasdType 19 getStorageDasdVendor 19 getStorageQuotaEnabled 36 getStorageShareCount 37 getStorageShareHostsAllowList 38 getStorageShareList 37, 38, 39, 40, 41, 43, 44 getStorageShareNfsEnabled 43 get
getSystemShortProductName 59 getSystemSyslogServerName 57 getSystemTime 52 getSystemTimestamp 51 getSystemTimezoneCurrentCountry 53 getSystemTimezoneCurrentDescription 52 getSystemTimezoneCurrentGmt 52, 53 getSystemTimezoneCurrentName 53 getSystemTimezoneEnabled 52 getSystemTimezoneList 53 getSystemUnixGroupNamesList 62 getSystemUnixUserNamesList 62 getSystemUpsEnabled 57 getSystemUpsList 57 getSystemUpsStatus 57 getSystemUpsTitle 58 getSystemUptime 59 getSystemUserGracePeriod 65 getSystemUserMapList 62 get
setClusterPackageEnabled 71 setClusterPackageFailbackPolicy 72 setClusterPackageFailoverPolicy 72 setClusterPackageNodeFailFastEnabled 73 setClusterPackagePrimaryOwner 71 setClusterPackageServiceFailFastEnabled 73 setClusterPackageServiceHaltTimeout 74 setClusterPackageVirtualIpAddressList 72 setClusterPackageVolumegroupList 72 setClusterQsHost 67 setClusterQsPollingInterval 68 setClusterSystemAdminDebugLevel 76 setClusterSystemAdminPassword 76 setClusterSystemEmailRecipientAddressList 77 setClusterSystemEm
Simple Mail Transfer Protocol 54 Simple Network Management Protocol 15 SMTP 54 snapshots using 34 SNMP 15 startCluster 66, 67 startClusterNode 66 startClusterPackage 70, 71 stopCluster 66 stopClusterNode 67 stopClusterPackage 70 System settings date and time 51 T TCP/IP settings 7 Time settings 51 toggleSystemBootPartitions 80 Trap definitions 55 Traps 15 Trusted hosts file management 43 U uninstallSystemPackage 61 UNIX settings 14 unmapClusterSystemWindowsGroupNameFromUnix GroupName 74 unmapClusterSystem
