Upgrade

Upgrade should be used to update an itsystem version of Newsroom Snowflake older or equal than 1.9.7 to a CYCL version equal or newer than 1.10.0.

ATTENTION!

• A new license has to be requested from CYCL. See chapter License Information

• All configuration files used by Newsroom 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 upgrade so you can merge them afterwards.

• Upgrade current versions of MatchPoint and MatchPoint Snow to their latest versions. Check MatchPoint Installation Guide.

• Run a “SharePoint 2016 Management Shell” instance as administrator
• Use one of the following methods:
  • Execute the following command:

\<root>\<drop>\upgrade.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 Upgrade command

\<root>\<drop>\upgrade.ps1 –ServerConfigPath "server.config.xml file path"

1. Reapply MPSComposed looks (see Reapply Composed Looks chapter)
2. Run the following Timerjob (see Run Timerjobs chapter)

Detailed description of upgrade operations run by the script

Please note that this section is not a mandatory reading, it only describes in detail each operation performed by the upgrade script.

All operations are executed automatically by the upgrade script.

1. If there’s no Server Configuration Path provided, a new server.config.xml is created.
2. WSPBuilder is started executing all the replacements configured in the wspBuilderConfig.
3. Deletes the News Business Data Connectivity Models
4. Uninstalls old Newsroom and Components SharePoint Features
5. Removes News and Teaser Content Sources from Search
6. Removes Newsroom persisted object stored in the local Farm
7. Removes old Newsroom and Components configurations.
8. Removes Newsroom related configurations from MPSnow config, MP config, MPSnow Advanced Search config
9. Removes old wsp solutions
10. Runs a new Install
11. Upgrades old workspaces
12. Updates workspace event receivers
13. Reapplies MPS Composed look on Workspaces, Snow and Snowflake sites.