Microsoft KB Archive/943595

= How OEM partners can develop Windows Live installation scenarios by taking advantage of the Windows Live Installer =

Article ID: 943595

Article Last Modified on 11/30/2007

-

APPLIES TO


 * Windows Live Messenger
 * Windows Live Mail
 * Windows Live OneCare Family Safety
 * Windows Live Photo Gallery
 * Windows Live Toolbar
 * Windows Live Writer Beta

-



SUMMARY
This document defines how Microsoft partners can create installation scenarios by taking advantage of the Windows Live Installer. This document covers the following scenarios:
 * Description of each application
 * Requirements
 * Installation scenarios
 * with a configuration file
 * without a configuration file
 * Command-line parameters
 * Product update codes
 * Example of the Config.txt file
 * Windows Live OEM Installer package



Description of each application

 * Sign in assistant

This Windows Internet Explorer add-in will help make the sign-in experience faster and more convenient if you have more than one Windows Live ID. A key feature gives you the ability for to save multiple credentials on your computer. These multiple accounts are shown as a list on the sign-in page. You can even save your password for each of your accounts. This eliminates the need to re-type your password every time that you want to change your identity!
 * Messenger

Instantly connect to the people who matter most, send text to computers, mobile phones, or handhelds. Messenger lets you show other Messenger users if you are online, offline, or out to lunch. Share your personal files, photos, and videos by using the Shared Folder drag-and-drop feature.
 * Writer

A powerful editing tool that lets you to easily publish pictures, videos, and other rich content to your blog. Writer is compatible with Windows Live Spaces, WordPress, Live Journal, and many other blog providers. Insert and customize photos, videos, tags, and lots of other cool content.
 * Mail

Windows Live Mail lets you see multiple e-mail accounts in one place. It contains a powerful virus scanning and other security features that help keep your online experience more secure. Mail also provides a “One-click” access to Windows Live Spaces and Messenger.
 * Toolbar

This Internet Explorer add-in lets you search from any Web page. You can also receive pop-up maps, weather forecasts, and more with Smart Menus on the Toolbar.
 * Photo Gallery

Edit and share your digital photos with ease. Create panoramas and other cool effects. You can even add tags for easy organization of your pictures and videos.
 * Family Safety

Be aware of what your children are doing and who they are talking to online. Family Safety lets you manage your children's Web access from almost any Web-connected computer. This includes blocking Web sites in unsuitable categories.

Requirements
Depending on the type of installation and components that you are installing, certain prerequisites may be required on the computer for the programs to function correctly. In the online installation process, the presence of these prerequisites is checked by the installer. Additionally, the prerequisites are downloaded if they are not present. This mechanism is bypassed in the offline installation process. Therefore, you must install the prerequisites.

OEM package installation without a configuration file
You can call the installer as follows:

WLSetup.exe /silent

In this scenario, without a configuration file all products EXCEPT Windows Live Family Safety will be installed on the computer.

OEM package installation with a configuration file
You can use the following command-line parameter to install specific Windows Live Products that are defined in the configuration file:

WLSetup.exe /silent /configfile: config.txt

To do this, use the example configuration .txt file (4.3).

Verbose or silent Installation without a configuration file
You can set the Windows Live installer to install without a configuration file. In this scenario, regardless of whether you run the installation from the Web, a CD, or UNC share, the installation will run. All the selected products will be installed.

Verbose

By using the Windows Live Installer User Experience, you can take advantage of the Windows Live Installer User Experience. By default the Family Safety Settings will not be selected. However, you can add them in the “upsell” selection.

For an example of this scenario, see the WLSetup.exe/configfile: config.txt configuration file.

Note This scenario works on CD, from the Web, or from a local network (UNC) share.

Silent

You can use your own User Experience to decide whether to create your own user experience for the installation. In this scenario, the Windows Live Installer can be programmatically run in “Silent” mode. The Windows Live Installer determines what to install based on what is “included” in the Windows Live Installer package. If all the MSIs are bundled in the OEM package, all the Windows Live products are installed on the computer, except FSS.

For an example of this scenario, see WLSetup.exe /silent/configfile: config.txt configuration file.

Notes This scenario will work on a CD, from the Web, or from a local network (UNC) share. For dependencies, you can rely on the Web connection to install dependencies, or you can include them and install them separately from the Windows Live Installer.

Verbose or silent with configuration file
You can configure the Windows Live Installer to install many different products by using a customizable configuration file. For more information, see 4.1. You can use this custom configuration file from the Web, from a CD, or from a local share (UNC). In the custom configuration file, you can specifically select the products that you want to install.

Verbose

You can select the specific products that you want to install by using the Windows Live Installer and configuration file, taking advantage of the Windows Live Installer’s User Experience with a configuration file. For an example of this scenario, see WLSetup.exe /configfile: config.txt configuration file.

Silent

Use your User Experience and a configuration file to take advantage of the Windows Live Installer and make it completely customizable. To do this, call the Windows Live Installer and include a configuration file. For an example of this scenario, see WLSetup.exe /silent /configfile: config.txt configuration file.

Notes In the Web scenario where a configuration file is used, you must create a wrapper .exe file that contains the config file to start the installer with the correct set of command-line parameters. We will not support this scenario for Wave 2. However, you can perform this scenario if you have to. In the Verbose scenario where a configuration file is used, the end-users running through the installation experience will see the Upsell text for any products that are not part of the configuration file. The only way for you to lock the list of products that you will install is in “/silent” mode. In the Silent scenario, you must provide your own User Experience.

Command-line parameters
The following is a list of command-line parameters that can be used together with the OEM installation configuration file.  /silent

The /silent command-line parameter is an unattended silent installation without user interaction or user interface. /FASTOEM

Flag to pass the /FASTOEM switch to all the MSI packages included in the bundle. The default is that the /FASTOEM switch is not set. The /FASTOEM switch reduces time for OEMs during installation by limiting the MSI overhead that is not needed in new (OEM) install scenarios.

For more information, visit:

http://msdn2.microsoft.com/en-us/library/aa368576.aspx

 /configfile:”config.txt”

If you pass a file configuration file, you must use the /configfile:< > parameter. The format of this .txt file is defined in 5.3.

Product list
The product list is identified by “p=” and also includes “*0” or “*1” for the priority of each application (0>1). This product list is comma separated.

Example: P=5A3D-4E68-82A1-3C166F03C379*0,88459F2D-0CF8-4558-B6AB-6E19B6AC34B0*0

Set MSN search
To set MSN as the default search engine, set “s=1”. If you do not want MSN as the default search engine, set “s=0”. If you leave “s” out of the config file, you will be prompted to set Live Search as your default, unless you are running silently. In silent mode, there is no UI/no change to search.

Set MSN home
To set MSN as the home page, set “h=1”. If you do not want MSN as the default home page, set “h=0”.

Enable CEIP
To enable the CEIP program, set “c=1”. To not enable CEIP set “c=0”.

Note Some OEM developers can be contractually obligated to have this pre-selected.

Market settings

To set the market, include “m=< >-< >.” For example, type m=EN-US. The market setting follows the standard < > < > format.

Terms of Use (TOU)
You can configure whether the installer displays the TOU during the verbose installation.
 * t=0

Use this code if you want the installer to display the TOU.
 * t=1

Use this code if you do not want the installer to display the TOU.

Example of the Config.txt file
In this example, you are performing the following tasks:
 * Installing the whole Windows Live suite while setting MSN as the default search
 * Setting MSN as the default home
 * Enabling CEIP
 * Setting the market as EN-US while displaying the Terms of Use agreement

p=31BB3B1C-5A3D-4E68-82A1-3C166F03C379*0,88459F2D-0CF8-4558-B6AB-6E19B6AC34B0*0,A26D7C8B-875D-48E2-BED1-7168268D022A*0,F81F501C-236B-4B4A-8E92-0575EAAD06FA*0,5DC07600-AAF3-11DA-A746-0800200C9A66*0,BB05EE9A-31CE-44F7-B0B3-1A341A8DFFCD*0,C41BA0D7-8DCB-4789-8B6C-543EE4C37142*0&s=1&h=1&c=1&m=EN-US&t=0

Windows Live OEM installation package
This is a multiple language link to the Windows Live OEM installation package. The download location will automatically redirect to the download location of the language of your browser. To change languages, select the appropriate language from the drop-down menu.

To do this, visit the appropriate Web site.

Additional information
If you programmatically call the bootstrapping application and install the application in silent mode where you provide the UI, you receive the following return codes:

1.1.1.1 INSTALL_SUCCESS S_OK = 0

1.1.1.2 INSTALL_FAILURE FAILED(hResult) == 1

1.1.1.3 ERROR_SUCCESS_REBOOT_REQUIRED ERROR_SUCCESS_REBOOT_REQUIRED = 3010

Keywords: kbhowto kbwinliveportal KB943595

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.