SharePoint Event Management Installation

Applies to: Event Management for SharePoint on premise (SP2010, SP2013, SP2016, SP2019)
Other versions: View the version for Office 365/SharePoint online


The following guide describes how to install the Event Management on your SharePoint on premise.

In this article:

Preparation

Sign on to the SharePoint Server’s console as an administrator.

Extract the SharePoint Event Management Setup

Download the latest release and unzip the setup files to a local folder.

Make sure that the setup has write access to the setup files’ folder.

The worker process pools of your SharePoint Farm will be recycled during installation. Consider which web applications you want to deploy the Event Management to during the setup.

Note: All screenshots below were taken from SharePoint 2013. There should be no differences in SharePoint 2010, SharePoint 2016 or SharePoint 2019.

Installation

Browse to the folder where you unzipped the setup files. The folder SP2010 contains the setup and solution packages for SharePoint 2010, the SP2013 folder contains the setup and solution packages for SharePoint 2013, and so on.

Navigate to …sapiens.at.setup.EVM\SP201x\Event Management and run Setup.exe (as an administrator!).

Run the setup as administrator

This is the setup’s welcome screen. Click on Next.

Event Management for SharePoint 2013 Setup

Setup verifies the system state. Make sure the SharePoint Administration Service is started. You will have to restart the setup if one check fails.

System Check

Accept the terms in the License Agreement and click on Next.

End-User License Agreement

Enter the license key and click on Next.

License Key

Select the Web Applications which you want the Event Management to be deployed to.

Web Application Deployment Targets

The setup will now try to validate the key. If the setup can’t connect to the key validation service (http://keyvalidation.sapiens.at/validate.asmx) the setup will fail. To continue with the installation, please take a look at Offline license validation.

Validating License Key

The Event Management consists of 11 solution packages that must be added and deployed. This will take a few minutes.

Solution Deployment Job

After the last deployment job completes, click Next …

Installation successfully completed

… to view a summary of the installation.

Installation Protokoll

You can verify the installation by viewing the “farm solutions” of your SharePoint.

Manage Farm Solutions

The following 11 solutions must be installed and deployed.

Check Farm Solutions

Please note that you don’t need the last solution if you use it on SharePoint 2010.

If all solutions are deployed successfully, continue with the configuration.

Event Management Configuration

Event Management User Manual

Event Management Overview

Update

The new version is published as the latest setup. The download contains one setup for SharePoint 2010, one for SharePoint 2013, one for SharePoint 2016 and one for SharePoint 2019.

Download the latest setup

View the release notes

Run setup.exe as an administrator and choose ‘Repair’ after the system check.

If the setup can’t connect to the key validation service the setup will fail. To continue with the installation, please take a look at Offline license validation.

If your key is invalid, please send an e-mail to support@sapiens.at and include your current license key. We will get back to you as soon as possible.

After the setup is complete, you have to deactivate and then re-activate the “Sapiens.at.SharePoint Event Management” site feature. Go to the site settings of an Event Management site, click on Manage site features and deactivate and re-activate the Sapiens.at.SharePoint Event Management feature.

Finally restart the SharePoint Timer Service on all servers in the SharePoint farm.

Uninstall

If you want to uninstall the solution completely, you have to delete all Event Management webs or at least all lists created from the template. Otherwise you’ll receive an error when opening any of the lists after the uninstall. You also have to deactivate all sapiens.at.SharePoint site collection and site features.

When all the features are deactivated, you can uninstall the solution. Re-run the setup and choose Remove after the system check.

Remove the solution

As an alternative, you can also retract and remove the solutions from the farm solutions in central administration. Please note that you cannot move the license to a different system if you use this approach.

Offline key validation

If your SharePoint Server is located behind a proxy or is not permitted to access our online key validation service you will need to perform an offline validation to successfully complete the setup and activate the solution. For online validation go to http://keyvalidation.sapiens.at/manualvalidation.aspx. The unvalidated surety file which you need to upload is created during the setup process. Upload it, then validate it and download the validated surety file to the setup folder and run the setup again.

Move license to a different system

If you want to move your license to a different system, please uninstall the solution from your old system using our setup (see Uninstall) and install the solution again on your new system. This is not possible if you use a trial key.

Manually remove license usage

If your SharePoint Server is located behind a proxy or is not permitted to access our online key validation service you will need to remove the license usage manually to be able to use the license key again on a different system. If the setup can’t connect to the key validation service (http://keyvalidation.sapiens.at/validate.asmx) it will create a file named uninstallSurety…xml in the setup folder. Upload this file to http://keyvalidation.sapiens.at/manualuninstall.aspx to remove the license usage. Now the license key can be used on a different system.