Page 1 command reference hp StorageWorks nas 8000 command reference NAS OS version 1.6.0 Edition: March 2003 Part Number: A7418-96025...
Page 2 Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information is provided “as is” without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard Company products are set forth in the express limited warranty statements for such products.
Page 3: Table Of Contents
contents Contents Overview ..............15 Using the Command Line Interface .
Page 4 Contents setNetworkCardBondMonitorInterval ..........23 getNetworkCardBondUpDelay.
Page 5 Contents getNetworkClientInfoName ............29 getNetworkClientInfoPath .
Page 6 Contents addStorageDasdScsiVa7xxxLun...........36 removeStorageDasdScsiVa7xxxLun .
Page 7 Contents getStorageVolumeAvailableCapacity..........42 getStorageVolumeTotalCapacity .
Page 8 Contents setNetworkSmbSecurityMode ........... .51 getNetworkSmbDomainControllerList.
Page 9 Contents System Settings................58 System Description .
Page 10 Contents getSystemLogEntryProgramName ..........64 getSystemLogEntrySeverity .
Page 11 Contents unmapSystemWindowsUserNameFromUnixUserName ....... .71 unmapSystemWindowsGroupNameFromUnixGroupName ......71 User and Group Quota Settings .
Page 12 Contents Cluster Package Commands.............77 addClusterPackage .
Page 13 Contents setClusterNetworkNisServerName ..........83 setClusterNetworkNfsTrustedHostList.
Page 14 Contents HP StorageWorks NAS 8000 Command Reference...
Page 15: 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 16: Using The Command Line Interface
Overview 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 17: Command Syntax
Overview 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 18: Scripting
Overview 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 19: Command Reference
Command Reference Network Card Settings The HP NAS 8000 supports a Network Interface Card (NIC) port on each NAS Server. The shipped cards are dual-port 10/100 cards, so your NAS really has two NIC ports per server. When you initially set up your HP NAS 8000, you can specify settings for primary and secondary NICs using the HP Command View NAS web interface or by using the following text commands.
Page 20: Getnetworkcarddhcpenabled
Command Reference 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 21: Getnetworkcardmacaddress
Command Reference 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. The MTU is the size of data packets that are sent across the network. inParam[0] = Network card name outParam[0] = MTU setNetworkCardMtu...
Page 22: Getnetworkcardtransmitbytes
Command Reference getNetworkCardTransmitBytes Returns the number of bytes transmitted by the specified NIC since any NIC configuration changes were made. inParam[0] = Network card name outParam[0] = Transmit byte count getNetworkCardTransmitCollisions Returns the number of transmit collisions experienced by the specified NIC since any NIC configuration changes were made.
Page 23: Bondreleasenetworkcard
Command Reference bondReleaseNetworkCard Releases the specified NIC from bonds. inParam[0] = Network card name getNetworkCardBondMonitorInterval Returns the bond monitoring interval (in milliseconds) for the selected NIC. inParam[0] = Network card name outParam[0] = Bond monitor interval setNetworkCardBondMonitorInterval Sets the bond monitoring interval (in milliseconds) for the selected NIC. inParam[0] = Network card name inParam[1] = Bond monitor interval getNetworkCardBondUpDelay...
Page 24: Getnetworkcardbondactiveslavelist
Command Reference getNetworkCardBondActiveSlaveList Returns a list of network cards that are both bond slaves and active (that is, their bond master has failed). inParam[0] = Bond master NIC handle outParam[0:N] = Slave network card names getNetworkCardBondSlaveList Returns a list of network cards that are bond slaves. inParam[0] = Bond master NIC handle outParam[0:N] = Slave network card names getNetworkCardBondMasterList...
Page 25: Getnetworkdnsdomainname
Command Reference 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 26: Getnetworknisdomainname
Command Reference getNetworkNisDomainName Returns the NIS domain name. outParam[0] = NIS domain name setNetworkNisDomainName Sets the NIS domain name for the HP NAS 8000. inParam[0] = NIS domain name getNetworkNisEnabled Returns whether the HP NAS 8000 is NIS enabled. outParam[0] = T (Enabled) or F (Disabled) setNetworkNisEnabled Enables or disables NIS for the HP NAS 8000.
Page 27: Setnetworksnmpcommunitystring
Command Reference setNetworkSnmpCommunityString Sets the SNMP community name for this device (default: public). inParam[0] = SNMP community name getNetworkSnmpTrapDestVersion Returns the version of SNMP protocol to use when sending a trap to this Trap Destination (currently only v1 and v2c are supported; default: v1). inParam[0] = Destination number outParam[0] = Value setNetworkSnmpTrapDestVersion...
Page 28: Getnetworksnmptrapdestport
Command Reference inParam[1] = Value getNetworkSnmpTrapDestPort Returns the port set for the SNMP trap (default: 162). inParam[0] = Destination number outParam[0] = Port setNetworkSnmpTrapDestPort Sets the port number for the SNMP trap (default: 162). inParam[0] = Destination number inParam[1] = Port setNetworkSnmpTrapDestStatus www.hp.com/support/nas8000 Sets the Status for this Trap Destination.
Page 29: Getnetworkclientinfolist
Command Reference Network Client Settings These commands provide information about the network clients connected to the HP NAS 8000 system. getNetworkClientInfoList Returns a list of network clients currently connected to the HP NAS 8000 storage. outParam[0:N] = Network client IDs getNetworkClientInfoProtocol Returns the protocol used by the specified network client.
Page 30: Getnetworkclientinfocomment
Command Reference %r - Time am/pm (exact format may change with locale) %R - %H:%M %T - %H:%M:%S (24 hour) %D - %m/%d/%y - (United States specific format) getNetworkClientInfoComment Returns the comment associated with the specified network client. inParam[0] = Network client ID outParam[0] = Extra information about network client (if applicable) Misc.
Page 31: Getstoragedasdlist
Command Reference 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 32: Getstoragedasdscsigenericdevicefile
Command Reference outParam[0:N] = SCSI DASD name getStorageDasdScsiGenericDeviceFile Returns the absolute path to the SCSI generic device file for a DASD. inParam[0] = DASD name outParam[0] = DASD generic device file getStorageDasdScsiHost Returns the SCSI driver host number for a DASD. inParam[0] = SCSI DASD name outParam[0] = Host number getStorageDasdScsiChannel...
Page 33: Setstoragedasdscsiva7Xxxalias
Command Reference outParam[0] = Alias setStorageDasdScsiVa7xxxAlias Sets the alias for the specified storage array. inParam[0] = SCSI VA7xxx DASD name inParam[1] = Alias getStorageDasdScsiVa7xxxUniqueName Returns the unique name of the specified storage array. inParam[0] = SCSI VA7xxx DASD name outParam[0] = Unique name getStorageDasdScsiVa7xxxHealth Returns health status of the specified storage array.
Page 34: Getstoragedasdscsiva7Xxxredundancygroupmaximumnumber
Command Reference outParam[0] = Minimum redundancy group getStorageDasdScsiVa7xxxRedundancygroupMaximumNumber Returns the highest numbered redundancy group of a VA7xxx array. inParam[0] = SCSI VA7xxx DASD name inParam[1] = Redundancy group outParam[0] = Maximum redundancy group getStorageDasdScsiVa7xxxTotalCapacity Returns the total raw capacity of 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])
Page 35: Getstoragedasdscsiva7Xxxredundantcapacity
Command Reference inParam[0] = VA7xxx DASD name inParam[1] = Redundancy group (* for all redundancy groups). inParam[2] = Units (B,MB,GB) outParam[0] = Included capacity (MB - unless overridden by inParam[1]) getStorageDasdScsiVa7xxxRedundantCapacity Returns the redundant capacity – that is, the space used for data redundancy for the current RAID setting –...
Page 36: Getstoragedasdscsiva7Xxxlunmaximumnumber
Command Reference inParam[0] = SCSI VA7xxx DASD name outParam[0] = Minimum LUN number getStorageDasdScsiVa7xxxLunMaximumNumber Returns the maximum allowed LUN number. Currently 127. inParam[0] = SCSI VA7xxx DASD name outParam[0] = Maximum LUN number addStorageDasdScsiVa7xxxLun Adds a LUN of the specified size to the specified storage array. inParam[0] = SCSI VA7xxx DASD name inParam[1] = LUN number inParam[2] = Device capacity (MB)
Page 37: Getstoragedasdscsiva7Xxxperformanceloglist
Command Reference getStorageDasdScsiVa7xxxPerformanceLogList Returns a list of paths to performance log files for a VA7xxx storage array. Returned paths are relative to the web-server document root directory. inParam[0] = SCSI VA7xxx DASD name outParam[0:N] = Downloadable performance log file paths getStorageDasdScsiVa7xxxDeviceLogList Returns a list of paths to diagnostic log files for a VA7xxx storage array.
Page 38: Getstoragedasdscsilungenericdevicefile
Command Reference outParam[0] = Raw device file getStorageDasdScsiLunGenericDeviceFile Returns the generic device file used to access a SCSI LUN. Generic device files are most commonly used to send raw SCSI commands to devices. inParam[0] = SCSI LUN name outParam[0] = Generic device file getStorageDasdScsiLunRedundancygroup Returns the redundancy group number that this DASD LUN is on.
Page 39: Getstoragevolumegroupuserlist
Command Reference getStorageVolumegroupUserList Returns a list of existing user data-volume group names. This command is exactly equivalent to the getStorageVolumegroupList command. outParam[0:N] = Volume group name list getStorageVolumegroupExists Answers: Is there a volume group with name? InParam[0] = Volume group name outParam[0] = T (true) or F (false) getStorageVolumegroupActivated Identifies whether or not the specified volume group has been activated.
Page 40: Setstoragevolumegroupname
Command Reference setStorageVolumegroupName Renames an existing volume group. inParam[0] = Existing volume group name inParam[1] = New volume group name getStorageVolumegroupAvailableCapacity Returns the available capacity – that is the amount of free space – on the specified volume group. inParam[0] = Volume group name inParam[1] = Units (B,MB,GB) outParam[0] = Available Capacity (MB - unless overridden by inParam[1]) getStorageVolumegroupTotalCapacity...
Page 41: Getstoragevolumegroupvolumelist
Command Reference getStorageVolumegroupVolumeList Returns a list of the file volumes that exist in the specified volume group. inParam[0] = Volume group name outParam[0:N] = Volume name list repairStorageVolume Attempts repairs on a volume. Use this command if, for some reason, the NAS 8000 could not mount the file volumes due to an error (for example, an array failure and recovery where the file system logs get corrupted).
Page 42: Getstoragevolumenumber
Command Reference getStorageVolumeNumber Returns the number of the specified file volume. inParam[0] = Volume name outParam[0] = Volume number getStorageVolumeVolumegroup Returns the name of the volume group that contains the specified file volume. inParam[0] = Volume name outParam[0] = Volume group name getStorageVolumeAvailableCapacity Returns the amount of available, or free, space in the specified file volume.
Page 43: Getstoragevolumevolumemaximumcapacity
Command Reference inParam[1] = Units (B,MB,GB) outParam[0] = Minimum volume capacity (MB - unless overridden by inParam[1]) getStorageVolumeVolumeMaximumCapacity Returns the maximum capacity for the specified storage volume. inParam[0] = Volume name inParam[1] = Units (B,MB,GB) outParam[0] = Minimum volume capacity (MB - unless overridden by inParam[1]) getStorageVolumeVolumeCapacityIncrement Returns the capacity increment (in bytes, megabytes, and gigabytes) used to create or resize file and snapshot volumes, i.e., when creating volumes, the capacity modulo increment must...
Page 44: Snapshot Settings
Command Reference 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 45: Getstoragevolumesnapshotexpiration
Command Reference 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 46: Getstoragequotaenabled
Command Reference getStorageQuotaEnabled Identifies whether quotas are enabled for the specified file volume. inParam[0] = Volume name outParam[0] = T (Enabled) or F (Disabled) setStorageQuotaEnabled Enables or disables quotas for the specified file volume. inParam[0] = Volume name inParam[0] = T (Enabled) or F (Disabled) HP StorageWorks NAS 8000 Command Reference...
Page 47: Share Settings
Command Reference 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: Shares are permissions that let you control Microsoft Windows users' access to data.
Page 48: Getstoragesharehostsallowlist
Command Reference inParam[0] = Volume name inParam[1] = Share path outParam[0:N] = Host allow list for this share OR (see getStorageShareList). This facilitates webFilter usage. inParam[0] = Volume name:_*_:Share path outParam[0] = Path for the share. getStorageShareHostsAllowList Returns a list of the hosts that will be given access to the storage on the HP NAS 8000 system. inParam[0] = Volume name inParam[1] = Share path outParam[0:N] = Host allow list for this share...
Page 49: Setstoragesharesmbenabled
Command Reference inParam[0] = Volume name:_*_:Share path outParam[0] = T (Enabled) or F (Disabled) setStorageShareSmbEnabled Enables or disables Windows SMB sharing for the specified share. inParam[0] = Volume name inParam[1] = Share path inParam[2] = T (Enable) or F (Disable) inParam[3] = SMB name (Only if enabling) OR (see getStorageShareList).
Page 50: Getstoragesharesmbrwpassword
Command Reference inParam[0] = Volume name:_*_:Share path inParam[1] = Comment getStorageShareSmbRwPassword Returns the Windows SMB read/write password for the specified share. inParam[0] = Volume name inParam[1] = Share path outParam[0] = Read/Write password OR (see getStorageShareList). This facilitates webFilter usage. inParam[0] = Volume name:_*_:Share path outParam[0] = Read/write password setStorageShareSmbRwPassword...
Page 51: Getnetworksmbcomment
Command Reference getNetworkSmbComment Returns the comment field associated with the network’s Windows share settings for the HP NAS 8000. outParam[0] = Comment setNetworkSmbComment Sets the comment associated with the network’s Windows share settings for the HP NAS 8000. inParam[0] = Comment getNetworkSmbWinsServerAddress Similar to DNS, the Windows Internet Naming Service (WINS) is the Windows NT server method for associating a computer's host name with its address.
Page 52: Getnetworksmbdomainlist
Command Reference getNetworkSmbDomainList Get the Windows domains that the NAS 8000 has been joined to. outParam[0:N] = Joined domain name list getNetworkSmbDomainName Get the name of the Windows domain that the NAS 8000 is currently joined to. outParam[0] = Domain/workgroup name joinNetworkSmbDomain Join the NAS 8000 to a specific Windows domain.
Page 53: Nfs Settings
Command Reference NFS Settings Network File System (NFS) settings are optional. NFS is a client/server application that lets a UNIX computer user view and optionally store and update files on a remote computer as though they were on the user's own computer. getStorageShareNfsEnabled Identifies whether UNIX NFS sharing is enabled for the specified share.
Page 54: Setstoragesharenfsreadonly
Command Reference OR (see getStorageShareList). This facilitates webFilter usage. inParam[0] = Volume name:_*_:Share path outParam[0] = T (ReadOnly) or F (ReadWrite) setStorageShareNfsReadOnly Sets the specified share to UNIX NFS read-only or read/write access. inParam[0] = Volume name inParam[1] = Share path inParam[2] = T (ReadOnly) or F (ReadWrite) OR (see getStorageShareList).
Page 55: Admin Settings
Command Reference 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 56: Local Admin Settings
Command Reference 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 57: Getsystemlocaladminlocation
Command Reference getSystemLocalAdminLocation Returns a description of the physical location of the HP NAS 8000 system. outParam[0] = Location setSystemLocalAdminLocation Defines the description of the physical location of the HP NAS 8000 system. inParam[0] = Location getSystemLocalAdminRackId Returns the rack ID for the HP NAS 8000 system. outParam[0] = Rack ID setSystemLocalAdminRackId Defines the rack ID for the HP NAS 8000 system.
Page 58: Getsystemoid
Command Reference 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 59: Getsystemeventnum
Command Reference 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.
Page 60: Setsystemtimestamp
Command Reference %r - Time am/pm (exact format may change with locale) %R - %H:%M %T - %H:%M:%S (24 hour) %D - %m/%d/%y - (United States specific format) setSystemTimestamp Sets the system timestamp. inParam[0] = Date (mm/dd/yyyy) or “NOW” inParam[1] = Time (24hh:mm:ss) or “NOW” getSystemDate Returns the current system date.
Page 61: Getsystemtimezonecurrentgmt
Command Reference inParam[0] = Time [24HH:MM:SS] or “NOW” getSystemTimezoneCurrentGmt outParam[0] = GMT value getSystemTimezoneEnabled Informs whether time zones are enabled on the HP NAS 8000. inParam[0] = Time zone name outParam[0] = Enable status setSystemTimezoneEnabled Enables time zone support. inParam[0] = Time zone name inParam[1] = Enable getSystemTimezoneCurrentDescription Displays the current time zone setting description.
Page 62: Getsystemntpenabled
Command Reference InParam[0] = Hostname or NTP server IP address getSystemNtpEnabled Determine whether the server is configured to sync its system time with NTP servers. outParam[0] = T or F getSystemNtpServerList Gets the list of NTP servers from which the system is currently getting NTP time synchronization information.
Page 63: Sendsystememailtest
Command Reference inParam[2] = Email body sendSystemEmailTest Sends a test email to the specified email address. inParam[0] = Email address getSystemNameEmailAddress Returns the email address of the specified user. inParam[0] = User name outParam[0] = Email address getSystemUIDEmailAddress Returns the email address for the user with the specified ID. inParam[0] = UID outParam[0] = Email address setSystemNameEmailAddress...
Page 64: Getsystemlogentryprogramname
Command Reference getSystemLogEntryProgramName Returns the name of the program that created the log entry. inParam[0] = Log entry handle outParam[0] = Log entry program name getSystemLogEntrySeverity Returns the severity level associated with the specified log entry. inParam[0] = Log entry handle outParam[0] = Log entry severity Values: E = Error...
Page 65: Getsystemsyslogservername
Command Reference 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 66: Getsystemmanufacturer
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 67: Dosystemshutdown
Command Reference doSystemShutdown Shuts down the NAS server. invokeSystemTool command [flags] [args] Returns the output for the requested command. inParam[0] = command inParam[1…n] = flags and args (optional) outParam[ ] = output from the requested command Definitions: command is the system tool to call. flags are any switches to send to the command.
Page 68: Getsystempackageauthorized
Command Reference 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 69: Getsystempackageweb
Command Reference 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 70: Getsystemunixusernameslist
Command Reference 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 71: Getsystemwindowsgroupnamesfromdomainlist
Command Reference 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. inParam[0] = Domain outParam[0:N] = Windows user -> UNIX user mapSystemWindowsUserNameToUnixUserName Maps the specified Windows user name to the specified UNIX user name and ID. inParam[0] = Windows user name inParam[1] = unix name | unix name:uid | uid mapSystemWindowsGroupNameToUnixGroupName...
Page 72: Setsystemgroupquota
Command Reference outParam[0] = Current usage Mb outParam[1] = Soft limit outParam[2] = Hard limit outParam[3] = Grace period setSystemGroupQuota Sets the quota settings for the specified group on the specified file volume. inParam[0] = Group name inParam[1] = Volume name inParam[2] = Soft limit inParam[3] = Hard limit getSystemUserQuota...
Page 73: Setsystemusergraceperiod
Command Reference inParam[0] = Volume name outParam[0] = Grace period in seconds setSystemUserGracePeriod Sets the grace period – that is the amount of time users will have access to the space after their quota is reached – for the specified file volume. inParam[0] = Volume name inParam[1] = Grace period in seconds getSystemGroupGracePeriod...
Page 74: Setsystemhostsfileentry
Command Reference 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.
Page 75: Getclustername
Command Reference 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. OutParam[0] = A multi-line text string that contains status information about the cluster, including nodes and packages running on those nodes.
Page 76: Getclusterqspollinginterval
Command Reference InParam[0:N] = List of heartbeat network cards For example: setClusterHeartbeatNetworkCardList eth0 eth1 getClusterQsPollingInterval Gets the interval from the registry. OutParam[0] = Interval, in seconds, for contacting the Quorum server setClusterQsPollingInterval Stores the polling interval in the registry: how often, in seconds, to contact Quorum server. InParam[0] = Interval, in seconds getClusterHeartbeatInterval Gets the interval from the registry.
Page 77: Getclustermaxconfiguredpackages
Command Reference getClusterMaxConfiguredPackages Gets the value from the registry. OutParam[0] = Maximum number of packages allowed to run setClusterMaxConfiguredPackages Stores the number in the registry. InParam[0] = Maximum number of packages allowed to run getClusterNtpLocalMaster Stores the number in the registry. OutParam[0] = Hostname or IP address of cluster node that is currently serving as an NTP master server for time synchronization.
Page 78: Startclusterpackage
Command Reference startClusterPackage Starts the package on the primary owning node, or if nodeName is given, then on that node. The volume group(s) associated with the package are activated on the node running the package. If the volume groups have previously defined volumes and shares, then those are activated.
Page 79: Getclusterpackageprimaryowner
Command Reference getClusterPackagePrimaryOwner Gets from the registry, the name of the node that owns the package. InParam[0] = Package name OutParam[0] = Primary owning node of the package setClusterPackagePrimaryOwner Required. Sets in the registry, the name of the node that owns the package. Running ‘startClusterPackage packageName’...
Page 80: Getclusterpackagefailoverpolicy
Command Reference setClusterPackageVolumegroupList pkg1 vg1 vg2 vg3 getClusterPackageFailoverPolicy Gets from the registry, value of the failover policy for this package. InParam[0] = Package name OutParam[0] = CONFIGURED_NODE or MIN_PACKAGE_NODE setClusterPackageFailoverPolicy Sets in the registry, the failover policy for the given package. The default is CONFIGURED_NODE.
Page 81: Getclusterpackageservicefailfastenabled
Command Reference getClusterPackageServiceFailFastEnabled Gets from the registry, the value of ServiceFailFastEnabled for this package. InParam[0] = Package name OutParam[0] = T or F setClusterPackageServiceFailFastEnabled Sets in the registry, the ServiceFailFastEnabled value for the given package. The default is F. InParam[0] = Package name InParam[1] = T or F OutParam[0] = None getClusterPackageServiceHaltTimeout...
Page 82: Unmapclustersystemwindowsusernamefromunixusername
Command Reference unmapClusterSystemWindowsUserNameFromUnixUserName Executes unmapSystemWindowsUserNameFromUnixUserName on all cluster nodes. InParam[0] = Windows user name InParam[1] = UNIX name DOMAIN+unixuser unmapClusterSystemWindowsGroupNameFromUnixGroupName Executes unmapSystemWindowsGroupNameFromUnixGroupName on all cluster nodes. InParam[0] = Windows user name InParam[1] = UNIX group DOMAIN+group OutParam[0] = None setClusterNetworkSmbComment Executes setNetworkSmbComment on all cluster nodes.
Page 83: Removeclustersystemntpserver
Command Reference removeClusterSystemNtpServer Executes removeSystemNtpServer on all cluster nodes. InParam[0] = Server name or IP address setClusterNetworkDnsDomainName Executes setNetworkDnsDomainName on all cluster nodes. InParam[0] = Domain name setClusterNetworkDnsAddressList Executes setNetworkDnsAddressList on all cluster nodes. inParam[0:N] = DNS address list setClusterNetworkNisDomainName Executes setNetworkNisDomainName on all cluster nodes.
Page 84: Setclustersystemtimezoneenabled
Command Reference setClusterSystemTimezoneEnabled Executes setSystemTimezoneEnabled on all cluster nodes. InParam[0] = Time zone name InParam[1] = T (enabled), or F (disabled) setClusterSystemUpsEnabled Executes setSystemUpsEnabled on all cluster nodes. InParam[0] = UPS name 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.
Page 85: Setclustersystemlocaladmincontactphone
Command Reference setClusterSystemLocalAdminContactPhone Executes setSystemLocalAdminContactPhone on all cluster nodes. InParam[0] = Administrator contact phone setClusterSystemLocalAdminContactPager Executes setSystemLocalAdminContactPager on all cluster nodes. InParam[0] = Administrator contact pager 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.
Page 86: Disaster Recovery
Command Reference Disaster Recovery Disaster can occur if the NAS server, 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 87: Recoversystemstorageregistryconfig
Command Reference backup mechanism. Also, if you had snapshot volumes defined in the prior SAN storage configuration, you will have to recreate them, as the storage recovery operation does not recreate the snapshot volumes. Be sure to reload your user data before recreating any snapshot volumes.
Page 88: Copysystemdrftofloppy
Command Reference copySystemDrfToFloppy Copies the latest disaster recovery file to a floppy disk. The administrator must supply an empty DOS-formatted floppy disk. This command takes the files with a .drf extension in the DisasterRecovery directory on the DISASTER_RECOVERY volume and generates a new tar file called drf.tar.
Page 89: Boot Partition Settings
Command Reference 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 90 Command Reference HP StorageWorks NAS 8000 Command Reference...
Page 91: Index
index addClusterPackage Date settings addClusterSystemNtpServer deleteClusterConfiguration addStorageDasdScsiVa7xxxLun deleteClusterPackage addStorageShare deleteStorageVolume addStorageVolumeFile deleteStorageVolumegroup addStorageVolumegroup deleteStorageVolumegroupLuns addStorageVolumegroupLuns deleteSystemHostsFileEntry addStorageVolumegroupUser DHCP addStorageVolumeSnapshot addSystemNtpServer 61, Domain Name Service Alerts settings doSystemReboot SMTP/Email doSystemShutdown SNMP/Network management Dynamic Host Configuration Protocol (DHCP) Syslog appendSystemLogEntry applyClusterConfiguration 74, Email notification of hardware failure applyClusterPackageConfiguration Error notification...
Page 92 Index getClusterName getNetworkDnsAddressList getClusterNetworkPollingInterval getNetworkDnsDomainName getClusterNodeNameList getNetworkHostName getClusterNodeTimeout getNetworkNfsMaxConnections getClusterNtpLocalMaster getNetworkNfsTrustedHostList getClusterPackageAdoptiveNodeList getNetworkNisCurrentServerName getClusterPackageAutoRun getNetworkNisDomainName getClusterPackageCurrentOwner getNetworkNisEnabled getClusterPackageFailbackPolicy getNetworkNisServerName getClusterPackageFailoverPolicy getNetworkSmbCodePage getClusterPackageNameList getNetworkSmbComment getClusterPackageNodeFailFastEnabled getNetworkSmbDomainControllerList getClusterPackagePrimaryOwner getNetworkSmbDomainList getClusterPackageServiceFailFastEnabled getNetworkSmbDomainName getClusterPackageServiceHaltTimeout getNetworkSmbDomainStatus getClusterPackageVirtualIpAddressList getNetworkSmbSecurityMode getClusterPackageVolumegroupList getNetworkSmbWinsServerAddress getClusterQsHost getNetworkSnmpActiveTrapDestList 28, getClusterQsPollingInterval getNetworkSnmpCommunityString 26, getClusterStatus getNetworkSnmpTrapDestAddress getNetworkCardBondActiveSlaveList...
Page 93 Index getStorageDasdScsiVa7xxxDeviceLogList getStorageVolumegroupActivated getStorageDasdScsiVa7xxxHealth getStorageVolumegroupAvailableCapacity getStorageDasdScsiVa7xxxIncludedCapacity getStorageVolumegroupExists getStorageDasdScsiVA7xxxList getStorageVolumegroupList getStorageDasdScsiVa7xxxLun getStorageVolumegroupLunList getStorageDasdScsiVa7xxxLunCapacity getStorageVolumegroupSystemList getStorageDasdScsiVa7xxxLunCapacityIncrement getStorageVolumegroupTotalCapacity getStorageDasdScsiVa7xxxLunList getStorageVolumegroupUserList getStorageDasdScsiVa7xxxLunMaximumNumber getStorageVolumegroupVolumeCapacityIncrement getStorageDasdScsiVa7xxxLunMinimumCapacity getStorageDasdScsiVa7xxxLunMinimumNumber getStorageVolumegroupVolumeList getStorageDasdScsiVa7xxxLunRedundancygroup getStorageVolumegroupVolumeMaximumCapacity getStorageDasdScsiVa7xxxManagementSoftwareRun ning getStorageVolumegroupVolumeMinimumCapacity getStorageDasdScsiVa7xxxPerformanceLogList getStorageDasdScsiVa7xxxRebuilding getStorageVolumeList getStorageDasdScsiVa7xxxRebuildPercentComplete getStorageVolumeMountPath getStorageVolumeNumber getStorageDasdScsiVa7xxxRedundancygroupMaxim getStorageVolumeRootPath umNumber getStorageVolumeSnapshotAutogrowEnabled getStorageDasdScsiVa7xxxRedundancygroupMinimu getStorageVolumeSnapshotExpiration mNumber getStorageVolumeSnapshotList getStorageDasdScsiVa7xxxRedundantCapacity getStorageVolumeSnapshotVolumeFile...
Page 94 Index getSystemLocalAdminContactPager getSystemUserQuotaList getSystemLocalAdminContactPhone getSystemWindowsDomainsList getSystemLocalAdminLocation getSystemWindowsGroupNamesFromDomainList getSystemLocalAdminRackId getSystemWindowsUserNamesFromDomainList getSystemLocalAdminRackPosition gtNetworkSmbCodingSystem getSystemLogEntryDescription getSystemLogEntryList getSystemLogEntryProgramName importClusterSystemGroupFile getSystemLogEntrySeverity importClusterSystemGroupMapList getSystemLogEntryTimestamp importClusterSystemPasswdFile getSystemManagementNetworkCard importClusterSystemUserMapList getSystemManagementUrl importSystemGroupFile 55, getSystemManufacturer importSystemGroupMapList getSystemMotherboardSerialNumber importSystemPasswdFile 55, getSystemNameEmailAddress importSystemUserMapList getSystemNasSerialNumber installSystemPackage getSystemNtpEnabled invokeSystemTool getSystemNtpServerList IP addresses getSystemOid getSystemOsBuildNumber getSystemOsVersion joinClusterNetworkSmbDomain getSystemPackageAuthorized...
Page 95 Index setClusterPackageVolumegroupList 79, setClusterQsHost recoverSystemHeadFromDisasterRecoveryFile setClusterQsPollingInterval recoverSystemStorageDedicatedAttachConfig setClusterSystemAdminDebugLevel recoverSystemStorageRegistryConfig setClusterSystemAdminPassword recoverSystemStorageSanConfig setClusterSystemEmailRecipientAddressList relocateClusterPackage setClusterSystemEmailServerName removeClusterNetworkSmbDomain setClusterSystemLocalAdminAssetNumber removeClusterSystemNtpServer setClusterSystemLocalAdminContactEmail removeNetworkSmbDomain 52, setClusterSystemLocalAdminContactName removeStorageDasdScsiVa7xxxLun setClusterSystemLocalAdminContactPager removeStorageShare setClusterSystemLocalAdminContactPhone removeSystemNtpServer setClusterSystemLocalAdminLocation repairStorageVolume setClusterSystemLocalAdminRackId resetNasHeadToFactoryDefaultSettings setClusterSystemLocalAdminRackPosition restartClusterAntivirus setClusterSystemNtpEnabled restartClusterNodeAntivirus setClusterSystemReservedDomainRange restartStorageDasdScsiVa7xxx setClusterSystemSyslogServerName restoreSystemDrfFromFloppy setClusterSystemTimestamp setClusterSystemTimezoneEnabled setClusterSystemUidEmailAddress scanStorageDasdScsiVa7xxx setClusterSystemUpsEnabled...
Page 96 Index setStorageQuotaEnabled Shares setStorageShareHostsAllowList creating setStorageShareNfsEnabled shares setStorageShareNfsReadOnly shutdownStorageDasdScsiVa7xxx setStorageShareSmbComment Simple Mail Transfer Protocol setStorageShareSmbEnabled Simple Network Management Protocol setStorageShareSmbRoPassword SMTP setStorageShareSmbRwPassword snapshots setStorageVolumegroupName using setStorageVolumeName SNMP setStorageVolumeSize startCluster 74, setStorageVolumeSnapshotAutogrowEnabled startClusterNode setStorageVolumeSnapshotExpiration startClusterPackage 78, setSystemAdminDebugLevel 55, stopCluster setSystemAdminPassword 55, stopClusterNode setSystemBootPartitionActive stopClusterPackage...

This manual is also suitable for:

Storageworks nas 8000

HP StorageWorks NAS 8000 - Version 1.6.X Command Reference Manual

1 Overview

2 Command Reference

Quick Links

Related Manuals for HP StorageWorks NAS 8000 - Version 1.6.X

Summary of Contents for HP StorageWorks NAS 8000 - Version 1.6.X

This manual is also suitable for:

Table of Contents