Install the Update

 Overview

1. Download the installation file from Matrix42 MarketPlace and save the .exe file on your server.

2. Right-click the file and select Run as Administrator. The Matrix42 Setup Wizard will be launched:
   
3. Click Launch the update process.
4. 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 for more details:

Install the required components, and then click Refresh.
Freely available system components are supplied on the CD or can be downloaded together with the installation file (the REDISTB.zip file). To continue the installation, you should install all the missing components.
For more details on required components see the System Requirements page.

For an update to DWP v.12.1.0 the following messages might appear:

• if you update the system versions earlier than 10.0.0 it requires an update to v.12.0.5 first, and only then it's possible to update to v.12.1.0 or higher
• suppose the AccessDatabaseEngine component installed from the redistributable folder during the initial system installation is compatible with 32-bit Windows systems. In that case, it is suggested to uninstall it and install a new version of Office System Driver Data Connectivity Components,  that is compatible with 64-bit Windows systems. This component is available in the Setup & Runtime Redistributables folder. See also, System Requirements: Office System Driver Data Connectivity Components page.
• if there are still present Workflows or Workflow Instances running on AppFabric:

5. Check the Environment Configuration and enter the password for the Service Account.
   In case you use SQL Server Authentication option to connect to the database, see  Configuration Wizard → Change Service Account section for more details.

6. Click Next.
7. 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.
   Open Internet Explorer and enter the Reporting Services URL to avoid timeouts during report updates. Do not close Internet Explorer.
   
8. Click Next.
9. Check the names of the databases for the Service Layer Configuration parameters:

10. Click Next.

11. Configure the security options of Matrix42 to protect the data that you process with Matrix42 Enterprise Service Management.

    • Use the HTTPS protocol if you want to encrypt your data when connecting to the Matrix42 Enterprise Service Management and Matrix42 Self Service Portal. To use the HTTPS protocol, you should specify the settings for Secure Socket Layer (SSL). The Domain name that you use for Matrix42 Enterprise Service Management is filled in automatically – the system reads it from the default IIS website – but you can change it.
    • Then 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.
    • Since 10.0.1 release, Force SSL option is the only possible. It means that when someone opens the console or the portal with the HTTP URL, they will be redirected to the HTTPS URL.

 

12. Click Next.

13. Continue with Security Configuration:
    •  Select the Activate Captcha checkbox to prevent automatic logins 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 are 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.

These settings can be changed later either in the Configuration Wizard or in the Global System Settings of Matrix42 Enterprise Service Management.

14. Click Next.

15. Configure STS (Secure Token Service):
    
    Use advanced settings for the Load Balancer properties configuration:
    
16. If necessary, modify the Cache Configuration options:
    
17. Check the Backup Settings and modify them as required.

18. Click Next.
19. A backup of the installation directory and the databases will be performed. 
    
20. Review the backup overview to ensure that the backup is completed successfully. Click Next. If there are no errors, the next dialog will be opened automatically after about 30 seconds.
    A complete database check will be performed. Depending on the size and customization degree of the respective databases, this may take a very long time.
    
    Individual problems that cannot be fixed automatically should be fixed manually. Additional information about the individual event IDs can be found in the online documentation. Just click the link Read more information online.
21. Click Apply. The displayed events will be fixed accordingly:
    
22. Click Next. A new database check will be performed until no more events are detected.
23. Click Next. If there are no errors, the Database Update dialog will be opened automatically after about 30 seconds:
    
24. The databases will be updated, and the setup wizard will configure your Matrix42 Enterprise Service Management installation:
    
25. Click Finish.
26. You will be prompted to close the Setup Wizard. Click Yes to confirm.

The configuration has been updated successfully and your Matrix42 Enterprise Service Management can be accessed again.

Log in to the Administration application to validate the system after the update and check the System Diagnostics results.