Product SiteDocumentation Site

Capítulo 7. Resolución de problemas y búsqueda de información relevante

7.1. Fuentes de documentación
7.1.1. Páginas de manual
7.1.2. Documentos info
7.1.3. Documentación específica
7.1.4. Sitios web
7.1.5. Tutoriales (HOWTO)
7.2. Procedimientos comunes
7.2.1. Configuración de un programa
7.2.2. Monitorización de lo que hacen los demonios
7.2.3. Pedido de ayuda en una lista de correo
7.2.4. Reporte de un error cuando un problema es demasiado difícil
Para un administrador, la habilidad más importante es poder enfrentarse a cualquier situación conocida o no. Este capítulo provee una serie de métodos que — esperamos — le permitirá aislar la causa de cualquier problema que encuentre para que pueda llegar a resolverlo.

7.1. Fuentes de documentación

Antes de que pueda entender lo que realmente está pasando cuando hay un problema, necesita saber el rol que cumple en teoría cada programa involucrado en el problema. Para hacerlo, lo mejor que puede hacer es consultar su documentación; pero ya que dichos documentos son numerosos y muy dispersos debe saber todos los lugares donde puede encontrarlos.

7.1.1. Páginas de manual

Las páginas de manual, aunque de estilo escueto, contienen gran cantidad de información esencial. Repasaremos rápidamente los programas para verlas. Simplemente ejecute man página_de_manual — la página de manual generalmente tiene el mismo nombre que el programa sobre el que busca documentación. Por ejemplo, para aprender sobre las opciones posibles de cp utilizaría man cp en una terminal (revise el recuadro VOLVER A LOS CIMIENTOS La consola, un intérprete de línea de órdenes).
Las páginas de manual no sólo documentan programas en la línea de órdenes, también archivos de configuración, llamadas de sistema, funciones de la biblioteca C y más. A veces pueden coincidir ciertos nombres. Por ejemplo, la orden de la consola read tiene el mismo nombre que la llamada de sistema read. Es por eso que las páginas de manual están organizadas en secciones numeradas:
  1. órdenes que pueden ser ejecutadas desde la línea de órdenes;
  2. llamadas de sistema (funciones proporcionadas por el núcleo);
  3. funciones de biblioteca (proporcionadas por las bibliotecas del sistema);
  4. dispositivos (en Unix éstos son archivos especiales generalmente ubicados en el directorio /dev/);
  5. archivos de configuración (formatos y convenciones);
  6. juegos;
  7. conjuntos de «macros» y estándares;
  8. órdenes de administración del sistema;
  9. rutinas del núcleo.
Es posible especificar la página del manual que está buscando: para visualizar la documentación de la llamada de sistema read utilizaría man 2 read. Cuando no se especifique una sección explícitamente, se mostrará la primera sección que posea una página de manual con el nombre pedido. Por lo tanto, man shadow mostrará shadow(5) porque no hay páginas de manual para shadow en las secciones 1 a 4.
Por supuesto, si no sabe el nombre del programa, el manual no le será de mucha utilidad. Éste es el propósito del programa apropos que le ayuda a buscar en las páginas de manual, más específicamente en sus descripciones cortas. Cada página de manual comienza esencialmente con un resumen de una línea. apropos devuelve una lista de las páginas de manual que mencionan en su resumen la palabra clave pedida (o todas las ingresadas). Si las selecciona correctamente encontrará el nombre del programa que necesita.

Ejemplo 7.1. Encontrar cp con apropos

$ apropos "copy file"
cp (1)               - copia ficheros y directorios
cpio (1)             - copia ficheros a y desde archivos
gvfs-copy (1)        - copia archivos
gvfs-move (1)        - copia archivos
hcopy (1)            - copia archivos desde o a un volumen HFS
install (1)          - copia archivos y un conjunto de atributos
ntfscp (8)           - copia un archivo a un volumen NTFS.
The man command is not the only means of consulting the manual pages, since khelpcenter and konqueror (by KDE) and yelp (under GNOME) programs also offer this possibility. There is also a web interface, provided by the man2html package, which allows you to view manual pages in a web browser. On a computer where this package is installed, use this URL:
Esta herramienta necesita un servidor web. Es por esto que si debería elegir instalar este paquete en uno de sus servidores: todos los usuarios de la red local se beneficiarán de este servicio (incluyendo máquinas que no tienen Linux) y le evitará tener que configurar un servidor HTTP en cada estación de trabajo. Si puede acceder a su servidor desde otras redes podría desear restringir el acceso a este servicio sólo a los usuarios de la red local.
Last but not least, you can view all manual pages available in Debian (even those that are not installed on your machine) on the manpages.debian.org service. It offers each manual page in multiple versions, one for each Debian release.

7.1.2. Documentos info

El proyecto GNU escribió manuales para la mayoría de sus programas en el formato info; es por esto que muchas páginas de manual hacen referencia a la documentación info correspondiente. El formato tiene ciertas ventajas, pero el programa por defecto para visualizar estos documentos (llamado info) es también ligeramente más complejo. En vez de éste se le recomienda usar pinfo (del paquete pinfo).
La documentación info tiene una estructura jerárquica y si ejecuta pinfo sin parámetros mostrará una lista de los nodos disponibles en el primer nivel. Generalmente los nodos tienen el nombre del programa correspondiente.
En la orden pinfo la navegación se controla con las teclas del cursos. Puede utilizar, alternativamente, un navegador gráfico que es mucho más amigable. Nuevamente, konqueror y yelp funcionan; info2www también provee una interfaz web.
Note que el sistema info, a diferencia del sistea de páginas man, no permite traducciones. Los documentos info estarán, por lo tanto, siempre en inglés. Sin embargo, cuando le pida a pinfo una página info que no exista, éste buscará la página de man con el mismo nombre (si es que existe) y ésta puede que sí esté traducida.

7.1.3. Documentación específica

Cada paquete incluye su propia documentación. Aún los programas menos documentados generalmente tienen un archivo README que contiene información interesante y/o importante. Esta documentación se instala en el directorio /usr/share/doc/paquete/ (donde paquete representa el nombre del paquete). Si la documentación es particularmente grande puede no estar incluida en el paquete principal del programa sino que puede haber sido separada a un paquete dedicado que generalmente es llamado paquete-doc. El paquete principal por lo general recomendará el paquete de documentación para que pueda encontrarlo fácilmente.
El directorio /usr/share/doc/paquete/ también contiene algunos archivos provistos por Debian que completan la documentación especificando las particularidades o mejoras del paquete comparándolo con una instalación tradicional del software. El archivo README.Debian también indica todas las adaptaciones que se realizaron para cumplir con la Normativa Debian. El archivo changelog.Debian.gz le permite al usuario seguir las modificaciones realizadas al paquete con el tiempo: es muy útil intentar entender lo que cambió entre dos versiones instaladas que no tienen el mismo comportamiento. Por último, a veces habrá un archivo NEWS.Debian.gz que documentará los cambios importantes en el programa que podrían interesar al administrador.

7.1.4. Sitios web

En la mayoría de los casos, los programas de software libre tienen sitios web que se utilizan para distribuirlo y reunir la comunidad de desarrolladores y usuarios. Estos sitios generalmente están llenos de información relevante en varias formas: documentación oficial, preguntas frecuentes (FAQ: «Frequently Asked Questions»), archivos de listas de correo, etc. Los problemas que podría tener ya han sido objeto de varias preguntas; los FAQ o los archivos de las listas de correos pueden tener una solución. Dominar los motores de búsqueda será de gran valor para encontrar las páginas relevantes rápidamente (restringiendo la búsqueda al dominio o subdominio de Internet dedicado al programa). Si la búsqueda devuelve demasiados resultados o éstos no coinciden con lo que desea, puede agregar la palabra clave debian para limitar los resultados y obtener información relevante.
If you do not know the address for the software's website, there are various means of getting it. First, check if there is a Homepage field in the package's meta-information (apt show package). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at /usr/share/doc/package/copyright. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc.
También podría desear revisar el wiki de Debian, un sitio web colaborativo donde cualquiera, inclusive simples visitantes, pueden hacer sugerencias directamente desde sus navegadores. Es utilizado tanto por desarrolladores para diseñar y especificar sus proyectos como por usuarios para compartir su conocimiento escribiendo documentos colaborativamente.

7.1.5. Tutoriales (HOWTO)

Un «howto» es un documento que describe, en términos concretos y paso a paso, «cómo» (en inglés «how to») llegar a un objetivo predefinido. Los objetivos cubiertos son relativamente variados pero generalmente de naturaleza técnica; por ejemplo: configurar «IP Masquerading», instalar un servidor Samba, etc. Estos documentos generalmente intentan cubrir todos los problemas potenciales que podrían ocurrir durante la implementación de una tecnología dada.
El Proyecto de Documentación de Linux (LDP: «Linux Documentation Project») gestiona muchos de estos tutoriales, su sitio web almacena todos estos documentos:
Tome estos documentos con un grano de sal. Generalmente tienen varios años; la información que contienen a veces está obsoleta. Este fenómeno es aún más frecuente para sus traducciones ya que las actualizaciones no son ni sistemáticas ni instantáneas luego de la publicación de nuevas versiones de los documentos originales. Esta es parte de la alegría de trabajar en un entorno de voluntarios y sin limitaciones…