Solved

IT documentation (network, servers, switches...)

Posted on 2013-01-28
8
362 Views
Last Modified: 2013-10-05
Dear EE community,

company I work for does not an adequate (read: almost non at all) IT enviroment documentation.

That means from network infrastructure to server, services, mail, dns etc. configuration, switches, routers etc.

I have made visual representation of network and network related services in Visio but I am stuck at producing good documentation.

Can you help me with templates or examples for documenting existing IT infrastructure such as:

Network (IP addressing, DHCP, DNS, Switches, Routers...)
Servers (Mail, DNS, DC, Virtual hosts etc...)
Security policies
Administrative information
Backup information

Most of infrastructure is based on Microsoft products (2008 AD, Hyper-V, DNS, DHCP...)

This is my first post/question here so please forgive me if I have not provided enough information or my question is not as clear as it should be. :)

Thank you in advance!
0
Comment
Question by:Divided
[X]
Welcome to Experts Exchange

Add your voice to the tech community where 5M+ people just like you are talking about what matters.

  • Help others & share knowledge
  • Earn cash & points
  • Learn & ask questions
8 Comments
 
LVL 37

Expert Comment

by:ArneLovius
ID: 38829251
Start by picking one part of it and writing it out in long form, then  do another etc, when you have completed this, go back to the first one and start editing, always remember that everything should be explicit.

Writing out how it all works should lead you into standardizing, not just how you write, but how services and applications run inside the network.

I tend to use Wikis for documentation as links to other documents are simpler than with word documents or text files, but I would start with just text.

List of servers
What each services each server has AD, DNS, DHCP, WSUS, File, Fax etc
Descriptions of how each service is configured
List of network equipment
Copies of their configs
How things are backed up
Where they are backed up to
How to restore

I also try to include "why" as in why something does something a specific way, why this decision was made, "I inherited like aaa, I tried changing it to bbb but it broke ccc, ddd and eee so it was reverted back to aaa".

Good documentation lives, it should be updated and corrected continuously.
0
 
LVL 43

Assisted Solution

by:Steve Knight
Steve Knight earned 250 total points
ID: 38829345
I like good documentation and work for several clients with good systems in place, Notes databases of work instructions, knowledge bases, wiki's etc. amongst others and well defined AD (Ok much of which is from me having a hand in setting it up[ many years ago!).

Bet you've got more documentation than a customer I recently inherited helping with their IT support -- I was amazed ... multiple servers and no domain, well actually there IS a domain controller but it isn't used as one, i guess tried and failed for some reason, some machines are domain members but don't have dns etc. to internal servers set so can't see dc anyway.  

The network "can't work" in that devices on same physical LAN but with different subnets need to communicate with each other without any router between the subnets... and actually works, most of the time.  One of those subnets is the other end of a leased line, 3 different internet connections at one site, multi-homed servers with links to different customers over VPN's off second cards etc.

Most recent "find" was main file server has 2003 Terminal server configured with 5 per-device licenses so my inadvertent RDP connections to the server to configure something while on a couple of user workstations suddenly took up the licenses (wrongly assumed it was in remote-admin only mode).

Anyway my point here is I have had to feel around for several months so far finding things out and still find things every time I go there.  I had... a list of (some) of the IP addresses, a list of usernames and their passwords (as there is no domain they are kept the same for different servers and workstations so users get allocated one and keep it..).  This info has been invaluable but is all I had.

So even the slightest amount of information is good.  Lists, anything.  In that case as I do for all my customers I keep the info. given and add to it in my databases as things are found out or needed.  There isn't really any templates I can share as each customer need / site is different frankly.

Perhaps obvious stuff that seems to be missed all too often:

Software.  Make sure at least one cd/dvd of each product catalogued along with database / excel / text list of license keys and who has each

Server software & licenses. Same as above.  You can have all the config. details for apps on there etc. and backups but when the discs are fried and you need to get it back up and running with no server discs or license keys to be found it gets interesting.

Anti-virus - config, indidivual, server pushed, updates come from local, internet etc.

Network. Make a list of all available IP's, mark off DHCP ones, reserved DHCP entries (+ their mac addresses + who/what), and record what /where Printers, network switches, routers, scanners, building access, cctv etc.  

DNS / DHCP / AD / VPN / CA etc.

Start with new stuff as it needs doing write it down then go back and fill in the blanks.

For a network upto 100 or so a series of text files or excel sheets on shared drive is probably adequate, for more than that databases, wiki, sharepoint site etc. might be more appropriate.

Anyway I waffle on, good luck with it!

Steve
0
 
LVL 81

Expert Comment

by:David Johnson, CD, MVP
ID: 38829835
spiceworks http://www.spiceworks.com has a nice network enumerator and tools for the network admin (all free)
0
Best Practices: Disaster Recovery Testing

Besides backup, any IT division should have a disaster recovery plan. You will find a few tips below relating to the development of such a plan and to what issues one should pay special attention in the course of backup planning.

 
LVL 51

Accepted Solution

by:
Keith Alabaster earned 250 total points
ID: 38829927
PLEASE - before you start, ask yourself (or your Managers) WHY do you want all of the documentation? What are you going to do with it once you have it? How are you going to maintain it once it gets completed?

What level of detail is REALLY required to be documented?

Whilst this sounds like a sales sort of statement, it is rather important to decide before you begin. Too much detail and it becomes useless as it is too difficult to maintain. Too high a level of detail and it does not articulate the information in a way that makes it meaningful to a variety of readers; and let's face it...documentation that no-one will read is a waste of time.

What is the purpose here? Is this for an audit or just for your own/internal use?

I tend to use the MS MAP kits to capture information when I am preparing for a significant change: http://technet.microsoft.com/en-us/solutionaccelerators/bb819696

If I want to build a supportable 'library' though of artefacts against which I can query my environment for things such as application portfolio, business capabilities, IT consumed by business group, lifecycle management, then I use an Enterprise Architect tool such as Troux but this may be overkill for you.

If you can advise on what level of detail you need and the purpose to which you will put the info documented then we can maybe suggest something more specific for you.

Keith
0
 
LVL 11

Expert Comment

by:hecgomrec
ID: 38833141
Sorry but this seems to me more like a homework..
0
 
LVL 22

Expert Comment

by:eeRoot
ID: 38833725
A handy category to add is the "system overview."  This is a relatively undefined category that starts as a Word doc that describes your environment's unique or proprietary systems with spreadsheets, screenshots, important config files, Visio diagrams, etc, attached to the Word doc for reference.  Word's ability to store/embed other files is in a doc file is very handy when doing documentation.

Also, be sure to document passwords in both onsite and offsite locations, with a monthly update schedule for both, if possible.
0
 
LVL 11

Expert Comment

by:sparab
ID: 39549005
This question has been classified as abandoned and is closed as part of the Cleanup Program. See the recommendation for more details.
0

Featured Post

Do you have a plan for Continuity?

It's inevitable. People leave organizations creating a gap in your service. That's where Percona comes in.

See how Pepper.com relies on Percona to:
-Manage their database
-Guarantee data safety and protection
-Provide database expertise that is available for any situation

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

How many times a day do you open, acknowledge, or close an IT incident? What’s your process? Do you have a process depending on the incident, systems involved, and other factors? New Relic Alerts gives you options for how you interact with notifica…
Gain an elementary understanding of Blockchain technology.
In this tutorial you'll learn about bandwidth monitoring with flows and packet sniffing with our network monitoring solution PRTG Network Monitor (https://www.paessler.com/prtg). If you're interested in additional methods for monitoring bandwidt…
Monitoring a network: why having a policy is the best policy? Michael Kulchisky, MCSE, MCSA, MCP, VTSP, VSP, CCSP outlines the enormous benefits of having a policy-based approach when monitoring medium and large networks. Software utilized in this v…

724 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question