Home > Networking Tips > Network Engineering > Network diagrams and documentation: Part 1
Networking Tips:
EMAIL THIS
 TIPS & NEWSLETTERS TOPICS 

NETWORK ENGINEERING

Network diagrams and documentation: Part 1


Tom Lancaster
04.12.2004
Rating: -4.21- (out of 5)


Digg This!    StumbleUpon Toolbar StumbleUpon    Bookmark with Delicious Del.icio.us   


In today's enterprise environment, documenting the network is absolutely critical. The de facto standard tool for documenting networks is Microsoft's Visio, although several free, open-source alternatives exist.

In my experience, the vast majority of Visio network diagrams suffer from two problems: lack of information (or cluttered info), and confusion between logical and physical aspects of the network. Besides general laziness, the main reason for the lack of information is that there is quite a lot of information about networks worth keeping and when the network is large or complex, it can be a real challenge to fit the information onto a page. In this tip and the next, I want to explain a great way to accomplish that.

The first secret is Visio's "custom properties". Each stencil and object has them, and you can view them by selecting the "View" menu and then "Custom Properties Window". That should bring up a little dialog box with fields and values in it. When you click an item in your drawing, it will show you the values for that particular object.

Visio's stencils have default properties that include the following fields:
Manufacturer
Product Number
Part Number
Product Description
Asset Number
Serial Number
Location
Building
Room
Department

I've found those properties to be almost entirely useless. Fortunately, they're called "custom properties" for a reason. Right-click in the Custom Properties Window, or on the stencil or object itself, and you can add, remove or change fields to something more useful. If you change the stencil, then all future objects you create with that stencil will have your changes. If you change the object's proper...


Digg This!    StumbleUpon Toolbar StumbleUpon    Bookmark with Delicious Del.icio.us   



RELATED CONTENT
Network Engineering
Desktop virtualization network requirements
Preventing hacker attacks with network behavior analysis IPS
Internal cloud computing on the cheap: Free automated provisioning?
Improved storage performance without adding more disk
Troubleshooting -- 'Network Know-How' Chapter 17
Windows Server 2008 IP routing configuration: Static and dynamic RIPv2
Understand Windows tracert output to troubleshoot network connectivity
Using tracert and TTL to troubleshoot network connectivity problems
10 Gigabit Ethernet interconnect solutions: Investigate carefully before choosing
Optimization of the data center with 10 Gigabit Ethernet

LANs (Local Area Networks)
3Com acquisition confirms HP-Cisco battle for China
Integrated wireless and wired LAN: Brocade-Motorola deal ups the ante
Enterprise passive optical networks: a spanning-tree LAN alternative
10 Gigabit Ethernet tutorial: Connecting data centers, storage, LAN and beyond
Intelligent edge switches: Complexity is driving a smarter LAN
Q&A: Jim Metzler previews the networking track at Interop
Extreme's port extender can replace consumer devices at network edge
VLANs versus IP subnets: Why use a VLAN over IP subnetting?
Troubleshooting VLANs: How to monitor 802.1q tagged traffic
Top 10 networking advice of 2008

Network Design
Desktop virtualization network challenges: A primer
No data cable? Wireless mesh networking the answer for Wi-Fi backhaul
802.11n upgrade: College ditches legacy network for new vendor
Dynamic policy ensures faster, safer network for school district
Network device management overload: Engineers managing too many boxes
Distributed network management means no more hard NOCs
Enterprise passive optical networks: a spanning-tree LAN alternative
How important are network infrastructure maps for engineers or admins?
New skills emerge for network engineering and administration careers
Cloud computing networks: Preparing for the future
Network Design Research

RELATED GLOSSARY TERMS
Terms from Whatis.com − the technology online dictionary
32-bit IP addressing  (SearchNetworking.com)
ARCNET  (SearchNetworking.com)
master  (SearchNetworking.com)
master/slave  (SearchNetworking.com)
Port Address Translation (PAT)  (SearchNetworking.com)
subnet  (SearchNetworking.com)
subnet mask  (SearchNetworking.com)
system administrator  (SearchNetworking.com)
Technical Office Protocol  (SearchNetworking.com)
virtual systems management  (SearchNetworking.com)

RELATED RESOURCES
2020software.com, trial software downloads for accounting software, ERP software, CRM software and business software systems
Search Bitpipe.com for the latest white papers and business webcasts
Whatis.com, the online computer dictionary


ties, it affects only that object.

If you use Visio often to create network diagrams, I recommend you create a set of stencils with your own properties. Cisco has created some beautiful stencils to represent various equipment, and I chose a stencil to represent a regular switch (e.g. Cat2948G), a regular router (e.g. 2600), a layer 3 switch (e.g. 3550), a chassis-based switch (e.g. 6509), etc. Then I gave it the following custom properties:

Hostname
Make
Model
Contact
Mgmt Address

I also created stencils for each type of link in my networks, with a different color and width representing technologies such as Token-ring, Ethernet, Fast Ethernet, Gigabit Ethernet, ATM, and various WAN circuits. For the links, I assign the following custom properties as appropriate:

Device 1
Port number
IP Address
Device 2
Port number
IP Address
Speed
Duplex
VLAN number
Trunk Type
Circuit ID
and a general Description field.

There are a number of advantages to using this system. First, I keep a lot of information but I don't have to use 6-point font to fit it on the page. Second, and this is very important... when I print the diagram, only the basic boxes and lines show up. All of the IP addresses and other sensitive information is hidden. This means that I can hang diagrams on my office walls, or give copies to managers, customers or vendors without violating common-sense security practices.


Tom Lancaster, CCIE# 8829 CNX# 1105, is a consultant with 15 years experience in the networking industry, and co-author of several books on networking, most recently, CCSPTM: Secure PIX and Secure VPN Study Guide published by Sybex.


Rate this Tip
To rate tips, you must be a member of SearchNetworking.com.
Register now to start rating these tips. Log in if you are already a member.


Submit a Tip




DISCLAIMER: Our Tips Exchange is a forum for you to share technical advice and expertise with your peers and to learn from other enterprise IT professionals. TechTarget provides the infrastructure to facilitate this sharing of information. However, we cannot guarantee the accuracy or validity of the material submitted. You agree that your use of the Ask The Expert services and your reliance on any questions, answers, information or other materials received through this Web site is at your own risk.



Networking Solutions for Business

Alcatel-Lucent Network Business Communications Solutions

About Us  |  Contact Us  |  For Advertisers  |  For Business Partners  |  Site Index  |  RSS
SEARCH 
TechTarget provides technology professionals with the information they need to perform their jobs - from developing strategy, to making cost-effective purchase decisions and managing their organizations' technology projects - with its network of technology-specific websites, events and online magazines.

TechTarget Corporate Web Site  |  Media Kits  |  Site Map




All Rights Reserved, Copyright 2000 - 2009, TechTarget | Read our Privacy Policy
  TechTarget - The IT Media ROI Experts