HP NAS 8000 Non-Clustered Solution Guida Utente

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

8 Command ReferencegetNetworkCardDhcpEnabledIdentifies whether the specified NIC is DHCP enabled. When DHCP is enabled, NIC configuration occurs autom

Command Reference 9setNetworkCardIpAddressSets the IP address for the specified NIC. The IP address and subnet mask for the primary NIC must be define

10 Command ReferencegetNetworkCardSubnetMaskReturns the subnet mask for the selected NIC. inParam[0] = Network card name outParam[0] = Subnet mask se

Command Reference 11getNetworkCardBondSlaveEnabledIdentifies whether the specified NIC is a bond slave. inParam[0] = Network card name outParam[0] =

12 Command ReferencesetNetworkCardBondDownDelaySets the time (in milliseconds) for the specified NIC to delay after bondRelease before taking the bond

Command Reference 13Network SettingsDomain Name Service (DNS) SettingsDomain Name Servers convert system names that people can remember (such as nas80

14 Command ReferenceNetwork NIS SettingsThe HP NAS 8000 supports Network Information System (NIS). NIS maintains a central database of names and locat

Command Reference 15Network SNMP SettingsIf you are using a Simple Network Management Protocol (SNMP) tool, you can define the names or IP addresses o

16 Command ReferencegetNetworkSnmpTrapDestDomainReturns the Domain for this Trap Destination (currently only “UDP” is supported). inParam[0] = Destina

Command Reference 17getNetworkSnmpTrapDestListReturns the complete list of Trap Destination Addresses. outParam[0:N] = List of trap destination hostna

2Notice© Hewlett-Packard Company, 2002. All rights reserved.Hewlett-Packard Company makes no warranty of any kind with regard to this material, includ

18 Command ReferencegetNetworkClientInfoPathReturns the path used by the specified client (that is, what part of the storage are they using). inParam[

Command Reference 19Storage SettingsStorage settings allow you to control Direct Access Storage Devices (DASDs) connected to the HP NAS 8000 solution.

20 Command ReferencegetStorageDasdDeviceFileReturns the name of the device file used to access the specified DASD. inParam[0] = DASD name outParam[0]

Command Reference 21getStorageDasdScsiVA7xxxListReturns a list of disk arrays attached to the system. outParam[0:N] = SCSI DASD Va7xxx name list getSt

22 Command ReferencegetStorageDasdScsiVa7xxxCapacitiesReturns the capacity and other configurations of the specified storage array. inParam[0] = SCSI

Command Reference 23getStorageDasdScsiVa7xxxAllocatedCapacityReturns the allocated capacity – that is, space included in volume groups – for the speci

24 Command ReferenceshutdownStorageDasdScsiVa7xxxShuts down the specified storage array. inParam[0] = SCSI VA7xxx DASD name restartStorageDasdScsiVa7x

Command Reference 25removeStorageDasdScsiVa7xxxLunDeletes the specified LUN from the specified storage array. All data will be lost. inParam[0] = SCSI

26 Command ReferencegetStorageDasdScsiPerDriveLunListReturns a list of LUNs available on the specified array or device. inParam[0] = SCSI DASD name o

Command Reference 27getStorageDasdScsiLunRedundancygroup Returns the redundancy group number that this DASD LUN is on. This command should only be use

11 Overview 3Using the Command Line Interface 4Command Syntax 5Scripting 62 Command Reference7Network Card Settings 7Network Card Bonding 10Network Se

28 Command ReferenceVolume Group SettingsA volume group is the aggregation of one or more LUNs. Volume groups combine the space from LUNs and make the

Command Reference 29addStorageVolumegroupLunsAdds the specified LUNs to an existing volume group. inParam[0] = Volume group name inParam[1:N] = LUN n

30 Command ReferencegetStorageVolumegroupVolumeMaximumCapacityReturns the maximum size that can be used to create a file volume or snapshot on the spe

Command Reference 31deleteStorageVolumeDeletes the specified file volume. All data will be lost. inParam[0] = Volume name setStorageVolumeNameRenames

32 Command ReferencegetStorageVolumeMountPathReturns the mount path, if any, that is defined for UNIX® sharing of the specified file volume. inParam[0

Command Reference 33getStorageVolumeFileUserListReturns a list of existing user-data file volume names. outParam[0:N] = Volume name listgetStorageVol

34 Command ReferenceSnapshot SettingsA snapshot is a read-only picture of a file volume at a specific point in time. When you create a file volume, th

Command Reference 35getStorageVolumeSnapshotVolumeFileReturns the name of the file volume associated with the specified snapshot. inParam[0] = Snapsho

36 Command ReferenceStorage Quota SettingsQuotas are set on a per file volume basis. You can have a quota larger than the available space on the file

Command Reference 37Share SettingsBefore network users can access the NAS server, you must give them permission. This is a security concern. Each plat

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

38 Command ReferenceremoveStorageShareRemoves the specified share/export from the specified file volume. inParam[0] = Volume name inParam[1] = Share

Command Reference 39SMB SettingsSMB/CIFS, the Windows protocol for sharing files, lets client applications read and write to files. CIFS is a proposed

40 Command ReferencegetStorageShareSmbCommentReturns the Windows SMB comment associated with the specified share. inParam[0] = Volume name inParam[1]

Command Reference 41getStorageShareSmbRoPasswordReturns the Windows SMB read-only password for the specified share. inParam[0] = Volume name inParam[

42 Command ReferencegetNetworkSmbSecurityModeThere are two Windows NT security modes: Share-Level Security: The HP NAS 8000 handles its own security.

Command Reference 43getNetworkSmbDomainStatusThis call is only applicable when in user (domain) SMB security mode. The result is true only if the NAS

44 Command ReferencegetStorageShareNfsNameReturns the UNIX NFS share name for the specified share. inParam[0] = Volume name inParam[1] = Share path

Command Reference 45getNetworkNfsMaxConnectionsReturns the maximum allowed number of simultaneous Network File System Daemons (NFSD) processes. Maximu

46 Command ReferenceAdmin SettingsThe NAS server can be password protected. This prevents unauthorized access to the Command View NAS web interface. T

Command Reference 47setSystemAdminPasswordSets the system admin password. inParam[0] = Admin password Local Admin SettingsThese informational settings

Overview 3OverviewWhile most of the HP NAS 8000 administrative tasks can be accomplished with the Command View NAS web interface, the HP NAS 8000 also

48 Command ReferencegetSystemLocalAdminContactPagerReturns the pager number of the primary IT contact responsible for the HP NAS 8000. outParam[0] = C

Command Reference 49System SettingsThe commands in this section are used to defined general system descriptions and settings for the NAS 8000.System D

50 Command ReferenceclearSystemEventClears a System Event. The Master Event Daemon (hpMed) will then handle things properly, sending e-mail as well as

Command Reference 51Time and Date SettingsThe HP NAS 8000 uses the information on this screen to keep track of the date and time for operations such a

52 Command ReferencesetSystemDateSets the system date. inParam[0] = Date [MM/DD/YYYY] or “NOW” getSystemTimeDisplays the current system time. inParam[

Command Reference 53getSystemTimezoneCurrentCountryDisplays the current time zone country. inParam[0] = Time zone name outParam[0] = Time zone countr

54 Command ReferenceEmail SettingsThe HP NAS 8000 lets you automatically notify individuals via email if there is a hardware failure or a critical sys

Command Reference 55getSystemUIDEmailAddressReturns the email address for the user with the specified ID. inParam[0] = UID outParam[0] = Email addres

56 Command ReferencegetSystemLogEntrySeverityReturns the severity level associated with the specified log entry. inParam[0] = Log entry handle outPar

Command Reference 57getSystemSyslogServerNameReturns the name of the remote syslog server. outParam[0] = Syslog server name setSystemSyslogServerNameD

4OverviewUsing the Command Line InterfaceTo access the NAS 8000 command line interface, you must first log in to the NAS server using a serial connect

58 Command ReferencegetSystemUpsTitleReturns the system title of the specified UPS. inParam[0] = Name of UPS outParam[0] = Title of UPS General Syste

Command Reference 59getSystemShortProductNameReturns the short version of the product name. outParam[0] = Short product name getSystemUptimeReturns th

60 Command ReferenceSoftware Module SettingsYou can enable/disable the following software modules for use with the HP NAS 8000: Data snapshots Virus

Command Reference 61getSystemPackageVersionReturns the version of the specified add-on software module. inParam[0] = Package name outParam[0] = Packa

62 Command ReferenceUser and Group SettingsThe following commands allow you to map users of the Server Message Block Protocol/Common Internet File Sys

Command Reference 63getSystemWindowsUserNamesFromDomainListReturns a list of users’ Windows IDs for users on the specified Windows domain. inParam[0]

64 Command ReferenceUser and Group Quota SettingsQuotas allow you to restrict the space usage on the HP NAS 8000 for both users and groups. You also c

Command Reference 65setSystemUserQuotaSets the quota settings for the specified user on the specified file volume. inParam[0] = User name inParam[1]

66 Command ReferenceHigh Availability Cluster SettingsThe following commands let you create and control a high-availability cluster. setSystemHostsFil

Command Reference 67stopClusterNodeTakes a node out of the cluster and transfers all it’s running packages to an alternate node. InParam[0] = Node nam

Overview 5Command SyntaxTo execute text commands, execute the commands at the command prompt as shown in the following sections, where: % represents t

68 Command ReferencegetClusterHeartbeatNetworkCardListGets the list of network card interfaces used for heartbeats as they are stored in the registry.

Command Reference 69setClusterAutoStartTimeoutStores the timeout in the registry. (How long to wait, in seconds, before timeout occurs.) InParam[0] =

70 Command ReferenceCluster Package CommandsThe following commands let you configure and control failover packages.addClusterPackageCreates a default

Command Reference 71failbackClusterPackagStops the package on the current node and starts it up on the Primary owning node. InParam[0] = Package names

72 Command ReferencesetClusterPackageVirtualIpAddressListRequired. Sets the given VirtualIpAddress/Subnet list for the given package. InParam[0] = Pac

Command Reference 73getClusterPackageAutoRunGets from the registry, value of AutoRun for this package. InParam[0] = Package name OutParam[0] = T or Fs

74 Command ReferencesetClusterPackageServiceHaltTimeoutSets in the registry, the ServiceHaltTimeout value for the given package. The default is 30 sec

Command Reference 75setClusterNetworkSmbWinsServerAddressExecutes setNetworkSmbWinsServerAddresssetNetworkSmbWinsServerAddresssetNetworkSmbWinsServerA

76 Command ReferencesetClusterNetworkNisDomainNameExecutes setNetworkNisDomainNamesetNetworkNisDomainNamesetNetworkNisDomainNamesetNetworkNisDomainNam

Command Reference 77importClusterSystemPasswdFileExecutes importSystemPasswdFileimportSystemPasswdFileimportSystemPasswdFileimportSystemPasswdFile on

6OverviewScriptingThe HP NAS 8000 text command interface is based on Tcl 8.0 (http://www.scriptics.cXom/software/tcltk/8.0.html), which allows for pow

78 Command ReferencesetClusterSystemLocalAdminContactEmailExecutes setSystemLocalAdminContactEmail setSystemLocalAdminContactEmail setSystemLocalAdmin

Command Reference 79Disaster RecoveryDisaster can occur if the NAS head, storage array, or multiple devices are destroyed, or sustain critical hardwar

80 Command ReferenceBoot Partition SettingsUse the following commands when you install a new version of the NAS OS or perform disaster recovery operat

iAaddClusterPackage 70addClusterSystemNtpServer 75addStorageDasdScsiVa7xxxLun 24addStorageShare 37addStorageVolumeFile 33addStorageVolumegroup 2

iigetClusterPackageVolumegroupList 72getClusterQsHost 67getClusterQsPollingInterval 68getClusterStatus 67getNetworkCardBondActiveSlaveList 12getN

iiigetStorageDasdScsiVa7xxxRedundancygroupMinimumNumber 22getStorageDasdScsiVa7xxxRedundantCapacity 23getStorageDasdScsiVa7xxxTotalCapacity 22getSt

ivgetSystemShortProductName 59getSystemSyslogServerName 57getSystemTime 52getSystemTimestamp 51getSystemTimezoneCurrentCountry 53getSystemTimezon

vsetClusterPackageEnabled 71setClusterPackageFailbackPolicy 72setClusterPackageFailoverPolicy 72setClusterPackageNodeFailFastEnabled 73setClusterP

viSimple Mail Transfer Protocol 54Simple Network Management Protocol 15SMTP 54snapshotsusing 34SNMP 15startCluster 66, 67startClusterNode 66st

Command Reference 7Command ReferenceNetwork Card SettingsThe HP NAS 8000 has one Network Interface Card (NIC) port on the motherboard and supports two