# 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. > [!NOTE] > > Each patch is different and the patch notes detail what systems you need to upgrade. See Patch notes for more information. ## 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 > [!NOTE] > > You don't need to uninstall the previous version. The install process does this automatically. 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 > [!NOTE] > > Updating **FastStats Binaries** lets you apply changes and bug fixes for the FastStats launcher without uninstalling and reinstalling the FastStats launchers. You need to close the launcher and log back in after the upgrade for the changes to apply. 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 > [!NOTE] > > Updating **PeopleStage Binaries** lets you apply changes and bug fixes for the PeopleStage launcher without uninstalling and reinstalling the PeopleStage launchers. You need to close the launcher and log back in after the upgrade for the changes to apply. 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]().