Exercise - Run the Portal Checker

  • 10 minutes

The purpose of this hands-on lab is to show how the Site Checker can identify potential portal issues.

Learning objectives

By the end of these exercises, you'll be able to:

  • Run the Site Checker.

  • Respond to the mitigation advice.

  • Rerun the Site Checker to confirm that the issue has been addressed.

Estimated time to complete this exercise: 10 to 15 minutes

Prerequisites

For this exercise, you'll need to have the following components set up in your environment:

  • A provisioned Power Pages website. If you don't have a Power Pages website available, follow the Create a Dataverse starter portal - Power Apps instructions to create one.

  • Access to the Microsoft Power Apps maker portal.

  • Access to Power Pages admin center.

High-level steps

In this exercise, you'll make a few changes to the settings in your website metadata. Next, you'll run the Site Checker tool from the Power Pages admin center and then evaluate the results. After you've addressed the issue, you'll rerun the Site Checker to ensure that the issue has been resolved.

The high-level steps are as follows:

  1. Locate the Header/OutputCache/Enabled site setting and then update the value to False.

  2. Purge the website cache.

  3. Run the Site Checker.

  4. Make a note of the warning message for the header output cache.

  5. Locate the Header/OutputCache/Enabled site setting and then update the value to True.

  6. Purge the website cache.

  7. Run the Site Checker.

  8. Make a note of the warning for the Header Output cache has been cleared.

Detailed instructions

The following sections outline the detailed instructions to the high-level steps.

Disable header output cache

Your first task is to disable header output cache by following these steps:

  1. Sign in to the Power Apps maker portal.

  2. Make sure that the correct environment with the portal provisioned is selected in the environment selector in the upper-right corner.

  3. From the Apps list, select the Power Pages Management app to open the app in a new window.

  4. Select Site Settings.

  5. Locate the Header/OutputCache/Enabled site setting.

    Tip

    Use the search functionality and look for header to quickly locate the row.

  6. Update the value to False and then select Save.

    Screenshot of the disable header output cache by using the Site Setting record.

  7. Leave the Power Pages Management app open.

Clear portal cache

To clear portal cache, follow these steps:

  1. In a new window or tab, sign in to the Microsoft Power Platform admin center.

  2. In the left pane, expand Resources and then select Power Pages sites.

  3. Select the target website.

  4. Select Purge Cache on the command bar.

  5. Select OK when prompted.

    Screenshot of the purge website cache step in the Power Platform admin center.

  6. Wait for the operation to complete.

Run Site Checker

Next, you'll run the Site Checker.

  1. Select the target website name to open Power Pages admin center.

  2. Select the Run button in the Site Health pane.

  3. The header output cache has a warning. Expand the message to get more details.

    Screenshot of the Header output cache warning in Site Checker.

Enable header output cache

To enable header output cache, follow these steps:

  1. Return to the Portal Management app.

  2. Update the Header/OutputCache/Enabled site setting to True and then select Save.

Check the issue resolution

Your last task is to check the issue resolution.

  1. Repeat the previous steps to clear the website cache.

  2. Repeat the previous steps to run Site Checker.

  3. Verify that the header output cache issue has been resolved.

Screenshot of the Site Checker with the Header output cache issue highlighted.