Deploying a Policy

When you deploy a policy successfully, the policy changes it status from the Draft state to the Deployed state. The Distribution Engine passes the policy to the agents in their respective ActiveMatrix nodes. When you deploy a policy for the first time, the policy will be in an Activated state.

Procedure

  1. Click Governance > Governance Controls.
    A list of policies are displayed.
  2. Select a policy and click Deploy.
    The Deployment Progress (Object Group Members) field shows the status of the policy being deployed. While the policy is being deployed, the Deployment Progress (Object Group Members) field helps you track the progress by showing the number of Successful, Failed, In progress, and Total object group members being affected by the policy. The following image shows the progress of a policy being deployed:
    Deploying a Policy

    In the table shown in the bottom-right corner of the window, you can sort on the deployment progress by clicking the Status. In this case, the status can be Deploying or Deployed.
    Note: The Deployment Progress (Object Group Members) field is displayed when you click any of the following:
    • Deploy
    • Undeploy
    • Activate
    • Deactivate

    You can view Object Group details in a new window by clicking Open in New Window button as shown in the following image:

    CLI Progess Indicator
    To track the progress of the deployment on CLI, use SYSTEM_PROPERTY_GC_DEPLOY_TIMER_PERIOD. By default, SYSTEM_PROPERTY_GC_DEPLOY_TIMER_PERIOD tracks the progress of the deployment in every 3 seconds. The SYSTEM_PROPERTY_GC_DEPLOY_TIMEOUT property is used to set the timeout period for the deployment. By default, it is 600 seconds. If the policy takes longer than 600 seconds to deploy, it is not deployed. To set the timeout period on Windows, use the following ANT command:
    set ANT_OPTS=-Damx.governance.gc.deploy.timeout=60000

Result

The policy is now deployed. You can see that the following buttons are now active on the page:
  • Activate
  • Undeploy
  • Sync
  • Status of the policy changes to Version: Deployed. Use the Version button to toggle between the Draft and Deployed versions of a policy.
    Note: When the Draft version of a policy is different from the Deployed version of the policy, use the Deploy button to deploy the new configuration.