Network documentation

Example of a basic network diagram

Network documentation is a form of technical documentation, the goal of which is to maintain computer networks.[1] It contains information about how the network is built, how it should perform, and where to troubleshoot problems. The purpose of network documentation is to keep networks running as smoothly as possible while minimizing downtime when repairs are necessary.[1]

Parts

Essential parts of network documentation include:[1]

  • Map of the entire network, including hardware locations for servers and network equipment and cabling details[2]
  • Metadata on the individual servers
  • Schedules and locations of backups
  • Metadata on installed software, including version numbers, installation dates, licensing details, and support information
  • Vendor and contractor information
  • Service agreements
  • Detailed record of problems, solutions, procedures, and results

Network documentations could contain charts, tables, diagrams, and even memory aids that help administrators locate information faster.[3]

Documentation tools

Though network documentation can be done by hand, large organizations must use network documentation software, including diagramming tools, inventory management, and circuit and cable traces. Examples include draw.io, Graphical Networks' netTerrain,[4] Microsoft Visio,[5] Docusnap, Gliffy,[6] Opnet's Netmapper, and XIA Configuration.[7]

References

  1. ^ a b c "Lesson 1: Documenting a Running Network". Knowledge Systems Institute. Archived from the original on 1 December 2016.
  2. ^ "Network Documentation Best Practices: What's Important & How to Track It - Packet Pushers".
  3. ^ "Evolution of Network Documentation - Packet Pushers".
  4. ^ "Network Documentation Software | DCIM, Network Documentation, OSP Software".
  5. ^ "Create a basic network diagram - Visio". Microsoft. Archived from the original on 17 April 2018. Retrieved 17 April 2018.
  6. ^ "UML Diagram Tool | How to Make UML Diagrams Online | Gliffy". Gliffy. Archived from the original on 17 April 2018. Retrieved 17 April 2018.
  7. ^ "XIA Configuration Network Documentation Tool". Retrieved 27 September 2017.