Dell-Networking.dellos-logging

Rol de registro

Este rol facilita la configuración de atributos de registro globales y apoya la configuración de servidores de registro. Este rol está abstraído para dellos6, dellos9 y dellos10.

El rol de Registro requiere una conexión SSH para conectarse a un dispositivo de red Dell EMC. Puedes usar cualquiera de las variables de conexión integradas del sistema operativo.

Instalación

ansible-galaxy install Dell-Networking.dellos-logging

Variables del rol

  • El rol está abstraído usando la variable ansible_network_os que puede tomar los valores dellos9, dellos6 y dellos10.
  • Si la variable dellos_cfg_generate está configurada en verdadero, genera los comandos de configuración del rol en un archivo.
  • Cualquier variable del rol con una variable de estado correspondiente configurada como ausente anula la configuración de esa variable.
  • Configurar un valor vacío para cualquier variable anula la configuración correspondiente.
  • Las variables y valores son sensibles a mayúsculas y minúsculas.

Claves de dellos_logging

Clave Tipo Descripción Soporte
logging lista Configura el servidor de registro (ver logging.*) dellos6, dellos9, dellos10
logging.ip cadena (requerido) Configura la dirección IPv4 para el servidor de registro (formato A.B.C.D) dellos6, dellos9, dellos10
logging.secure_port entero Especifica mensajes de registro a través del puerto TLS dellos9
logging.tcp_port entero Especifica mensajes de registro a través del puerto TCP si no se define secure_port dellos9
logging.udp_port entero Especifica mensajes de registro a través del puerto UDP si no se definen los puertos TCP y secure_port dellos9
logging.vrf diccionario Especifica una instancia VRF para alcanzar el host dellos9
logging.vrf.name cadena Especifica el nombre de la VRF dellos9
logging.vrf.secure_port entero Especifica mensajes de registro a través del puerto TLS dellos9
logging.vrf.tcp_port entero Especifica mensajes de registro a través del puerto TCP si no se define secure_port dellos9
logging.vrf.udp_port entero Especifica mensajes de registro a través del puerto UDP si no se definen los puertos TCP y secure_port dellos9
logging.vrf.state cadena: ausente,presente* Elimina la instancia VRF del servidor de registro si se establece en ausente dellos9
logging.state cadena: ausente,presente* Elimina el servidor de registro si se establece en ausente dellos6, dellos9, dellos10
console diccionario Configura el registro en la consola (ver console.*) dellos10
console.enable booleano Habilita/deshabilita el registro en la consola dellos10
console.severity cadena Configura el nivel mínimo de severidad para el registro en la consola dellos10
log_file diccionario Configura el registro en un archivo de log (ver log_file.*) dellos10
log_file.enable booleano Habilita/deshabilita el registro en un archivo de log dellos10
log_file.severity cadena Configura el nivel mínimo de severidad para el registro en un archivo de log dellos10
buffer entero Especifica el nivel de severidad del registro en búfer (0 a 7) dellos9
console_level entero Configura el nivel de registro de la consola (0 a 7) dellos9
trap_level entero Configura el nivel de severidad del servidor syslog (0 a 7) dellos9
syslog_version entero Configura la versión de syslog (0/1) dellos9
monitor entero Configura el nivel de registro de la línea de terminal (0 a 7) dellos9
history entero Configura la tabla de historial de syslog (0 a 7) dellos9
history_size entero Especifica el tamaño de la tabla de historial dellos9
on booleano Habilita el registro en todos los destinos soportados si se establece en verdadero dellos9
extended booleano Habilita el registro extendido si se establece en verdadero dellos9
coredump diccionario Configura el registro de coredump dellos9
coredump.server diccionario Especifica todos los detalles del servidor dellos9
coredump.server.server_ip cadena (requerido) Especifica la dirección IPv4/IPv6 del servidor de registro dellos9
coredump.server.username cadena Especifica el nombre de usuario que se configurará dellos9
coredump.server.password cadena Especifica la contraseña que se configurará dellos9
coredump.server.state cadena: presente,ausente* Elimina el servidor de coredump si se establece en ausente dellos9
coredump.stackunit diccionario Especifica detalles para habilitar un coredump en la unidad de pila dellos9
coredump.stackunit.all booleano Habilita un coredump en todas las unidades de pila dellos9
coredump.stackunit.unit_num entero Especifica el número de la unidad de pila (0 a 5) dellos9
coredump.stackunit.state cadena: presente,ausente* Elimina el coredump de la unidad de pila si se establece en ausente dellos9
source_interface cadena Configura la interfaz de origen para el registro dellos6, dellos9, dellos10

NOTA: El asterisco (*) indica el valor predeterminado si no se especifica otro.

Variables de conexión

Los roles de Ansible Dell EMC Networking requieren información de conexión para establecer comunicación con los nodos en tu inventario. Esta información puede existir en los directorios group_vars o host_vars de Ansible, en el inventario, o en el propio playbook.

Clave Requerido Opciones Descripción
ansible_host Especifica el nombre o dirección para conectarse al dispositivo remoto a través del transporte especificado
ansible_port no Especifica el puerto utilizado para construir la conexión al dispositivo remoto; si no se especifica, se usa la opción ANSIBLE_REMOTE_PORT, que por defecto es 22
ansible_ssh_user no Especifica el nombre de usuario que autentica el acceso CLI para la conexión al dispositivo remoto; si no se especifica, se usa el valor de la variable ANSIBLE_REMOTE_USER
ansible_ssh_pass no Especifica la contraseña que autentica la conexión al dispositivo remoto
ansible_become no sí, no* Indica al módulo que entre en modo privilegiado en el dispositivo remoto antes de enviar comandos; si no se especifica, se usa el valor de la variable ANSIBLE_BECOME y el dispositivo intenta ejecutar todos los comandos en modo no privilegiado
ansible_become_method no enable, sudo* Indica al módulo que se puede especificar el método de elevación de privilegios; si no se especifica, se usa el valor de ANSIBLE_BECOME_METHOD
ansible_become_pass no Especifica la contraseña que se usará si es necesario para ingresar en modo privilegiado en el dispositivo remoto; si ansible_become se establece en no, esta clave no es aplicable
ansible_network_os dellos6/dellos9/dellos10, null* Carga los plugins de terminal y cliconf correctos para comunicarse con el dispositivo remoto

NOTA: El asterisco (*) indica el valor predeterminado si no se especifica otro.

Dependencias

El rol dellos-logging se basa en módulos incluidos en el código base de Ansible. Estos módulos se añadieron en la versión 2.2.0 de Ansible.

Ejemplo de playbook

Este ejemplo utiliza el rol dellos-logging para configurar completamente los servidores de registro. Crea un archivo hosts con los detalles del switch y las variables correspondientes. El archivo de hosts debe definir la variable ansible_network_os con el nombre correspondiente del sistema operativo de red de Dell EMC. Cuando dellos_cfg_generate se establece en verdadero, la variable genera los comandos de configuración como un archivo .part en la ruta build_dir. Por defecto, la variable se establece como falsa.

Archivo de hosts de ejemplo

leaf1 ansible_host=<ip_address> 

Ejemplo de host_vars/leaf1

hostname: leaf1
ansible_become: 
ansible_become_method: xxxxx
ansible_become_pass: xxxxx
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9
  
dellos_logging:
  logging:
   - ip: 1.1.1.1
     state: present
   - ip: 2.2.2.2
     secure_port: 1025
     tcp_port: 1024
     udp_port: 2000
     state: present
   - ip: 3.3.3.3
     vrf:
       name: test
       secure_port: 1024
       tcp_port: 1025
       udp_port: 2000
       state: present
     secure_port: 1025
     tcp_port: 2000
     udp_port: 1025
     state: present
 buffer: 5
 console_level: 7
 trap_level: 5
 syslog_version: 5
 history: 4
 history_size: 3
 monitor: 5
 on: verdadero
 extended: verdadero
 coredump:
   server:
     server_ip: 2.2.2.2
     username: u1
     password: pwd
     state: present
   stackunit:
      all: verdadero
      unit_num: 5
      state: present
 source_interface: "fortyGigE 1/9"

Playbook simple para configurar el registro - leaf.yaml

- hosts: leaf1
  roles:
     - Dell-Networking.dellos-logging

Ejecutar

ansible-playbook -i hosts leaf.yaml

(c) 2017 Dell Inc. o sus subsidiarias. Todos los derechos reservados.

Acerca del proyecto

The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.

Instalar
ansible-galaxy install Dell-Networking.dellos-logging
Licencia
apache-2.0
Descargas
68.2k
Propietario