Skip to main content
Matrix42 Self-Service Help Center

Installation: Step by Step

You can either install Matrix42 Software Asset & Service Management on one server (all-in-one installation) or distribute it on two servers (distributed installation on the Web server and the database server). This topic describes the all-in-one installation in detail. Comments about the distributed installation are included, as required.


  1. Save the .exe file on your server. For Windows Server 2008 and greater, right-click the file, and then click Run as Administrator. The Matrix42 Setup Wizard will be launched.


  1. Click Launch the installation process.
  2. Read the License Agreement. Click Accept to accept the license agreement.

Then the installation wizard will check the system prerequisites.

If your system does not meet all system prerequisites, those missing will be displayed under Required Components. Click the respective component to get more details.


Freely available system components are supplied on the CD or can be downloaded together with the installation file (the file). To continue the installation, you should install all missing components.

  1. The installation wizard will select the default installation path (C:\Program Files (x86)\Matrix42\Matrix42 Workspace Management\) for the installation files. You can change this installation path by using the Browse button.
  2. Under Service Account, enter the Login and the Password.

This account is used to communicate with IIS [application pool] and receive client requests.


The service account is specified as owner of the databases on the database server.

  1. Click Next.
  2. Now you should license the installation: If you use the online activation option, enter your license key in the License Key field, and then click Activate License (active Internet connection is required for this purpose).

If you use a certificate as a license key, click Browse Certificates. Save your certificate(s) to the Certificates Directory and close it. The certificate(s) will appear in the list under Manual Activation.


  1. Click Next.
  2. Create an administrative user for interactive login to Matrix42 Software Asset & Service Management.

Enter your installation user or the user that will open the application for the first time and will add other users.


  1. Click Next.
  2. Specify your E-Mail Settings: SMTP Server, Default Sender, Authentication details, and Password. This information will be used in notifications and other types of emails. You should also specify whether you want to Send test mail to check SMTP server configuration and select the Default Language of your environment.


  1. Click Next.

You may skip this step by clearing the Send test mail to check SMTP server configuration checkbox. If you leave it selected and then click Next, an error message (in red) will appear at the top of the window. Click the respective error message.


Now you can click Skip to skip the configuration process.

  1. Enter your SQL Server Name, possibly including the instance name, and apply all other default settings.
  2. Enter the database names. We recommend that you apply the automatically inserted values.

Enter the local SQL server name if you want to perform an all-in-one installation, and the remote SQL server name for a distributed installation.


The SQL server should operate in the mixed mode [SQL Server and Windows authentication mode]. Use the Latin1_General_CI_AS language scheme ("collation").

  1. Click Next.
  2. Enter the Analysis Services Server and the Analysis Services DB. In most cases you can apply the suggested entries.
  3. Enter the Reporting Services URL. The default name of this website is http://<Servername>/ReportServer. It will be specified during the configuration of MS SQL Reporting Services. In most cases you can apply the suggested URL to the installation server.

To avoid timeouts during the first creation of the report, open Internet Explorer and enter the Reporting Services URL. Do not close Internet Explorer.


  1. Click Next.
  2. Specify the Service Layer Configuration parameters for your Matrix42 Software Asset & Service Management environment. First, enter the names of the Workflow Persistence and Monitoring databases.

You can apply the automatically specified values for all-in-one installation.


  1. Click Next.
  2. Second, specify the Security Configuration parameters for Service Layer. Please make sure that the specified Security Group for AppFabric configuration exists (was created manually) on the distributed server/in the domain. Members of this group should be assigned write rights on the Workflow Persistence and Monitoring databases. Matrix42 Service Account should also be a member of this group. Finally, select the Run AppFabric with Matrix42 Service Account checkbox for distributed installation. To protect the Service Layer connections, the service and client certificates will be generated and installed on the local computer.


  1. Configure the security options of Matrix42 to protect the data that you process with Matrix42 Software Asset & Service Management. If you want to encrypt your data when connecting to the Matrix42 Software Asset & Service Management Console and Matrix42 Self Service Portal, you should use the HTTPS protocol. To use the HTTPS protocol, you should specify the settings for Secure Socket Layer (SSL). The Domain name that you use for Matrix42 Software Asset & Service Management is filled in automatically – the system reads it from the default IIS website – but you can change it. Then you should choose whether to Use your own SSL Certificate or Use Self Signed Certificate. If you use your own SSL certificate, then all necessary settings are defined automatically based on the provided domain name. If you use a self-signed certificate, then you should provide a password to create this certificate.

Finally, select the Force SSL option if you want to always use HTTPS for the console and the portal. It means that when someone opens the console or the portal with the HTTP URL, they will be redirected to the HTTPS URL.

You can change the configuration settings later either in the Configuration Wizard or in Global System Settings of Matrix42 Software Asset & Service Management.


  1. Click Next.
  2. Continue with Security Configuration. Select the Activate captcha checkbox to prevent automatic logins to the Matrix42 Self Service Portal or Matrix42 Software Asset & Service Management Console from external sources. The captcha will be displayed after the first unsuccessful login attempt. For more advanced protection from such logins, use the Lock Accounts option. Enter a number of unsuccessful login attempts after which the account will be locked, and a time period (in minutes) after which the account will be unlocked. Please note that the minimum number of attempts should be 3, and the minimum time period should be 10 minutes. Information about all (un)successful login attempts and account (un)locking events including the IP addresses is stored in the Matrix42.Security.log file under %programfiles%\Matrix42\Matrix42 Workspace Management\Logs. In addition, information about failed login attempts and locked accounts is stored in Windows Event Log (Applications) under the M42_SEC event name. Finally, select the Encrypt VIEWSTATE checkbox to encrypt information that is passed to the server every time someone changes data in Matrix42 Software Asset & Service Management. This setting provides additional client side security, but be aware that it may decrease client performance.

You can change these settings later either in the Configuration Wizard or in Global System Settings of Matrix42 Software Asset & Service Management.


  1. Click Next.
  2. An overview of the collected information will be displayed. Click Next.


The setup wizard will now install and configure Matrix42 Software Asset & Service Management. This process will take from 30 to 60 minutes, please wait.

While Publishing workflows it is possible that some workflows are not able to be published due to different reasons. Setup itself will automatically retry (3 times) publishing workflows that failed to be published. That may fix some failures that occurred due to locked files or directories.

Publish failure reasons are listed in a setup log, displayed above the progressbar.

If after 3 retries some workflows remained unpublished Setup wizard will alert user about the actions he may perform.


User may either decide to skip publishing failed workflows (and optionally publish them later) pressing on "Yes" button, or fix the issue and retry publishing them. In that case user should press "No" in a popped up dialog and press "Retry" button whenever he believe he resolved the issue.



  1. The setup wizard will inform you that the installation is completed successfully. Click View the Installation Summary Report to view more details about the changes that have been made on the installation server during the installation/configuration.


  1. Select the Launch Matrix42 Workspace Management Console checkbox if you want to open the console directly after the installation.
  2. Click Finish.

The console will be opened if you have selected the default setting.

  • Was this article helpful?