Upgrade Statistics Manager for Skype for Business Server 2015

Summary: Read this topic to learn how to upgrade Statistics Manager for Skype for Business Server 2015.

This topic describes how to upgrade an existing installation of Statistics Manager for Skype for Business Server—a powerful tool that allows you to view Skype for Business Server health and performance data in real time. You can poll performance data across hundreds of servers every few seconds, and view the results instantly on the Statistics Manager Website.

For more information about Statistics Manager and the new features in Release 1.1, see Plan for Statistics Manager for Skype for Business Server 2015 and Deploy Statistics Manager for Skype for Business Server 2015. For information about known issues fixed in Release 1.1, see Known issues fixed in release 1.1.

There are two methods for upgrading:

  • Automated upgrade. This method uses an automated script. It is the easiest method and should be applicable to all upgrade scenarios.

  • Manual upgrade. This method is provided as a backup plan in the unusual case that the automated upgrade fails.

Prerequisites

Before you upgrade, be sure you have the following information:

  • Active Listener Certificate Thumbprint

  • Listener Service Password (entered on install of the listener and every agent)

  • SSL Certificate configuration for the website

Automated upgrade

The script will gather your current certificate information and listener password, uninstall the old version of the product, and then install the new version of the product. The Redis instance installed on the server will not be touched, so any data stored in the cache will be retained through the upgrade process.

  1. Place the MSI files for the new version of the agent, listener and website along with the Update-StatsMan.ps1 script into a single folder on the Listener computer.

  2. Open an administrative PowerShell window. Upgrade the Listener component:

    .\Update-StatsMan.ps1 -Service Listener
    

Note

The Statistics Manager service password will be displayed in clear text on the command line as it is passed to the installer. Be sure to shield your monitor as needed.

  1. On running the script, you should be prompted to uninstall the old version of the product. Answer Yes.

  2. If the Listener service is running, you will be prompted to close the application before continuing. Allow the application to close (the Statistics Manager Listener service will be stopped).

  3. Continue the install process. You should notice that the service password and certificate thumbprint are pre-populated. If not, add the values you saved before continuing.

  4. Open an administrative PowerShell window. Upgrade the Website component:

    .\Update-StatsMan.ps1 -Service Website
    
  5. On running the script, you should be prompted to uninstall the old version of the product. Answer Yes.

  6. If the Agent service is running, you will be prompted to close the application before continuing. Allow the application to close (the StatsMan Agent service will be stopped).

  7. Continue the install process. You should notice that the service password and certificate thumbprint are pre-populated. If not, add the values you saved before continuing.

  8. Open an administrative PowerShell window. Upgrade the Agent component:

    .\Update-StatsMan.ps1 -Service Agent
    
  9. On running the script, you should be prompted to uninstall the old version of the product. Answer Yes.

  10. Continue the install process. You should notice that the website port is pre-populated. If not, add the value you saved before continuing.

  11. Verify the website is working as expected using the browser.

Note

The Agent upgrade can be used with the -NoPrompt switch. This will allow the uninstall/install process to run silently, allowing tools such as PSExec to run the upgrade remotely on a large number of servers.

Manual upgrade

If for some reason, the automated upgrade fails, you can always perform a manual upgrade as follows:

  1. On the Listener computer, uninstall the Listener, Website and the Agent (if it was installed on this server) via the Programs and Features control panel.

    Note

    Keep Redis installed so that the data in the cache will then be maintained through the upgrade process.

  2. Install the new versions of the components, including the values you saved above when prompted for them. For more information about installing components, see Deploy Statistics Manager

Known issues fixed in release 1.1

The following known issues have been fixed in release 1.1:

  • UI/Server/Agent - Numerous significant reliability and performance improvements

  • UI - Main filter control now sorts correctly with different cases (was leading people to think certain servers weren't in the system when they were)

  • Server - Server components will now install on non-English servers.

  • Server/Agent - In some cases, agent and server components would not install with .NET errors due to a specific version of .NET 4.0. This has been resolved.

  • Agent - Extended event logging added for the StatsMan Agent. The agent will no longer crash when installed on a server not in the topology, this will now be logged in the event log, along with many other possible error conditions.

  • UI - Web clients using the Chrome browser would see multiple login prompts when using a client computer not joined to the same workgroup or domain as the Statistics Manager Web server. Now only a single login should be required per session.

For more information

For more information, see the following: