Migrating existing mashups

To ensure that upgrades to Pega Platform 8.5.1 and later work seamlessly, you must migrate your existing mashups. Beginning in Pega Platform 8.5.1, Pega Web Mashups include a channel ID in the mashup code for validation with your mashup server.

Before you upgrade your production environment, migrate existing mashups by completing the following steps:

1. Create the mashup channel and mashup script on the upgraded, cloned staging environment, with the URL pointing to the production environment. Ensure that the mashup code contains a data-pega-channelID value. For more information, see Creating a mashup.

2. Update the appropriate external websites that host the mashup with the generated mashup scripts that you generated.

3. If you need to maintain full availability of the mashup during the upgrade of the production environment, on the upgraded, cloned staging environment, create a product rule that contains the mashup channel to deploy to production. For more information, see Creating a product rule that includes associated data by using the Create menu.

   Skipping this step will result in the mashup being inaccessible for a short period of time during the upgrade.

   1. On the Product page, in the Individual instances section, in the Select a class and press Query field, pressing the Down arrow key and select Data-Channel-Mashup.

   2. In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.

   3. Save the product rule.

   4. Use an ad hoc task to deploy it the product rule to production. For more information, see Performing ad hoc tasks.

4. Add the mashup channel to the product rule that contains your upgrade fixes. For more information, see Editing a product rule.

   1. On the Product page, in the Individual instances section, in the Select a class and press Query field, pressing the Down arrow key and select Data-Channel-Mashup.

   2. In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.

   3. Save the product rule.