Installation - Puzzlepart/prosjektportalen GitHub Wiki

Installation using the installation script

Unpackage the (latest) installation zip-package downloaded from releases. The file is on the format prosjektportalen-2.X.X.56e9650b.zip.

In the installation package you'll find:

  • Install.ps1
  • SearchConfiguration_tenant.xml
  • SetupSearchSchemaOnPrem.ps1
  • Additional installation files

Before you install

Read this before installing!

Troubleshoot installation

See installation troubleshooting

Installation process

  • QA that term store is in applicable language Read more
  • Create site collection Read more
  • Run Install.ps1 with applicable parameters (see below)
  • Configure managed properties in search (see below)

Install.ps1

Syntax

Install.ps1 [-Url <String>]
            [-AssetsUrl <String>]
            [-DataSourceSiteUrl <String>]
            [-SkipAssets <switch>]
            [-SkipData <switch>]
            [-SkipDefaultConfig <switch>]
            [-SkipTaxonomy <switch>]
            [-SkipThridParty <switch>]
            [-SkipRootPackage <switch>]
            [-SkipLoadingBundle <switch>]
            [-GenericCredential <String>]
            [-UseWebLogin <switch>]
            [-CurrentCredentials <switch>]
            [-PSCredentials <String>]
            [-Environment <String>]
            [-ExtensionFolder <String>]
            [-ConfirmExtensions <switch>]
            [-Logging <String>]

Parameters

Parameter Type Required Description
Url String True URL for the root site.
AssetsUrl String False URL for assets if you want to maintain assets in a separate site collection. Defaults to Url.
DataSourceSiteUrl String False URL for data source if you want to maintain data sources in a separate site collection. Defaults to Url.
SkipAssets switch False Skip the deployment of assets (scripts, styling, images). Needed for certain upgrade scenarios where you want multiple site collections to point to the same assets resource, or if you use a CDN outside your environment.
SkipData switch False Skip the deployment of default data items (tasks, documents etc). Needed for upgrade scenarios.
SkipDefaultConfig switch False Skip deployment of default configuration items. Needed for upgrade scenarios.
SkipTaxonomy switch False Skip deployment of taxonomy (in case you already have them and don't want to modify).
SkipRootPackage switch False Skip deployment of root package.
SkipLoadingBundle switch False Do you want to handle PnP libraries and PnP PowerShell without using bundled files? If this switch is used, you need to download and install appropriate release of PnP PowerShell yourself. See https://github.com/SharePoint/PnP-PowerShell/releases
GenericCredential String False Specify the name of a generic credential if you've set up one.
UseWebLogin switch False Use Web Login to connect to SharePoint. Useful for e.g. ADFS environments and forms based login.
CurrentCredentials switch False Use the credentials of the current user to connect to SharePoint. Useful e.g. if you install directly from the server.
PSCredentials String False Use a named credential in Windows Credential Manager on your local machine.
Environment string False SharePoint environment. SharePointPnPPowerShell2013, SharePointPnPPowerShell2016 or SharePointPnPPowerShellOnline. Defaults to SharePointPnPPowerShellOnline
ExtensionFolder String False Path to the folder with extensions (.pnp files) that will be applied after standard installation
ConfirmExtensions switch False Get prompted for installation of every extention.
Logging String False Values "file", "host" or "none". Default logging to file, alternative log to console or turn off logging.

Examples

Example 1 - Installing to SharePoint Online with default settings

.\Install.ps1 -Url [URL]

Example 2 - Installing to SharePoint Online without default taxonomy, configuration and data (in case of an upgrade)

.\Install.ps1 -Url [URL] -SkipData -SkipDefaultConfig -SkipTaxonomy

Example 3 - Installating to SharePoint 2016 with default configuration and data

.\Install.ps1 -Url [URL] -Environment SharePointPnPPowerShell2016

Example 4 - Installating to SharePoint 2016 with default configuration and data in a forms-based login environment

.\Install.ps1 -Url [URL] -Environment SharePointPnPPowerShell2016 -UseWebLogin

Example 5 - Installating to SharePoint Online where you want assets and list data on a separate site collection

.\Install.ps1 -Url [URL] -AssetsUrl [URL2] -DataSourceSiteUrl [URL2]

Example 6 - Installating to SharePoint Online where you have installed PnP Powershell independently

.\Install.ps1 -Url [URL] -SkipLoadingBundle

Manual configuration after installation

A manual step is required before installation is completed. See Configuring Search Mappings.

⚠️ **GitHub.com Fallback** ⚠️