config multi gma

Multiple GMA Configuration

Beginning with GMS version 3.0.0, it is possible to support multiple Global Metrics Application apps within a single deployment of the Governed Metrics Service. The purpose of this capability is to support multiple lines of business within a single Qlik deployment who have their own set of metrics they do not wish to share, or may conflict in naming or definition from one another.

To activate this capability, please follow the configuration steps below.

Configuring Governed Metrics Service for Multi GMA

Setting the multiGma feature flag in GMS configuration

1. Open the config.js file located in the config folder of the Governed Metrics Service installation path. The default path for the Governed Metrics Service is C:\Program Files\Qlik\Sense\EAPowertools\GovernedMetricsService

2. Find the property labeled featureFlags. Inside the featureFlags property is a property labeled multiGma. Set this property to true.

3. Save the config.js file and restart the Governed Metrics Service by stopping and starting the Qlik EAPowertools Service Dispatcher service.

Add a tag in the QMC "gma"

1. Open the QMC for the Qlik Sense server GMS will work with.

2. Click on the Tags menu item in the Manage Resources section of the QMC menu.

3. At the bottom of the Tags interface, click on the Create new button.

4. Enter the name "gma" (without quotes) into the Name dialog and click the Apply button.

Apply the gma tag to applications within the QMC.

1. To add the gma tag to apps in the QMC, click on the Apps menu item in the Manage Content section of the QMC menu.

2. From the list of applications that appear, choose one more apps (holding the control key while selecting) and click the Edit button.

3. In the window that appears, click on the Tags menu item on the right side of the screen to make it visible.

4. When the Tags section appears in the middle of the screen, add the gma tag to the dialog box. Click Apply to commit changes.

   Warning: Adding the gma tag to apps that do not have the correct field definitions and structure will cause errors in GMS processing. For more information on the field definitions and structure of a global metrics application, please navigate here.

Add a custom property in the QMC named GMA_Subscription

1. From the QMC menu, click on the Custom properties menu item in the Manage Resources section.

2. Create a new custom property by clicking on the Create new button on the bottom of the page.

3. In the window that appears, enter GMA_Subscription for the Name of the custom property.

4. Click on the check box for Apps in the Resource Types section.

5. In the Values section, add the guid for each global metrics application on the Qlik server. Click Create new and enter the guid. Click Apply when finished.

   Information: To find the guid of an application, click on the Apps menu item in the QMC. When the list of applications appears, click the column selector icon next to the Actions button and mark the checkbox next to ID. In order to see the full guid, hiding other columns may be required.

Apply the GMA_Subscription custom property to an app

1. Double click on an app from the list of apps in the apps section of the QMC. This will open the app detail page.

2. From the app properties menu on the right, click on the Custom properties option to expose the available custom properties for apps in the middle of the screen.

3. Find the GMA_Subscription custom property and select the guid representing the global metrics app this child app will subscribe to. Click the Apply button when finished.

   Warning A ManagedMasterItem custom property value must be assigned to have a working subscription to a gma. If no gma guid is supplied in the GMA_Subscription Custom property for the app, the app will subscribe to the default gma named in the properties of the Governed Metrics Service config.js file.

   Information If a ManagedMasterItem property value is selected that does not exist in the subscribed gma app, the app will not receive any dimensions and measures during GMS distribution.