==========================
R E L E A S E N O T E S
==========================
Broadcom BASP Silent Configuration Program
Copyright (c) 2003-2004 Broadcom Corporation
All rights reserved.
October 07, 2004
Introduction
============
Broadcom BASP Silent Configuration is a Win32 console application that allows
end users to configure team(s), VLAN(s) and static IP address for team(s) and VLAN(s)
from command line or a input file. This application requires the BASP driver and BMAPI to be installed.
The following command can be used to install the Control Suite and BASP silently or it can be added to a batch file for automation. The installer can be found in the Management applications folder on the CD.
msiexec /i BMP.msi /qn ADDSOURCE=BACSi32,BASPi32
Broadcom BASP Silent Configuration runs under Windows 2000, XP32, Windows .NET32,
and Windows .NET64.
Installation
============
1. Copy BASFND.SYS to your windows\system32\drivers directory.
2. Copy BMAPI.DLL to your windows\system32 directory.
Note
====
At least one of the team members MUST have link as Microsoft WMI is used to set the static IP address
and requires link.
Usage:
-----
BaspSCfg {[-file CFG_file] |
[-restore file_path_name] |
[-remove [team_name]] |
[-save file_path_name -nicid MACADDR|PCIINFO] |
[-name team_name [-type team_type] [PHY_NIC_SEL]
[-snic MAC_address|bus:dev.func] [IP_CFG|VLAN_CFG]] |
[-help|-?]}
{}: The parameter must exist
[]: Optional option
-file CFG_file: CFG_file is the input configuration file name.
-restore file_path_name:Restore the configuration from the
parameter file_path_name.
-remove [team_name]: Remove a team specified by the parameter
team_name. If team_name is not specified then
all team(s) will be removed.
-save file_path_name -nicid MACADDR|PCIINFO:
Save the current configuration to the
parameter file_path_name. MACADDR and PCIINFO
simply tells BASPSCfg to save the NIC ID by
MAC address or PCI bus information. The NIC
identification of a NIC will be saved in the
format of MAC address (as MAC_Address) or PCI
bus number (as bus:dev.func). The format is
“%02u:%02u.%01u” as shown in linux lspci.
The IP settings will not save if DHCP is enabled.
-name team_name: team_name is name of the team.
-type team_type: team_type is type of the team. Default is 0.
0: Smart Load Balance and Fail Over.
1: Generic Trunking (FEC/GEC).
2: Link Aggregation (802.3ad).
4: SLB (Auto-Fallback Disable).
PHY_NIC_SEL: -pnic MAC_address|bus:dev.func [PHY_NIC_SEL]
-pnic: Specify primary NIC by using MAC
address or PCI bus number, device, and
function number.
MAC_address: a 12 digit hex string for MAC
address
bus:dev.func: bus is pci bus number, dev is
pci device number and func is pci function
number.
IP_CFG: IP_ADDR [GATE_ADDR] [DNS_ADDR] [WNS_ADDR]
IP_ADDR: -ip IP_address -smask subnetmask [IP_ADDR]
GATE_ADDR: -gw gateway_IP_address [GATE_ADDR]
DNS_ADDR: -dns DNS_IP_address [DNS_ADDR]
WNS_ADDR: -wsp Primary_WINS_Server_IP_address
[-wss Secondary_WINS_Server_IP_address]
VLAN_CFG: -vname VLAN_name -vid VLAN_id [IP_CFG] [VLAN_CFG]
VLAN_name: VLAN_name is name of VLAN.
VLAN_id: VLAN_id is the ID of VLAN and must be
between 0 and 4094.
-help: Print the usage.
-?: Print the usage.
‘PHY_NIC_SEL’ option allows selection of multiple physical network adapters.
‘-pnic’ option is for load balance adapters and ‘-snic’ is for standby adapter.
Each Load Balance team allows only one standby adapter. FEC/GEC or 802.3ad team
cannot have a standby adapter.
When ‘IP_CFG’ is specified, user MUST set both IP and subnet mask or it will be ignored.
At least one of the team members MUST have link as WMI is used to set the static IP
address and requires link.
‘VLAN_CFG’ option allows configuration for multiple VLANs. Each ‘-vname’ MUST couple
with ‘-vid’ or the VLAN configuration will be ignored.
The default behavior of ‘BaspSCfg.exe’ (without any options) will grab all ‘teamable’
physical network adapters into a Smart Load Balancing (SLB) team without VLAN configured
and the virtual adapter of the team will use DHCP. A NIC is ‘teamable’ or not will
depend on the specific OEM. The default team name will be “SLBTeam”.
If the -pnic option is omitted then BaspSCfg.exe will also grab all ‘teamable’ physical
network adapters into a new team.
Examples:
BaspSCfg will create a default Load Balance SLBTeam with all ‘teamable’ physical
network adapters and configure SLBTeam with DHCP.
BaspSCfg -name FGTeam -type 1 -pnic 00101801794D
will create a FEC/GEC FGTeam with one load balance physical adapter.
BaspSCfg -name BRCMTeam -pnic 00101801794D -snic 001018 -vname VLAN100 -vid 100
-vname VLAN200 -vid 200 will create a Load Balance BRCMTeam with two VLANs and
configure VLAN100 and VLAN200 with DHCP.
BaspSCfg -name BRCMTeam -pnic 00101801794D -snic 001018 -vname VLAN100 -vid 100
-ip 172.16.8.100 -smask 255.255.255.0 -vname VLAN200 -vid 200 -ip 172.16.8.200
-smask 255.255.255.0 will create a Load Balance BRCMTeam with two VLANs and
configure VLAN100 and VLAN200 with static IP address and subnet mask.
BaspSCfg -file TeamConfig.txt will create team(s) from the input TeamConfig.txt
configuration file.
Configuration File:
------------------
The syntax plain text file is defined as following.
TEAM_CFG
[TEAM_CFG]
...
Each ‘TEAM_CFG’ is defined as following.
name: team_name
[type: team_type]
pnic: MAC_address
[pnic: MAC_address
...]
[snic: MAC_address]
[[ip: IP_address
smask: subnetmask]
|[vname: VLAN_name
vid: VLAN_ID
[ip: IP_address
smask: subnetmask]]
...]
A configuration file MUST contain at least one team configuration.
‘BaspSCfg.exe’ will recognize ‘name’ as starting point of a team configuration section.
All lines after ‘name’ will apply to the ‘team_name’ till another ‘name’ or end of file.
Each team configuration MUST contain at least one physical network adapter or the
configuration of the team will be ignored.
If ‘type’ is missing, the default is set to Smart Load Balancing (SLB).
If ‘ip’ is set, ‘smask’ must also be set or ‘ip’ will be ignored. If ‘ip’ is not set,
DHCP will be used.
Team IP can be set if no VLAN are configured. If any VLAN is configured, the team IP
will be ignored. Multiple VLAN configurations are allowed. Each VLAN configuration
allows an optional static IP information. Each IP MUST be couple with ‘smask’ or will
be ignored.
Please note that there must at least one white space or tab between the tag (‘name’, ‘pnic’, etc.)
and the value pair (‘team_name’, ‘MAC_address’, etc.) in each line.
Example:
A sample of the TeamConfig.txt configuration file:
name: BRCMTeam
type: 1
pnic: 00101801794D
pnic: 001018040a04
vname: VLAN2
vid: 2
vname: VLAN3
vid: 3
ip: 172.16.8.3
smask: 255.255.255.0
vname: VLAN4
vid: 4
ip: 172.16.8.4
smask: 255.255.255.0
vname: VLAN5
vid: 5
ip: 172.16.8.5
smask: 255.255.255.0
Exit Codes:
----------
BASPSCFG_NO_ERROR 0 // No error
ERROR_NOT_SUPPORTED_OS 500 // Not supported OS
ERROR_CANNOT_ALLOC_MEM 501 // Cannot allocate memory
ERROR_TEAM_NO_MEMBER 502 // Team has no member
ERROR_EXCEED_NUMBER_OF_TEAM_ALLOW 503 // Cannot create more than one team from command line
ERROR_EXCEEDMAXVLAN 504 // Cannot create more than 64 VLANs
ERROR_CANNOT_OPEN_FILE 505 // Cannot open the input file
ERROR_NO_TEAM_TO_CONFIG 506 // No team to configure
ERROR_BASP_NOT_INSTALL 507 // BASP is not installed and cannot create any team
ERROR_CANNOT_SET_IPADDR 508 // Cannot set static IP Address
ERROR_WRONG_OPTION_FLAG 509 // Wrong option flag
ERROR_CANNOT_CREATE_FECGEC_8023AD 510 // Cannot create FECGEC or 802.3ad with a standby adapter
ERROR_ONLY_BROADCOM_NIC_FOR_VLAN 511 // Only Broadcom certified adapters are supported in VLAN
ERROR_DUPLICATE_MAC_ADDRESS 512 // Duplicate adapter physical MAC address
ERROR_INVALID_TEAM_NAME 513 // & is not a legal character for the team name
ERROR_TEAM_ALREADY_EXISTED 514 // Team already exists, please use a different team name
ERROR_CANNOT_MATCH_MAC_ADDR 515 // Cannot match the MAC Address
ERROR_DUPLICATE_VLANID 516 // Duplicate VLAN ID
ERROR_TEAM_NOT_FOUND 517 // Team not found, please use a different team name
ERROR_CANNOT_INIT_BMAPI 550 // Cannot initialize BMAPI
ERROR_CANNOT_CHECK_BASP_STATUS 551 // Cannot check BASP status
ERROR_CANNOT_GET_ALL_UNASG_NIC_DATA 552 // Cannot get all unassigned adapters data
ERROR_CANNOT_GET_NIC_PCI_INFO 553 // Cannot get adapter PCI information
ERROR_CANNOT_CREATE_TEAM 554 // Cannot create team
ERROR_CANNOT_GET_ALL_UNASG_NIC_NUM 555 // Cannot get all unassigned adapters number
ERROR_CANNOT_GET_ALL_CREATED_TEAM 556 // Cannot get all created teams
ERROR_WRONG_BMAPI_VERSION 557 // Wrong BMAPI version
ERROR_CANNOT_GET_NIC_INFO 558 // Cannot get physical NIC information
ERROR_CANNOT_REMOVE_TEAM 559 // Cannot remove team
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.