HP StorageWorks 8000 - NAS Command Reference Manual
  1. Manuals
  2. Brands
  3. HP Manuals
  4. Storage
  5. StorageWorks 8000 - NAS
  6. Command reference manual
HP StorageWorks 8000 - NAS Command Reference Manual

HP StorageWorks 8000 - NAS Command Reference Manual

Hp surestore nas 8000 command reference manual
Hide thumbs Also See for StorageWorks 8000 - NAS:
Table of Contents

Advertisement

Quick Links

Download this manual See also: User Manual, Installer and User Manual
command
reference
hp surestore nas 8000
command reference
Edition March 2002
Printed in U.S.A.

Advertisement

Table of Contents
loading

Related Manuals for HP StorageWorks 8000 - NAS

Summary of Contents for HP StorageWorks 8000 - NAS

  • Page 1 command reference hp surestore nas 8000 command reference Edition March 2002 Printed in U.S.A.
  • Page 2 Microsoft, Windows, and Windows NT are U.S. fitness for a particular purpose. Hewlett-Packard shall not registered trademarks of Microsoft Corporation. be liable for errors contained herein or for incidental or UNIX is a registered trademark of The Open Group.

  • Page 3: Table Of Contents

    contents Overview 3 Using the Command Line Interface 4 Command Syntax 5 Scripting 6 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.
  • Page 4 High Availability Cluster Settings 66 Cluster Package Commands 70 Cluster Operation 74 Disaster Recovery 79 Boot Partition Settings 80 Index i...

  • Page 5: Overview

    Overview 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.

  • Page 6: Using The Command Line Interface

    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...

  • Page 7: Command Syntax

    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.

  • Page 8: Scripting

    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]”...

  • Page 9: Command Reference7

    Command Reference 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).
  • Page 10 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...
  • Page 11 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.

  • Page 12: Network Card Bonding

    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.
  • Page 13 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.
  • Page 14 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. inParam[0] = Network card name outParam[0] = Bond master interface name getNetworkCardBondActiveSlaveList...

  • Page 15: Network Settings

    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.

  • Page 16: Network Nis Settings

    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.

  • Page 17: Network Snmp Settings

    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.
  • Page 18 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.

  • Page 19: Network Client Settings

    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).

  • Page 20: Misc. Network Settings

    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...

  • Page 21: Storage Settings

    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.
  • Page 22 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.
  • Page 23 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...
  • Page 24 getStorageDasdScsiVa7xxxCapacities Returns the capacity and other configurations of the specified storage array. inParam[0] = SCSI VA7xxx DASD name inParam[1] = Units (B,MB,GB) outParam[0] = Total capacity outParam[1] = Unallocated capacity outParam[2] = Allocated capacity outParam[3] = Unincluded capacity outParam[4] = Included capacity outParam[5] = Redundant capacity outParam[6] = Active spare capacity getStorageDasdScsiVa7xxxRedundancygroupMinimumNumber...
  • Page 25 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.
  • Page 26 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.
  • Page 27 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. inParam[0] = SCSI VA7xxx DASD name inParam[1] = LUN number inParam[2] = Units (B,MB,GB) outParam[0] = Device capacity (MB - unless overridden by inParam[1])
  • Page 28 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.
  • Page 29 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...

  • Page 30: Volume Group Settings

    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.
  • Page 31 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...

  • Page 32: Volume Settings

    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.
  • Page 33 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...
  • Page 34 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...
  • Page 35 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.

  • Page 36: Snapshot Settings

    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.
  • Page 37 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. inParam[0] = Snapshot name inParam[1] = Optional date format string (defaults to “%m/%d/%Y”) inParam[2] = Optional time format string (defaults to “%T”) For display, you should always select one of the “locale”...

  • Page 38: Storage Quota Settings

    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.

  • Page 39: Share Settings

    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 Windows Windows to data.
  • Page 40 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. getStorageShareList getStorageShareList 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...

  • Page 41: Smb Settings

    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.
  • Page 42 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 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.

  • Page 43: Inparam[0] = Volume Name Inparam[1] = Share Path

    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 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.
  • Page 44 getNetworkSmbSecurityMode There are two Windows NT security modes: Share-Level Security: The HP NAS 8000 handles its own security. Shares may be password- protected 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.

  • Page 45: Nfs Settings

    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.
  • Page 46 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 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.
  • Page 47 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.

  • Page 48: Admin Settings

    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.

  • Page 49: Local Admin Settings

    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.
  • Page 50 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.

  • Page 51: System Settings

    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.0 getSystemManagementUrl...
  • Page 52 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.

  • Page 53: Time And Date Settings

    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.
  • Page 54 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”. %c - TIME & DATE for locale %x - DATE for locale %X - TIME for locale %r - Time am/pm (exact format may change with locale)

  • Page 55: System Ntp Settings

    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.

  • Page 56: Email Settings

    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.

  • Page 57: Log Settings

    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...
  • Page 58 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...

  • Page 59: Ups Settings

    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.

  • Page 60: 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.
  • Page 61 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.

  • Page 62: Software Module Settings

    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.
  • Page 63 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.

  • Page 64: User And Group Settings

    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.
  • Page 65 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.

  • Page 66: User And Group Quota Settings

    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.
  • Page 67 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...

  • Page 68: High Availability Cluster Settings

    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*...
  • Page 69 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 applyClusterConfiguration applyClusterConfiguration applyClusterConfiguration is called.
  • Page 70 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 applyClusterConfiguration applyClusterConfiguration. InParam[0:N] = List of heartbeat network cards For example: setClusterHeartbeatNetworkCardList eth0 eth1 getClusterQsPollingInterval...
  • Page 71 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. InParam[0] = Interval, in seconds, between polling events getClusterMaxConfiguredPackages Gets the value from the registry.

  • Page 72: Cluster Package Commands

    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.
  • Page 73 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. InParam[0] = Package name InParam[1] = Node name InParam[2] = T (enabled) or F (disabled)
  • Page 74 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...
  • Page 75 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.

  • Page 76: Cluster Operation

    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”...
  • Page 77 setClusterNetworkSmbWinsServerAddress Executes setNetworkSmbWinsServerAddress setNetworkSmbWinsServerAddress on all cluster nodes. If no address is provided, setNetworkSmbWinsServerAddress setNetworkSmbWinsServerAddress the current WINS server address is cleared. InParam[0] = WINS server name | WINS server IP address setClusterNetworkSmbSecurityMode Executes setNetworkSmbSecurityMode setNetworkSmbSecurityMode on all cluster nodes. setNetworkSmbSecurityMode setNetworkSmbSecurityMode InParam[0] = SHARE or DOMAIN...
  • Page 78 setClusterNetworkNisDomainName Executes setNetworkNisDomainName setNetworkNisDomainName on all cluster nodes. setNetworkNisDomainName setNetworkNisDomainName InParam[0] = NIS domain name setClusterNetworkNisEnabled Executes setNetworkNisEnabled on all cluster nodes. InParam[0] = T (enabled), or F (disabled) setClusterNetworkNisServerName Executes setNetworkNisServerName setNetworkNisServerName setNetworkNisServerName on all cluster nodes. setNetworkNisServerName InParam[0] = NIS server name setClusterNetworkNfsTrustedHostList Executes setNetworkNfsTrustedHostList setNetworkNfsTrustedHostList...
  • Page 79 importClusterSystemPasswdFile Executes importSystemPasswdFile importSystemPasswdFile on all cluster nodes. The import file on the execution importSystemPasswdFile importSystemPasswdFile machine is rsync’d to other cluster nodes and imported locally on all nodes. InParam[0] = Local pathname of import file importClusterSystemGroupFile Executes importSystemGroupFile importSystemGroupFile on all cluster nodes. The import file on the execution machine importSystemGroupFile importSystemGroupFile is rsync’d to other cluster nodes and imported locally on all nodes.
  • Page 80 setClusterSystemLocalAdminContactEmail Executes setSystemLocalAdminContactEmail setSystemLocalAdminContactEmail on all cluster nodes. setSystemLocalAdminContactEmail setSystemLocalAdminContactEmail InParam[0] = Administrator contact email setClusterSystemLocalAdminLocation Executes setClusterSystemLocalAdminLocation setClusterSystemLocalAdminLocation setClusterSystemLocalAdminLocation on all cluster nodes. setClusterSystemLocalAdminLocation InParam[0] = Administrator contact location setClusterSystemLocalAdminRackId Executes setSystemLocalAdminRackId setSystemLocalAdminRackId setSystemLocalAdminRackId all cluster nodes. setSystemLocalAdminRackId InParam[0] = Rack ID setClusterSystemLocalAdminRackPosition Executes setSystemLocalAdminRackPosition setSystemLocalAdminRackPosition...

  • Page 81: Disaster Recovery

    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.

  • Page 82: Boot Partition Settings

    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...
  • Page 83 index DNS 13 Domain Name Service 13 addClusterPackage 70 doSystemReboot 59 addClusterSystemNtpServer 75 doSystemShutdown 59 addStorageDasdScsiVa7xxxLun 24 Dynamic Host Configuration Protocol (DHCP) 7 addStorageShare 37 addStorageVolumeFile 33 addStorageVolumegroup 28 Email notification of hardware failure 54 addStorageVolumegroupLuns 29 Error notification addStorageVolumegroupUser 28 email 54 addStorageVolumeSnapshot 34 SNMP server 15...
  • Page 84 getClusterPackageVolumegroupList 72 getNetworkSnmpActiveTrapDestList 17 getClusterQsHost 67 getNetworkSnmpCommunityString 15 getClusterQsPollingInterval 68 getNetworkSnmpTrapDestAddress 16 getClusterStatus 67 getNetworkSnmpTrapDestCommunity 15 getNetworkCardBondActiveSlaveList 12 getNetworkSnmpTrapDestDomain 16 getNetworkCardBondDownDelay 11 getNetworkSnmpTrapDestList 17 getNetworkCardBondMasterEnabled 10 getNetworkSnmpTrapDestPort 16 getNetworkCardBondMasterInterfaceName 12 getNetworkSnmpTrapDestStatus 16 getNetworkCardBondMasterList 12 getNetworkSnmpTrapDestVersion 15 getNetworkCardBondMonitorInterval 11 getStorageDasdList 19 getNetworkCardBondSlaveEnabled 11 getStorageDasdProduct 19 getNetworkCardBondSlaveList 12...
  • Page 85 getStorageDasdScsiVa7xxxRedundancygroupMinimum getStorageVolumeTotalCapacity 31 Number 22 getStorageVolumeType 30 getStorageDasdScsiVa7xxxRedundantCapacity 23 getStorageVolumeVolumeCapacityIncrement 32 getStorageDasdScsiVa7xxxTotalCapacity 22 getStorageVolumeVolumegroup 31 getStorageDasdScsiVa7xxxUnallocatedCapacity 22 getStorageVolumeVolumeMaximumCapacity 32 getStorageDasdScsiVa7xxxUnincludedCapacity 23 getStorageVolumeVolumeMinimumCapacity 32 getStorageDasdScsiVa7xxxUniqueName 21 getSystemAdminDebugLevel 46 getStorageDasdSerialNumber 19 getSystemAdminPassword 46 getStorageDasdType 19 getSystemBootPartitionActive 80 getStorageDasdVendor 19 getSystemBootPartitionList 80 getStorageQuotaEnabled 36 getSystemBootPartitionOsBuildnumber 80 getStorageShareCount 37 getSystemBootPartitionOsVersion 80...
  • Page 86 getSystemShortProductName 59 Network management settings 15 getSystemSyslogServerName 57 Network settings getSystemTime 52 TCP/IP 7 getSystemTimestamp 51 UNIX 14 getSystemTimezoneCurrentCountry 53 Windows 41 getSystemTimezoneCurrentDescription 52 NFS settings 43 getSystemTimezoneCurrentGmt 52 NIC 7 getSystemTimezoneCurrentName 53 NIS settings 14 getSystemTimezoneEnabled 52 getSystemTimezoneList 53 getSystemUnixGroupNamesList 62 Quotas getSystemUnixUserNamesList 62...
  • Page 87 setClusterPackageEnabled 71 setNetworkSnmpTrapDestDomain 16 setClusterPackageFailbackPolicy 72 setNetworkSnmpTrapDestList 17 setClusterPackageFailoverPolicy 72 setNetworkSnmpTrapDestPort 16 setClusterPackageNodeFailFastEnabled 73 setNetworkSnmpTrapDestStatus 16 setClusterPackagePrimaryOwner 71 setNetworkSnmpTrapDestVersion 15 setClusterPackageServiceFailFastEnabled 73 setStorageDasdScsiVa7xxxAlias 21 setClusterPackageServiceHaltTimeout 74 setStorageQuotaEnabled 36 setClusterPackageVirtualIpAddressList 72 setStorageShareHostsAllowList 38 setClusterPackageVolumegroupList 72 setStorageShareNfsEnabled 43 setClusterQsHost 67 setStorageShareNfsReadOnly 44 setClusterQsPollingInterval 68 setStorageShareSmbComment 40 setClusterSystemAdminDebugLevel 76...
  • Page 88 Simple Mail Transfer Protocol 54 Simple Network Management Protocol 15 SMTP 54 snapshots using 34 SNMP 15 startCluster 66 startClusterNode 66 startClusterPackage 70 stopCluster 66 stopClusterNode 67 stopClusterPackage 70 System settings date and time 51 TCP/IP settings 7 Time settings 51 toggleSystemBootPartitions 80 Trap definitions 55 Traps 15...

This manual is also suitable for:

Surestore nas 8000

Table of Contents