BI Genius Deployment Step-by-Step

Installing BI Genius is simple, easy and takes approximately 20 minutes. The Reporting Hub web application and required Azure services can all be fully deployed by following our guided installation service.

Your Reporting Hub app must be version 7.0.0.9 or higher to support BI Genius. View instructions on updating your Reporting Hub app by visiting your in-app documentation. In your application, open the Admin menu by selecting your profile icon and then Help > Self-Serve Guided Updates.

Requirements

Please review the checklist below before getting started:

Need Help? Contact our support team at https://support.thereportinghub.com. A dedicated team member will be available to assist with your deployment.

Follow Along With Our Guided Tutorial

The tutorial below outlines the step-by-step process to install and deploy BI Genius and associated Azure services within your Azure environment. For each Azure resource, you will have the option to select an existing resource or create a new resource.

Installation Steps

  1. If prompted, grant Application Admin Consent: After signing in, you may be prompted to grant application admin consent to the Reporting Hub Installer application. This consent will allow the Installer application to deploy the applicable Azure services and BI Genius application within your Azure environment. You must grant consent to proceed and complete the installation. This is the same installer application used for the Reporting Hub, so you may have already granted it permission.

    Admin consent form

    BI Genius Installer is a Microsoft 'verified' application and Shift Analytics Inc. is a Microsoft ISV Partner as identified on the Admin Consent page. This admin consent can be revoked at anytime following deployment via your Azure Portal.

  2. Start by selecting your Azure Subscription and Azure Subscription from the dropdown list and click Next.

  3. Select the Reporting Hub application and domain (slot) you want to add BI Genius to. Your Reporting Hub application must be version 7.0.0.9 or higher; the installer will verify that your selected Reporting Hub app is the minimum required version. Click Next.

  1. Next, select your Azure Resource Group. Regional availability of the required resources is limited. If a resource is not currently offered in your selected region, a notification will appear. You can keep your resource group in the selected region, but will need to choose a different region for the BI Genius resources.

    • If using an existing Resource Group, select it from the dropdown list and click Next. If you are using existing Azure resources instead of creating new ones, select the Resource Group that those resources belong to. Click Next.

    • If adding a new Resource Group, select Add New from the dropdown list. Enter a Name and select a Resource Group Region. Click Next.

  2. Select your Azure App Service. Currently, you must create a new App Service for your BI Genius.

    1. Select Add New.

    2. Enter a Name for your app service. The name can only contain alphanumeric characters, hyphens, parentheses, and underscores. Since BI Genius will be embedded in your application, the name is not public-facing.

    3. Select an app service Tier.

    4. Then, click Next.

  3. Select your PostgreSQL Server. You can choose an existing one or create a new one.

    1. Select a Region.

    2. Select a Tier; we recommend starting with Standard_B1ms.

    3. Select Storage; we recommend starting with 32 GiB.

    4. Enter a Server name and Database name.

      1. The server name can only contain lowercase letters, numbers, and hyphens. It must be between 3 and 63 characters long. It can't start or end with a hyphen. It also must be globally unique.

      2. The database name can only contain alphanumeric characters and hyphens. It must be between 1 and 63 characters long.

  4. Select your Azure OpenAI Service.

    1. In the dropdown menu, select Add New.

    2. Select a Region.

    3. Enter an Azure OpenAI Service Account Name.

  5. Name your Entra ID Application and Service Principal.

    1. Application is the name of your BI Genius App Registration

    2. Service Principal is the name of the Entra ID Security Group that the installer will create and add the App Registration as a member of.

  6. The installer will check that the selected Azure resources exist or are deployed. Once they're all deployed, select Next.

    If there are any failures, hover over the information icon in the failed status bar and note the error message that appears. Then, please contact [email protected] so we can assist in the resolution. If you see a region-related error, see this section.

  7. The BI Genius installation will begin. This step may take several minutes.

  8. The installer will run a series of checks and start your new BI Genius application.

Next Steps: Power BI Configuration

When the app has been successfully installed, you will need to ensure that BI Genius has been granted adequate permission in your Power BI tenant and to your Power BI workspaces.

Enable Power BI Service Settings

Incomplete Installations

The installer provisions Azure resources incrementally during the setup process. If you exit the installation before it completes, some resources may remain active and could incur costs.

If you stop the installer after the Select your Azure Resource Group step, we recommend reviewing your Azure portal to identify and delete any resources or objects the installer may have created. This includes reviewing your Entra ID for the App Registration and Security Group created in step 8.

Last updated