Update
ATTENTION:
All configuration files used by Publishing Snowflake will be lost during the upgrade process! If there are changes that have been done manually in one or more configuration files, make sure to save them before the update so you can merge them afterwards.
Make sure the license for the Publishing snowflake is saved and available for you after the update process.
- Update MatchPoint and MatchPoint Snow to the latest version
- Run a “SharePoint 2016 Management Shell” instance as administrator
- Use one of the following methods:
- Execute the following command:
<root>\<drop>\update.ps1
Provide the parameters that are required as input
WebApplication, SearchServiceApplication, Owner, AdminSiteRelativeUrl, SnowSiteRelativeUrl, SnowflakeSiteRelativeUrl, TagStoreId, LicenseHolder, LicenseKey
Note: LicenseHolder and Licensekey are optional parameters and can be added later in the Snowflake configuration file.
During the execution of this script a new server.config.xml file will be generated based on the input parameters.
- Use a config file. The build provides a template “server.config.template.xml”.
Update all environment specific variables (Also check Server configuration).
The file can then be used as a parameter in the following Update command
<root>\<drop>\update.ps1 –ServerConfigPath {server.config.xml file path)
- Reapply MPSComposed looks (see Reapply Composed Looks chapter)
- Run the following Timerjob (see Run Timerjobs chapter)
- MPSnow.Tags.System.xml
- MPS.Publishing.Tags.System.xml
- Run a Full Crawl on the following Content Sources
- Default content source: Local SharePoint sites
- Portal Content Source
- Additionally – if mentioned in the update-process of the specific version – execute these steps now. The following chapters are not part of an usual update, but might be helpful in certain circumstances!
Advanced update scenarios
The update script provided in the installation package calls a Powershell commandlet Update-Snowflake. This cmdlet can be used for an advanced upgrade scenario, and provides the following switch parameters:
| Parameter | Description | Used in standard update |
|---|---|---|
| RecreateSnowflakeSite | Recreates the Publishing Snowflake site collection anew. All data is lost if this parameter is used. | No |
| LocalDeploymentOnly | SharePoint solutions (.wsp) will be updated using the -Local switch. Should not be used in multi server farms | |
| SkipTimerJobs | Skips the execution of timer jobs | Yes |
| ReactivateFeatures | Reactivates all features used by the Publishing Snowflake | No |
| EnsureUserProfileProperties | Ensures the user profile properties used by the Publishing Snowflake exist | No |
| ApplyProvisioningTemplate | Provisions the \<NewsroomSnowflake> with the appropriate site structure | Yes |
| ExecutePostActions | Executes custom post-update scripts | Yes |
| ExecuteUpdateActions | Executes custom update scripts | Yes |
| SkipSolutionUpdate | Skips the update of the SharePoint solution packages “Colygon.MatchPoint.Snow.Newsroom.wsp” and “Colygon.MatchPoint | No |
| SkipUpdateSnowComposedLook | The step Reapply-MPSComposedLook look is skipped |
Updating from MatchPoint Snow version 2.0.0 to 2.0.1
Before updating the Publishing Snowflake to MatchPoint Snow v2.0.1, make sure MatchPoint Snow has been successfully updated to v2.0.0. The update scripts will perform the following actions:
- update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2.0.1
Updating from MatchPoint Snow version 2.1.1 to 2.2.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2.2.0. Please follow the update scenario, as described before, and pass the ExecutePostActions & ExecuteUpdateActions parameters as described in Advanced Update Scenario chapter. The update scripts will perform the following actions:
- Update images
- Migrate pages from snowflake root Favorites list to MySite
- Update old workspace Event Receivers
- Update workspaces
- Revert manage users control (Users.aspx) to MPSnow
Updating from MatchPoint Snow version 2.2.0 to 2.3.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2.3.0. Please follow the update scenario, as described before, and pass the ExecutePostActions, ExecuteUpdateActions, EnsureUserProfileProperties, ReactivateFeatures, ApplyProvisioningTemplate parameters as described in Advanced Update Scenario chapter. The update scripts will perform the following actions:
- Updates the snowflake version number
- Creates user profile properties
| Name | Type |
|---|---|
| Disable Publishing Mail Messages | boolean |
| Disable Publishing Notification Center Messages | boolean |
- Adds new feature
| Name | Description |
|---|---|
| Colygon.MatchPoint.Snow.SnowflakeComponents.SnowSite | Adds a Markdown wiki page |
Updating from MatchPoint Snow version 2.3.0 to 2.4.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2.4.0. Please follow the update scenario, as described before, and pass the ExecutePostActions & ExecuteUpdateActions parameters as described in Advanced Update Scenario chapter. The update scripts will perform the following actions:
- Update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2.4.0
- Update the tag inheritance for the MicroFeed list in all Publishing workspaces
- Update the permissions on Logo.aspx in the Site Pages list for all Publishing workspaces
- Update the BDC Model and create Managed Properties in Search
| Name | Description |
|---|---|
| IsArchived | The page is in status Archived when crawled |
| IsLanding | The page is of type Landing Page |
After updating the Publishing Snowflake restart the SharePoint Search Service Instance.
Updating from MatchPoint Snow version 2.4.0 to 2.5.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2.5.0. Please follow the update scenario, as described in this document (No Advanced parameters required). The update scripts will perform the following actions:
- update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2.5.0
Updating from MatchPoint Snow version 2.5.0 to 2.6.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2.6.0. Please follow the update scenario, as described in this document (No Advanced parameters required). The update scripts will perform the following actions:
- update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2.6.0
Updating from MatchPoint Snow version 2.6.0 to 2016.7.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2016.7.0. Please follow the update scenario, as described in this document (No Advanced parameters required). The update scripts will perform the following actions:
- update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2016.7.0
Updating from MatchPoint Snow version 2016.7.0 to 2016.8.0
Before updating the Publishing Snowflake, make sure MatchPoint Snow has been successfully updated to v2016.8.0. Please follow the update scenario, as described in this document (No Advanced parameters required). The update scripts will perform the following actions:
- update the Publishing Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2016.8.0
- create Managed Properties in Search
| Name | Description |
|---|---|
| PortalPagePath | Url of a Page when crawled |
After updating the Publishing Snowflake run a full search crawl on Portal Content Source.