HP ProLiant Network Adapter Scripting Utility User Guide Abstract This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels.
© Copyright 2008, 2013 Hewlett-Packard Development Company, L.P. 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. Confidential computer software.
Contents Overview ..................................................................................................................................... 4 Network Configuration Utility and Scripting .................................................................................................. 4 Scripting functionality ................................................................................................................................ 4 Scripting ...............................................
Overview Network Configuration Utility and Scripting 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 Preliminary scripting information When using scripting to configure target systems, adapters are identified by their relative order in the system. The relative order is determined by the following properties.
• Some properties are not configurable if an adapter has FlexNIC enabled. Teams on target systems The target system is configured with the same number of teams that were present on the source server. • Teams are created on the target system consisting of the same relative adapters that were teamed on the source server. For example, if adapters 3 and 5 were teamed on the source server, then that teaming information is saved in the data file, and adapters 3 and 5 are teamed on the target system.
• If the properties of the server adapters are not supported by all team members, those properties may be disabled for all the adapters in the team. The NCU displays a message listing the properties that have been disabled. iSCSI limitations for creating teams • The following team types are not supported for iSCSI-enabled adapters. Disable iSCSI on the adapter or team before changing to any of the incompatible team types. o Automatic o 802.
cqniccmd /c For target MAC based team member assignment on Windows 2008 only, run the Command Line utility with the following syntax: cqniccmd /M 6. Check the log file for errors and warnings. The default location of the log file is \cpqsystem\log\cpqteam.log on the system drive. To use the utility with the SSST, see the documentation included with SSST on the HP website (http://h18013.www1.hp.com/products/servers/management/toolkit/index.html).
Argument Description /L 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. /F This option causes all errors, including those errors normally treated as non-fatal errors, to be treated as fatal errors.
Configuration properties Adapter configuration properties for Windows Server 2008 The following properties are configured on the target server adapters from the source server data. Each adapter property displays only if the property is supported by the selected adapter. • PriorityVLANTag—Enables or disables the ability to insert or remove the 802.1q tags for priority and VLAN.
that is receiving the PAUSE frame will momentarily stop transmitting. The default setting Auto is recommended. • CPUSaver—Minimizes power consumption by enabling the adapter to enter a deep sleep mode under certain conditions. • NumCoalesce—Coalesce Buffers reduce the number of DMA operations per transfer by combining small fragments into a single buffer. • NumRfd—Number of Receive Descriptors determine how many resources are allocated to receive packets.
the driver adjusts the adapter's interrupt setting to achieve that DPC rate. Changing this setting may improve performance for some configurations. • EnablePME—Allows the use of power management and wake-up functions. • SmartPowerDown—Minimizes power consumption by enabling the adapter to enter a deep sleep mode under certain conditions. • DefaultVlanId—Determines the VLAN ID used for any un-tagged packets received by the adapter. This only applies to adapters that have VLANs defined.
• IPChecksumOffloadIPv4 describes whether the device enabled or disabled the calculation of IPv4 checksums. • IPChecksumOffloadIPv6 describes whether the device enabled or disabled the calculation of IPv6 checksums. • UDPChecksumOffloadIPv4 describes whether the device enabled or disabled the calculation of UDP checksum over IPv4 packets. • UDPChecksumOffloadIPv6 describes whether the device enabled or disabled the calculation of UDP checksum over IPv6 packets.
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: • —Brackets the entire data file and is required. • —Defines adapter properties. • —Defines teams and their properties. • —Defines VLANs and their properties. The relnics attribute of the element lists the adapters that are to be configured on the team.
PAGE 16- - PAGE 17Error 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. When invalid property values are detected, a WARNING error message is written to a log file and configuration continues with either default or existing values.
Acronyms and abbreviations DHCP Dynamic Host Configuration Protocol iSCSI Internet Small Computer System Interface MAC Media Access Control NCU Network Configuration Utility NFT network fault tolerant RSS Receive-Side Scaling SLB switch-assisted load balancing SSST SmartStart Scripting Toolkit TLB transmit load balancing TOE TCP/IP Offload Engine VLAN virtual local-area network XML extensible markup language Acronyms and abbreviations 18
Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (mailto:docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Index A P adapter order 5 arguments 8 priority and vlan 10 B bay numbering 5 C checksum offload 10 codes, return 17 command line options 8 CQNICCMD 7 D data file 8, 14 E error code 17 examples 9 F Flow Control 10 S script conversion 7 scripting application 4, 5, 7 scripting syntax 8 SmartStart Scripting Toolkit 7 T targets, discovering 5, 6 TCP/IP Offload Engine (TOE) 5 team configuration 5, 6, 12 team properties 5 teaming limitations 5, 6 TOE (TCP/IP Offload Engine) 5, 17 W Wake Up Capabilities