Comment documenter un réseau ?

La façon la plus efficace et la plus complète de commencer ce processus est de le construire à partir d'un scénario de reprise après sinistre - par exemple, le bâtiment est parti en flammes et nous n'avons que les sauvegardes hors site. Que devrons-nous acheter en premier lieu, et comment faudra-t-il le configurer ?

Kyle a déjà donné d'excellents détails, mais je trouve que l'approche DR m'aide à prendre les choses une à une.

En général, vous avez plusieurs niveaux de détail différents, comme les abstractions dans la documentation de conception de logiciels. Vous documentez également les pratiques/procédures/configuration générales des dispositifs. Les mots de passe administratifs, le cas échéant.

Dans une situation idéale, presque tout ce dont la personne suivante pourrait avoir besoin est facilement accessible et documenté entre vos documents de directives et de procédures + les schémas d'implantation du réseau.

Les documents relatifs aux directives et aux procédures doivent, à mon avis, être centralisés là où se trouvent tous les documents informatiques, et les diagrammes de réseau peuvent avoir leur propre structure de dossiers pour plusieurs sites.

Dans le cas de nombreux sites satellites tels que walmart/targer/home depot, vous disposerez d'un document générique pour toutes les succursales, puis de documents détaillés sur l'ensemble de la société concernant les interconnexions des bureaux principaux, avant de vous plonger dans les documents relatifs aux réseaux locaux des bureaux.

Approche de la documentation d'un réseau comme un développeur approche le développement d'un système...

• Considérez les exigences - cela a été bien noté ci-dessus, mais considérez QUI va consulter le doc-o et dans QUEL BUT. Les auditeurs rechercheront et liront des artefacts différents de ceux d'un administrateur système.

• La maintenance des documents - de nombreuses personnes ont mentionné la valeur des diagrammes et des cartes, et en tant que penseur visuel, je suis tout à fait d'accord. MAIS ces éléments peuvent être invalidés par le simple fait d'ajouter/supprimer un hôte. Réfléchissez au "bon niveau" de doc-o, celui que votre groupe peut réellement maintenir.

• Datez tout et incluez des notes expliquant pourquoi vous avez configuré le réseau de cette façon. Beaucoup, beaucoup de gens oublient d'inclure une date - mais la DATE fournit un pointeur dans l'histoire du réseau. C'est une aide précieuse pour la résolution de problèmes et cela permet d'atténuer l'obsolescence inhérente à la plupart des diagrammes de réseau.

• Déchargez la documentation dans des "processus" - souvent, des procédures de construction/déploiement solides et bien conçues finissent par rationaliser la "documentation réseau", car les détails de la configuration et du nommage des machines sont mieux décrits dans les procédures.

Principaux enseignements : abordez la documentation comme un "système" ; elle doit apporter une valeur ajoutée dès le premier jour et il y a une responsabilité inhérente à sa maintenance.

Sur notre site, nous utilisons plusieurs systèmes pour documenter nos propres réseaux et ceux de nos clients. Nous avons essayé et échoué avec un grand nombre de techniques/outils qui n'ont pas évolué, mais maintenant nous sommes bien installés avec ce qui suit :

• DokuWiki pour des conseils, des descriptions détaillées des configurations et des
• Tables (Patchport/MAC/IP/Hostname/Role/Admin-Lookup pour tous les appareils, Réseaux/VLANs/VPNs, Aperçu du matériel, etc)
• RSS pour diffuser les modifications des pages wiki
• Visio (la meilleure société que M$ ait jamais achetée...) pour dessiner des diagrammes de tout.
• KeePass pour les mots de passe, y compris les connexions aux systèmes de billetterie des fournisseurs.
• RackTables pour documenter l'endroit où les dispositifs sont situés et patchés
• Système de tickets, accessible aux clients
• WhatsUp Gold et autres outils de surveillance et de création de rapports.
• Listes de diffusion pour tenir les gens au courant

Si l'on a affaire à de nombreux réseaux IP, phpIP pourrait être une solution IPAM appropriée.

Pour plus de tutoriels sur comment/quoi documenter, il y a documentationréseau.com .

Pour de bons exemples, voir ratemynetworkdiagram.com . par exemple, celui-ci est assez bon et celui-ci est génial ;).