Help and Support

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

Article ID:943595
Last Review:November 30, 2007
Revision:2.1
On This Page

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

Back to the top

MORE INFORMATION

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.

Back to the top

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.
PartnerDependencyDownload Location
Live Writer.NET 2.0http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5 (http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5)
Photo GalleryWindows Imaging Component (windows XP only)http://www.microsoft.com/downloads/details.aspx?FamilyID=8e011506-6307-445b-b950-215def45ddd8 (http://www.microsoft.com/downloads/details.aspx?FamilyID=8e011506-6307-445b-b950-215def45ddd8)
Photo GalleryMicrosoft SQL Server 2005 Compact Editionhttp://www.microsoft.com/downloads/details.aspx?FamilyID=85e0c3ce-3fa1-453a-8ce9-af6ca20946c3 (http://www.microsoft.com/downloads/details.aspx?FamilyID=85e0c3ce-3fa1-453a-8ce9-af6ca20946c3)
ToolbarSee KB articlehttp://support.microsoft.com/kb/944026/en-us (http://support.microsoft.com/kb/944026/en-us)

Back to the top

Installation scenarios

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.

Back to the top

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 (http://msdn2.microsoft.com/en-us/library/aa368576.aspx)
/configfile:”config.txt”
If you pass a file configuration file, you must use the /configfile:<path_filename> 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=<lang>-<market>.” For example, type m=EN-US. The market setting follows the standard <language> <market> 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.

Back to the top

Product upgrade codes

Product nameProduct upgrade code
WL MessengerA26D7C8B-875D-48E2-BED1-7168268D022A
WL Mail88459F2D-0CF8-4558-B6AB-6E19B6AC34B0
WL Writer5DC07600-AAF3-11DA-A746-0800200C9A66
WL Photo GalleryF81F501C-236B-4B4A-8E92-0575EAAD06FA
WL ToolbarBB05EE9A-31CE-44F7-B0B3-1A341A8DFFCD
WL Sign-in Assistant31BB3B1C-5A3D-4E68-82A1-3C166F03C379
WL FSSC41BA0D7-8DCB-4789-8B6C-543EE4C37142

Back to the top

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

Back to the top

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.
LanguageWL OEM package
Arabichttp://g.live.com/1rewlive/ar/WLSetup.exe
Bulgarianhttp://g.live.com/1rewlive/bg/WLSetup.exe
Czechhttp://g.live.com/1rewlive/cs/WLSetup.exe
Danishhttp://g.live.com/1rewlive/da/WLSetup.exe
Germanhttp://g.live.com/1rewlive/de/WLSetup.exe
Greekhttp://g.live.com/1rewlive/el/WLSetup.exe
Englishhttp://g.live.com/1rewlive/en/WLSetup.exe
Spanish (traditional sort)http://g.live.com/1rewlive/es/WLSetup.exe
Estonianhttp://g.live.com/1rewlive/et/WLSetup.exe
Finnishhttp://g.live.com/1rewlive/fi/WLSetup.exe
Frenchhttp://g.live.com/1rewlive/fr/WLSetup.exe
Hebrewhttp://g.live.com/1rewlive/he/WLSetup.exe
Croatianhttp://g.live.com/1rewlive/hr/WLSetup.exe
Hungarianhttp://g.live.com/1rewlive/hu/WLSetup.exe
Italianhttp://g.live.com/1rewlive/it/WLSetup.exe
Japanese (Japan)http://g.live.com/1rewlive/ja/WLSetup.exe
Koreanhttp://g.live.com/1rewlive/ko/WLSetup.ex
Lithuanianhttp://g.live.com/1rewlive/lt/WLSetup.exe
Latvianhttp://g.live.com/1rewlive/lv/WLSetup.exe
Norwegian (Bokmål)http://g.live.com/1rewlive/nb/WLSetup.exe
Dutchhttp://g.live.com/1rewlive/nl/WLSetup.exe
Polishhttp://g.live.com/1rewlive/pl/WLSetup.exe
Portuguese-Brazilhttp://g.live.com/1rewlive/pt-br/WLSetup.exe
Portuguese-Portugalhttp://g.live.com/1rewlive/pt-pt/WLSetup.exe
Romanianhttp://g.live.com/1rewlive/ro/WLSetup.exe
Russianhttp://g.live.com/1rewlive/ru/WLSetup.exe
Slovakhttp://g.live.com/1rewlive/sk/WLSetup.exe
Slovenianhttp://g.live.com/1rewlive/sl/WLSetup.exe
Serbian (Latin)http://g.live.com/1rewlive/sr-latn/WLSetup.exe
Swedishhttp://g.live.com/1rewlive/sv/WLSetup.exe
Thaihttp://g.live.com/1rewlive/th/WLSetup.exe
Turkishhttp://g.live.com/1rewlive/tr/WLSetup.exe
Ukrainianhttp://g.live.com/1rewlive/uk/WLSetup.exe
Chinese-simplifiedhttp://g.live.com/1rewlive/zh-cn/WLSetup.exe
Chinese-traditionalhttp://g.live.com/1rewlive/zh-tw/WLSetup.exe

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

Back to the top


APPLIES TO
Windows Live Messenger
Windows Live Mail
Windows Live OneCare Family Safety
Windows Live Photo Gallery
Windows Live Toolbar
Windows Live Writer

Back to the top

Keywords: 
kbhowto kbwinliveportal KB943595

Back to the top

Article Translations

 

Related Support Centers

Other Support Options

  • Contact Microsoft
    Phone Numbers, Support Options and Pricing, Online Help, and more.
  • Customer Service
    For non-technical assistance with product purchases, subscriptions, online services, events, training courses, corporate sales, piracy issues, and more.
  • Newsgroups
    Pose a question to other users. Discussion groups and Forums about specific Microsoft products, technologies, and services.