Installation Guide for SharePoint 2019

Prerequisites

Make sure you have the following files:

• LiveTiles.Intranet.Metadata.SP2019.sppkg
• LiveTiles.Intranet.SP2019.WSPs.zip

Installation Steps

Install LiveTiles Intranet API Service Application

Fist of all, install the LiveTiles Intranet API Service Application as described here.
After you have successfully installed the LiveTiles Intranet API Service Application you can continue with the steps below.

Setup Maintenance Job

The LiveTiles Intranet Metadata uses the SharePoint List Web Hooks functionality. They are registered upon assigning a site collection to a config. As they are only valid for a certain period, the need to be renewed. This is done by the MatchPoint Metadata Maintenance Job.

First you need to install the "MatchPoint Metadata Maintenance Job"-Feature:

Install-SPFeature -Path CYCL.MatchPoint.SharePoint.Metadata.MaintenanceJob

Then you need to activate the "MatchPoint Metadata Maintenance Job"-feature on your web application(s).

Anonymous Access

The metadata service uses SharePoint web hooks to be notified when something has changed in SharePoint. In order for this to work, anonymous access needs to be enabled on the web app. This can be done by selecting your web app in the web app overview in the SharePoint Central Administration and then in the "Authentication Providers"-settings.

Please note:

• In future we might provide a different approach than enabling anonymous access for the web app. But for the time being, this is how it needs to be done.
• Maybe the calls from SharePoint to the web hooks will work even after enabling anonymous access once on the web app and then disabling it again.

Metadata App Installation

1. Add LiveTiles.Intranet.Metadata.sppkg to the app catalog. Please make sure that you are viewing the app catalog in the classic view, as otherwise you might not be able to deploy correctly.
2. Head over to any site collection and install the LiveTiles Metadata app.

Hub Integration

Once the app is installed, you should be able to see new action buttons on the bottom right part of the screen. If you also have LiveTiles Intranet Hub installed, the metadata launcher will be integrated into the Hub actions. Please note, that this is not supported on the hub.aspx page.

Configuration

Once the app is installed, you can define your metadata configs.