Router Traps
************

Esta guía detalla los pasos a seguir para habilitar la funcionalidad
**Router Traps** en WOCU-Monitoring.

Requisitos Previos
==================

Debe tener privilegios adecuados para editar archivos del sistema
y ejecutar comandos como Superusuario (root o usando ``sudo``).

Pasos de Configuración
======================

Paso 1: Habilitar la funcionalidad de **Router Traps**
------------------------------------------------------

Para habilitar dicha función, debe modificar el archivo de
configuración **wocu.yml** ubicado en ``/etc/wocu/wocu.yml``.

  * Abrir el archivo para su edición mediante el siguiente comando:

    ::

      sudo nano /etc/wocu/wocu.yml

  * Añadir la siguiente configuración en la sección ``feature``:

    ::

      feature:
        router: enabled

Paso 2: Configurar el Colector MongoDB
--------------------------------------

Debe definir la URI del colector de MongoDB con antelación,
para que el router introduzca los datos. Esto también se realiza
en el archivo de configuración **wocu.yml**.

  * En el mismo archivo **wocu.yml**, agregue las siguientes líneas
    reemplazando `[IP-MONGO]` con la dirección IP de la instancia de MongoDB
    (si no exisiten debe añadirlas):

    ::

      wocu-indexer-addresses:
        collector_uri: "mongodb://[IP-MONGO]:27017"

  * (Opcional) Si MongoDB requiere autenticación, modifique la
    variable ``collector_uri`` de la siguiente manera:

    - Reemplace ``[USER]`` con el nombre de usuario de MongoDB.
    - Reemplace ``[PASS]`` con la contraseña de MongoDB.

    ::

      collector_uri: "mongodb://[USER]:[PASS]@[IP-MONGO]:27017"

Paso 3: Guardar y aplicar los cambios
-------------------------------------

  * Después de realizar los cambios necesarios, guarde el archivo
    y cierre el editor (en ``nano``, ejecute la combinación ``CTRL+O``
    para guardar y ``CTRL+X`` para salir).

  * Aplique la configuración ejecutando el siguiente comando:

    ::

      sudo wocu-ctl configure

Verificación
============

Para verificar que la configuración se ha aplicado correctamente,
puede revisar el contenido del archivo **environ.yml** generado
por el sistema.

  * Abra el siguiente para revisar los cambios:

    ::

      sudo cat /var/opt/wocu/etc/wocu/import_tool/environ.yml

  * Asegúrese de que la función de router y la URI del colector de
    MongoDB estén correctamente configuradas en este archivo.

.. Important::

  No modifique manualmente el archivo **environ.yml**, ya que es
  gestionado automáticamente por el comando ``wocu-ctl configure``.