HP ProLiant Network Adapter Scripting Utility User Guide Part Number 289166-40B March 2008 (Twentieth Edition)
© Copyright 2006, 2008 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.
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, 919948, and 923187 of the Microsoft Knowledge Base (KB). These Microsoft hotfixes are required only for Windows Server 2003 (SP1) and Windows Server 2003 x64 (SP1).
• Manual is converted to Network Fault Tolerance Only (NFT). • SmartSwitch is converted to Network Fault Tolerance Only with Preference Order. • For Smart Switch Teams, the existing PreferredPrimaryNic attribute determines which team member should be more highly ranked than others within the PreferredPrimaryRanking attribute. All other unspecified parameters use their defaults.
/S /D /C /P The /L argument can be used with any of the configuration options. The /F argument can only be used with the /C configuration option. Command line arguments Argument Description /S This configuration option causes the source server configuration to be saved. The name of the XML configuration data file must be specified and the path to the data file must exist.
cqniccmd /Cc:\HP\teamcfg.xml /Lc:\HP\config.log cqniccmd /C c:\HP\teamcfg.xml /L c:\HP\config.log cqniccmd /C"c:\HP\teamcfg.xml" /L" c:\HP\config.log" /F cqniccmd /F /C c:\HP\teamcfg.xml Command line help The following option can be used to display usage information. /? For example: cqniccmd /? Usage: cqniccmd [[/F] /C] [/D] [/L] [/P] [/S] [/?] /C Configures the source server according to the specified filename. /D Dissolves all teams on the target server.
Configuration properties Adapter configuration properties The following properties are configured on the target server adapters from the source server data. Properties that are common to all HP adapters include: • SpeedDuplex—Determines the current speed and duplex of the adapter. Possible values include Auto/Auto, 10/Half, 10/Full, 100/Half, 100/Full, 1000/Full. The default is Auto/Auto. The value must be valid for the adapter on the target system.
• iSCSIPacketPriority—Specifies the QoS Packet Priority for the iSCSI enabled device. Possible values 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. • iSCSIIPAddress—If DHCP is not used, this specifies the IPv4 address (dotted decimal) for the iSCSI enabled device. If DHCP is enabled, the value is 0.0.0.
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, 919948, and 923187 of the Microsoft Knowledge Base (KB). These Microsoft hotfixes are required only for Windows Server 2003 (SP1) and Windows Server 2003 x64 (SP1).
only valid when all the team members are 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 the switch or network device to something else other than round robin and then re-start the team (disable the team and enable the team for all VLANs).
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--> - - -
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. 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 iSCSI Internet Small Computer System Interface NCU Network Configuration Utility NFT network fault tolerant RSS Receive-Side Scaling TOE TCP/IP Offload Engine VLAN virtual local-area network XML extensible markup language Acronyms and abbreviations 18
Index A adapter properties 10 C command line options 8 CQNICCMD 7 E error code 17 examples 8 L log file 17 O overview of configuration procedure 5 R Receive-Side Scaling (RSS) 5, 10, 12 RSS (Receive-Side Scaling) 5, 10, 12 S script conversion 6 scripting application 7 scripting syntax 7 T TCP/IP Offload Engine (TOE) 5, 10, 12 team configuration 12 team properties 12 TOE (TCP/IP Offload Engine) 5, 10, 12 X XML sample file 14 Index 19