Skip to content

FastStats launcher configuration

The following guide takes you through the steps required to configure your FastStats launcher, distributed as a Microsoft Installer (MSI) file.

Configuring the launcher files

  1. Run Setup Manager on the web server.
  2. Select Browse and open the appropriate FastStats64LauncherSetup.msi file from FastStatsEnterprise\Launcher\systemname\FastStats64LauncherSetup.msi.

The FastStats Setup Manager window opens. Configure the relevant tabs as described below.

Properties tab

Rename the Product Name to match the system for this FastStats launcher.

Product name field in Setup Manager Properties tab

Note

It's best practice to tick Base installer identity on Product Name to avoid issues when opening multiple launchers with the same product name.

Field Value
Product name Rename to match the system (e.g. FastStats Holidays - Launcher)
Base installer identity on Product Name Recommended: lets you run multiple launchers simultaneously

Appearance tab

You don't need to change the default configuration unless you want to replace the default FastStats icons and banners.

Appearance tab in Setup Manager

Configurator tab

  1. Select Launch Configurator to edit the Launcher64.exe.config file held within the MSI.

    Launch Configurator button

  2. Update the Application Base URL and the Application Configuration File to use the web server address:

    Application Base URL field

    Client configuration fields

    Field Value
    Application Base URL http://MyWebServer/FastStatsWebService/GetBinary.aspx/Holidays/Binaries (replace localhost with your web server name and Holidays with your Binaries name if different)
    Application Configuration File http://MyWebServer/FastStatsWebService/DiscovererConfiguration.aspx/Holidays (replace localhost with your web server name and Holidays with the FastStats Client configuration name if different)
  3. Choose File > Save to save the Launcher64.exe.config file back into the MSI.

  4. Close the Launcher Configurator window to return to Setup Manager.

Directory structure tab

Setup Manager directory structure tab

  1. Expand Desktop and Programs Menu.
  2. Paste the same shortcut names you set for Product in the Properties tab.
  3. Right-click on these and select Rename.

Digital signature

Digital Signature section in Setup Manager

If you need to set up a digital signature for the launcher:

  1. Tick Digitally Sign Installer and select the Certificate File and Private Key File.
  2. Once the launcher setup changes are complete, choose File > Save to save the MSI.
  3. Select Yes on the 'No Digital Signature information has been specified, are you sure?' message if you don't need a digital signature.

    Confirmation dialog for no digital signature

  4. If you have a digital certificate, apply it here if required.

    Installer identity with digital certificate applied

This ensures the product installs only once on a user's machine.

Moving the launcher installer to your web server

On your web server, the base directory is by default C:\inetpub\wwwroot\. When translated to a browser address, this is http://MyWebServer/.

The Launcher directory serves the FastStats application to your clients. Create a separate folder for each system underneath this folder. When translated to a browser address, this is: http://MyWebServer/Launcher/Holidays/.

Copy files

Copy the following files to the system folder (find these in the FastStatsEnterprise.zip Launcher/systemname/ directory):

  • FastStatsLauncherSetup.msi: the launcher file you configured
  • LaunchPage.html
  • AptecoHTMLpages.css, the js directory, and the image directory

Editing the launch page

The LaunchPage.html provides end users with an easy page to download the launcher from. By default, it includes both the FastStats 64-bit and 32-bit launcher links. The following process removes the 32-bit launcher, leaving only the 64-bit launcher.

If you open the launch page in a browser, it looks like this:

LaunchPage.html in a browser before editing

To remove the FastStats 32-bit launcher:

  1. Open LaunchPage.html in a text editor such as Notepad++.

    LaunchPage.html source in text editor

  2. Delete line 49, which contains:

    HTML
    <a href="FastStatsLauncherSetup.msi" target="_blank">Download Apteco FastStats 32 bit Launcher
    

    HTML after removing the 32-bit launcher link

  3. Save the file and open it in a browser to verify the changes.

    LaunchPage.html after removing 32-bit link

  4. Select Download Apteco FastStats 64 bit Launcher to confirm the MSI downloads.

Send clients the launch page

Send clients the following install link: http://MyWebServer/Launcher/Holidays/LaunchPage.html