Applies to: Employee Training 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 Employee Training Management on your SharePoint on premise.
In this article:Preparation
Sign on to the SharePoint Server’s console as an administrator.
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 Employee Training Management to during the setup.
Note: All screenshots below were taken from SharePoint 2010. There should be no differences in SharePoint 2013, 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.ETM\SP201x\Employee Training Management and run Setup.exe (as an administrator!).
This is the setup’s welcome screen. Click on Next.
Setup verifies the system state. Make sure the SharePoint Administration Service is started. You will have to restart the setup if one check fails.
Accept the terms in the License Agreement and click on Next.
Enter the license key and click on Next.
Select the Web Applications which you want the Employee Training Management to be deployed to.
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.
The Employee Training Management consists of 11 solution packages that must be added and deployed. This will take a few minutes.
After the last deployment job completes, click Next …
… to view a summary of the installation.
You can verify the installation by viewing the “farm solutions” of your SharePoint.
The following 11 solutions must be installed and deployed.
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.
Employee Training Management Configuration
Employee Training Management User Manual
Employee Training 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.
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 Employee Training Management” site feature. Go to the site settings of an Employee Training Management site, click on Manage site features and deactivate and re-activate the Sapiens.at.SharePoint Employee Training 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 Employee Training 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.
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.
