Skip to the content ForoHackers
Log inJoin

El diagrama de red que alguien puede leer a las tres de la madrugada

DocumentationNetwork administrationTechnical writing
#1085 · ElProfeDeRedes · · Report

He visto muchos diagramas de red que son un plato de espaguetis con iconos. Cuando algo falla de madrugada no ayudan. Lo que les enseño a mis alumnos:

  1. Un diagrama, una pregunta. Uno lógico ("qué subredes hay y quién habla con quién"), otro físico ("qué cable va a qué puerto"), otro de flujo si hace falta. Mezclarlos es lo que crea el plato de espaguetis.
  2. Leyenda y convenciones. Una línea continua es un enlace físico, una discontinua es una VPN, un color es una VLAN. Y se pone en el propio diagrama.
  3. Lo importante, grande. Direcciones, VLAN y velocidades de los enlaces troncales en la figura; el resto en una tabla al lado.
  4. Fecha, versión y autor. Un diagrama sin fecha es un rumor.
  5. Texto además de dibujo. Una tabla de direccionamiento (subred, máscara, puerta de enlace, quién la usa) se puede buscar con Ctrl+F y un dibujo no.
  6. En un sitio que se versione. Si el diagrama se genera a partir de un fichero de texto, se puede revisar en un cambio como el código.

Y una prueba: dale el diagrama a alguien que no lo ha visto y pídele que cuente el camino de un paquete de un ordenador a Internet. Si duda, el diagrama no está terminado.

#1684 · PaellaDePaquetes · · Report

+1 a todo. En la red comunitaria donde participo el mejor documento que tenemos es una tabla de IPs y antenas con la fecha de la última visita al tejado. Lo vi como una chapuza y resultó ser lo que más se consulta.

#1685 · LaAbuelaDelCOBOL · · Report

Lo de "un diagrama sin fecha es un rumor" lo voy a pegar en la pared. En el banco teníamos un esquema de 1994 que todos sabíamos que estaba mal, pero nadie sabía en qué.

#1686 · CaracolDelDNS · · Report

Añado una cosa que casi nadie documenta: los nombres. Qué registros DNS apuntan a qué, y quién puede cambiarlos. Cuando se rompe, lo difícil nunca es la red, es averiguar quién tiene la contraseña del proveedor del dominio.

#1687 · ElProfeDeRedes · · Report

Muy buena, Caracol. Los nombres y los responsables van en la tabla. Si la contraseña solo la sabe una persona, eso es un fallo de documentación y de organización a la vez.

Log in or join to reply.