MORE INFORMATION
The Custom Maintenance Wizard gives you more flexibility,
ease of use, and control when you need to install or modify Office 2000
features in an existing installation. The following sections outline how to
download and install the Custom Maintenance Wizard, how to create a .cmw file,
and how to use the .cmw file to add or remove features on an existing Office
installation.
How to download and install the Custom Maintenance Wizard
The Custom Maintenance Wizard can be downloaded from the Office
Resource Kit World Wide Web site. To do this, do the following:
- Enter the following URL in your Web
browser:
http://www.microsoft.com/offichttp://www.microsoft.com/office/orkarchive/2000ddl.htm#maintwize/ork/2000/appndx/toolbox.htm - Right-click the link for Maintwiz.exe.
- Click Save Target As in the shortcut menu.
- Select a download location in the Save As dialog box, and click Save.
Note The recommended download location is the C:\Program Files\ORKTools\ToolBox\Tools\CIW and IEAK\Custom Installation Wizard folder, but it is not a requirement. - Repeat steps 2-5 for Maintwiz.hlp.
Introduction to the Custom Maintenance Wizard
The Microsoft Office 2000 Custom Maintenance Wizard allows you to
update the installed feature set for a software product on users' computers.
Initially the Custom Maintenance Wizard reads the Windows Installer package
(.msi file) and creates a new product configuration (.cmw) file. Later the
Custom Maintenance Wizard uses the .cmw file to update the installed feature
set of the product installed on users' computers. As with other Office wizards,
the Custom Maintenance Wizard guides you through a series of panels and
options. To advance to the next panel, click
Next. To go back to a previous panel, click
Back.
The Custom Maintenance Wizard does not write your
modifications to the .cmw file until you click
Finish, so you can return to any panel and change your selections before
you complete the final panel. The .msi file is never modified. You can quit the
Custom Maintenance Wizard at any time by clicking
Cancel.
Note The Custom Maintenance Wizard is designed for use with the .msi
files included with Office 2000 products using Windows Installer technology.
How to create a .cmw file with the Custom Maintenance Wizard
To create a .cmw file that you then use to modify existing Office
installations, do the following:
- Open the .msi file used to install your Office product. In
the Open the MSI File dialog box, click Browse to locate and select the .msi file for the Office product you
want to update. For example, the .msi file for Office 2000 Premium is
Data1.msi.
If you do not use the correct .msi file at this step, the
following error message may appear when you later apply the .cmw file to your
Office installation: Product is not installed on this
computer.
For more information about this problem, click the following article number to view the article in the Microsoft Knowledge Base:
242311
Error message: "Product is not installed on this computer" using Custom Maintenance Wizard
- Select whether you want to create a new .cmw file or modify
an existing .cmw file.
Note If you open an existing .cmw file, you must use the same .msi
file you used when you originally created the .cmw file. Otherwise, the
following error message appears when you click Next: The ProductCode found in the CMW file
does not match the opened MSI file. Please try again.
For more information about this
problem, click the following article number to view the article in the Microsoft Knowledge Base:
242346
Error message: "ProductCode found in the CMW file does not match..."
- If you are creating a new .cmw file, select Do not
open an existing CMW file (the default setting) and click Next.
Note If you have previously created .cmw files and you click
Open an existing CMW file, the list of .cmw files you created
appears when you click the list for Name and path of CMW file to
open. - In the next step, Select the CMW File to
Save, specify the name you want to use for your .cmw file.
- In the next step, Set Feature Installation
States, set the installation states for each feature displayed in the
Features tree.
In this dialog box, the Custom Maintenance Wizard
displays features in a hierarchical tree in the same way they are displayed
when you run Office Setup. To expand or collapse a portion of the tree, click
the plus sign (+) or minus sign (-) to the left of the feature name.
You can set the installation state of features in the Custom Maintenance Wizard
just as you do in Office Setup. Click the icon to the left of the feature name,
and then select the installation state you want from the list.
The
default setting for each feature, Leave feature's installation state
unchanged, is to leave the feature as it exists in the Office
installation when you apply the .cmw file. The following are the seven
available installation states for every feature:- Leave feature's installation state unchanged
- Run from My Computer
- Run all from My Computer
- Run from Network
- Run all from Network
- Installed on First Use
- Not Available
Note Run from CD and Run all from
CD are not available as installation states in the Custom Maintenance
Wizard.
If you set a top-level feature, like Microsoft Word for
Windows, to Installed on First Use in the Custom Maintenance
Wizard, the feature may not be installed or it may be removed if it is already
installed. This may occur if your operating system does not support Windows
Installer shortcuts.
For more information about operating systems that support Windows
Installer shortcuts, click the following article number to view the article in the Microsoft Knowledge Base:
229396
Unable to modify Office shortcuts
For more information about features being uninstalled unexpectedly
by the CMW, click the following article number to view the article in the Microsoft Knowledge Base:
242988
Program removed after you update Office with Custom Maintenance Wizard
If you set a feature to a state that is not
normally supported by that feature, the installation state of that feature will
be changed to one that is supported or will remain unchanged when you apply the
.cmw file to your installation. For example, if you change the Help feature
under the Microsoft Excel feature to Not Available, and you apply the .cmw file to your installation, the Help
feature for Excel will instead be set to Run from My Computer,
regardless of its installation state prior to applying the .cmw file. This is
because Not Available is not a supported installation state for Microsoft Excel Help.
If you want to see the supported installation states for each feature, run
Setup for your current Office installation, and click Add or Remove Features in the Microsoft Office 2000 Maintenance Mode
dialog box. Then click the icon next to the feature or features in question.
To revert the feature tree in the Custom Maintenance Wizard to its
previous settings, click Reset at the bottom of the Set Feature Installation
States dialog box. This reverts all features to their original state.
If you are modifying a previously saved .cmw file, clicking Reset returns the entire feature tree to the state the .cmw file was in
when you first opened it. However, if you select just the feature you want
changed back to its original state, press CTRL, and then click Reset, only that feature and all related sub features are
changed. - After you have made all of your changes in the features
tree, click Next or Finish. When you click Finish, your .cmw file is created with all of your settings, and the
final dialog box displays a sample command line to run the Custom Maintenance
Wizard with the .cmw file. The sample command line uses the /C, /Q, and /L
switches; however, only the /C switch is required to apply a .cmw file to your
Office installation.
Custom Maintenance Wizard switches
The Custom Maintenance Wizard has four switches that you can use
to control the way the wizard works when you are creating a .cmw file and when
you are applying the .cmw file to your installation. The following is a list of
the CMW switches and a description of how they are used:
Switch Description and Sample Command Line
-----------------------------------------------------------------------
/X Use the /X switch to fully expand the features tree in the
Set Feature Installation States dialog box in the CMW. This
allows you to see the entire tree without having to manually
expand each branch. The following command line uses the
/X switch:
<path>\Maintwiz.exe /x
When you get to the Set Feature Installation States dialog
box, the features tree will be fully expanded.
/C Use the /C switch to specify the .cmw file you want to apply
to an existing Office installation. You must first create the
.cmw file with the CMW before you can use this switch. The
following command line will apply a .cmw file to an existing
Office installation:
<path>\Maintwiz.exe /c "c:\update files\OffPre.cmw"
Enclose the path to your .cmw in quotes if you have any spaces in the
path.
/Q The /Q switch is used in conjunction with the /C switch. It
will run the CMW in quiet mode when you are updating an
existing Office installation. No dialog boxes are displayed
during the update or when the update is finished. The
following command line applies a .cmw file to an existing
Office installation without showing any dialog boxes:
<path>\Maintwiz.exe /c "c:\update files\OffPre.cmw" /q
/L The /L switch is used in conjunction with the /C switch. It
will create a log file when you update an existing Office
installation with a .cmw file. You can specify any path and
file name for the log file. The following command line will
apply a .cmw file to an existing Office installation and a
log file called Cmwlog.txt will be created in the C:\Temp
folder:
<path>\Maintwiz.exe /c c:\OffPre.cmw /L c:\Temp\Cmwlog.txt
Note None of the above switches is case-sensitive. So you can use
either uppercase or lowercase letters when using any of the switches.
Applying a .cmw file to an Office installation
After you create a .cmw file with the Custom Maintenance Wizard,
you can then apply it to an existing Office installation. When you do this,
your Office installation is updated with the modifications you specified in the
Custom Maintenance Wizard. Therefore, if you run Office Setup in Maintenance
Mode and click
Add or Remove Features, the updated installation states for the Office features are
displayed.
To apply a .cmw file to an Office installation, do the
following:
- Make sure the Maintwiz.exe and .cmw file you created are in
a location that is accessible from the computer you are trying to
update.
- On the Start menu, click Run.
- In the Open box, type the command line to apply your .cmw file and then click
OK. For example, you could use a command line similar to the
following:
\\servername\share\Maintwiz.exe /c \\servername\share\Offpre.cmw
- If you did not use the /q switch in your command line,
click OK to the alert stating that the computer was successfully
updated.
Logging
By default, the Custom Maintenance Wizard does not create a log
file when you apply a .cmw file to your Office installation. If you want to log
the update to your installation, use the /L switch when you apply your .cmw
file. For example, you can use the following command line to create a log file
Cmwlog.txt in the c:\Test folder:
<path>\Maintwiz.exe /C c:\OffPre.cmw /L c:\Test\Cmwlog.txt
When you use the /L switch, the following process occurs:
- The log file you specified on the command line is
created.
- This log file contains a header section with the following
items:
- CMW file path
- ProductCode
- ProductName
- ProductVersion
- Cached MSI path
- At the same time, a Windows Installer log file is created
in the \Temp folder. This file has a name in the form Cmw####.tmp, where ####
are four random numbers.
- When the update has finished, the contents of the Windows
Installer log file are copied below the header information in the log file you
specified.
- After the Windows Installer log file information has been
copied to the log file you specified, the Windows Installer log file is
automatically deleted.
The following sample text is taken directly from a portion of a
Custom Maintenance Wizard log file:
***** MAINTWIZ start: 1999-10-01 14:56:32 *****
CMW file path = c:\CMW\offpre.cmw
ProductCode = {00000409-78E1-11D2-B60F-006097C998E7}
ProductName = Microsoft Office 2000 Premium
ProductVersion = 9.00.2720
Cached MSI path = C:\WINDOWS\Installer\2ad9b.msi
Installation Update Succeeded!
***** MAINTWIZ end: 1999-10-01 14:56:36 *****
=== Logging started: 10/1/99 14:56:33 ===
Action 14:56:33: AppSearch. Preparing to install Microsoft Office 2000 Premium
AppSearch:
AppSearch:
AppSearch:
Note There is one situation where the log file you specified is not
created, and at the same time the Windows Installer log file is not deleted. In
this case, you still have the Cmw####.tmp log file to review if there are
problems during the update. This occurs when you update an installation and you
are required to restart after the update. For example, if you update an Office
installation by adding Outlook, you are required to restart after the
update.
For more information about this
issue, click the following article number to view the article in the Microsoft Knowledge Base:
242990
Custom Maintenance Wizard log file is not created
Getting Help with the Custom Maintenance Wizard
If you downloaded the Maintwiz.hlp file with Maintwiz.exe, and
both of these files are in the same folder, the
Help button is available in any of the Custom Maintenance Wizard
dialog boxes. The Maintwiz.hlp file contains more information about the wizard
and is a great resource for working with this wizard.
Note If the
Help button is unavailable (dimmed) in the Custom Maintenance Wizard
dialog boxes, make sure that Maintwiz.hlp and Maintwiz.exe are in the same
folder before you start the wizard.
For more information
about this issue, click the following article number to view the article in the Microsoft Knowledge Base:
243041
Help button is unavailable in Custom Maintenance Wizard
Hidden features in your Office installation
If you used a transform when you initially installed Office and
you specified certain features to be hidden, you can use the Custom Maintenance
Wizard to change the installation states of these hidden features. For example,
if you originally set the Microsoft Outlook for Windows feature to
Not Available and you hid the feature in your transform, this feature does not
appear in your original Office installation. Also, because this is a hidden
feature, you cannot change its installation state in Maintenance Mode
Setup.
If you then set the Microsoft Outlook for Windows feature to
Run from My Computer in the Custom Maintenance Wizard and apply the .cmw file to your
Office installation, Microsoft Outlook is available for use on your computer.
However, it remains a hidden feature and you cannot change its installation
state in Maintenance Mode Setup.
If you want to unhide a hidden
feature in your Office installation, you must uninstall your existing
installation and do one of the following:
- Option 1
Re-run Office Setup without the transform that hid the
feature or features. - Option 2
Create a new transform where the feature is not hidden, and
then run Office Setup with this new transform.
For more information, click the following article number to view the article in the Microsoft Knowledge Base:
242338
Custom Maintenance Wizard cannot unhide hidden features