Manual Installation

This chapter describes the manual installation process of MatchPoint. The installation is executed from the "SharePoint 2016 Management Shell". You need to make sure that the executing user has farm administrator privileges.

SharePoint 2016 deploys the content of the Colygon.MatchPoint.wsp to all servers in the Farm with running Microsoft SharePoint Foundation Web Application service. This means that an installation on a multi-server farm should always be executed from a server with running web application service instance (server with "Web Frontend Server" role) for the following reasons:

  • MatchPoint features, Layouts content etc. are only available on Web Frontend Servers.
  • PowerShell CmdLets are only registered on Web Frontend Servers.

Install and Deploy Prerequisites

MatchPoint depends on third party libraries:

  • One of them is the MS Chart control which has to be deployed on all front end servers.
  • Microsoft.Deployment.Compression.dll, Version 3.0.5419.0 (Windows Installer XML) and Microsoft.Deployment.Compression.Cab.dll, Version 3.0.5419.0 (Windows Installer XML) which have to be installed in the GAC of all servers in the SharePoint farm. If this is not the case already, use the Microsoft.Deployment.Compression.wsp solution file to deploy the missing DLLs:
    Add-SPSolution -LiteralPath C:\Microsoft.Deployment.Compression.wsp
Install-SPSolution -Identity Microsoft.Deployment.Compression.wsp -GACDeployment
  • Newtonsoft.Json.dll, Version 8.0.2.19309 which has to be installed in the GAC of all servers in the SharePoint farm. If this is not the case already, use the Newtonsoft.Json.wsp solution file to deploy the missing DLL:
    Add-SPSolution -LiteralPath C:\Newtonsoft.Json.wsp
Install-SPSolution -Identity Newtonsoft.Json.wsp -GACDeployment

Install and Deploy the MatchPoint Solution Files

To install MatchPoint in a SharePoint environment, the MatchPoint solution package files have to be added to the farm's solution store:

Add-SPSolution -LiteralPath C:\Colygon.MatchPoint.wsp
Add-SPSolution -LiteralPath C:\Colygon.MatchPoint.TaggingService.wsp

Next, the solution files have to be deployed to every web application that will use MatchPoint functionality:

Install-SPSolution -Identity Colygon.MatchPoint.wsp -GACDeployment -WebApplication <WebApplicationUrl>

<WebApplicationUrl> specifies the URL of the web application that will use MatchPoint.

The Colygon.MatchPoint.TaggingService.wsp is a farm-scoped feature and does not need the WebApplication parameter:

Install-SPSolution -Identity Colygon.MatchPoint.TaggingService.wsp -GACDeployment

Perform the following commands on each server in the farm:

net stop sptimerv4
net start sptimerv4
iisreset

Activate Infrastructure- and Administration Features

Next, the following features have to be activated in the environment:

  • Colygon.MatchPoint.Core.Infrastructure has to be enabled on any web application that uses MatchPoint functionality.
  • Colygon.MatchPoint.Core.Administration has to be enabled on exactly one site collection that will host the MatchPoint Administration.
  • Colygon.MatchPoint.Tagging.Service only has to be enabled if tagging functionality is used. This is a farm-scoped feature. After enabling this feature, a tagging service instance is created on every server in the farm. The initial state of the service instances is "Stopped".
  • Colygon.MatchPoint.Tagging.Inheritance has to be enabled on any web application that uses tagging functionality.
Enable-SPFeature -Identity Colygon.MatchPoint.Core.Infrastructure -Url <WebApplicationUrl>
Enable-SPFeature -Identity Colygon.MatchPoint.Core.Administration -Url <SiteCollectionUrl>
Install-SPFeature –Path Colygon.MatchPoint.Tagging.Service
Enable-SPFeature -Identity Colygon.MatchPoint.Tagging.Service
Enable-SPFeature -Identity Colygon.MatchPoint.Tagging.Inheritance -Url <WebApplicationUrl>

<WebApplicationUrl> specifies the URL of the web application where MatchPoint is installed.
<SiteCollectionUrl> specifies the URL of the site collection used as the Instance Administration site.

A tagging service application can be either installed via SharePoint Central Administration or by using the NewTaggingServiceApplicationCmd class.

Create Managed Properties for use with MatchPoint

To create managed properties for use with MatchPoint, you can use a PowerShell Snap In that is available from the "SharePoint 2016 Management Shell" when the MatchPoint solutions are deployed to a SharePoint environment.

  1. Start the "SharePoint 2016 Management Shell".
  2. Execute the following command:
    Add-MPManagedProperties –SearchServiceApplication <ServiceApplication>
    <ServiceApplication> specifies name or ID of the search service application.

Install and deploy MatchPoint Hybrid Solution File

To install MatchPoint Hybrid Solution in a SharePoint environment, the MatchPoint Hybrid solution package file have to be added to the farm's solution store:

Add-SPSolution -LiteralPath C:\Colygon.MatchPoint.Hybrid.wsp

The Colygon.MatchPoint.Hybrid.wsp is a farm-scoped feature:

Install-SPSolution -Identity Colygon.MatchPoint.Hybrid.wsp -GACDeployment

results matching ""

    No results matching ""