Update
ATTENTION!
- All configuration files used by Newsroom Snowflake will be lost during the update 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 Newsroom 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 inputWebApplication, 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
- Run a Full Crawl on the following Content Sources
- Default content source: Local SharePoint sites
- Newsroom News Content Source
- Newsroom Teaser 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 update scenario, and provides the following switch parameters:
| Parameter | Description | Used in standard update |
|---|---|---|
| RecreateSnowflakeSite | Recreates the Newsroom 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 Newsroom Snowflake | No |
| EnsureUserProfileProperties | Ensures the user profile properties used by the Newsroom Snowflake exist | No |
| ApplyProvisioningTemplate | Provisions the |
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 Newsroom 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 Newsroom 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 Newsroom Snowflake, make sure MatchPoint Snow has been successfully updated to v2.2.0. Please follow the update scenario, as described in this document, and pass the ExecutePostActions & ExecuteUpdateActions parameters as described in Advanced Update Scenario. The update scripts will perform the following actions:
- Update images
- Migrate news from snowflake root Read Later list to MySite
- Migrate news from snowflake root Favorites list to MySite
- Update old workspace Event Receivers
- Update workspaces
- Revert manage users control (Users.aspx) to MPSnow
Updating MatchPoint Snow version 2.2.0 to 2.3.0
Before updating the Newsroom Snowflake, make sure MatchPoint Snow has been successfully updated to v2.3.0. Please follow the update scenario, as described in this document, and pass the ExecutePostActions, ExecuteUpdateActions, EnsureUserProfileProperties, ReactivateFeatures, ApplyProvisioningTemplate parameters as described in Advanced Update Scenario. The update scripts will perform the following actions:
- Updates the snowflake version number
- The update script will migrate the News Author on the Teaser
- Create user profile properties
| Name | Type |
|---|---|
| Disable Newsroom Mail Messages | boolean |
| Disable Newsroom Notification Center Messages | boolean |
- Adds new feature
| Name | Description |
|---|---|
| Colygon.MatchPoint.Snow.SnowflakeComponents.SnowSite | Adds a Markdown wiki page |
| Colygon.MatchPoint.Snow.WebParts | Enables Contextual Actions Web Part |
Updating MatchPoint Snow version 2.3.0 to 2.4.0
Before updating the Newsroom Snowflake, make sure MatchPoint Snow has been successfully updated to v2.4.0. Please follow the update scenario, as described in this document and pass the ExecuteUpdateActions parameters as described in Advanced Update Scenario. The update scripts will perform the following actions:
- Update the Newsroom 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 Newsroom workspaces
- Update the permissions on Logo.aspx in the Site Pages list for all Newsroom workspaces
- Update permission for every Newsroom workspace tag
Updating MatchPoint Snow version 2.4.0 to 2.5.0
Before updating the Newsroom 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 Newsroom Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow
Updating from MatchPoint Snow version 2.5.0 to 2.6.0
Before updating the Newsroom 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 Newsroom 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 Newsroom 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 Newsroom Snowflake assemblies and solutions to the latest version, compatible with MatchPoint Snow v2016.7.0