Creating and editing distribution policies
Distribution policies control how apps are distributed from an on-premises Qlik Sense Enterprise on Windows node to your Qlik Cloud deployments.
All configured distribution policies are listed on the Distribution policies overview page. For details on the available fields, see Distribution policies.
Understanding distribution policies
To distribute apps to your cloud deployments, you need to define distribution policies. These policies are necessary for transferring apps from your on-premises environment to the cloud.
Key points
-
Distribution policies work similarly to security rules by defining which resources are affected and what actions are permitted.
-
These policies specify one or more cloud deployments (tenants) for distribution, and determine which apps are sent to which cloud deployment.
-
Only published apps can be distributed. Policies are evaluated when an app is published, determining which cloud deployments will receive a copy.
-
Distribution policies can automate app distribution upon successful publishing or reload, based on app properties (such as name, owner, stream, or custom properties).
-
Alternatively, distribution can be scheduled using distribution tasks. For more information, see Creating and editing distribution tasks.
-
Apps not covered by a distribution policy will not be transferred to the cloud.
Overview of creating distribution policies
Here’s a high-level overview of creating distribution policies:
-
Define the resource filter for the rule.
-
Choose the actions allowed by the rule.
-
Set conditions for the rule using criteria such as app custom properties and stream names from publishing actions.
-
Validate and apply the rule.
For details on publishing apps, see Publishing apps to cloud hubs with tags.
Creating distribution policies
Do the following:
-
Open the QMC: https://<QPS server name>/qmc
-
Select Cloud distribution on the QMC start page or from the Start drop-down menu to display the overview.
-
Click Create new.
-
Enter the following details:
Distribution policy identification properties Property Description Default value Create rule from template Select a template for your rule to have some values automatically filled in.
Information noteChanging the Create rule from template selection automatically clears all Actions, and changes the Conditions text box in the Advanced section accordingly.Unspecified Disabled Select to disable the rule if you do not want it to be active. Cleared Name
Name the rule. Blank Description
Optional. Add a description of the rule. Blank Distribution policy basic properties Property Description Default value Resource filter In the list, select the resource that the rule will apply to. Note that App_* means that the rule only applies to apps and not app objects and app sheets. App_* Actions Select the actions for the rule. Distribute Distribution policy advanced properties Property Description Default value Conditions The text box reflects changes made in the policy editor above. You can define conditions by typing in the text box. ((subject.name="")) Click Validate rule to check that the syntax is correct.
Distribution policy tag properties Property Description Tags Tip noteIf no QMC tags are available, this property group is empty.Click the text box to be display a list of the available tags. Start typing to reduce the list. Connected tags are displayed under the text box.
-
Click Apply to save your changes.
A message saying Successfully added will appear at the bottom of the page.
Editing distribution policies
Do the following:
-
In the QMC, go to Cloud distribution and select Distribution policies.
-
Select the policy you want to edit and click Edit in the action bar.
-
Modify the desired properties.
-
Under Advanced, click Validate rule to ensure that the syntax is correct.
-
Click Apply to save your changes.
A message saying Successfully updated will appear at the bottom of the page.