HP StorageWorks 8000 - NAS Installation manual

hp surestore nas 8000
command reference
Edition March 2002
Printed in U.S.A.
command
reference

2
Notice
© Hewlett-Packard Company, 2002. All rights reserved.
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. Hewlett-Packard shall not
be liable for errors contained herein or for incidental or
consequential damages in connection with the furnishing,
performance, or use of this material.
This document contains proprietary information, which is
protected by copyright. No part of this document may be
photocopied, reproduced, or translated into another
language without the prior written consent of Hewlett-
Packard. The information contained in this document is
subject to change without notice.
Format Conventions
WARNING Identifies a hazard that can cause personal
injury
Caution Identifies a hazard that can cause
hardware or software damage
Note Identifies significant concepts or operating
instructions
Computer font — used for all text to be typed
verbatim: all commands, path names, file names, and
directory names also, text displayed on the screen
Italics font — used for variables used in commands
Bold font — used for screen menu options and controls
Trademark Information
Java and all Java-based marks are trademarks or
registered trademarks of Sun Microsystems, Inc. in the
U.S. and other countries.
Microsoft, Windows, and Windows NT are U.S.
registered trademarks of Microsoft Corporation.
UNIX is a registered trademark of The Open Group.

1
1Overview 3
Using the Command Line Interface 4
Command Syntax 5
Scripting 6
2Command 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. Network Settings 18
Storage Settings 19
Volume Group Settings 28
Volume Settings 30
Snapshot Settings 34
Storage Quota Settings 36
Share Settings 37
SMB Settings 39
NFS Settings 43
Admin Settings 46
Local Admin Settings 47
System Settings 49
System Description 49
System Events 49
Time and Date Settings 51
System NTP Settings 53
Email Settings 54
Log Settings 55
UPS Settings 57
General System Settings 58
Software Module Settings 60
User and Group Settings 62
User and Group Quota Settings 64
contents

2
High Availability Cluster Settings 66
Cluster Package Commands 70
Cluster Operation 74
Disaster Recovery 79
Boot Partition Settings 80
3Index i

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

4Overview
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.xxx is the IP address of the HP NAS 8000 system.
To log in to the system:
■Press enter until you see the system name and login prompt.
■Log in as “admin”. No password is required until you set one using the command line
interface or the Command View NAS web interface.
hp nas8000
NAS OS v1.0.0
localhost login:admin

Overview 5
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.
Table 1 Sample Command Syntax
% getNetworkCardList
bond0
bond1
eth0
command
outParam[0]
outParam[1]
outParam[2]
% getNetworkCardIpAddress eth0
10.1.1.1
command inParam[0]
outParam[0]
% setNetworkCardIpAddress eth0 10.1.1.2
command inParam[0] inParam[1]

6Overview
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.0
Network Card Info: bond1
ip address = 0.0.0.0
subnet mask = 0.0.0.0
Network Card Info: eth0
ip address = 10.10.0.1
subnet mask = 255.255.255.0

Command Reference 7
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).
When you initially set up your HP NAS 8000, you need to configure the primary NIC. After the
primary NIC IP address is set, you can specify additional settings for primary and secondary
NICs using the HP Command View NAS web interface or by using the following text commands.
getNetworkCardList
Returns list of NIC names and numbers for use in the remaining NIC related commands.
■outParam[0:N] = Network card names
getSystemManagementNetworkCard
Returns the NIC assigned for accessing the Command View NAS web interface.
■outParam[0] = Network card name
setSystemManagementNetworkCard
Sets the NIC assigned for accessing the Command View NAS web interface. The default is the
on-board network port (eth0). If you change the port designated as the management port, be
sure to note to new IP configuration as this is only way to re-establish communication with your
NAS server.
■inParam[0] = Network card name
getNetworkCardBroadcastAddress
Returns the broadcast address for the specified NIC. The broadcast address is the address that
can be used to send messages to all machines on the subnet.
■inParam[0] = Network card name
■outParam[0] = Broadcast address
setNetworkCardBroadcastAddress
Sets the Broadcast address for the specified NIC.
■inParam[0] = Network card name
■inParam[1] = Broadcast address
2

8 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
Enables or disables DHCP for the specified NIC. If DHCP is disabled, the NIC IP address must be
manually defined.
■inParam[0] = Network card name
■inParam[1] = T (Enable) or F (Disable)
getNetworkCardEnabled
Identifies whether the specified NIC is enabled.
■inParam[0] = Network card name
■outParam[0] = T (Enabled) or F (Disabled)
getNetworkCardGatewayAddress
Returns the gateway address for the specified NIC.
■inParam[0] = Network card name
■outParam[0] = Gateway address
setNetworkCardGatewayAddress
Sets the gateway address for the specified NIC.
■inParam[0] = Network card name
■inParam[1] = Gateway address
getNetworkCardInterfaceName
Returns the name for the specified NIC.
■InParam[0] = Network card (NIC)
■OutParam[0] = Name
getNetworkCardIpAddress
Returns the IP address for the specified NIC.
■inParam[0] = Network card
■outParam[0] = IP address

Command Reference 9
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. The MTU is the
size of data packets that are sent across the network.
■inParam[0] = Network card name
■outParam[0] = MTU
setNetworkCardMtu
Sets the MTU size for the specified gigabit NIC. The MTU is the size of data packets that are sent
across the network.
■inParam[0] = Network card name
■inParam[1] = MTU
getNetworkCardReceiveErrors
Returns the number of errors received by the specified NIC since any NIC configuration changes
were made.
■inParam[0] = Network card name
■outParam[0] = Receive Error Count
getNetworkCardReceivePackets
Returns the number of packets received by the specified NIC since any NIC configuration
changes were made.
■inParam[0] = Network card name
■outParam[0] = Receive packet count
getNetworkCardSpeed
Returns the speed of the specified NIC.
■inParam[0] = Network card name
■outParam[0] = Speed

10 Command Reference
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.
■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.
■inParam[0] = Network card name
■outParam[0] = Transmit collision count
getNetworkCardTransmitPackets
Returns the number of packets transmitted by the specified NIC since any NIC configuration
changes were made.
■inParam[0] = Network card name
■outParam[0] = Transmit packet count
Network Card Bonding
When you configure NIC ports, you have the option of enabling bonding, a failover mechanism
that automatically switches a specific NIC port to a standby network upon the failure or
abnormal termination of the currently active system. By default, the lowest-numbered NIC
provides the addresses of the bond channel, but you can change the addresses manually.
Note Enabling DHCP disables NIC bonding and enabling NIC bonding disables DHCP.
Enabling DHCP or NIC bonding disables manually configuring addresses.The
following commands are used to configure NIC bonding.
getNetworkCardBondMasterEnabled
Identifies whether the specified NIC is a bond master.
■inParam[0] = Network card name
■outParam[0] = T (Enabled) or F (Disabled)

Command Reference 11
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.
■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
Returns the time (in milliseconds) for the selected NIC to delay after bondEnslave before
bringing the bond link up.
■inParam[0] = Network card name
■outParam[0] = Bond up delay
setNetworkCardBondUpDelay
Sets the time (in milliseconds) for the specified NIC to delay after bondEnslave before bringing
the bond link up.
■inParam[0] = Network card name
■inParam[1] = Bond up delay
getNetworkCardBondDownDelay
Returns the time (in milliseconds) for the specified NIC to delay after bondRelease before taking
the bond link down.
■inParam[0] = Network card name
■outParam[0] = Bond down delay

12 Command Reference
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
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
Returns a list of network cards that are bond masters.
■outParam[0:N] = Network card names

Command Reference 13
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.
■inParam[0] = DNS domain name
getNetworkDnsAddressList
Returns the list of DNS addresses associate with the HP NAS 8000.
■outParam[0:N] = DNS address list
setNetworkDnsAddressList
Up to three DNS Server Addresses can be specified. These should be entered in the appropriate
search order. In other words, enter the IP address of the Primary DNS first followed by the IP
address of the secondary DNS and so on until all of your Domain Name Servers have been
identified.
■inParam[0:N] = DNS address list
Values must be separated by spaces, for example:
■%setNetworkDnsAddressList 10.1.1.1 10.1.1.2 10.1.1.3
Network Host Settings
getNetworkHostName
Returns the network host name.
■outParam[0] = Host name
setNetworkHostName
Sets the network host name. If the full host name is nas8000.fc.hp.com, then nas8000 is the host
name and fc.hp.com is the domain name.
■inParam[1] = Host name

14 Command Reference
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.
■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.
■inParam[0] = T (Enable) or F (Disable)
getNetworkNisCurrentServerName
Returns the name of the NIS server the HP NAS 8000 system is currently connected to.
■outParam[0] = Current NIS server name
getNetworkNisServerName
Returns the name of the NIS server the HP NAS 8000 will attempt to connect to at boot.
■outParam[0] = NIS server name
setNetworkNisServerName
Sets the NIS server the HP NAS 8000 system will attempt to connect to at boot.
■inParam[0] = NIS server name

Command Reference 15
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.
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
getNetworkSnmpCommunityString
Returns the SNMP community name for this device (default: public).
■outParam[0] = SNMP community name
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
Sets 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
■inParam[1] = Value
getNetworkSnmpTrapDestCommunity
Returns the SNMP community name for this Trap Destination (default: public).
■inParam[0] = Destination number
■outParam[0] = Value
setNetworkSnmpTrapDestCommunity
Sets the SNMP community name for this Trap Destination (default: public).
■inParam[0] = Destination number
■inParam[1] = Value

16 Command Reference
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.
■inParam[0] = Destination number
■outParam[0] = Value
setNetworkSnmpTrapDestAddress
Sets the address for this Trap Destination. May be numeric (1.2.3.4) or DNS hostname
(snmp.hp.com).
■inParam[0] = Destination number
■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
Sets the Status for this Trap Destination. See www.hp.com/support/nas8000 for information on
trap status.
■inParam[0] = Destination number
■inParam[1] = Value
getNetworkSnmpTrapDestStatus
Returns the Status for this Trap Destination. See www.hp.com/support/nas8000 for information
on trap status.
■inParam[0] = Destination number
■outParam[0] = Value

Command Reference 17
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).
■inParam[0:N] = List of trap destination hostnames or IP addresses
getNetworkSnmpActiveTrapDestList
Returns the complete list of “active”Trap Destinations.
■outParam[0:N] = List of trap destination hostnames or IP addresses
getNetworkSnmpCommunityString
Returns the SNMP community name for this device (default: public).
■outParam[0] = SNMP community name
setNetworkSnmpCommunityString
Sets the SNMP community name for this device (default: public).
■inParam[0] = SNMP community name
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.
■inParam[0] = Network client ID
■outParam[0] = Network protocol (telnet, NFS, Windows®, etc.)
getNetworkClientInfoName
Returns the network name of the specified client.
■inParam[0] = Network client ID
■outParam[0] = Network name (xxx.xxx.xxx.xxx or DNS name)

18 Command Reference
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.
■inParam[0] = Network client ID
■outParam[0] = Sub-directory used by client within volume used by client (if applicable)
getNetworkClientInfoConnectTime
Returns the time the specified client connected to the HP NAS 8000 storage.
■inParam[0] = Network client ID
■inParam[1] = Optional format string (default is “%c”)
■outParam[0] = Date & Time according to format (default is “%m/%d/%Y%T”)
For display, you should always select one of the “locale”safe formats:
■%c - TIME & DATE for locale
■%x - DATE for locale
■%X - TIME for locale
■%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. Network Settings
getNetworkConfigured
Identifies whether or not the network is configured.
■outParam[0] = T (configured) or F (not configured)