Upgrade Bold Reports® Enterprise Reporting version from 2.4.19 to latest

You can upgrade the Bold Reports® Azure App Service from version 2.4.19 to a later version in the Azure portal. You migrate the UMS blob resources, reconnect the deployment to the Bold Reports® GitHub repository, sync, and update the application settings.

How do I upgrade from v2.4.19 to the latest version?

You upgrade the Bold Reports® Azure App Service from version 2.4.19 by following these steps:

  1. Log in to the Azure Portal and select the Bold Reports® Azure App Service in Microsoft Azure Services.

  2. In the Overview section, click Stop.

    Stop Bold Reports<sup>®</sup> Azure App Service

  3. Choose Deployment Center in the left panel of the Bold Reports® Azure App service.

    Deployment center

  4. To upgrade to v3.1.42, migrate the v2.4.19 or v2.4.10 UMS blob resources to a new blob structure. To do this, click Sync in the deployment center blade.

    Deployment center utility sync

    Deployment center utility redeployment

  5. Check the deployment status in the logs. When the deployment completes successfully, the logs show a success status.

    Deployment center utility success

  6. After successful deployment, navigate to WebJobs in the left panel of the Bold Reports® Azure App service.

    Webjobs options

  7. In WebJobs, the migration utility is available. Click Run and wait for the migration to complete.

    Webjobs run

    Webjobs success

  8. To confirm the migration succeeded, go to the blob container used by the Bold Reports® Azure App service and check whether the boldservices Blob is created.

    Blob migration confirmation

  9. After the migration is completed, choose Advanced Tools in the left panel of the Bold Reports® Azure App service and click Go. The KUDU console opens.

    Kudu Console options

  10. In the KUDU console, click Debug Console and choose PowerShell.

    Kudu Console poweshell options

  11. In PowerShell, navigate to the path C:\home\site\repository\.git.

    Kudu Console repository path

  12. Run the git command git remote rm origin.

    Git command

  13. After running the command, go to the deployment center and click Disconnect. The deployment option opens.

    Choose Source

  14. Select External Git in the source option.

    External Repository

  15. In External Git, fill out the following information:

    Repository - Bold Reports® Azure repository URL

    Branch - v3.1.42

    Repository Type - Public

    Deployment option for External repository

  16. Click the Save option. The Successfully set up deployment notification is shown in the notification blade.

    Finish Deployment

    Success notification of Deployment option

  17. After completing the deployment setup, click Sync in the deployment center blade.

    Sync Repository

    Deployment confirmation

  18. The synchronization progress is shown in the deployment options blade.

    Synchronization Status

  19. Wait until synchronization is completed.

    Synchronization Success

  20. After the synchronization is completed, Save the following configuration settings.

    • Add the following application settings key.

      Key Value
      WEBSITE_LOAD_USER_PROFILE 1

    Application Settings

    • Change the following value in General Settings.

      Settings Value
      .NET version .NET 6

    General Settings

    • Change the Physical Path in Path Mappings.

      Virtual Path Physical Path (v2.4.19, v2.4.10) Physical Path (v3.1.42)
      / site\wwwroot\IDP site\wwwroot\idp\web
      /api site\wwwroot\IDP\api site\wwwroot\idp\api
      /reporting site\wwwroot\Report Server site\wwwroot\reporting\web
      /reporting/api site\wwwroot\Report Server\api site\wwwroot\reporting\api
      /reporting/jobs site\wwwroot\Report Server\jobs site\wwwroot\reporting\jobs
      /reporting/reportservice site\wwwroot\Report Server\reportservice site\wwwroot\reporting\reportservice
      /ums Site\wwwroot\IDP\ums site\wwwroot\idp\ums

    Path Mappings

  21. Click Start in the Overview section to start the Bold Reports® Azure App service.

    Start Bold Reports<sup>®</sup> Azure App Service

Frequently asked questions

Which .NET version does the upgraded App Service use?

After the Bold Reports® upgrade, set the .NET version in General Settings to .NET 6.

How do I confirm the blob migration succeeded?

Check whether the boldservices Blob is created in the blob container used by the Bold Reports® Azure App service.

See also