Azure Marketplace Install

Install the Reporting Hub through the Azure Marketplace

You can install the Reporting Hub using our installer, or through the Azure marketplace. This guide will explain the differences between the two installation methods and describe the requirements and steps for installing through Azure Marketplace.

Comparison with Installer Methods

Regardless of which installation method you choose, the latest version of the Reporting Hub will be installed in your environment.

The biggest differences when you install via the Azure Marketplace versus using our installer are:

  • There is no free trial period when you install through the Azure Marketplace.

  • Can only deploy a Power BI Embedded capacity (instead of a Fabric capacity). We will update our offering to include the Fabric capacity option soon.

  • Translator service isn't deployed automatically through Azure Marketplace and requires manual configuration.

Installing through the Azure Marketplace

Create a Managed Identity

Before you install through the Azure Marketplace, you must create a Managed Identity. You must also assign the necessary permissions to the Managed Identity. The Managed Identity requires contributor access on the Azure subscription where the app will be installed, as well as Application Administrator and Groups Administrator permissions in the directory.

Create a User Assigned Managed Identity

  1. In the Azure portal, select Managed Identities.

  2. Select Create.

  3. Select the appropriate Subscription in which you'd like to deploy all of the Reporting Hub app resources.

  4. Select the Resource Group you'd like to use, or create a new one.

  5. Select a Region you'd like to deploy your Azure resources in.

  6. Name your managed identity.

  7. Select Review + Create to review your settings and select Create.

Managed Identity Permissions

To assign the required Entra ID roles:

  1. In the Azure portal, select Microsoft Entra ID.

  2. Under Manage, select Roles and administrators.

  3. From the list of roles, select:

    1. Application Administrator

    2. Groups Administrator

  4. Select Add assignments.

  5. Search for the name of the managed identity and select it. Select Add.

To add the contributor role on the subscription:

  1. In the Azure portal, select Subscriptions.

  2. Select the relevant subscription.

  3. Select Access control (IAM) on the left menu.

  4. On the top menu select Add and then Add role assignment.

  5. Select the Privileged administrator roles tab and then select Contributor. Select Next.

  6. Leave the Assign access to field set to User, group, or service principal. Click Select members.

  7. Search for the Managed Identity you created, select it, and hit the Select button below.

  8. Select Review + assign at the bottom of the screen.

Deploy through the Azure Marketplace

  1. Open the link above in a new tab to view our Azure Marketplace offering and select Get It Now.

  2. Sign in to the Microsoft Azure Marketplace.

  3. Choose a Plan and select Create.

    1. You must select a paid plan; there is no free trial period when you install through the Azure Marketplace. If you'd like to install with a free trial period, use our installer instead.

  4. Select your Azure Subscription and the Resource group that your Managed Identity is in.

  5. Select the Region that you'd like to deploy all of the Reporting Hub resources in.

  6. Enter a name for the Managed Application and the Managed Resource Group. Select Next.

  7. On the App Service Setup page, you will be presented the option to either use an existing App Service or add a new App Service.

    • To use an existing App Service, check the Use existing App Service box and select an App Service and deployment slot. Select Next.

    • To create a new App Service, enter an App Service Name. Select a Tier; you can scale up your App Services plan later. Select Next.

  8. On the Database Setup page, you can either use an existing Azure SQL Server or create a new one.

    • To use an existing server, select the Use existing Azure SQL Server box and select it from the list.

    • To create a new server, enter a SQL Server Name.

    Enter a Database Name. Select Next.

  9. On the Database Credentials page, enter a SQL Server Username, Password, and enter the Password again to confirm. If you are creating a new SQL server, the server admin credentials will be what you enter here. If you are using an existing server, please ensure that you are entering the correct server admin credentials here — the installer is unable to validate them here. Select Next.

  10. On the Embedded Capacity Setup page, you have the option of creating a new Embedded Capacity or using an existing one.

    • To use an existing capacity, check the Use existing capacity box and select a capacity from the list. Only capacities in the resource group you have selected will be available to select. Select Next.

    • To create a new capacity, enter a Capacity Name and an Administrator Email for the user you'd like to set as the capacity's administrator. You can add additional capacity administrators later on. Select Next.

  11. On the Identity page, select Add and then select the user assigned managed identity you created earlier. Select Next.

  12. Review your terms. You can read The Reporting Hub's Terms of Use and Privacy Policy, as well as the Azure Marketplace Terms, and select I agree to the terms and conditions above. Select Create.

  13. The wizard will deploy your Reporting Hub app in your Azure environment. After deployment, navigate to your App Service and select the domain from the Overview page to launch your Reporting Hub.

After deployment, enable Power BI Settings and configure your Reporting Hub app settings. Additionally, if you want to translate your Reporting Hub into a language other than English, link a Translator service to your Reporting Hub app.

Enable Power BI Service Settings

Follow the instructions linked below.

Configure Reporting Hub App Settings

Follow the instructions linked below.

Add a Translator (Optional)

Create a Translator service in Azure

  1. In the Azure portal, search for Translators in the top search bar and select Translators.

  2. Select Create.

  3. Choose a Subscription and Resource group; it doesn't have to be in the same subscription or resource group that your Web App is in.

  4. Choose a Region that is the same as or close to the region your Web App is in.

  5. Enter a Name for your Translator.

  6. Set the Pricing tier as Free.

  7. On the Network tab, select All networks, including the internet, can access this resource.

  8. Select Review + Create and then Create to create the resource.

Add Translator Keys to Reporting Hub App

After the Translator has been created, you need to add its keys to your Reporting Hub app's settings.

  1. Select the Translator in your Azure portal.

  2. Under Resource Management, select Keys and Endpoint.

  3. Select Show Keys and copy KEY 1, KEY 2 and Location/Region to a notes app, like notepad.

  4. Navigate to your App Services list; you can use the search bar at the top of the page.

  5. From the list of App Services, select your Reporting Hub app service.

    1. If you deployed your Reporting Hub app to a specific slot on your app service, then expand the Deployment menu in the left menu pane; select Deployment slots; and select the desired slot.

  6. On the left menu, expand the Development Tools menu and select Advanced Tools.

  7. Select Go -> and Kudu tools will open in a new tab.

  8. On the Kudu page, in the top menu, select Tools and Zip Push Deploy.

  9. Scroll down in the file list and find appsettings.json. Select the pencil icon next to it.

  10. In the text editor on the page, find "key1" and replace the text beside it with the KEY1 value from step 3. Ensure the key value is inside quotation marks.

  11. Find "key2" and replace the text beside it with the KEY2 value from step 3.

  12. Find "location" and replace the text beside it with the translator region you copied in step 3.

  13. Select Save.

Last updated