Skip to main content
Matrix42 Self-Service Help Center

Configuration Package Installation


There are two options for the Configuration Package installation: upload package and run installation via the user interface or run the installation directly on the application server with the PowerShell script.

Only Administrator can run the package installation.

Install Package Action

To install Configuration Package via user interface proceed to the Administration application → Extensions → Installed Packages → click Install Package action: 


Uploaded and ready for installation Configuration Package details preview

  1. Upload the archive of Configuration Package in the suggested field;
  2. Wait for the Configuration Package details preview, depending on a package size the upload may take a while. If the Setup Directives differ from the default values the system informs that the package installation may cause the system downtime. Confirm the warning message and proceed:
  3. Click Start Installation. The Installation Progress view shows more details about the current installation processing stage and occurring errors.
  4. Click Finish to complete the package installation.

The page reloads and the installed package is available in the system.


Configuration Package Installation Progress view: successfully finished installation example

Only one package installation can be running at the same time in the same environment.

If another Administrator user tries to start the package installation the following message is shown:


Installation with cmdlet PowerShell script

To install the package:

  1. Upload the package archive to the application server;
  2. Enable maintenance mode (optional, depending on the package);
  3. Run the PowerShell script as an Administrator to install the package:
Import-Module "<PathToYourInstallation>\bin\matrix42.maintenance.cmdlets.dll" -force
$Credentials = Get-Credential
New-WMConfigurationSession -Credentials $Credentials
Enable-WMMaintenance             #Switching Maintenance Mode On (optional)
Install-ConfigurationPackage -File "<PathToYourPackageZipArchive>" -Log packages.log -ExitOnError
Disable-WMMaintenance            #Turning Maintenance Mode Off (optional)

For more information see also Interactive Usage of Powershell page.

The successfully completed Configuration Package installation may look as follows:


Package Components Installation sequence

Package Installation regardless of the installation type (via user interface or PowerShell script) involves standard for the Configuration Packaging processing stages.

The overall sequence includes the following steps:

  1. Enable maintenance mode
  2. Stop services
  3. Files copy (including assemblies)
  4. Applying Schema Scripts
  5. Applying SQL script
  6. Applying PowerShell script
  7. Automatic compliance rule processing
  8. Automatic workflow publishing
  9. Report deploy
  10. Service restart
  11. Application pool recycle
  12. Remove maintenance mode

Not all steps are mandatorily applied for your specific Configuration Package installation. Depending on the Configuration Package content and settings, like Setup Directives, some steps can be skipped or omitted.

Installation Troubleshooting & Recovery Console

For cases when the package installation via the user interface fails, analyze and fix the issue using the information provided in the installation progress view and click Retry:


Use Cancel to abort the package installation.

In the future release, the Cancel button will revert the changes applied by the package and rollback the system to the previous state.

For the cases when the package installation runs in the maintenance mode and the installation fails due to some reason, the system provides an installation recovery console where the issues can be analyzed and the package installation can be canceled.

The installation recovery console opens automatically for the system administrators when the package installation running in the maintenance mode has failed and the system is not available for other users.

The package installer recovery console lists all packages that have been installed on the current environment and the package installation in progress:


The same as for the Install Package action, you can analyze and fix the issue using the information provided in the installation progress view and click Retry or click Cancel to abort the installation and turn off the maintenance mode. 

The installation recovery console can also be accessed by the Administrator by adding /wminstaller to the application URL.

Any user with Administrator permissions can access the recovery console and retry or cancel the package installation started by other Administrator on the current system environment.

Click on the package to see details:


Installed Packages

The Installed Packages are listed on a dedicated page of the Administration application:


  • Was this article helpful?