The first thing we've got to do in order to document our
network is to create a network baseline. After all, if we don't know our
goals, we can't accomplish them. A baseline is really a "network
snapshot", a picture of our network devices and their performance
- which also helps us spot issues before they happen.
Every network has its "breaking point", the point at which it
can no longer transfer data effectively. By creating a baseline, you can
see what the current network load is now - and by maintaining that baseline,
you can spot network issues well before they become critical. For example,
say you baseline all your network routers, and part of that is noting
the CPU capability and usage. By maintaining the network baseline, you
can note smaller, gradual increases in CPU usage and do something about
it before the situation becomes critical.
Establishing a baseline also gives less-experienced network personnel
a starting point for troubleshooting, and it gives new network support
personnel a starting point as well.
To begin that task, we've got to define where this baseline will begin
and end - in other words, we must define the scope of the baseline. Some
questions to ask:
What is the scope of this baseline?
What goals do we have for our network?
What network devices will be part of this baseline?
What is the objective here? Why are we creating this baseline?
Baseline construction methods differ from one vendor to another, but I
recommend the first thing you do when creating a baseline is taking inventory.
Why? First, it's hard to create a full network picture if you don't know
everything that's in your network; second, many networks are poorly inventoried.
When you're creating network documentation, consistency is vital. This
goes for abbreviations, symbols, and icons. There are sets of Cisco icons
for use in Microsoft Visio - find and use these icons when documenting
and diagramming your network. Keep your usage of these icons consistent
as well.
Decide upon your scope and your goals, and stick with that decision. Don't
start documenting one part of the network and then jump to another part.
Also, don't hide the documentation! If I have to substitute for you at
a client site, I should be able to find the documentation without asking
anyone.
Most importantly, maintain the documentation. Nothing is worse than seeing
a date at the top of a network baseline doc that's from last year. (Or
the last century.) Don't fall into the trap of "I'll catch the documentation
up next week", because I can practically guarantee that no matter
how great your work ethic is, something's going to happen that will distract
you from getting the documentation done. Do it now.
In short, when creating network documentation, follow these rules:
Define the scope of the documentation and stick to it.
Define your objective and the values to be documented.
Consistency is key. Keep abbreviations and terminology consistent from
document to document.
Make sure the appropriate personnel have access to the documentation.
Keep the documentation current.
Your client will thank you, and those that follow you will thank you as
well!
|