Installation Guide for SharePoint 2019

Overview

This article helps you installing LiveTiles Intranet Hub on your SharePoint 2019 environment.

Prerequisites

Make sure you have following zip file:

Make sure you have a user with enough permissions to deploy WSPs, create service apps, install apps, etc.

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.

Configure Search Service Application

The Search Service Application can be configured either manually or by running a script. Following either one of the methods below will ensure that the Search Service Application will be be configured properly.

Manual configuration

Head over to the central admin. We recommend accessing the central admin using an Internet Explorer instance run as Administrator.

  • Search Service Application
    • Create managed property EventDateRefinable that maps to ows_q_DATE_EventDate (Type: DateTime, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property EndDateRefinable that maps to ows_q_DATE_EndDate (Type: DateTime, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property DueDateRefinable that maps to ows_q_DATE_DueDate (Type: DateTime, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property AuthorOWSUserRefinable that maps to ows_q_USER_Author (Type: Text, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property AssignedToRefinable that maps to ows_q_USER_AssignedTo (Type: Text, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property SiteTitleRefinable that maps to ows_SiteName (Type: Text, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Create managed property StatusRefinable that maps to ows_Task_x0020_Status (Type: Text, Searchable, Queryable, Retrievable, Allow multiple values FALSE, Refinable [yes - active], Sortable [yes - active])
    • Please note that certain Managed Properties as well as the Crawled Properties will be created automatically by SharePoint once there is content, so you might not be able to use them before you actually have content.

Automated configuration

By running the script sp_createSearchConfigSettings.ps1, the properties written above will be created. The script has the following mandatory parameters:

  • SearchServiceApp, the name of the Search Service Application
  • SearchPropertiesSchemaFile, the path to the file that contains the search properties. The file is provided by default and it is called SearchProperties.xml.

Add the Apps to the App Catalog

Navigate to the app catalog and add all apps. Please make sure that you are viewing the app catalog in the classic view, as otherwise you might not be able to deploy correctly. Please also note that if SharePoint mentions that content will be retrieved from "SharePoint Online" this is fine - it is a bug from SharePoint 2019. All JavaScript will be served from your farm.

  • LiveTiles.Intranet.Hub.SP2019.sppkg
  • LiveTiles.Intranet.Hub.LandingPage.SP2019.sppkg

Install Apps

  • Head over to the site collection where the hub should be installed.
  • Add the apps
    • LiveTiles Intranet Hub Landing Page
    • LiveTiles Intranet Hub
  • Hub.aspx will be set as the landing page of your site collection.
  • Go to the site collection and edit the properties of the web part that has been deployed to that page. Specify following value in JSON-property:
// Please note that if you are also using the workspaces functionality,
// this step needs to be done later in the process.
{"configTypeKey": "webPart_hubPage"}
  • Save the page
← Microsoft 365Upgrade →