documentacion
Documentación de Red
These materials are licensed under the Creative Commons Attribution-Noncommercial 3.0 Unported license
(http://creativecommons.org/licenses/by-nc/3.0/) aspart of the ICANN, ISOC and NSRC Registry Operations Curriculum.
Documentación
Quizás se ha preguntado, “Cómo saber dónde está
todo?”
Documentar,
documentar,
documentar.
Ladocumentación actualizada es esencial
• Para saber qué hizo hace 6 meses
• Para que otros en su equipo puedan
resolver problemas rápidamente
• Piense en estas preguntas:
– Qué le pasaría a la red si elingeniero principal
encuentra otro trabajo?
– Cómo harían sus compañeros para resolver
problemas si usted está enfermo? O de
vacaciones?
La documentación no es fácil
• Es un trabajo tedioso– “Ahora no puedo, tengo mucho que hacer”
– “Que lo haga otro”
• Difícil mantener organizada
– Necesita una metodología que todos puedan seguir
– Si no, se vuelve un desorden con el tiempo• La red cambia constantemente
– La información vieja es inútil e incluso peligrosa.
– La documentación no es un proyecto, es un proceso!
Pautas
• Cree una política de documentación
– Qué responsabilidad tiene cada uno?
– Cómo es el proceso? Orden de las tareas?
– Cómo se verifica la calidad?
– Metodologías
• Esquemas de nombres consistentes
– Para equipos, cableado,etc.
Pautas
• Etiquete TODO
– Servidores, routers, switches, puntos
inalámbricos, UPS, etc…
– Cables
– Tomas de red
– Racks
Documentación
Cosas básicas, como la documentación de losswitches...
–
A qué está conectado cada puerto?
–
Puede ser simplemente un archivo de texto con una línea
por cada puerto del switch:
• health-switch1, port 1, Salón #29 – Director
• health-switch1, port 2, Salón #43 – Recepcionista
• health-switch1, port 3, Salón #100 – Salón de clase
• health-switch1, port 4, Salón #105 – Oficina de profesores
• …..
• health-switch1,...
Regístrate para leer el documento completo.