PeopleStage launcher configuration

The following guide takes you through the steps required to configure your PeopleStage launcher.

Configuring the launcher files¶

1. Run Setup Manager on the web server.
2. Click Browse and open the appropriate PeopleStage64LauncherSetup.msi file from PeopleStageEnterprise\Launcher\systemname\PeopleStage64LauncherSetup.msi.
3. The FastStats Setup Manager window opens. Configure the relevant tabs as described below.

Properties tab¶

Under the Properties tab, rename the Product Name and Description to match the system for this PeopleStage launcher.

Appearance tab¶

No changes from the default configuration are needed unless you want to replace the default PeopleStage icons or banners.

Configurator tab¶

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

   

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

   

   

   Field	Value
   Application Base URL	http://MyWebServer/FastStatsWebService/GetPeopleStageBinary.aspx/Holidays/Binaries—replace localhost with your web server name and Holidays with your Binaries name if different
   Application Configuration File	http://MyWebServer/FastStatsWebService/PeopleStageConfiguration.aspx/Holidays—replace localhost with your web server name and Holidays with the FastStats Client configuration name if different

   Note

   When configured, the Application Configuration File is installed onto the client's machine and provides it with Binaries and PeopleStage Client settings to retrieve from the FS_Config database via the FastStats Web Service: http://MyWebServer/FastStatsWebService/GetBinary.aspx/FastStats/Binaries

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¶

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

Digital signature¶

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. Click Yes on the 'No Digital Signature information has been specified, are you sure?' message if no digital signature is required.

   

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

   

This ensures the product can only be installed once on a user's machine.

Moving the launcher MSI to your web server¶

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

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

Copy files¶

Copy the following files to the system folder (these can be found in the PeopleStageEnterprise.zip Launcher/systemname/ directory):

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

Editing the launch page HTML¶

The LaunchPage.html provides end users with an easy page to download the launcher from. By default it is configured with FastStats launcher links. The following process replaces the FastStats 32-bit launcher with the PeopleStage 64-bit launcher.

If the launch page is opened in a browser, it looks like this:

To change the FastStats 32-bit launcher to the PeopleStage 64-bit launcher:

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

   

2. On line 49, change the following:

   • File name: href="../FastStatsLauncherSetup.msi" → href="../PeopleStage64LauncherSetup.msi"
   • Link text: Download Apteco FastStats 32 bit Launcher → Download Apteco PeopleStage 64 bit Launcher

   

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

   

4. Click Download Apteco PeopleStage 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