.. _config:

=============================
Konfigurace
=============================

Konfigurace importní komponenty se provádí v souboru
``imwhooser.yml``, který se nachází v adresáři
``/config/``. Tento soubor obsahuje nastavení pro jednotlivé
datové zdroje, umožňuje jejich další parametrizaci,
obsahuje nastavení pro napojení na aplikaci Elza.

Komponenta je realizována pomocí frameworku Java Spring Boot,
který umožňuje snadnou konfiguraci a rozšiřitelnost. Jednotlivá 
nastavení jsou definována také v dokumentaci k frameworku.

Port
=======

Komponenta poskytuje webové rozhraní umožňující její 
:ref:`monitorování <oper_monit>` a další ovládání. 
Komponenta běží ve výchozím nastavení na portu 8080.

Port je možné změnit v konfiguračním souboru
``imwhooser.yml`` v sekci `server`:

.. code-block:: yaml

  # Port, kde bude služba dostupná
  server:
    port: 8088


Databáze
==========

Komponenta používá pro ukládání dat relační databázi.
Primární podporovanou databází je PostgreSQL.


.. code-block:: yaml

  # Konfigurace připojení k databázi
  spring:
    datasource:
      driver-class-name: org.postgresql.Driver
      url: jdbc:postgresql://localhost:5432/mydb
      username: user
      password: password


Elza
======

Napojení na Elza slouží k přenosu importovaných dat.

.. code-block:: yaml

  # Nastavení pro připojení k ELZA
  elza:
    url: http://localhost:8080
    username: pevaimport
    password: XXXXXX
    soapLogging: false
    batchSize: 20
    #batchSize: 1
    scope: CAM
    systemCode: CAM
    # zakázat přenos dat
    send:
      enabled: true


.. _config_monit:

Monitorování
==============================

Pro monitorování běhu a stavu komponenty Imwhooser je možné použít
rozhraní, které poskytuje data ve formátu OpenMetrics. V konfiguračním souboru
je nutné povolit k němu přístup. 

.. code-block:: yaml

  # Povolení OpenMetrics endpointu
  management:
    endpoints:
      web:
        exposure:
          include: health, prometheus
      prometheus:
        enabled: true
      health:
        enabled: true
    endpoint:
      health:
      show-details: always


Datové zdroje
=========================

Každý datový zdroj je definován v konfiguračním souboru ``imwhooser.yml``
v samostatné sekci. Konfigurace je specifická pro každý typ datového zdroje.

.. toctree::

   clo.rst
   whois.rst
   peva.rst