OFF2000: How to Use the Custom Maintenance Wizard

ID: Q242216


The information in this article applies to:
  • Microsoft Office 2000


SUMMARY

When you deploy Office 2000, you might not install all of the Office programs and features, and you might even hide some features by using a custom transform. Later you might decide to add or remove Office features. To do this, you have four options:

  • Uninstall Office and then run Setup again (with a new transform if necessary).


  • -or-

  • Run Office Setup in maintenance mode, click Add or Remove Features, and then change the installation state of the feature or features you want to change.

    NOTE: This approach does not allow you to change the installation state of any hidden features.


  • -or-

  • Use command-line properties like ADDLOCAL, ADDSOURCE, ADVERTISE, and REMOVE to change the installation state of features, including hidden features.


  • -or-

  • Use the Custom Maintenance Wizard (CMW) to create a .cmw file, which you can use to completely reconfigure your users' Office installations.


This article explains how to download, install, and use the Custom Maintenance Wizard to modify existing Office 2000 installations.


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:
  1. Enter the following URL in your Web browser:

    http://www.microsoft.com/office/ork/2000/appndx/toolbox.htm


  2. Scroll down the page and locate the link for Maintwiz.exe.


  3. Right-click the link for Maintwiz.exe.


  4. Click Save Target As in the shortcut menu.


  5. 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.


  6. 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:
  1. 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 additional information about this problem, click the article number below to view the article in the Microsoft Knowledge Base:
    Q242311 OFF2000: Error Message: 'Product Is Not Installed on This Computer'


  2. 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 additional information about this problem, click the article number below to view the article in the Microsoft Knowledge Base:
    Q242346 OFF2000: Error Message: 'ProductCode Found in the CMW File Does Not Match'



  3. 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.


  4. In the next step, Select the CMW File to Save, specify the name you want to use for your .cmw file.


  5. 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 additional information about operating systems that support Windows Installer shortcuts, click the article number below to view the article in the Microsoft Knowledge Base:
    Q229396 OFF2000: Unable to Modify Office Shortcuts

    For additional information about features being uninstalled unexpectedly by the CMW, click the article number below to view the article in the Microsoft Knowledge Base:
    Q242988 OFF2000: 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.


  6. 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 Example 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 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:
  1. 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.


  2. On the Start menu, click Run.


  3. 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


  4. 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:
  1. The log file you specified on the command line is created.


  2. This log file contains a header section with the following items:
    • CMW file path
    • ProductCode
    • ProductName
    • ProductVersion
    • Cached MSI path


  3. 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.


  4. 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.


  5. 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 additional information about this issue, click the article number below to view the article in the Microsoft Knowledge Base:
Q242990 OFF2000: CMW 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 additional information about this issue, click the article number below to view the article in the Microsoft Knowledge Base:
Q243041 OFF2000: Help Button Is Unavailable in the 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:
  • Re-run Office Setup without the transform that hid the feature or features.


  • -or-

  • Create a new transform where the feature is not hidden, and then run Office Setup with this new transform.



For additional information, click the article number below to view the article in the Microsoft Knowledge Base:
Q242338 OFF2000: Custom Maintenance Wizard Cannot Unhide Hidden Features

Additional query words: OFF2000

Keywords : kbdta
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbhowto kbinfo


Last Reviewed: November 11, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.