HP 289166-40B User Manual
HP 289166-40B User Manual

HP 289166-40B User Manual

Hewlett-packard proliant network adapter user guide

Advertisement

Quick Links

HP ProLiant Network Adapter Scripting Utility
User Guide
Part Number 289166-40B
March 2008 (Twentieth Edition)

Advertisement

Table of Contents
loading

Summary of Contents for HP 289166-40B

  • Page 1 HP ProLiant Network Adapter Scripting Utility User Guide Part Number 289166-40B March 2008 (Twentieth Edition)
  • Page 2 The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
  • Page 3: Table Of Contents

    Command line examples ... 8 Command line help ... 9 Configuration properties ... 10 Adapter configuration properties ... 10 HP Multifunction adapter properties ... 10 Team configuration properties... 12 XML data file... 14 XML elements and typical adapter teaming script ... 14 Error handling and reporting...
  • Page 4: Overview

    The HP Network Configuration Utility (NCU) enables configuration of network adapters and teams of network adapters. The scripting feature of the utility provides the ability to perform adapter configuration using a batch process. This guide provides information about using the HP Network Adapter Scripting Utility to configure HP adapters. Scripting functionality Scripting functionality provides the capability to configure a target system based on configuration information saved from a source server.
  • Page 5: Scripting

    Slot and port order for adapters in non-HP BladeSystem configurations • Enclosure switch bay number and switch port order for adapters in HP BladeSystem configurations Adapters embedded on the system board are assigned the lowest numbers, followed by adapters ordered by their slot or switch bay number with the lowest slot or switch bay number first.
  • Page 6: Script Conversion

    Scrip t conversion Scripts created with previous versions of the NCU are supported; however, HP recreate the script using the latest version of the NCU. Several oper NCU versions 7.7x and earlier have changed and are converted as follows: ows Server 2003 x64 (SP1).
  • Page 7: Scripting Application (Cqniccmd)

    Configure adapter teaming on the s Generate a script file on the source server by clicking Save in the HP NCU user interface or running CQNICCMD /S<filename> in the Command Line utility. Modify the script file as necessary.
  • Page 8: Command Line Arguments

    This option can be used to change the name and location of the cpqteam.log default log file that is created in \cpqsystem\log on the system drive. The supplied path must exist. An invalid log file name will cause the configuration to terminate with no changes. HP recommends this option only in batch files.
  • Page 9: Command Line Help

    /Cc:\HP\teamcfg.xml /Lc: cqniccmd /C c:\HP\teamcfg.xml /L c cqniccmd /C"c:\HP\teamcfg.xml" /L" c:\HP\config.log" cqniccmd /F /C c:\HP\teamcfg.xml Command line help The f ollowing option c an be used to display usage information. For e xample: cqniccmd /? Usage: cqniccmd [[/F] /C<filename>] [/D] [/L<filename>] [/ [/S<filename>] [/?]...
  • Page 10: Configuration Properties

    This value must be a valid unicast address if it is edited. HP Multifunction adapter properties The following properties are common only to HP Multifunction adapters. To transfer iSCSI, TCP/IP Offload Engine (TOE), and Receive-Side Scaling (RSS) parameters on an...
  • Page 11 • iSCSIPacketPriority—Specifies the QoS Packet Priority for the iSCSI enabled device. Possible v are D=Disabled and 1-7. The default setting is D (Disabled). • iSCSIDHCPEnabled—Specifies that DHCP is used to acquire an IP configuration for the iSCSI enabled device. Possible settings are Enabled and Disabled. The default setting is Enabled. •...
  • Page 12: Team Configuration Properties

    x64 (SP1), download SNP and required Microsoft hotfixes and install them on the system. See the Microsoft (http://www.microsoft.com) website to download the latest version of the Microsoft Windows Server 2003 Scalable Networking Pack (SNP) and required Microsoft Windows Server 2003 (SP1) hotfixes in article numbers 921136, 919 Base (KB).
  • Page 13 HP Multifunction Server Adapters. 0=Disabled. 1=Enabled. The default setting is Enabled. TOE teaming performance is reduced if a switch or network device is configured with the round robin aggregation load balancing method. Configure the aggregation load balancing method on...
  • Page 14: Xml Data File

    XML data file XML elements and typical adapter teaming script The XML data file contains configuration properties for adapters and teams and consists of the following XML elements: • <teamingconfig>-Brackets the entire data file and is required. • <nic>-Defines adapter properties. •...
  • Page 15 <property id="iSCSIEnabled" value="1" /> <property id="PreferredPrimaryRanking" value="0" /> <property id="DualChannelGroup" value="0" /> <property id="ConfiguredPortCost" value=" <property id="TOEEnabled" value="1" /> <property id="RSSEnabled" value="1" /> <property id="iSCSIVlanId" value="0" /> <property id="iSCSIVlanName" value="" /> <property id="iSCSIPacketPriority" value="Disabled" / <property id="iSCSIDHCPEnabled" value="Enabled" /> <property id="iSCSIIPAddress" value="0.0.0.0" /> <property id="iSCSISubnetMask"...
  • Page 16 - <!-- --> - <!-- <team> element 1 --> - <team relnics="2 7"> <property id="TeamName" value="HP Network Team #1" /> <property id="OpMode" value="TransmitLoadBalancing <property id="LoadBalAlgorithm" value="Auto" /> <property id="RxPathValidationInterval" value="3" /> <property id="TxPathValidationInterval" value="3" /> <property id="RxPathValidationMode" value="Enabled" /> <property id="TxPathValidationMode" value="Enabl <property id="TeamNetworkAddress"...
  • Page 17: Error Handling And Reporting

    Error handling and reporting Error checking and completion code Errors can occur for a variety of reasons including differences between the source and target system NICs or because of errors introduced by editing the XML data file. The software performs extensive error checking as the XML data file is read and processed.
  • Page 18: Acronyms And Abbreviations

    Acronyms and abbreviations iSCSI Internet Small Computer System Interface Network Configuration Utility network fault tolerant Receive-Side Scaling TCP/IP Offload Engine VLAN virtual local-area network extensible markup language Acronyms and abbreviations 18...
  • Page 19: Index

    Index adapter properties 10 command line options 8 CQNICCMD 7 error code 17 examples 8 log file 17 overview of configuration procedure 5 Receive-Side Scaling (RSS) 5, 10, 12 RSS (Receive-Side Scaling) 5, 10, 12 script conversion 6 scripting application 7 scripting syntax 7 TCP/IP Offload Engine (TOE) 5, 10, 12 team configuration 12...

Table of Contents