MSHC Migrate Utility

Search this site

Blog /RSS Feed‎ > ‎

Add an Index to your .Cab Help Package

posted Jan 10, 2010 10:56 PM by Robert Chandler   [ updated Oct 27, 2010 12:04 AM by Robert Chandler ]
Most people don't sign help packages. They just ship & install the .mshc file and that get's indexed at install time (as recommended by MS).

Signing means you can install silently.

If you are going to sign your help then the .mshc help file needs to be put inside a .cab file. And the .cab file signed. Microsoft .cab packages contain a .mshc & a .mshi index file. By including an Index your help does not need to be ripped (index) at install time. Fast install.

The index is easy to find and include:
  1. Merge your .mshc help to generate the latest index file.
  2. Open mshcMigrate.exe and go to "Help Library Store" page.
  3. Drill down to (and click on) your package. Notice at the top of the page there is now full path to you help's store location.
  4. Click on "Help Library Location" link above the path. This will open the store folder containing your .mshc and .mshi
  5. Copy the .mshi index file into your Migrate output folder. You will need to rename it to the same name as your .mshc file. 
    EG. xxxxx.1.mshi  --> xxxxx.mshi
  6. In mshcMigrate.exe > Update page perform a simple update (Zip only) to refresh the .cab file with both files.
If you don't use mshcMigrate, just grab the .mshi index file (from the help data store) and add the .mshc and .mshi to a .cab file. It's import that the .cab, .mshc and .mshi (if included) all have the same base file name. Otherwise install will fail.

Note #1: Whenever mshcMigrate Migrate/Update commands run they create a .cab file of the same name. It places into the .cab file the .mshc help file and an index (.mshi) file if one exists with the same name (in the same folder as the .mshc/.cab etc).