HP Networking Utilities User Guide HP Integrity Servers with Microsoft® Windows® Server 2003 for Itanium-based systems Manufacturing Part Number: 5991-3711 February 2007 © Copyright 2007 Hewlett-Packard Development Company, L.P.
Legal notices © Copyright 2007 Hewlett-Packard Development Company, L.P Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. Intel and Itanium are registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided “as is” without warranty of any kind and is subject to change without notice.
Contents 1. Replicate Agent Settings tool Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Tool usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Viewing Task Results page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents iv
1 Chapter 1 Replicate Agent Settings tool 5
Replicate Agent Settings tool Overview Overview The HP Network Configuration Utility (NCU) enables configuration of network adapters and teams of network adapters installed on an Integrity server. To better support server management, the NCU has been enhanced using the Replicate Agent Settings tool of HP Systems Insight Manager (HP SIM).
Replicate Agent Settings tool Overview If there are no teams configured on the source server, no teaming information is transferred, and configuration of the target system consist of configuring individual NICs only. If the transferred information defines an advanced team, but a valid Integrity Essentials Intelligent Networking Pack license is not on the target system, an error message is returned and the operation exits without performing any actions.
Replicate Agent Settings tool Tool usage Tool usage To replicate network configuration settings from source server to target server: Step 1. From the HP SIM home page, select All Systems to display all servers in the All Systems window. Figure 1-1 All Systems window Step 2. Select the desired target systems from the list. Step 3. Select Configure > Replicate Agent Settings from the menu, and the “Step 1: Verify Target Systems” page displays with the selected targets listed.
Replicate Agent Settings tool Tool usage Step 4. Click Next. The “Step 2: Choose Source System” displays. Figure 1-3 Step 2: Choose Source System window Step 5. Select the specific server with a configured network to replicate on the target servers (the Web Agent that supports network configuration is the one labeled “HP Network Configuration Utility”). Step 6. Click Next. The “Step 3: Choose Source Configuration Settings” page appears.
Replicate Agent Settings tool Tool usage An overview of the networking configuration provides the following information: • Teams — number of teams in the configuration • Team VLANs — total number of team VLANs defined (multiple teams can use the same VLAN) • Adapters — total number of adapters in the configuration • Adapter VLANs — total number of adapter VLANs defined (multiple adapters can use the same VLAN) • Version — version of the teaming utility NOTE Currently, the edit function is not operational f
Replicate Agent Settings tool Tool usage Viewing Task Results page The Task Results page displays the task instance results of each targeted server. Figure 1-5 Task Results page Status information messages indicate the success or failure of the configuration and may include one of the following messages: Table 1-1 Status information messages Status Message Agent Configured Successfully Network Configuration — Agent Configured Successfully.
Replicate Agent Settings tool Tool usage 12 Chapter 1
2 Chapter 2 Network Adapter License Utility 13
Network Adapter License Utility Overview Overview Use the Network Adapter License Utility for Windows® (nalicense) to add an Integrity Essentials Intelligent Networking Pack to the system, or display licenses previously installed on the system. This utility is a Windows-based command line utility and can be run at the command line of a Command Prompt window or from a Windows command file.
Network Adapter License Utility Tool usage Tool usage The nalicense command determines if a license is a valid Integrity Essentials Intelligent Networking Pack license, and if it is valid, adds it to the system. It then writes the results to a default log file (nalicense.log) in the %SystemRoot%\cpqsystem\log directory. All messages, whether successful or error, are written both to the stdout/stderr and to the log file. Each time you run the utility the log file is appended with a date and time stamp.
Network Adapter License Utility Tool usage Table 2-1 nalicense command line arguments (Continued) Argument Function /help Displays utility usage (optional). /M Prints license information in a format capable of being parsed by machine (optional). Return codes The following return codes may display: Table 2-2 nalicense return codes Code Description 0 Success. 1 Duplicate license exists. 2 Invalid Integrity Essentials Intelligent Networking Pack license.
Network Adapter License Utility Tool usage What it does: Displays all valid licenses on the system and upon successful operation writes the following example message to both stdout and to the license.txt file located in the same directory as nalicense.
Network Adapter License Utility Tool usage 18 Chapter 2
3 Chapter 3 SetLACState Utility 19
SetLACState Utility Overview Overview If a server contains more than one server adapter and at least one of those adapters is not connected, the server may display as failed on some network management consoles, and SNMP traps may also be triggered. Use the SetLACState utility (SetLACState) to disable the Local Area Connection containing the unused adapter. This stops the server from displaying as failed and prevents the SNMP traps also.
SetLACState Utility Tool usage Tool usage The SetLACState utility can be run from the command prompt or it can be used during RDP installations. It can also be added to the [GuiRunOnce] section of unattend.txt for use in unattended installations.
SetLACState Utility Tool usage Example #2: SetLACState “Local Area Connection 2” disable What they do: Both of these commands will disable Local Area Connection 2. NOTE Specifying “Enable” for a connection that is already enabled, or “Disable” for a connection that is already disabled, will not generate an error.
4 Chapter 4 Network Adapter Scripting Utility 23
Network Adapter Scripting Utility Overview Overview Use the Network Configuration Utility to configure network adapters (NICs) and teams of network adapters. The utility’s scripting feature lets you do this using a batch process. The scripting functionality also lets you configure target systems based on configuration information saved from a source server.
Network Adapter Scripting Utility Introduction Introduction When using scripting to configure the target systems, NICs are identified by their relative order in the system. The relative order is determined by the slot and port order in the system. NICs on the system board are assigned the lowest numbers, followed by the remaining NICs that are ordered from lowest slot number to highest. Multi-ported NICs are ordered by ascending port number within each slot.
Network Adapter Scripting Utility Introduction • If the data file defines an advanced team, but a valid HP Integrity Essentials Intelligent Networking Pack license is not installed on the target system, an error message is written to the log and the script exits without performing any actions.
Network Adapter Scripting Utility The scripting application (CQNICCMD) The scripting application (CQNICCMD) CQNICCMD is a Windows Server 2003 utility that uses a script file to duplicate the NIC teaming configuration information of one Integrity source server and copy it to another Integrity target server. Script conversion issues Scripts created with earlier versions of the Network Configuration Utility (NCU) are supported.
Network Adapter Scripting Utility The scripting application (CQNICCMD) NOTE If you want to use this tool in combination with the Smart Setup Scripting Toolkit (SSSTK), see the SSSTK documentation found on your Smart Setup CD. Command line syntax Use the following format at the command line: cqniccmd [/F] [/C] [/D] [/L] [/P] [/S] [/?] NOTE Only one of the following configuration options can be specified at a time: /S, /D, /C, or /P.
Network Adapter Scripting Utility The scripting application (CQNICCMD) Table 4-1 cqniccmd command line arguments (Continued) Argument Function /L This option is 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 causes the configuration to terminate with no changes. HP recommends this option only in batch files.
Network Adapter Scripting Utility The scripting application (CQNICCMD) Command line help Use the following option to display usage information: c/? For example: cqniccmd /? displays detailed usage information for the command.
Network Adapter Scripting Utility Configuration properties Configuration properties The XML data file contains configuration properties for individual NICs and NIC teams. NIC configuration properties The properties configured on the target server NICs from the source server data are properties that are common to all HP NICs. These properties include: • SpeedDuplex — determines the current speed and duplex of the NIC. Possible values include Auto/Auto, 10/Half, 10/Full, 100/Half, 100/Full, 1000/Full.
Network Adapter Scripting Utility Configuration properties target system for advanced teaming options to be configured on the target server. If a valid license does not exist, an error message is written to the log and the script exits without performing any actions. • LoadBalAlgorithm — determines the team load balancing algorithm. Possible values are MACAddress, IPAddress, TCPConnection, RoundRobin, and Auto. • TeamNetworkAddress — establishes the MAC address for the NIC team.
Network Adapter Scripting Utility Configuration properties written to the log and the script exits without performing any actions. The following values are written only when the ActivePathEnabled option is used: — EchoNodeResponseMech — determines which echo node response mechanism to use: DirectedARP or CommunityAddressARP. If CommunityAddressARP is chosen, Community Probe IP Address, Community Probe MAC Address, and Use Default fields are used.
Network Adapter Scripting Utility Configuration properties • RouterPathIPAddress — determines the IP address for the router path. This option is written only if RouterPathEnabled is enabled. • RouterPathVlanID — determines the Vlan ID used for the router path validation. This option is written only if a VLAN is defined for the team. RouterPathVlanID is relevant only when RouterPathEnabled is Enabled. • CDPv1Enabled — enables or disables the CDPv1 discovery protocol feature.
Network Adapter Scripting Utility XML data file XML data file The XML data file contains the configuration properties for NICs and teams and consists of the following XML elements: • — brackets the entire data file and is required • — defines NIC properties • — defines teams and their properties • — defines VLANs and their properties The “relnics” attribute of the element lists the NICs to be configured on the team.
Network Adapter Scripting Utility XML data file
