4.8 Opciones de Ficheros de Registro.

Ocasionalmente, necesitaremos averiguar qué está haciendo Samba. Esto es especialmente cierto cuando Samba está realizando una acción no esperada o no está funcionando bien. Para localizar esta información, necesitaremos chequear los ficheros de registro de Samba para ver porqué hizo lo que hizo.

Los ficheros de registro de Samba pueden ser tan breves o completos como tú quieras. Aquí tienes un ejemplo de cómo sería uno de ellos:

[1999/07/21 13:23:25, 3] smbd/service.c:close_cnum(514)
phoenix (192.168.220.101) closed connection to service IPC$
[1999/07/21 13:23:25, 3] smbd/connection.c:yield_connection(40)
Yielding connection to IPC$
[1999/07/21 13:23:25, 3] smbd/process.c:process_smb(615)
Transaction 923 of length 49
[1999/07/21 13:23:25, 3] smbd/process.c:switch_message(448)
switch message SMBread (pid 467)
[1999/07/21 13:23:25, 3] lib/doscalls.c:dos_ChDir(336)
dos_ChDir to /home/samba
[1999/07/21 13:23:25, 3] smbd/reply.c:reply_read(2199)
read fnum=4207 num=2820 nread=2820
[1999/07/21 13:23:25, 3] smbd/process.c:process_smb(615)
Transaction 924 of length 55
[1999/07/21 13:23:25, 3] smbd/process.c:switch_message(448)
switch message SMBreadbraw (pid 467)
[1999/07/21 13:23:25, 3] smbd/reply.c:reply_readbraw(2053)
readbraw fnum=4207 start=130820 max=1276 min=0 nread=1276
[1999/07/21 13:23:25, 3] smbd/process.c:process_smb(615)
Transaction 925 of length 55
[1999/07/21 13:23:25, 3] smbd/process.c:switch_message(448)
switch message SMBreadbraw (pid 467)

Muchas de estas opciones sólo las usan los programadores de Samba. Sin embargo, veremos el significado de algunas de estas entradas con más detalle en el Capítulo 9, Solución de Problemas con Samba.

Samba contiene seis opciones que permiten a los usuarios describir cómo y dónde se debería escribir la información de registro. Cada una de estas opciones son opciones globales y no pueden aparecer en la definición de un recurso. Aquí tienes un fichero de configuración actualizado que cubre cada una de las opciones que veremos:

[global]
  netbios name = HYDRA server
  string = Samba %v on (%I)
  workgroup = SIMPLE

  # Networking configuration options
  hosts allow = 192.168.220. 134.213.233. localhost
  hosts deny = 192.168.220.102
  interfaces = 192.168.220.100/255.255.255.0 \ 134.213.233.110/255.255.255.0
  bind interfaces only = yes

  # Debug logging information
  log level = 2
  log file = /var/log/samba.log.%m
  max log size = 50
  debug timestamp = yes

[data]
  path = /home/samba/data
  browseable = yes
  guest ok = yes
  comment = Data Drive
  volume = Sample-Data-Drive
  writeable = yes

Aquí, hemos añadido un fichero de registro de usuario que reporta información de depuración de nivel 2. Este es un relativamente mínimo nivel de depuración. El rango de nivel va de 1 a 10, donde el nivel proporciona sólo una pequeña cantidad de información y el nivel 10 proporciona una cantidad enorme de información de bajo nivel. El nivel 2 nos proporcionará información útil sin ocupar demasiado espacio en disco en nuestro servidor. En la práctica, deberías evitar el uso de niveles de depuración superiores a 3 a menos que estés programando Samba.

Este fichero está localizado en el directorio /var/log gracias a la opción log file. Sin embargo, podemos usar las variables para crear ficheros de registro independientes para cada usuario o cliente, como la variable %m en la siguiente línea:

log file = /usr/local/logs/samba.log.%m

La posibilidad de aislar los mensajes de registro puede resultar de un valor inapreciable a la hora de tener que rastrear un error de red si sabes que el problema viene de una máquina o cliente determinado.

Hemos añadido otra precaución a los ficheros de registro: ninguno de ellos puede exceder en tamaño de 50 kilobytes, como indica la opción max log size. Si un fichero de registro supera este tamaño, el contenido es movido a un fichero con el mismo nombre pero con el sufijo .old añadido. Si el fichero .old ya existe, es sobreescrito y su contenido perdido. El fichero original es limpiado, a la espera de recibir nueva información de registro. Esto previene que el disco se quede sin espacio por culpa de los ficheros de registro de Samba durante el tiempo de vida de los demonios.

Por conveniencia, hemos decidio dejar la fecha y hora de la depuración en los registros con la opción debug timestamp, la cual es el valor por defecto. Esto coloca una cadena de fecha y hora en formato "timestamp" junto a cada mensaje en el fichero de registro. Si no estamos interesados en ésta opción, deberemos especificar el valor no para esta opción.