Install Arbitrator System
-------------------------

.. _arb-policy-conf-files:

Policy Configuration Files
..............................

Polices are a modular groupings of correlation rules, actions, and response
procedures that define how to respond to certain situations that happen on
the monitored systems. Policies are usually system and manufacturer
specific but can contain custom scripts for actions and response
procedures. Each policy will also contain several correlation rules that
are designed to create Alerts based on the best practices of that
particular system manufacturer.

The configuration files in this table are installed at the end of the 
installation process. The table describes the purpose of the components: 

.. tabularcolumns:: |p{3cm}|p{7cm}|p{6cm}|

+------------------------+----------------------------------------------------------+------------------------------------+
| Component              | Purpose                                                  | Filename                           |
+========================+==========================================================+====================================+
| Controls               | Controls are actions that the system can automate, user  | ``STDCONTROLS.lxcfg``              |
|                        | actions to support data collection, analysis before      |                                    |
|                        | presenting to an operational user as an alert to help    |                                    |
|                        | reduce user input and provide information and actions    |                                    |
|                        | faster.                                                  |                                    |
|                        |                                                          |                                    |
|                        | * Turn an alarm a different color                        |                                    |
|                        | * Push alert to another system such as dashboard server  |                                    |
|                        |   or a correlation server                                |                                    |
|                        | * Auto acknowledge alarms                                |                                    |
|                        | * Email the alert to a destination                       |                                    |
|                        | * Create a ticket with ServiceNow                        |                                    |
|                        | * Pre scripted action based on a response                |                                    |
|                        |                                                          |                                    |
|                        | Other options that can be developed:                     |                                    |
|                        |                                                          |                                    |
|                        | * Using API send the data to another destination         |                                    |
|                        | * Interact with another system                           |                                    |
|                        | * Run a script to collect additional information         |                                    |
|                        | * Run a script with actions to change state or           |                                    |
|                        |   configuration                                          |                                    |
+------------------------+----------------------------------------------------------+------------------------------------+
| Probes                 | A script to poll a system to collect data from a remote  | ``StandardDeploymentProbes.lxcfg`` |
|                        | system. This is important if the data required can't be  |                                    |
|                        | streamed from a system to the Arbitrator to be consumed, | ``PROBES.lxcfg``                   |
|                        | the Arbitrator and collect data remotely by periodic     |                                    |
|                        | probing of the system. Examples of probes that collect   |                                    |
|                        |                                                          |                                    |
|                        | * AXL                                                    |                                    |
|                        | * API                                                    |                                    |
|                        | * CLI                                                    |                                    |
+------------------------+----------------------------------------------------------+------------------------------------+
| Response procedures    | Contains group of controls that are assigned to the      |                                    |
|                        | policies.                                                |                                    | 
+------------------------+----------------------------------------------------------+------------------------------------+
| Policies               | A set of rules for the data that is turned into an       | ``SiteStats_08122020.lxcfg``       |
|                        | alert. It enables an alert to be generated and defines   | ``POLICIESUCCE221020.lxcfg``       |
|                        | the alarm ID and the content of the alarm that gets      | ``POLICIESCUCM221020.lxcfg``       |
|                        | presented to a user.                                     | ``POLICIESCUCIMP221020.lxcfg``     |
|                        |                                                          | ``PINGMON.lxcfg``                  |
+------------------------+----------------------------------------------------------+------------------------------------+




Installation Steps
...................

#. Log in to the Arbitrator: ``admin``/``admin``
#. Click the Wrench icon.

   |7fc67e0f816ffdee|

3. Click on the icon shown below

   |f0301700a05246d3|

4. Click **Import**,

   |1c7f03e7e4f4141c|

5. Click **Choose file**, then select your file and click **OK**.

   |62103d6777f092cd|

6. Ensure the name of the file you selected displays adjacent to **Choose file**,
   then click **Upload**.

7. Once the file has uploaded click **Import**.

8. Repeat this procedure for the following:

   * **Controls**
   * **Probes**
   * **Response Procedures**
   * **Policies**

   See: :ref:`arb-policy-conf-files`



.. |7fc67e0f816ffdee| image:: /src/images/7fc67e0f816ffdee.png
.. |f0301700a05246d3| image:: /src/images/f0301700a05246d3.png
.. |1c7f03e7e4f4141c| image:: /src/images/1c7f03e7e4f4141c.png
.. |62103d6777f092cd| image:: /src/images/62103d6777f092cd.png
.. |629d95c38a60bf25| image:: /src/images/629d95c38a60bf25.png
.. |b06e91afe1adf45e| image:: /src/images/b06e91afe1adf45e.png