Migrating existing mashups
Version:
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:
-
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.
-
Update the appropriate external websites that host the mashup with the generated mashup scripts that you generated.
-
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.-
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.
-
In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.
-
Save the product rule.
-
Use an ad hoc task to deploy it the product rule to production. For more information, see Performing ad hoc tasks.
-
-
Add the mashup channel to the product rule that contains your upgrade fixes. For more information, see Editing a product rule.
-
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.
-
In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.
-
Save the product rule.
-