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.
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...
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.
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.
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).
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.
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.
/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>] [/?]...
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. •...
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...
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. •...
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.