Skip to main content
Matrix42 Self-Service Help Center

Installation Guide V: Update

Overview

This guide covers the upgrade process for Silverback. This guide will show a common setup, but every environment is different! For advanced configuration or special requirements, talk to your technical contact or raise a support ticket to cover your needs. 

Please follow our recommendation to do for every update first a backup of your current system. 

Preparation

For the upgrades ensure that you have on the Silverback server, the installation executable files for the latest version you wish to upgrade to. Ensure that you have a functioning Silverback deployment before commencing an upgrade. This ensures that any issues can be traced to the upgrade process and not an existing issue

Stop Services

Launch the Services.msc application on your Silverback server, and stop all Silverback related services

  • Silverback EPiC Service
  • Silverback Maintenance Service
  • Silverback Queuing Service
  • World Wide Web Publishing Service (w3svc) or open Internet Information Services (IIS) Manager and Stop the Website 

stop-service w3svc,silv*,epic*,mat*  (Powershell + Administrative Privileges  

Backup Silverback Database

To ensure you can roll back the upgrade in the event of an issue, we will back up the SQL database. Generally, this backup can be requested from the group that manages your SQL databases.

If you need to manually do this:

  • Launch the SQL Server Management Studio,
  • Right click on your Silverback database
  • Select Tasks >
  • Select Back Up…
  • Ensure the backup type is Full, and specify the backup location
  • Click OK
  • Click OK after completion

Create Snapshot from Server (optional)

An optional method is to create a Snapshot from your Silverback Server which can be easily restored. This method is very useful if you have Silverback and SQL running on one server. 

Backup Configuration Files

To ensure you can rollback the upgrade in the event of an issue, backup the website configuration files. The simplest way to do this is, is to navigate to the location of the Silverback Installation Files on your server’s drive (e.g. C:\Silverback) and create a copy of the web.config file located in the /admin folder.  You should ideally preserve this backup until you can verify the upgrade process is complete.

Upgrade to Major Version

This section will describe the update from e.g. Silverback 18.0.3.25 to Silverback 19.0.0.1.

Installation

  • Launch the installer executable
  • Click Run
  • Wait until extracting is finished
  • Click Next
  • Ensure all prerequisites are installed and configured
  • Click Next
  • Carefully read the license agreement. You can also print the agreement if needed for documentation.
  • Select „I accept the terms in the agreement“
  • Press Next
  • Enter a username and organization name

This information is stored with Windows to track the installation, this information is only stored locally and is not sent anywhere.

  • Click Next
  • Click Next or change to your custom location for the Silverback Website files and Services. Proceed with Next

This should match the current installation, or the installer will deploy a new website in IIS.

  • Ensure that all Silverback Services and Silverback Website in IIS has stopped
  • Select I understand and choose to proceed with the installation
  • Click Next
  • Select Standard Setup Type and click Next
  • Click Install
  • Confirm Silverback Installer Information for required reboot 

A reboot is optional after upgrade

  • When the Upgrade is finished, keep everything as it is and proceed with Database Update

Database Update

  • Silverback Installation Wizard will detect your current configuration and prompt you to launch the admin console. 

Do not click Finish. 

  • Re-start all previously stopped services (Silverback Services + IIS)

restart-service w3svc,silv*,epic*,mat*  (Powershell + Administrative Privileges  

  • Navigate back to the Installation Wizard
  • Ensure that the Launch the Silverback Admin Console checkbox is enabled
  • Click Finish 
  • Admin Console will be opened  in your browser 
  • Click Continue to this website 
  • Wait until Database Upgrade page will appear 
  • Click Start Upgrade
  • Wait for completion
  • After the upgrade, your browser will redirect to the admin console login. Continue with the verification steps

Update To Hotfix

This section will describe the update from e.g. Silverback 19.0.0.1 to Silverback 19.0.0.2.

Installation

  • Launch the installer executable
  • Click Yes  
  • Wait until the extracting process is finished
  • Click Next
  • Click Next
  • Please wait while the installation wizard installs Silverback
  • Before you click finish check and re-start all previously stopped services (Silverback Services + IIS)
  • Click Finish 
  • Admin console will be opened in your browser
  • Proceed with Database Update

Database Update

  • Click Continue to this website 
  • Wait until Database Upgrade page will appear 
  • Click Start Upgrade
  • Wait for the database upgrade to complete
  • After the upgrade, the browser will redirect to the admin console login. Continue with the verification steps below.

Upgrade Verification

To verify that your installation functions as expected. Login to the admin console and inspect the devices list and other settings to ensure the console is functioning as expected. Also, test basic device functions such as:

  • Do enrolled devices have all of the settings they had prior to the upgrade?
  • Do the device functions (Lock, Block, Wipe etc.) function as expected?
  • Does an OTP generate successfully?
  • Was this article helpful?