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