background image

HP ProLiant Network Adapter Scripting Utility 
User Guide 

 

 

Part Number 289166-40B 

March 2008 (Twentieth Edition) 

 

Summary of Contents for 289166-40B

Page 1: ...HP ProLiant Network Adapter Scripting Utility User Guide Part Number 289166 40B March 2008 Twentieth Edition ...

Page 2: ...Valid license from HP required for possession use or copying Consistent with FAR 12 211 and 12 212 Commercial Computer Software Computer Software Documentation and Technical Data for Commercial Items are licensed to the U S Government under vendor s standard commercial license Microsoft Windows Windows Server 2003 and Windows Server 2008 are U S registered trademarks of Microsoft Corporation Audie...

Page 3: ...ne syntax 7 Command line arguments 8 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 17 Error checking and completion code 17 Acronyms and abbreviations 18 Index 19 Conten...

Page 4: ...provides the capability to configure a target system based on configuration information saved from a source server The target system is not required to be identical to the source server The configuration of the source server may not be duplicated in its entirety on the target system Both adapters and teams of adapters can be configured on the target system When scripting is run the adapter propert...

Page 5: ... then the extra adapters retain their current settings If the target system has fewer adapters than the source server data for additional adapters on the source server is ignored HP Multifunction adapters on target systems eive Side Scaling RSS parameters on an HP ltifu n adapter must be located in the same relative position on the target server as on the ameters are assigned to an adapter that do...

Page 6: ...pts generated with SP1 and Windows Server 2003 x64 SP1 To ansfer the RSS parameter on one of these adapters the following conditions apply The ada server If the RSS parameter is assigned to an adapter that does not support RSS it is ignored If an adapter sup left unchanged Teams on target systems The target system is configured with the same number of teams that were present on the source server T...

Page 7: ...r 2008 x64 Editions Windows Server 2003 Windows Server 2003 x64 Editions Run the utility from the command line in a Command Prompt window from the Run option on th Windows Start menu or from a Windows command file To execute the CQNICCMD utility from the command line the HP Network HP recommends that you use this application as part of deployment However the application can be used outside of this...

Page 8: ... space following the switch is optional Any teams that exist on the targe will be dissolved before the configuration is applied all VLANs will be removed and 802 1p q Packet Tagging will be disabled P r syntax checking the XML data file This option is identical to the C option except that the configuration options are not applied to the target system This is useful fo L This option can be used to ...

Page 9: ...ename cqniccmd Cc teamcfg xml To apply a script and specify the logfile location cqniccmd Cc teamcfg xml Lc logs teamcfg log F cqniccmd F C c HP teamcfg xml ollowing option c xample cqniccmd Usage cqniccmd F C filename D L filename S filename C Configures the source server according to the specified filename D Dissolves all teams on the target server F Causes all errors to be treated as fatal erro...

Page 10: ...VLan d le network address is the burned in address This value must be a valid unicast address if it is edited e adapter must be located in the same relative position on the target machine as on the source e multifunction parameters but the parameters are not assigned the ured for the led device IDs NetworkAddress This value is written only for adapters that are not teamed It overrides the burne in...

Page 11: ...s Server 2003 SP2 iSCSI cannot be enabled Windows Se 2008 and Windows Server 2008 x64 comes with the iSCSI Initiator included TOEEnabled Enables the offloading of TCP connections to the Multifunction Server Adapter Microsoft Scalable Networking Pack SNP is required when enabling TOE and is included on systems running Windows Server 2003 SP2 or Windows Server 2003 x64 SP2 SNP also is supported but ...

Page 12: ...are Enabled or Disabled RxPathV adapters Possible values are Enabled or Disabled TxPathValidationInterval Determines how frequently the packet signals are transmitted The range of ac to 60 RxPathValidationInterval Determines how frequently the packet signals are received The range of acceptable values is 3 to 60 Values less than 3 are set to 3 and values greater than 60 are set to 60 RxPathValidat...

Page 13: ... 10 GbE adapters the switch or network device to something else other than ro disable the team and enable the team for all VLANs TOE and RSS teaming are not supported on Windows Server 2008 and Windows Server 2008 x64 in this release Currently not supported on HP NC51xx 10 GbE adapters RSSEnabled Enables the receive processing of networking traffic to be load balanced across teamed adapters Micros...

Page 14: ... the adapters that are to be configured on the team The following example is a typical adapter teaming script 1 0 encoding ISO 8859 1 xml version teamingconfig The comment lines in this file make it convenient to reference nic team and vlan elements within the file It is recommended that these comment lines remain unchanged if the user edits the file Version Data 0 7 ScriptVersion 3 1 version Util...

Page 15: ...nic nic element 3 nic property id SpeedDuplex value 100 Full propert nic nic element 4 nic property id SpeedDuplex value 100 Full propert nic nic element 5 nic property id SpeedDuplex value Auto Auto propert nic nic element 6 nic property id SpeedDuplex value Auto Auto propert nic nic element 7 nic property id SpeedDuplex value Auto Auto property id iSCSIEnabled value 0 property id PreferredPrimar...

Page 16: ...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 value property id TOEEnabled value 1 property team XML data file 16 ...

Page 17: ...m a command line or a Windows command file a completion code is written as an error level code to both a log file and the screen This error code can be used by the Windows command file to determine how to proceed The error level codes are as follows Successful start of the action returns a completion code of error level zero 0 Non fatal errors return a completion code of error level one 1 An inval...

Page 18: ...net 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 ...

Page 19: ...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 ...

Reviews: