SharePoint Calendar E-Mail Extension Installation

Preparation

Sign on to the SharePoint application server as an administrator.

Unzip the setup files to a local folder.

Extract the setup

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 Calendar E-Mail Extension to during the setup.

Uninstall previous version to upgrade from version 3

For a new deployment you can skip this section.

Step 1: Run the following command in SharePoint Management Shell for each site where the features are activated. Change http://yoursite with the URL of the site collection.

$web = Get-SPWeb http://yoursite
$f = $web.Fields.GetFieldByInternalName("icExternalParticipants")
$f.Type = [Microsoft.SharePoint.SPFieldType]::Note;
$f.Update($true)
$f = $web.Fields.GetFieldByInternalName("icExternalInvitedParticipants")
$f.Type = [Microsoft.SharePoint.SPFieldType]::Note;
$f.Update($true)
$web = Get-SPWeb http://yoursite
$f = $web.Fields.GetFieldByInternalName("icExternalParticipants")
$f.Type = [Microsoft.SharePoint.SPFieldType]::Note;
$f.Update($true)
$f = $web.Fields.GetFieldByInternalName("icExternalInvitedParticipants")
$f.Type = [Microsoft.SharePoint.SPFieldType]::Note;
$f.Update($true)

Step 2: Deactivate the Meeting Organizer and Calendar E-Mail Extension features in the site settings of all sites where these features are activated.

Step 3: Run SetupMO (as an administrator!) to uninstall Meeting Organizer. Alternatively you can retract and delete the solution package calendar_email_extension_mws from the solution store in the central administration, system settings.

Step 4: Run Setup (as an administrator!) to uninstall Calendar E-Mail Extension. Alternatively you can retract and delete the solution package sapiens.at.sharepoint.calendar_email_extension from the solution store.

Step 5: Run SetupFramework (as an administrator!) to uninstall sapiens.at.sharepoint.all.2.3.0 from the solution store.

Step 6: In Server Manager, Configuration, Services restart SharePoint Timer service (on all servers in your farm which can process incoming e-mail).

Installation

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

Navigate to …sapiens.at.setup.CEE\SP201x\Calendar Email Extension and run Setup.exe (as an administrator!).

NOTE: The screen shots were taken from the SharePoint 2013 Setup. There should be no differences in SharePoint 2010 or SharePoint 2016.

Run setup as administrator

Ignore the security warning and click on Run.

Ignore security warning

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

Setup - Welcome screen

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

Setup - System Check

 

Select the Web Applications which you want the Calendar E-Mail Extension to be deployed to.

Setup - Select Web Application

 

Enter the license key and click on Next.

Setup - Enter License Key

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) it will create a file named unvalidatedSurety…xml in the setup folder. Upload this file to the manual validation page http://keyvalidation.sapiens.at/manualvalidation.aspx to perform an offline validation and download the validated surety file, then store it in the setup folder and rerun the setup.

Setup - Validating License

The Calendar E-Mail Extension consists of 3 solution packages that must be added and deployed. This will take a few minutes.

Setup - Installing Solution

After the last deployment job completes, click on Next …

Setup - Installation Completed

… to view a summary of the installation.

Setup - Installation Successfully Completed

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

Central Administration - Manage farm features

The following 3 solutions must be installed and deployed.

Central Administration - Farm Features list

Please note that only the first 2 solutions are required for SP2010.

Install the Exchange resource booking add-on

To install and configure Exchange resource booking, please follow this post:

Book rooms and equipment directly from a SharePoint calendar

Upgrade

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

To upgrade to the new version, run the setup and choose repair after the system check. Now you have to enter a license key. If you have already purchased a license for the Calendar E-Mail Extension and you have valid SW maintenance, you can request a new key. Just send an e-mail to support@sapiens.at and include your current license key. We will get back to you as soon as possible.

If you don’t have a valid license, you can get a trial key on the product page.

After the setup is complete, you have to deactivate and then re-activate the “Calendar E-Mail Extension” site feature. Go to the site settings of a Calendar E-Mail Extension site, click on Manage site features and deactivate and re-activate the Calendar E-Mail Extension feature.

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

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.

After the installation

After the setup succeeds continue with the configuration SharePoint Calendar E-Mail Extension Configuration Guide.

If you haven’t yet configured SharePoint incoming and outgoing E-Mail, read this guide SharePoint incoming and outgoing e-mail configuration for the Calendar E-Mail Extension.

Uninstall

If you want to uninstall the solution completely, you have to delete all calendar lists that were created from our template. Otherwise you’ll receive an error when opening a calendar 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.