Microsoft KB Archive/826213

= Description of the Setup logging options in Office 2003 =

Article ID: 826213

Article Last Modified on 1/17/2007

-

APPLIES TO


 * Microsoft Office Professional Edition 2003
 * Microsoft Office Excel 2003
 * Microsoft Office FrontPage 2003
 * Microsoft Office Outlook 2003
 * Microsoft Office PowerPoint 2003
 * Microsoft Office Publisher 2003
 * Microsoft Office Word 2003
 * Microsoft Office Standard Edition 2003
 * Microsoft Office Student and Teacher Edition 2003
 * Microsoft Office Small Business Edition 2003
 * Microsoft Office Basic Edition 2003
 * Microsoft Office Access 2003

-





Important This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

IN THIS TASK

 * SUMMARY
 * Description of logging options
 * Use default Windows Installer logging
 * Use custom logging options
 * Use a custom command line
 * Modify the Setup.ini file
 * Use Maintenance mode or install on first use logging



SUMMARY
This article describes the Microsoft Office 2003 Setup logging options, how to use default and custom logging options, and how to set these options in the Microsoft Windows Registry.

back to the top

Description of logging options
The Microsoft Office 2003 Setup program automatically creates log files in your Temporary folder. The log files have names that are similar to the following:

The  characters in the log file names are numbers that start with 0001. They increment by 1 if you have to run the Setup program multiple times. Therefore, the log file that has the highest number is the log file for the last time that you ran the Setup program.

The following table lists the logging options that are available that you can use with the /L switch of the Windows Installer.

back to the top

Use default Windows Installer logging
When you run the Office 2003 Setup program for the first time, logging is not verbose by default as was the case with Microsoft Office XP Setup. Initial logging options are already defined for the Windows Installer process (for example, Type=PIWAEO), as specified in the [Logging] section of the Setup.ini file. You can override the default logging options by using a custom command line or by modifying the Setup.ini file.

Note If the first installation try fails, verbose logging by using the Type=VOICEWARMUP setting in the Setup.ini file is enabled for any subsequent attempts to successfully complete an installation of Office 2003.

back to the top

Use custom logging options
There are two ways that you can customize the logging parameters that are used to create a Windows Installer log file. You can use a custom command line, or you can modify the Setup.ini file.

back to the top

Use a custom command line
You can use any combination of parameters with the /L switch. The only requirement for this switch is that you also specify a path and a file name for your log files.

The following is a sample command line:

\Setup.exe /Lme C:\Customlog.txt

back to the top

Modify the Setup.ini file
The Setup.ini file contains a [Logging] section that you can modify to create a custom set of logging options. To change the default logging parameters for *v, modify the Type= line in the Setup.ini file. For example, change the Type= line that is similar to the following:

Type=voicewarmup

You can also specify a path for your log files by creating a Path= line in the [Logging] section. For example, if you create the following entry in the [Logging] section, the Logfiles folder is created on the root of your C drive (if it does not already exist), and any log files that were created during the Office installation will be created in this folder:

Path=C:\Logfiles

If you modify the Setup.ini file in the Files\Setup folder of your administrative installation, you do not need a custom command line. However, if you rename the modified Setup.ini file, or it is located in a location other than the Files\Setup folder of your Office installation, use a command line that is similar to the following to reference the new settings file:

\Setup.exe /settings \\ \ \Customsetup.ini

In this example,  is the path of the Setup program,   is the server, and   is the share on the server.

back to the top

Use Maintenance mode or install on first use logging
Warning If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

Logging does not occur when you run the Office Setup program after Office has already been successfully installed. For example, if the Setup program runs because a feature is being installed on demand (it was originally set to Install on First Use), or you click Detect and Repair on the Help menu, the logging will not occur.

If you want to log either of these two situations, you can turn on logging by making the following changes in the Windows Registry:  Quit all programs that are running. Click Start, and then click Run. In the Open box, type regedit, and then click OK. In Registry Editor, click the following key:

 With the Installer key selected, point to New on the Edit menu, and then click String Value. Type Logging, and then press ENTER. With the Logging value selected, click Modify on the Edit menu.</li> In the Value data box, type the setup logging options that you want (for example, type voicewarmup ), and then click OK.</li> On the File menu, click Exit to quit Registry Editor.</li></ol>

When you turn on logging by using the registry, the logging file that is created is named MSI .log, where  is a random set of five alphanumeric characters. The file is stored in the Temp folder. Because a new MSI .log file is created whenever the Windows Installer runs, the use of this registry modification must be strictly controlled.

For more information about how to turn on logging in the Windows Registry, visit the following Microsoft Web site:

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

back to the top

Keywords: kbfunctions kbsetup kbwindowsinstaller kbhowtomaster KB826213

-

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

© Microsoft Corporation. All rights reserved.