Skip to content

Building InCert for Windows Utility Mode

Brent Moberly edited this page Jan 12, 2015 · 1 revision

Prerequisites

Steps

  1. Download, install, and launch the preview version of InCert for Windows from the InCommon test server.

    Launch InCert image

  2. From InCert's "Login" dialog, click "Advanced."

    InCert Login Dialog

  3. From InCert's advanced menu, select item 19 ("Restart InCert in Utility Mode") and click the "Run."

    InCert Advanced Menu Dialog

  4. InCert will restart in Utility mode.

    InCert Utility Mode

  5. Click "Build Engine Package."

  6. From the certificate details dialog, provide the thumbprint for your code-signing certificate and, optionally, the Url for a timestamp server. Your certificate should be installed into your personal certificate store.

    InCert Certificate Details Dialog

  7. From the utility folders dialog, provide the paths to SignTool.exe and to the WiX 3.7 Toolset installation folder. The engine should provide these values for you, but you may need to modify them as necessary.

    InCert Utility Folders Dialog

  8. From the input folders dialog, provide the path to your secure files folder.

    InCert Certificate Details Dialog

    This folder contains the files that will be compressed into the signed "settings.cab" archive that will be bundled and installed with the engine. Only files included in the root of your secure files folder will be compressed into the final archive.

    Example InCert Archive Folder

  9. From the input folders dialog, check "Download engine and installer files" to download the latest version of the engine files and various installer directives from our server. Otherwise, uncheck "Download engine and installer files" to use local versions of these files.

  10. From the output name and folder dialog, provide the name for your installer and the folder that folder that will contain the assembled installer package.

    InCert Output Name and Folder Dialog

  11. From the installer details dialog, provide the installer version. Here, it is important that you use a version that is greater than any previous version numbers that you may have already deployed to users' computers. Otherwise, the installer's upgrade functionality will not function correctly.

    InCert Installer Details Dialog

  12. From the installer details dialog, provide the display name and institution name for the installation bundle. These values determine both the bundle's branding and the engine's installation folder.

  13. From the installer customization dialog, provide an icon path. This determines the icon associated with the installation bundle.

    InCert Installer Details Dialog

  14. From the installer customization dialog, provide a help url. This determines the web-page that will be opened if users click "Help" from the installer's dialog. Also provide a foreground and background color and check the appropriate boxes to have the installation bundle create Desktop and Start Menu to InCert.

  15. From the build dialog, click "build."

    InCert Installer Build Dialog

  16. The engine will now assemble your installation bundle. This may take a few minutes.

    InCert Installer Building Dialog

  17. If everything worked, your installation bundle (and it's accompanying info.xml file) will be placed into your output folder. You can access this folder from the build complete dialog.

    InCert Installer Details Dialog

    Output Folder

  18. Place your installation bundle and its info.xml file on your server.