Network documentation is one of those things that people struggle to accurately label and describe. In the same way that art is in the eye of the beholder, so too is network documentation.
In fact, the need for proper network documentation can bring out the artist in all of us. Engineers tend to get creative under budget restraints, and just as there are as many ways to tackle a problem as there are people in the world there almost as many different network documentation processes and solutions. There is, however, one common element: end-result satisfaction is rare.
Similar to DCIM, ask ten different people to define network documentation and you will end up with at least ten different answers (more like 15 or 20 answers). One effective way to define something is to eliminate things from its definition. To define network documentation, let’s weed out what it’s not.
Let’s back up a bit before we start eliminating. Here’s a look at a basic wish list for network documentation (this will probably vary a little depending on your unique needs):
So, above is my wish list for the “what”. It’s not JUST about the what, however. It’s also about the HOW: how the data is gathered, how it is accessed and how useful it ultimately is.
So, now that we’ve covered what is needed and how, we’ve got to bring out the bad news (sorry)…
That monitoring/NMS tool? That is NOT network documentation.
We’ve heard it time and time again…”well, to document the network we actually use our network monitoring tool.” If that’s what you’re using, here’s the bad news:
You are out of your element.
Using your NMS as your primary network documentation system means your diagrams will be sorely lacking. Monitoring tools, after all, can only include what they can discover. You’re missing devices from other vendors, non-discoverable objects, cabling, racks, patch panels, industrial equipment and much more. Further, your NMS tool is not accessible for all of your stakeholders, it’s not easy to use and doesn’t offer much of a physical depiction of your assets.
It’s here that the real creativity in engineers starts to shine. I bet you’ve created some amazing stuff suing a Wiki. Collaborative efforts via SharePoint and Google Drive can be downright inspiring. THere are some amazingly detailed diagrams on AutoCad. Problem, though? You’re no Tatsuo.
Who is Tatsuo? A Japanese artist who turns spreadsheets into masterpieces. It’s breathtaking and completely out-of-the-box art. That being said, most of us lack the talent and time to create something like this. Further, documenting networks isn’t done for the love of it – it’s done out of necessity.
If I had just a penny for every time I’ve heard, “But I can already do such and such task using a strange workaround”….I might not be rich but I could probably afford that Ferrari I’ve been eyeing for 20 years. I mean: I’ve heard of a guy using the recycling bin as his file storage system. You’ve probably heard about folks using their CD-ROM drives as coffee holders. It’s human nature to invent workarounds or strange habits and nerds aren’t immune. I once knew a programmer who absolutely wouldn’t use an IDE: he insisted on writing all of his code in notepad. Point? Just because you CAN do something doesn’t mean you SHOULD.
So, if your network is very small – I fully understand. Maybe a spreadsheet or a Wiki really is adequate. Those unsightly columns and rows may just be all that you really need. If you must keep up with the day-in and day-out changes to a 100+ object corporate network, however, automated network documentation is key to your success.
The philosophy that ‘monitoring is documentation’ brings in the automation but misses some key players such as diagrams, configuration items and other features. With the group of varied tools we went through above in Bill & Ted’s (not so) Awesome Adventure, you do get flexibility but you end up with a collection of products designed for something very different and no real automation to speak of.
Bottomline here? While we applaud your bootstrapping and creativity, get yourself a real network documentation system and leave Google Docs in the dust.