Policy Management

  • General Information
  • Policy Operations
  • Copy/Rename Policies
  • Compare Policies
  • Searching Policies
  • Pattern Validation

  • Demos
    Add new Monitor Policy  
    Export/Import Policies  




    General Information

    Two major concepts of the boom Infrastructure are managed inside the Policy Management:

  • Monitors
  • Indication Policies

  • For more details about policy types see chapters Monitor Policy and Indication Policy.

    The boom GUI Workbench contains two views that are belonging to the Policy Management. The view on the left gives an overview of all existing Policies and the view on the right provides all available Policy details.


    policy and policy list view

    The Policy Overview view shows all policies and offers two filter alternatives:

    Additional Columns

    	
    	Related Assignment
    	Related Agents
    	

    Filter on Name

    	Specify the full policy name or a part of the name. 



    Policy tree folder "_Lost and Found"

    The server job Find_Lost_Policies detects lost policies and adds them to the policy tree folder _Lost and Found. e.g. If the server job detects a policy which is not known in his policyGroups.xml file then the policy will be added to the _Lost and Found folder. An user can decide whether the policy should be deleted or copied to another folder.




    Policy Operations

    All existing Policies are displayed in form of a tree hierarchy. Double-click on a single Policy to open the appropriate Policy details.

    All available actions are located in the context menu. Right-click on a Policy Group or a single Policy to open the appropriate context menu:

    Context menu on Policy Group level:       Context menu on Policy level:
    policy group context menu policy context menu

    Import Policies: This function is used to import boom Policies into the boom Server. For the Policy import a xml formatted file called policyGroups.xml is needed. This file must be selected as a source during the import process. The xml formatted file contains a list of all the Policies that have to be imported.
    Import Other: Import of a single Policy from other vendors.
    Export Policies: Export the Policy tree to a specified location.
    Add Group: Create a new Policy Group (tree folder).
    Rename Group: Rename a Policy Group.
    Delete Group Recursive: The selected Policy Group will be completely removed. That means all Policies and all subfolders inside the Policy Group will be deleted.
    Delete Group: This will delete the selected Policy Group, but it will also move the complete content to the Policy Group (toplevel folder).
    Open Policy: This will open the appropriate Policy details in the Policy Details View.
    Add New Monitor Policy: A new Monitor Policy tab will be opened. Please note: You have to save the Policy before you can deploy it. After the Policy has saved, the policy name cannot be changed any more. If you need to change a name, you have to use the "Copy and Rename Policies".
    Play Video:  
    Add New Indication Policy: A new Indication Policy tab will be opened. Please note: You have to save the Policy before you can deploy it. After the Policy has saved the first time, the Policy name cannot be changed any more. If you need to change a Policy name, you have to use the function "Copy and Rename Policies".
    Duplicate Policy: The duplicate Policy function is used to duplicate a single Policy within the same policy group. The duplication of multiple Policies is described in 4.1.8 Copy and Rename Policies. Please note: The Policy name is unique and therefore it is not possible to have multiple Policies with the same name. If you duplicate a Policy you must provide a new unique name to the policy.
    Cut/ Copy/ Paste: Copy/Paste gives you the possibility to copy a single policy within the same policy group or to another policy group. Cut/Paste allows you to move a single or multiple policies to another policy group.
    Search Policy: Opens a policy search view with a "Global Search" and an "Advanced search" utility.
    Copy And Rename Policies: Copy or rename a single or multiple Policies. For more details see the paragraph Copy/Rename Policies below
    Delete Policy: A single Policy or multiple Policies can be selected and deleted.
    Show Indications: This will open a new Indication Tab displaying all active Indications for the selected Policy.
    Show Related Agents/Assignments: This shows general Policy information like Type, Version, Group, ....
    and a list of Agents and Assignments on which this Policy is deployed on.

    Related
    Deploy on: Allows to deploy the selected Policies to one or more boom Agents. It also starts necessary monitor tasks. During the deployment process you have to select the Agents where the selected policies should be deployed. For more information see the paragraph Deploy on/Undeploy from below.
    Redeploy to all: Allows to trigger re-deployment of the selected Policies to all boom Agents where they were previously deployed.
    Undeploy from: Triggers the removing of the selected policies (and also stops monitor task) from the selected boom Agents. During the undeployment process you have to select the Agents from where the selected policies should be undeployed. For more information see the paragraph Deploy on/Undeploy from below.
    Hint: If the policy was deployed as part of an assignment group it must be undeployed together with the assignment or unlinked from the assignment group first.
    Undeploy from all: Triggers the removing of the selected Policies from all boom Agents where they were previously deployed.
    Hint: If the policy was deployed as part of an assignment group it must be undeployed together with the assignment or unlinked from the assignment group first.
    Mark as Deployed on:
    Enqueue Deployment on ...
    Enqueue ReDeployment to all
    Enqueue UnDeployment from...
    Enqueue UnDeployment from all   
    All "Enqueue Deployment" actions will be added to the Deployment Queue and must be triggered manually! This actions will NOT be started automatically! For more details about the Deployment Queue see the Chapter Assignment Summary.

    Deploy on / Undeploy from

    During the deployment/undeployment process you need to select the boom Agents where you want to deploy/undeploy the polices. A filter function inside the Deployment Dialog helps to find the appropriate Agents. Just enter some letters that matches with the boom Agents you need for the deployment process and press the Apply button. To remove an existing filter from the tree you have to clean the filter input field and press the Apply button.

    cCopy




    Copy/Rename Policies

    To rename one or multiple Policies you have to select all the Policies you want to copy/rename. If you select a Policy Group all Policies inside this Group and inside all subgroups will be processed. If you select a single Policy only this Policy will be processed. In the Copy and Renaming Dialog you will see a list of all Policies that you have selected:

    cCopy

    Renaming Options:

  • adding Prefix/Suffix
  • find/replace
  • copy Policies to a different group
  • Preview: Any changes to the Prefix/Suffix or the Find/Replace field will reflect directly in the Preview Table. To exclude one or more Policies from the renaming process, select them in the Preview table and remove them from the Preview Table by pressing the button "Remove line(s)".

    Naming Conflicts: Changes to the Prefix/Suffix or the Find/Replace field also triggers automatic validation of the Policy names. Naming conflicts are indicated in the Preview Table. To remove naming conflicts you can either change your renaming parameters or you can click on the button "Remove Conflicts" button. If you click on the button, all Policies with conflicts will be deleted from the Preview Table and excluded from the copying/renaming process.

    Copy Policies and save them to a different Group: If you want to save the renamed Policies to a different location, you have to enable the section "Enable Copying to a different Group". All original Policies remain unchanged and the renamed Policies will be saved to the selected Group. If you need to add a new folder inside the Policy Tree, you can create the folder using the tree context menu.

    Please note: The Policy name is a unique name across all Policies. If you rename a Policy and the new name already exists, you will get a naming conflict. The renaming process itself will be started by pressing the "Rename" button on the bottom right corner.




    Compare Policies

    Every change that is made to a Policy will increase the Policy version. To compare the current Policy with an older version select the version you want to compare with and press the "compare" button. This opens the Policy Compare Dialog:

    compare policy dialog




    Searching Policies

    There are two alternative ways to find the wanted policy names

  • use the Filter on name field in the Policy Overview view. Specify the full policy name or a part of the name.

  • Use Policy Search. Select Policy Name in the Advanced Search.

    Policy Search provides a powerful algorithm for searching policy attributes or policy names.
    Right-click in the policy overview view to open the context menu. Select Search Policy to open the Policy Search view.

    First you have to select the search criteria. A search is possible over all Policies, Monitor Policies only or Indication Policies only.
  • find policies


    Use Global Search to search through all main attributes and condition attributes of a policy.
    Specify the full attribute name or a part of the name.

    find policies


    Use Advanced Search to either search through all Main Properties (select Policy Name or Main Attributes: all attributes without condition attributes)

    find policies

    or Condition Properties (select Condition ID or Condition Attributes: all condition attributes, no main attributes) of a policy.

    find policies




    Pattern Validation

    One of the main tasks during creation of a new Indication Policy is defining of a regular expression used for filtering and parsing incoming messages. The boom GUI has powerful validation tool integrated.

    pattern validation dialog

    Edit Line: You can edit only one line at a time.
    Append Line: Appends a single line to the table.
    Paste: Paste the clipboard into the table.
    Load from file: Load a complete file to the table. Please note: All existing lines will be remove!
    Append from file: This will load and append a complete file into the table. Please note: The existing lines will not be removed! The new data will be appended to the table.
    Save to file: This will save the table content to a text file.
    Validate All Lines: If you want to validate the whole table use this action.
    Stop Validation: This will stop the validation process.
    Remove Line: The selected lines will be removed from the table.
    Clear All Lines: This action removes all lines from the table.