Applying patches

At some point you may need to apply a patch to Apteco software if, for example:

• A bug turns up in the software
• An external source, such as Facebook, has made an API change

Follow this guide to help you upgrade your Apteco software.

Determine your current release version¶

To determine your current FastStats Service version:

1. Open the FastStats Configurator.

2. Select FastStats Services.

   

   Here you can see the version number and quarterly release under Version. In this example, the release is Q2 2023.

3. Close the FastStats Configurator.

Download the patched software¶

To get the latest Apteco software, log in to the Apteco website and go to the Software Release section of the portal:

• portal.apteco.com/portal/software-releases

To see which part of the Apteco software a patch affects, select Read the patch notes on the portal. This takes you to the patch notes page on the Help Hub.

Each patch note details which products of the Apteco software you need to reinstall with the latest version of the release.

Installation files¶

For patches to the products listed below, download the corresponding .zip file and run the necessary .msi file to install the upgraded version:

• FastStats Designer (Designer.zip)

• Response Gatherers

  • FastStats Email Response Gatherer (DigitalIntegration.zip)
  • Facebook Response Gatherer (DigitalIntegration.zip)
  • Twitter Response Gatherer (DigitalIntegration.zip)
  • LinkedIn Response Gatherer (DigitalIntegration.zip)
  • Google Response Gatherer (DigitalIntegration.zip)

• FastStats Excelsior (Excelsior.zip)

For patches to the products listed below, download the WebService.zip and follow the individual instructions for each of the products:

• Web Service
• FastStats Configurator
• FastStats Service
• FastStats Launcher Binaries
• PeopleStage Launcher Binaries

Applying a patch¶

Web Service¶

To install the upgraded version of the Web Service:

1. Unzip the WebService.zip on to the server that currently has the Web Service running.
2. Browse the to WebService\WebServer\Web Service Installer folder.

3. Run the setup.exe.

   

4. Follow the on screen instructions to complete the upgrade.

FastStats Configurator¶

To install the upgraded version of the FastStats Configurator:

1. Unzip the WebService.zip.
2. Browse to the WebService\Configuration Utility folder.

3. Close the FastStats Configurator on the App server, then run the FastStats Configuration x64 Setup.msi file.

   

4. Follow the on screen instructions to complete the upgrade.

FastStats Service¶

To upgrade the FastStats Service:

1. Install the latest FastStats Configurator, which contains the upgraded version of the FastStats Service.

2. Open your FastStats Configurator and select FastStats Services.

   

3. Stop the Service that the patch applies to. From the FastStats Service Manager, highlight the Service and select Stop.

   

4. Select Update. The FastStats Service Upgrade box opens with details of the service, including:

   • Service current version
   • Version that the Upgrade Service moves on to
   • Upgrade to Integrations
   • Create Backups including number of backups to keep

5. Select Upgrade Service.

6. If the patch includes a change to an integration, such as an Email Service Provider or Social integration, then make sure to check Upgrade Integrations.

   

7. Select Upgrade. When complete, a confirmation box appears.

8. Start the Service again to complete the upgrade.

FastStats launcher binaries¶

To upgrade the FastStats Binaries:

1. Make sure you have installed the latest FastStats Configurator, as this contains the upgraded version of the FastStats Binaries.
2. After you upgrade the FastStats Configurator, open it and select Web Service.

3. A Web Service Chooser dialog box appears. If you've used this FastStats Configurator before, it's prepopulated. Otherwise, enter the connection string to the FS_Config database.

   

4. Select OK.

5. The FastStats Web Service Configuration is now available. To upgrade the FastStats Binaries, select Client Binaries.

   

   A list of the configured Binaries is now available.

   Note

   Select the Client Discoverer (former name of Apteco FastStats) for the FastStats Configuration that's having the patch applied, then select Update.

   

6. Choose the Discoverer Package and select OK.

   

   The Binaries start to update.

   

7. Once the binaries finish updating, select OK.

8. Close the Client Binaries dialog box.
9. Close the FastStats Web Service Configuration. This automatically saves the changes you applied to the binaries.

When you next start your FastStats launcher, it uses the new binaries.

PeopleStage binaries¶

To upgrade the PeopleStage Binaries:

1. Make sure you have installed the latest FastStats Configurator, as this contains the upgraded version of the PeopleStage Binaries.
2. After you upgrade the FastStats Configurator, open it and select Web Service.

3. A Web Service Chooser dialog box appears. If you've used this FastStats Configurator before, it's prepopulated. Otherwise, enter the connection string to the FS_Config database.

   

4. Select OK.

5. The FastStats Web Service Configuration is now available. To upgrade the PeopleStage Binaries, select Client Binaries.

   

   A list of the configured Binaries is now available.

   Note

   Select the Client PeopleStage for the FastStats Configuration that's having the patch applied, then select Update.

   

6. Choose the PeopleStage Package and select OK.

   

   The Binaries start to update.

   

7. Once the binaries finish updating, select OK.

8. Close the Client Binaries dialog box.
9. Close the FastStats Web Service Configuration. This automatically saves the changes you applied to the binaries.

When you next start your PeopleStage launcher, it uses the new binaries.

For more detailed Apteco software installation guides, see Installation and updates.