The tag has no wiki summary.

learn more… | top users | synonyms

51
votes
19answers
14k views

How do you document a network?

I'm not sure how to ask this question, since I'm not in the field. Say you're a network admin and you leave your job. How does the new guy know where to start?
21
votes
9answers
4k views

IT Documentation Platforms

We are a growing IT operation that continues to provide additional offerings and support to a variety of customers. As we continue to sustain this growth, we have found that we need to have easy ...
16
votes
6answers
2k views

What software is available to keep track of hundreds of servers?

What good software is available (free or not free) to help me keep track of information relating to hundreds of servers, their relationships to each other (parent/child, category, type), and ...
14
votes
9answers
972 views

Documentation As-A-Manual vs. Documentation As-A-Checklist

I've had discussions in the past with other people in my department about documentation, specifically, level-of-detail and requirements. In their view, documentation is a simple checklist of Y things ...
14
votes
4answers
1k views

IT Documentation with MediaWiki

We are looking for ways in which to further enhance our documentation and our ability to allow easy access to the information as well as editing the information. With these ideas in mind, we created ...
13
votes
6answers
1k views

Getting started with documentation

We haven't been doing any documentation at my workplace. I'm completely new to it and ask for some guidance getting started. I have a few questions: What are the essential documents that a ...
13
votes
6answers
550 views

Where can I document useful things to know as a Mac sysadmin?

I've recently done some research on the directory service tools on the Mac (dscl, dsimport, dsexport), and would like to be able to document them somewhere for all to benefit (and perhaps where my ...
12
votes
6answers
5k views

free tool for datacenter documentation [closed]

Is there any free tools out there that can help to better document at datacenter, for information like servers in a rack, the group port it is connected to and etc?
12
votes
6answers
331 views

Consulting: Organizing site/environment documentation for customers?

Over time, I've taken on consulting and contract engineering work for various clients. More recently, customers are asking for certain types of documentation. Which static IP addresses can I use ...
12
votes
5answers
11k views

How do you document windows server configurations?

I come from a Unix background where documenting the configuration of a service (email for example) could be as simple as grabbing a few text configuration files and a paragraph or 2 of explanatory ...
11
votes
4answers
842 views

Industry Standards for Network Infrastructure Labeling

Are there any current industry standards IEEE, ISO, ANSI.... available that state how a buildings physical infrastructure should be labeled at the rack and jack and how the documentation should be ...
10
votes
4answers
466 views

Legal IT documents

I have been wondering this past week because my big boss told me to start keeping track of all the things I have fixed, how to fix them, etc. Which is reasonable and have been doing anyway. But then ...
10
votes
2answers
6k views

Anything Close to an NSA Guide for Securing RHEL 6

Some in our infrastructure group want to upgrade to start taking advantage of the new features in RHEL 6. In the past, I have relied on the NSA Guide ...
9
votes
11answers
972 views

What metaphors have you used to convey complex technical terms to the layman or beginner?

As sysadmins, we are constantly forced to convey complex technical terms and situations to the layman or beginner. I was just wondering what metaphors each of you may have devised to describe things ...
9
votes
6answers
4k views

How to document linux server configuration?

I have about 20 linux servers which I need to document the configuration of. I do not mean the detailed configuration of services, but rather user accounts, databases, databases accounts, ip ...
8
votes
7answers
288 views

What level of documentation do you expect to be provided to you by developers?

Title says it all really. It can sometimes end up that development and IT are at loggerheads over this sort of thing. What level of documentation do you expect when you're expected to install, patch, ...
8
votes
4answers
5k views

What is important to document in an active directory server?

Later this year I will be handing over support of my church’s active directory servers to someone else and would like to know what kind of information is important to document and share. Are there any ...
7
votes
6answers
637 views

Documenting server details

This could be a very naive question for many of you, but I have problem in answering this one, your help will be deeply appreciated. I need to document the server on which I work, and it should ...
7
votes
3answers
265 views

How do you avoid that server documentation gets out of sync with the actual setup?

We have have reasonably good documentation for our environment (in AsciiDoc format) which recently allowed another person to recreate the entire setup from scratch in less than 30 minutes. However, I ...
7
votes
2answers
217 views

documenting a schools pcs and network (voluntary)

My daughter’s school have several networked pcs (various OS), printers, networked interactive white boards (connect to the internet, stream media etc). They have a parent who was looking after ...
7
votes
4answers
1k views

How do you document your Cisco configurations?

How do you document your Cisco configurations? How much / what kind of information do you include in the description field (connects to, circuit ID, device information, etc.)? Do you use any ...
7
votes
3answers
3k views

What are some great network diagram techniques?

Over a long time, the network I work with has grown from a couple of servers and a handful of client PCs to a gargantuan beast with the following things configured on the core switch: VLANs - ...
6
votes
5answers
6k views

What's the difference between a Disaster Recovery Plan and a Business Continuity Plan?

I used to think both terms referred to the exact same thing, but one of my clients just requested to have a look at both documents. The request emanates from the security department of a very big ...
6
votes
3answers
2k views

Where can I find introductory documentation for ZFS?

I recently installed OpenIndiana because of an interest in ZFS. I like the feature-list of ZFS, but I'm having a hard time wrapping my head around how to configure it. All of the documentation I ...
5
votes
1answer
236 views

Are there standards/conventions used by IT technical writers?

TL:DR? Fine...here: Short of hiring or outsourcing to a Tech Writer, are there basic standards/conventions/practices that Technical Writers employ in their trade that can be learned from in order to ...
5
votes
5answers
544 views

What's the best platform to publish documentation to internal users?

My team has a need to publish documentation internally. At the moment, it's spread all over the place and this means we often have to search everywhere to find something. We'd like to publish ...
5
votes
8answers
4k views

creating decision tree based troubleshooting documentation?

We troubleshoot a lot of server and network issues and follow a loose set of steps on what to do in different cases. With more and more people and responsibility, the need for standardization is ...
5
votes
3answers
349 views

Best solution to store client sysadmin information

I currently work at a small company that manages system administration tasks for a variety of clients. We do our work mostly remotely and we are encountering that the data to all our clients system's ...
5
votes
1answer
159 views

Linux I/O buffering reference

Can someone point me to a fairly complete reference on the Linux I/O system, primarily how all the buffers and caches are handled and flushed? My understanding so far is that there are Application ...
4
votes
3answers
89 views

IP address range for examples in documentations

Is there an IP address range dedicated to example in documentations ? (Like example.com for DNS)
4
votes
2answers
8k views

Dell fumbles OpenManage installation process, forgets to write documentation?

I'm setting up a Dell PowerEdge 2950 for a small business, and I've just spent a while with Dell OpenManage Server Administrator 6.2, trying to clear the installation process of errors before I ...
4
votes
2answers
239 views

Sharing responsibilities within a SysAdmin team

I used to work in a small System Administration team that consisted of 3 members. We each had our own area: E-mail Server build and monitoring File sharing I am not sure if this is typical but it ...
4
votes
3answers
414 views

Documenting Job Schedules?

Once upon a time, I thought I found the perfect way to document all scheduled jobs across all servers. I used Google Calendar and created a cal for each server and then added all the jobs as scheduled ...
4
votes
1answer
844 views

server handover document template - users, security settings (firewall,selinux), packages etc

As part of the handover of our linux application server automated builds I would like to produce a high level "handover document" which captures the key functions and config items. (This is more of a ...
4
votes
1answer
253 views

Documenting servers [closed]

I work for a relatively small software development firm that grew pretty quickly over the last few years. This hoewever caused a lot of growing pains, especially infrastructure-wise. It is currently a ...
3
votes
11answers
1k views

What do i use to hold the server documentation?

I had to document the servers i use and i don't know what to use to hold the data. Could you sugest the best way to keep the server documentation? Do i create a data base that holds the harware and ...
3
votes
4answers
364 views

What's new in Puppet since 2007?

I've got a copy of the Pulling Strings with Puppet book (written in 2007) but given that it has a bunch of equivocal language, I'm wonder how much has changed since then? I've found this Release Notes ...
3
votes
7answers
212 views

tutorial/training creation tools

I've used Wink to create Flash tutorials for employees on setting up and using various programs. It's a nice tool, but sometimes I wish I had more options. Have you used a tool or tools to do this ...
3
votes
1answer
323 views

Powershell and NMAP Information Sharing

I am working on a project where I would like to perform host documentation for a variety of items. Part of these items would be sourced from Powershell and the rest would be sourced from NMAP. For ...
3
votes
3answers
434 views

Documenting port numbers on floor plan

I want to be able to create a simple floor plan and document where all the ports are located and what there number is. Is there any good software to help with this. Preferably open source / free.
3
votes
2answers
1k views

Migrating from MyISAM to XtraDB

Just a few questions that I just can't find anywhere about migrating to XtraDB. My group has been using MyISAM dbs for production and was wondering how hard is it to migrate to Percona's XtraDB and ...
3
votes
4answers
4k views

Cisco 48 port switch template diagram

We have just taken delivery of a 'mature' 48 port switch for testing, deployment and general skulduggery. Since we are going to be constantly mucking around with the patching we need a diagram so we ...
3
votes
2answers
88 views

Documentation for native modules in IIS 7.x

I've been working for some time at a super lean IIS 7.5 configuration for a static file serving purposes web site. To achieve this, I've simply stripped the designated web site for all dynamic ...
3
votes
2answers
810 views

Is there reference documentation for CloudInit?

Ubuntu's CloudInit package is very useful; however, the only documentation I've found on all of the available options is in their examples: ...
3
votes
2answers
188 views

Documenting Client Infrastructure [closed]

Working on a new project, and need some documentation advice. I need to be able to document ~ 400 client sites to track assets, setup, hardware layout, network layout, etc. We want to have photos, ...
3
votes
4answers
231 views

Which is the best way to keep up all your documentation? [closed]

I hope I'm not bothering anybody with this question. I have my technical documentation scattered using different methods, here is a list of the most used: notebook I have several notebooks full of ...
3
votes
1answer
50 views

Documenting a lab environment [closed]

I've been tasked with setting up and managing a brand new lab environment, consisting of lots of machines in different roles. There's a VM host, several web servers, several database servers, and ...
3
votes
4answers
519 views

Free web-based software for team collaboration/documentation [closed]

Looking for some advice here, as my search has turned up to be pretty fruitless. My group (9 people - SAs, programmers, and two network guys) is looking for some sort of web tool to... ahem... ...
3
votes
4answers
111 views

How do you write a Linux deployment documentation / plans?

I have few, relatively small, servers running Linux distros. Sometimes I need to re-install 1 or 2 of the "development" servers from scratch. Often I just forget to setup little things, eg. forwarding ...
3
votes
1answer
347 views

What are we supposed to document of our server infrastructure?

It's very important to have decent and good documentation. The problem is that often we might have good documenting techniques, but we forget some crucial points. It can be extremely painful to find ...