Unattended Update

# Command line install for base driver and Intel® PROSet

Installation methods

Base driver installation

Intel PROSet installation

Msiexec.exe command line options

## Installation methods

The base driver install utility allows unattended install of base drivers from a command line (SetupBD.exe). And Intel PROSet installation is based on Microsoft* Windows Installer (MSI) Service. There are two MSI packages (PROSet.msi and PROSet64.msi) in the release that can be used to install Intel PROSet on 32-bit Operating Systems and 64-bit Operating Systems individually with command line supports.

MSI package installation requires Windows Installer Service to be installed into the system first. Windows* 2000, Windows ME, Windows XP32 and Windows XP64 operating systems have Windows Installer Service installed by default. However, Windows Installer Service is required to be installed in Windows 98, Windows 98SE and Windows NT 4.0*. A bootstrap program (PROSet.exe) can be used to install Windows Installer Service first on Windows 98 and 98SE.

## Base driver installation

### Command line options

SetupBD.exe supports the following command line options. Examples are shown below.

Option | Description
/s | silent install with no reboot
/r | force reboot (must be used with the /s option)
/u | uninstall
/infdir directory_name | search for inf files only in the specified directory

Examples:

Option | Description
SetupBD | Installs and/or updates the driver(s) and displays the GUI. On Windows NT40 ,Windows 98 and Windows ME reboot options are displayed. No reboot is required for other OSs.
SetupBD /s | Installs and/or updates the driver(s) silently.
SetupBD /s /r | Installs and/or updates the driver(s) silently and forces a reboot.
SetupBD /u | Uninstalls all drivers from the system.
SetupBD /infdir x:\infdir | Installs and/or updates the driver(s), looks for inf files only in the specified directory

### Other information

Users can use the "/r" option only for silent install (i.e. with the "/s" option). It is not necessary to use this option for non-silent install mode on Operating Systems like Windows NT 4.0, Windows 98 and Windows Me, since the installer provides options by displaying two buttons "Reboot now" and "Reboot later" or does an automatic reboot 20 seconds after installation if neither button is clicked.

The Reboot option is not available through command line or through the button options for Operating Systems like Windows 2000, Windows XP32 and Windows XP64, since it is not required to restart the system after installation of drivers.

On the Windows NT 4.0, operating system Intel PROSet, NMS and ANS are also installed during the driver installation. Users are not required to install Intel PROSet separately after installing the drivers.

When invoked without the /infdir option, SetupBD makes some assumptions about where to search for the required inf files. The relative CD directory structure should be maintained.

### Modifying SetupBD.ini

The ability to specify inf file locations is accomplished via an ini file, SetupBD.ini. This file can be modified to point to the inf files wherever they have been copied. SetupBD.ini must be in the same folder as SetupBD.exe.

The SetupBD.ini file has these keywords: LevelstoRoot, InfSectionName, and InfDir. While the values of the keywords can be modified, the keywords themselves cannot. The SetupBD.ini file begins with the keyword LevelstoRoot:

[Config]
LevelsToRoot=4

The value in LevelsToRoot refers to how many directory levels the root of the media is located above the SetupBD.ini file. For example, on the Intel CD, go 4 levels up to the root, the access PRO100\WIN98_ME to look for the associated .inf files. If you move the inf file, you may need to change the LevelsToRoot value.

The SetupBD.ini file then lists operating systems, followed by their associated keywords. For example:
[Win98]
InfSectionName=Intel
InfDir=PRO100\WIN_98ME
InfDir=PRO1000\WIN_98ME

You must modify the section of SetupBD.ini that corresponds to the OS you are installing onto. The above example refers to the Windows 98 OS. InfSectionName is the name included inside the inf. This is reserved for Intel adapters and should not be changed.

InfDir points to the path on the media where the .inf is located. There are two paths listed: one for Pro100; and one for Pro1000. If you change the location of the .inf, this path must be modified.

In Windows NT there is an additional keyword:

NMSDir=PRO100\WINNT4\NMS

This keyword points to the location of NMS. Its value can be changed, as long as it points to the location of the MS files.

## Intel PROSet installation

This section describes how to install Intel PROSet from the command line. It describes all the command line options supported in PROSet.msi. The instructions are primarily for NCS Intel PROSet installation (Windows 2000 and beyond operating systems).

Notes:

- 64-bit version of PROSet64.msi has wired components only. The command line options relating to wireless components will be invalid.

- This release ships NCS (Network Configuration Services) Intel PROSet on Windows 2000 and beyond. Intel PROSet II is shipped on the CD only for Windows 98, 98SE, and ME.

- Intel PROSet can be installed with PROSet.exe or msiexec.exe. Intel recommends using PROSet.exe. PROSet.exe is mainly used for language support. It detects the system language, searches for the appropriate transform file in the same folder, and then launches PROSet.msi in the language specific to the operating system. The transform file translates the installation instructions to the language associated with your operating system.

### Command line options

This section describes how to install Intel PROSet using PROSet.msi / PROSet64.msi and msiexec.exe from the command line. For more information on msiexec.exe command line parameters, refer to the msiexec.exe command line options section.

Windows Installer Service is installed by default in Windows 2000, XP32 and XP64. msiexec.exe is under System32 folder. When System32 is not in the current PATH, the full path to msiexe.exe should be specified in the command line. For example:

> C:\WINNT\System32\msiexec.exe /i PROSet.msi /qn /liew c:\temp\install.log

Most commonly used msiexec.exe command line options:

Option | Description
/i | install;
/x | uninstall;
/q[r|n] | silent install. ("r", reduced GUI, show progress bar information only; "n", fully silent.)

/liew

/l --- log file option. Following are log switches:

"i" | log only status messages;
"w" | log only non-fatal warnings;
"e" | log all error messages.
"a" | log the start of all actions.

TRANSFORMS

A property used to apply transforms (a .mst file) to an MSI package. Syntax example:

> TRANSFORMS=2052.mst

Applies a Chinese language transform to MSI package, so the installer displays Chinese strings during installation.

#### Silent install / upgrade command line syntax

> <Full path to msiexec.exe> /i <Full path to PROSet.msi> /qn /liew <Full path to install.log>

Launches a typical installation of PROSet.msi.

#### Silent uninstall command line syntax

> <path to msiexec.exe> /x <path to PROSet.msi> /qn /liew <path to uninstall.log>

Uninstalls all the Intel PROSet components. It can be used when the path to PROSet.msi is available.

> <path to msiexec.exe> /x <ProductCode of PROSet.msi> /qn /liew <path to uninstall.log>

Uninstalls all the Intel PROSet components. It can be used when the path to PROSet.msi is not available but the ProductCode of MSI package is known.

#### Command line options supported by PROSet.msi

PROSet.msi provides public properties that can be used to change Intel PROSet install selections from command lines.

By setting the properties in the command line, user can disable and hide some features in PROSet.msi, or force some feature to be selected/displayed. It provides flexibility for users to install different components/features in Intel PROSet.

Following is the list of public properties provided by PROSet.msi:

Property | Definition
TRAYICON | "0" , hide PRONotify, installer will not launch PRONotify after install. It will not be hooked up in Run key. "1", default value, always launch PRONotify after install/upgrade.

WIRED

used to select/deselect wired Intel PROSet.

"0", deselect / hide wired components, this will deselect all sub-features of wired Intel PROSet (including ANS, FTMI, CIMV2), so ANS, FMTI, CIMV2 will be invalid when WIRED=0.

"1", select wired components.

"2", default value, neutral state.

NOTE: This is mainly used in the wireless software release. In release wired release, wired components are always selected by default.

ANS | "0", deselect / hide ANS. "1", select ANS. In the wireless release, when SWITCHING=1 (Mobile IP is selected), this option will be invalid. Mobile IP has higher priority. NOTE: In this release, it is set to "1" by default. It is always installed by default in this release.
FMTI | "0", deselect / hide FTMI DLL feature. "1", select FTMI DLL feature. "2", default value. NOTE: It is always installed by default in this release.
CIMV2 | "0", deselect / hide CIMV2 support feature. "1", select CIMV2 support feature. "2", default value. NOTE: It is deselected in this release by default. To turn it on from command line, set CIMV2=1.
WIRELESS | "0", deselect / hide Wireless (802.11) feature. "1", select Wireless (802.11) feature. "2", default value. NOTE: This is used mainly for Wireless releases. When wireless network adapter is detected in system, it will be turned on by default. By default, it will be deselected when there is no wireless adapter detected.
SWITCHING | "0", deselect / hide Adapter Switching feature. "1", select Adapter Switching feature. "2", default value. NOTE: This is used mainly for Wireless releases. When wireless network adapter is detected in system, it will be turned on by default. By default, it will be deselected when there is no wireless adapter detected. ANS and Adapter Switching are mutually exclusive to each other. When SWITCHING is set to "1", ANS feature will be deselected, and ANS=1 is invalid in this case. Adapter Switching has higher priority in Wireless releases.

NOTE:

Public properties are case sensitive. All characters should be in uppercase and there should be no white space in public property settings. For example:

> msiexec.exe /i PROSet.msi /qn CIMV2=1

Any white space in "CIMV2=1" makes the setting invalid. "cimv2=1" is not a valid setting.

### Use PROSet.exe utility to simplify command lines

PROSet.exe is a setup utility used for Intel PROSet installation. It is mainly used for language support. It detects the system language, searches for the appropriate transform file in the same folder, and then launches PROSet.msi in the language specific to the operating system. The transform file translates the installation instructions to the language associated with your operating system.

PROSet.exe also takes the install options from the command line and applies them to the PROSet.msi command line installation. Following is an example of PROSet.exe command line:

> PROSet.exe /qn CIMV2=1 WIRELESS=0 SWITCHING=0

It is same as:

> C:\WINNT\System32\msiexec.exe /i PROSet.msi /qn CIMV2=1 WIRELESS=0 SWITCHING=0 TRANSFORMS=1033.mst

Detects the system's language and searches for the appropriate transform file. For example, when it is launched in Chinese (simplified) operating systems, it is equal to:

> C:\WINNT\System32\msiexec.exe /i PROSet.msi /qn CIMV2=1 WIRELESS=0 SWITCHING=0 TRANSFORMS=2052.mst

This displays Chinese (Simplified) strings during installation, and it also installs the Chinese (Simplified) version of wired Intel PROSet in the system.

| NOTE: The name of PROSet.exe may subject to change, but the functions will not be changed.

### Command line install examples

This section describes some examples used in install command lines.

Assume C:\WINNT\System32 is system32 folder and PROSet.msi is under D:\Apps\PROSet\WS03XP32 folder. User can modify the paths for different operating systems and CD layouts and apply the command line examples.

1. How to install Intel PROSet silently on XP32:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn /liew C:\ install.log
   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn /liew C:\install.log

   Launches typical install silently. In this release, it installs Intel PROSet with ANS and FTMI DLL by default.

2. How to install Intel PROSet silently on XP64:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP64\PROSet64.msi /qn /liew C:\ install.log

   Another way to do:

   > D:\Apps\PROSet\WS03XP64\PROSet.exe /qn /liew C:\install.log

   | NOTE: There are no wireless components in PROSet64.msi. ANS is selected by default always. CIMV2 support is deselected in typical install.

3. How to install Intel PROSet silently with CIMV2 support:

   Set the CIMV2 public property to "1" in the command line, for example:

   For XP32 and Windows Server 2003 Operating System, use:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn CIMV2=1 /liew C:\ install.log

   It is same as:

   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn CIMV2=1 /liew C:\install.log

   For XP64, use:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP64\PROSet64.msi /qn CIMV2=1 /liew C:\ install.log

   It is same as:

   > D:\Apps\PROSet\WS03XP64\PROSet.exe /qn CIMV2=1 /liew C:\install.log

   | NOTE: There is no white space in "CIMV2=1" and all characters are in uppercase.

4. How to force wireless components not to be installed and install wired components only:

   Set the WIRELESS=0 SWITCHING=0 in the command line, for example:

   For XP32 and Windows Server 2003 Operating System, use:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn WIRED=1 ANS=1 WIRELESS=0 SWITCHING=0 /liew C:\ install.log

   It is same as:

   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn WIRED=1 ANS=1 CIMV2=1 WIRELESS=0 SWITCHING=0 /liew C:\install.log

5. How to force wired components not to be installed and install wireless components only:

   Set the WIRED=0 WIRELESS=1 SWITCHING=1 in the command line, for example:

   For XP32 and Windows Server 2003 Operating System, use:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn WIRED=0 WIRELESS=1 SWITCHING=1 /liew C:\ install.log

   It is same as:

   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn WIRED=0 WIRELESS=1 SWITCHING=1 /liew C:\install.log

6. How to install wired components and wireless components but deselect ANS:

   Set the WIRED=1 ANS=0 WIRELESS=1 SWITCHING=1 in the command line, for example:

   For XP32 and Windows Server 2003 Operating System, use:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn WIRED=1 ANS=0 WIRELESS=1 SWITCHING=1 /liew C:\ install.log

   It is same as:

   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn WIRED=1 ANS=0 WIRELESS=1 SWITCHING=1 /liew C:\install.log

7. How to apply a transform file to MSI using msiexec.exe:

   Set the TRANSFORMS=filename.mst in the command line. For example:

   For XP32 and Windows Server 2003 Chinese (Simplified) Operating System, use PROSet.msi from this release:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn TRANSFORMS=2052.mst /liew C:\ install.log

   > D:\Apps\PROSet\WS03XP32\PROSet.exe /qn /liew C:\install.log

   | NOTE: Intel recommends using PROSet.exe to install Intel PROSet. PROSet.exe detects the system's language, searches for the appropriate transform file, and applies it to MSI package.

8. How to hide PRONotify and prevent installer from launching it:

   Set TRAYICON=0 in command line, for example:

   > C:\WINNT\System32\msiexec.exe /i D:\Apps\PROSet\WS03XP32\PROSet.msi /qn TRAYICON=0 /liew C:\ install.log

   Prevents installer from launching PRONotify. PRONotify is also unhooked in Run key. In next reboot, PRONotify will not be launched.

### Command line uninstall examples

NOTE: Do not use the "ANS" option when uninstalling Intel PROSet from a command line.

1. How to uninstall Intel PROSet from command line when PROSet.msi path is available:

   First get the path of PROSet.msi in the local system or any other image path when you installed Intel PROSet, then use msiexec.exe to uninstall Intel PROSet.

   For example, assume System folder is C:\Windows\System, and PROSet.msi is in d:\unattend, then the command line will be:

   > C:\Windows\System\msiexec.exe /x d:\unattend\PROSet.msi /qn /liew d:\unattend\uninst.log

2. How to uninstall Intel PROSet using product code:

   (Following product codes are used for this release and Wireless releases only, they are subject to change in each new release)

   Release 6.4 and later product codes:

   Uninstall Intel PROSet on Windows 2000 and XP32:

   > msiexe /x {EF4EF65F-4D62-44D7-82C9-1AECCBA74C50} /qn

   Uninstall Intel PROSet on XP64:

   > msiexec /x {DFB82058-3E67-4B2B-83C3-636E3CE134BE} /qn

   Uninstall Intel PROSet II on Windows 98, 98SE, ME

   > msiexec /x {2B8D4AFB-05D0-49F3-82E3-B7F4D1043CEF} /qn

   Wireless product codes:

   Uninstall Intel PROSet from wireless release on Windows 2000 and XP32:

   > msiexe /x {8552A53D-5226-462B-8E7C-B3174C04E7BD} /qn

   Uninstall Intel PROSet from wireless release on XP64:

   > msiexec /x {8D9705F1-701C-4F09-9C5D-0DE4C38AF56B} /qn

   Uninstall Intel PROSet II from Wireless release on Windows 98, 98SE, ME

   > msiexec /x {01A4AEDE-F219-49A2-B855-16A016EAF9A4} /qn

### Command line reinstall / repair

If you need to repair an Intel PROSet installation, uninstall the application and then reinstall it. See the uninstall and install examples above for more information.

### Command line supports on Windows 98, 98SE and ME

Intel PROSet II is shipped on the CD for Windows 98, 98SE and ME. In this release, Intel PROSet II has only wired components.

Windows 98 and 98SE has no Windows Installer Service by default. PROSet.exe in the same folder of PROSet.msi is used to install Windows Installer Service whenever in need and then launch PROSet.msi. User is recommended to use PROSet.exe for command line installs.

Command line install examples:

> PROSet.exe /qn WIRELESS=0 /liew C:\inst.log

This will install wired Intel PROSet and force wireless components not to be installed.

> PROSet.exe /qn WIRELESS=1 /liew C:\inst.log

This will install wireless Intel PROSet. (Wired component is required always in Intel PROSet II.)

Command line uninstall examples:

> msiexec.exe /x D:\apps\PROSet\WN98SEME\PROSet.msi /qn REBOOT= ReallySuppress

> msiexec.exe /x {2B8D4AFB-05D0-49F3-82E3-B7F4D1043CEF} /qn REBOOT= ReallySuppress

| NOTE: Uninstalling Intel PROSet II on Windows 98, 98SE and ME requires a reboot to clean up the cached MSI package. User can suppress the reboot from the command line. Upgrading Intel PROSet II in these Operating Systems also requires a reboot.

## msiexec.exe command line options

Refer to Microsoft's web site for the most current information on msiexec.exe command line options: http://msdn.microsoft.com/library

| NOTES: Not all command line options Microsoft provides with msiexec.exe have been tested or are necessarily supported for Intel PROSet installation.
| Msiexec also sets an error level on return that corresponds to system error codes: http://msdn.microsoft.com/library

`Last modified on 7/29/03 3:08p Revision 7`