> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/policy-manager.md).

# Policy Manager

The policy manager allows you to define and manage different settings for multiple hosts at once.

{% hint style="warning" %}
**Please note**: If several policy managers are assigned to the same host and manage the same settings, Enginsight applies the settings of the policy manager with the highest priority. If the priority is also the same, Enginsight applies the settings of the most recently created policy manager.
{% endhint %}

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **Policy Manager** to show a list of all created policy managers. If you have not created a policy manager yet, this view is empty.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FHSBHrAgvUugpTsWmr6qz%2FEnginsight-EN-Hosts-Policy%20Manager-Full.jpg?alt=media&amp;token=8209cc20-50bd-419e-ae0b-bfac40774ce8" alt=""><figcaption></figcaption></figure>

The [policy manager overview](#policy-manager-overview) provides information such as:

* which host settings were configured for a created policy manager.
* which hosts are assigned to the policy manager.
* which priority the policy manager has compared to other policy managers.

You can also [export policy managers](#export-policy-managers) and [add new policy managers](#add-policy-manager).

***

## Navigation

<i class="fa-magnifying-glass">:magnifying-glass:</i> Click the **Text Search** field above the list and enter a search term of your choice to find specific list items more quickly.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Refresh** icon <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> above the list to update all list items.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scroll down the list or adjust the number of results shown per page ![](https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FfjKACCt2SKXcFd3S7Xb5%2FEnginsight-EN-Results%20per%20Page.jpg?alt=media\&token=e1650160-7a41-4965-aaca-6975db758dbe) to view additional entries. Use the page navigation ![](https://content.gitbook.com/content/V7OrHgKXA0t1jankQBYf/blobs/wnxVw06QGoSsYjhwMJRF/Enginsight-Seitennavigation-2.jpg) to switch between pages.&#x20;

### Filtering the List

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Filter** icon <i class="fa-filter">:filter:</i> above the list to filter the list by predefined parameters.

<details>

<summary>Available Filters</summary>

<table><thead><tr><th width="206.60546875">Parameter</th><th width="116.515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>Host Settings</td><td>String</td><td>Filter for all hosts with a specific setting or exclude them from the results. All available settings are shown.</td></tr><tr><td>Assigned Tags</td><td>String</td><td>Filter for all hosts with a specific tag or exclude them from the results. All available tags are shown.</td></tr></tbody></table>

</details>

### Sorting List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Sort** icon <i class="fa-sort">:sort:</i> next to a column name in the table header to sort by that column in ascending <i class="fa-angle-up">:angle-up:</i> or descending order <i class="fa-chevron-down">:chevron-down:</i> .

<i class="fa-computer-mouse">:computer-mouse:</i> Click the sort icon <i class="fa-bars-sort">:bars-sort:</i> above the list to adjust the priority of the applied sorting. A menu opens that shows all columns by which the list is currently sorted. Drag and drop the shown items to change the sorting priority.

### Further Actions for List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Select the checkbox <i class="fa-square">:square:</i> next to a list item to select the respective item. Alternatively, select the checkbox in the table header to select all list items.

The number of selected list items is now shown next to the search field.

The <i class="fa-slider">:slider:</i> **Actions** menu also appears in the upper-right corner. Click it to expand the respective submenu. The following actions are available:

<table><thead><tr><th width="192.7578125">Action</th><th>Description</th></tr></thead><tbody><tr><td>Delete</td><td><p>Delete all selected policy managers. To do so, confirm the message that appears with <strong>Delete Permanently</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: Deleted settings are permanently lost.</p></div><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: A policy manager overrides the settings of the assigned hosts. If you delete a policy manager, the <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/host-detail-view/settings.md#core-feature">settings of the assigned hosts</a> themselves are therefore retained. So if you delete a policy manager to undo a specific setting, we strongly recommend that you also check the settings of the assigned hosts and adjusting them if necessary.</p></div></td></tr></tbody></table>

***

## Policy Managers: Overview

The policy manager overview is structured as a table.&#x20;

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FhyVVeGbzgetjv7mng2KC%2FEnginsight-EN-Hosts-Policy%20Manager-Overview.jpg?alt=media&amp;token=63c2a6a4-3fee-4491-913e-72686b81446b" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="200.01953125">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Shows the custom name of the policy manager and an additional description, if provided. The date and time it was created and it was last edited are also shown.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a policy manager to navigate to the respective edit view. Here you can adjust the <a href="https://docs.enginsight.com/docs/manual/english/archive/configurations/policies/add-policy.md#general-information">configured settings</a> and delete the policy manager.</td></tr><tr><td>Host Settings</td><td>Shows the settings that apply to all hosts assigned to the policy manager.</td></tr><tr><td>References</td><td><p>Shows the names of the hosts that are assigned to the respective policy manager or that are excluded from it, as well as the tags that refer to the corresponding host groups.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Whether host names, tags, or both are shown depends on the <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/policy-manager/add-policy-manager.md#assigned-hosts">settings for assigned hosts</a> that you configured for the respective policy manager.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a host to navigate to the respective <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/host-detail-view.md">host detail view</a>.</p></td></tr><tr><td>Priority</td><td><p>Shows the custom priority that applies to the policy manager.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: If several policy managers are assigned to the same host and manage the same settings, Enginsight applies the settings of the policy manager with the highest priority. If the priority is also the same, Enginsight applies the settings of the most recently created policy manager.</p></div></td></tr></tbody></table>

## Adding a Policy Manager

You have two options for adding a policy manager. You can either create new policy managers or import policy managers that you [previously exported](#exporting-policy-managers), for example from other organizations.

### Option 1: Creating a New Policy Manager

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Create Policy** in the upper-right corner and select <i class="fa-plus">:plus:</i> **Create New** from the submenu that opens to [add a new policy manager](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/policy-manager/add-policy-manager.md#basic-settings).

### Option 2: Importing a Policy Manager

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Create Policy** in the upper-right corner and select <i class="fa-up-from-line">:up-from-line:</i> **Import** from the submenu that opens to [import one or more policy managers](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/policy-manager/add-policy-manager.md#import-policy-managers).

***

## Exporting Policy Managers

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-down-to-line">:down-to-line:</i> **Export Policy Managers** in the upper-right corner to open a new window in which you can configure additional export settings.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FIQo6dR9isC5NEgyqqfEO%2FEnginsight-EN-Hosts-Policy%20Manager-Export.jpg?alt=media&amp;token=3be40fd5-f126-4718-8241-3d0dcffdf995" alt="" width="411"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Export All** after configuring all settings to download all policy managers that can be exported. The export is provided in ZIP format.

{% hint style="info" %}
You can find the exported file in the default download location of your browser.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Abort** to return to the list overview.

### Assigned Policy Managers

Here you can define specific policy managers for export.

{% hint style="info" %}
Specifying assigned policy managers is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Policy Manager** field to expand a list of all available policy managers and select one or more policy managers for export.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Remove** icon <i class="fa-circle-x">:circle-x:</i> next to an added policy manager to remove it from the **Policy Manager** field again.

#### Excluded Policy Managers

Here you can define which policy managers should be excluded from the export.

{% hint style="info" %}
Specifying excluded policy managers is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** to show the options for **Excluded Policy Managers**.

<i class="fa-gear">:gear:</i> Configure all settings in the same way as for an [assigned policy manager](#assigned-policy-managers).

### Direct References

Here you can specify how objects that contain direct references should be handled during export. Direct references are objects referenced by ID (for example, hosts) that cannot be transferred to other environments.

The following options are available:

| Option                              | Description                                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Skip Entries with Direct References | Select this option to exclude objects that contain direct references from the export. This option is selected by default.  |
| Strip Direct References             | Select this option to also export objects that contain direct references. The direct references are removed during export. |

***

## Policy Manager: Edit View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a policy manager to navigate to the corresponding edit view. Here you can adjust the [configured settings](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/policy-manager/add-policy-manager.md#basic-settings) and delete the policy manager.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2Fo5SRZV63Bwy9SXl6oyrJ%2Fenginsight-hosts-management-policy%20manager-edit%20view.jpg?alt=media&amp;token=0bd888a3-5daf-493a-8d9f-f041bc8bcf0b" alt=""><figcaption></figcaption></figure>

The following actions are available:

<table><thead><tr><th width="200.39453125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Save Changes</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Save Changes</strong> after adjusting any settings.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Unsaved changes cannot be recovered.</p></div></td></tr><tr><td>Back</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Back</strong> to return to the list overview.</td></tr><tr><td>Remove</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Remove</strong>, then confirm the prompt that appears to delete the object that you are editing.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Deleted objects cannot be recovered.</p></div></td></tr></tbody></table>

***
