Skip to main content
Matrix42 Self-Service Help Center

Installation Guide II: Installation

Overview

This article will guide you through a typical installation of Silverback by Matrix42 and offer guidance on configuring the system for a successful deployment. For advanced configuration or special requirements, talk to your technical contact or raise a support ticket. 

Before you Start

Installation Files and License Key

Before beginning the installation, ensure that you’ve confirmed all the items in the Prerequisites Guide and that you have the following available:

Installation & Configuration

  • Launch the installer executable
  • Click Run if Security Warning appear
  • Click Next to begin
  • Ensure all prerequisites are installed and configured
  • Click Next
  • Read the license agreement

You can also print the agreement if needed

  • Click I accept the terms in the license agreement
  • Click Next
  • Enter a User Name (e.g Vincent Valentine)
  • Enter a Organization Name (e.g. Imagoverum)
  • Click Next
  • Proceed with Next or
    • Change the installation folder for the Silverback Website Directory Location (optional & not recommended)
    • Change the installation folder for the Silverback Services Directory Location (optional & not recommended)

As best practice use the recommended standard folders. All websites will be hosted on your IIS, so please ensure that the folder you may choose is accessible by the IIS. 

  • Select I understand and choose to proceed with the installation
  • Confirm with Next

The warning is designed only for updates

  • Keep Standard 
  • Click Next
  • Click Install
  • When Installation Wizard Completed screen appears, stop here and run Silverback SSL Certificate Tool

Silverback SSL Certificate Tool

Open newly Installed SSL Certificate Tool to quickly generate the Silverback Root CA certificate and import your SSL Certificate. 

  • Click on the Windows Icon in the Taskbar
  • Run recently added SSL Certificate Tool
  • Ensure that Certificate Type is set to CA
  • Enter as Company Name e.g. Imagoverum
  • Enter as Organisational Unit e.g.  Imagoverum Corporate
  • Enter Country: e.g. DE
  • Enter State: e.g. Hessen
  • Enter City Town: e.g. Frankfurt am Main
  • Change the Days Remaining to a minimum value of how long the Certificate should be valid
    • We recommend a value between 3650 for 10 years and 7300 for 20 years
  • Enter PFX Password: e.g. Pa$$w0rd
  • Click Generate

Import your SSL certificate

  • Switch Certificate Type to Website
  • Click Import SSL Certificate Tab
  • Enter your SSL Certificate password
  • Click Browse and Import Certificate
  • Select your SSL Certificate: e.g wilcard.imagoverum.com.pfx
  • Click Open

You should see now SSL Certificate has been imported and bound to the Silverback website. After that you have successfully created your Silverback Root CA certificate and imported and bound your SSL certificate.

Check Bindings

To check if everything went well: 

  • Open Internet Information Services (IIS) Manager
  • Expand your Server
  • Expand Sites
  • Right click on the Default Website item
  • Select Edit Bindings
  • Ensure that there are no https entries for port 443
  • Click Close
  • Right click Silverback and select Edit Bindings
  • Open https and check if your SSL certificate is selected
  • Click Cancel
  • Click Close

Proceed with Database Setup

  • Navigate back to Silverback - Installation Wizard
  • Ensure that Launch the Silverback Admin Console is enabled
  • Click Finish
  • Internet Browser will now try to open https://localhost/admin
  • Select Continue to this website or Go on to the webpage
  • Wait until the Database wizard will appear
  • Proceed with SQL Preparation

SQL Preparation 

Before we deploy your new Silverback's database, you need to configure your SQL Permissions based on the desired SQL setup and preferred authentication type.

Azure SQL 

For an Azure SQL hosted cloud database you need to ensure that your Silverback Server is able to establish a remote connection to the database. Additionally you should be aware of the connection string. In case you don't have any Azure SQL in place at this moment, please utilize Migration II: On-Premise to Azure SQL Database and perform the Azure SQL part and proceed here after the you've copied your connection string

On-Premise SQL

  • Open your SQL Management Console 
  1. For a deployment where SQL is located on a separate, dedicated SQL Server you can either:
  • For SQL Authentication: Add a new Login with SQL Server Authentication on SQL with dbcreator role

It is possible to decrease the rights later to db_owner

  • For Windows Authentication: If the servers are domain members, permission can be delegated to the Silverback server. Add the Silverback server (Domain\Computername$) as a user or add the Silverback Enterprise Device Management group and assign the dbcreator role
  1. For a deployment where SQL is located on the same server as Silverback do the following: 
  • For SQL Authentication: Add a new Login with SQL Server Authentication on SQL with dbcreator role 
  • For Windows Authentication: Create new Login with Windows Authentication on SQL for NT AUTHORITY\NETWORK SERVICE and assign dbcreator role

This is only recommended for small deployments with under 20 users or test environments, because SQL will compete with IIS for system resources

Database Creation

  • Enter now your SQL Database settings
Setting Description Mandatory
Use Azure SQL Enable if you are utilizing an Azure SQL hosted cloud database No
Data Server Address Network location of the SQL Server. Enter an IP-Address, FQDN or localhost Yes
Failover Database Server Address If using, an optional SQL server that will be used if the primary is not available No
Database Name Database name that Silverback will use. As best practice enter Silverback as Database name Yes
Use SQL Authentication By default, SQL Authentication is enabled. Enter a Username and Password for SQL Authentication. By disabling, the Windows permissions will be used to access the SQL Server. No
Web Settings Certificate Thumbprint

Silverback encrypts settings using this certificate. The installer will automatically generate this for you. It is stored under Certificates (Local Computer) > Personal > Certificates > Silverback Web Settings Certificate

Note that if this field is empty after a fresh install, this means that an encryption certificate already exists, so the installer didn’t create one. Most likely from a previous installation. You can choose an existing certificate by clicking “Pick” and then choosing the certificate.
Yes
  • Perform a cross-check
  • Click Save
  • Wait until the next screen appear and click OK
    • Keep Database data and log file locations (best practice)
    • or change the file location (optional)
  • Click Start Installation

If something went wrong use your browser to get back. If you locked you out, delete the SilverbackConnection String Registry key in Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\Silverback, restart the Internet Information Service and reopen localhost/admin

  • Wait until the database will be deployed.
  • After a successful database deployment you will see an Error Message "Server Error in '/admin' Application
  • Proceed with Change Login Parameters

Change Login Parameters    

Restart IIS & Login into Management Console

  • Navigate to your Internet Information Services (IIS) Manager
  • Restart the IIS
  • Navigate back to your Internet Explorer
  • Open now https://localhost/admin
  • Click Continue to this website
  • Enter the following credentials
  • Username: admin
  • Password: S1lverb@ck
  • Click SIGN IN

Next Steps  

 

  • Was this article helpful?