The getting started guide will walk you through an example where the Firefox setup executable is wrapped in an MSI package. The resulting MSI can be used to install Firefox via group policies under active directory.
It is recommended that you take this quick introduction to the product and what it does before you start building your own MSI package with the program.
Convert Firefox setup to an MSI package
Here are the steps you can follow to create an MSI package with the Firefox setup.
Download Firefox Installer
Go to www.firefox.com to download the latest installer.
Install the Program
The MSI Wrapper can read many of the program properties from the registry if the original program is installed. This is why we recommend that you install the downloaded Firefox installer before we continue.
Start the MSI Wrapper
When you installed the MSI Wrapper a shortcut was created in your start menu. You can open your start menu and launch the MSI Wrapper from there.
A welcome screen is displayed as the first page of the wizard that will guide you through the process of creating an MSI package.
Click next to skip the start page and go to the next page where you can specify the setup executable that you just downloaded.
Enter the file name and location of the executable or click the browse button.
The wizard will automatically suggest a file name and location for the MSI output file if the input field is empty when you specify the setup executable. Please make sure that you have write access to the location where the output MSI package is written.
Click next to go to the page where you specify some codes for your program.
The "Application Id" is a text string that identifies the program in the computers uninstall information database. This value is needed in the finished MSI package so that the MSI can make a clean uninstall of the wrapped setup executable if the user or administrator chooses to uninstall the package.
Upgrade codes are a unique identifiers that tells the system which MSI packages that are different versions of the same program. If this is the first time you are building an MSI package for this program then you can let the wizard create an upgrade code for you. However, if you have built a package for an earlier version of the program then you should reuse that upgrade code.
Click next to go to the page where the program properties are set up.
Since you already installed the program the wizard can detect many of the property values from the registry. In case you hadn't installed the program then you could enter these values manually or have the wizard try to read them from the file properties of the executable. However, not all executable installers hold the correct values and therefore it is recommended that you install the program and let the wizard read the properties from the registry.
A second page of properties is shown when you click next after setting the properties.
Click next to set up some command line parameters for the wrapped setup program.
When the MSI package is installed the embedded setup executable is unpacked to a temporary location and run from there. You may be interested in passing some command line parameters to the executable when it is run by the Windows Installer. Typical use of this feature could be to set parameters for silent installation.
In our example the setup program will accept parameters for both quiet install and uninstall. Unless we want to force these parameters when installing the MSI package, we can leave these fields empty. The reason behind this is that we can specify parameters for the embedded setup executable at a later stage when running the MSI package using msiexec.exe.
Now you are ready to build your MSI package. The wizard has collected all the information it needs to complete the process. Before you click the "Build" button you should consider saving your current settings in a configuration file. You can reload these settings from the start page of the wizard if you need to make another MSI for the same program on an updated version of it. Please note that it is important to keep the selected upgrade code if you plan to make an updated version of the MSI at a later point in time.
When the MSI Wrapper has finished building the MSI package it will show you a status message. Alternatively, it will show you error messages if something didn't work out as expected.
Now that the MSI is ready the wizard offers you a couple of helpful features. You can either make it open a File Explorer in the folder where the output MSI package is stored or it can show you how to install the MSI using a msiexec.exe command line.
If you click the "Install MSI" button you will see the following dialog. This dialog can show you how to install your new MSI using the Windows Installer msiexec.exe command line tool. You can specify parameters for the msiexec.exe tool and also specify parameters that are passed on to the embedded setup program.
The finished command line can be copied on to the clipboard or launched.
That's it! You now have an MSI package for your favorite setup executable :-)