The tag has no wiki summary.

learn more… | top users | synonyms

0
votes
1answer
1k views

How does samba usershare_acl parameter works?

Looks like it is not even documented on the samba website itself, or did I miss it?
16
votes
9answers
995 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 ...
15
votes
5answers
4k views

How do I write man pages? [closed]

How do I write a man page? Where can I find a reference of all formatting codes? Are there any good tutorials on writing man pages? What is the most convenient way to write a man page? Should I ...
-1
votes
1answer
45 views

Hardware asset documentation and tracking [closed]

In my company we have a couple dozen servers in different locations, many LAN switches and a couple SAN switches we work with. Up until now the LAN architecture, port map, the location of each machine ...
2
votes
2answers
261 views

Looking for good documentation of odbc.ini and odbcinst.ini files on Linux

I saw partial information, old information, but nothing as good as the actual sample files with brief comments that I have locally. I need to understand the exact relationship between odbc.ini and ...
0
votes
1answer
731 views

PAM Errors in auth.log [Debian Squeeze]

Based on the the Securing Debian article on debian.org, I added the following to /etc/pam.d/other. auth required pam_securetty.so auth required pam_unix_auth.so auth required ...
1
vote
3answers
249 views

Powershell 2: How to eliminate duplicate help entries?

I am frequently making calls such as: get-help <some-command> in Powershell 2. For many, but not all, of these commands, I am not shown the contents of the help entry. Instead, I get ...
3
votes
11answers
2k 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 ...
51
votes
19answers
15k 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?
2
votes
1answer
55 views

Need advice on documenting LAMP web site

I need to document my web site. It is a music web site on Linux/Apache/MySQL/PHP on AWS. I need to document everything: architecture (5 servers), database (100+ tables), php classes, programming ...
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 - ...
3
votes
1answer
64 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 ...
2
votes
2answers
91 views

I have hard the term “swimlane” used but don't fully understand it [closed]

I have heard the term swimlane used in the context of group of servers. It can be a rack that houses all the parts of a particular application. Everything from database to load balances. Or maybe for ...
0
votes
2answers
142 views

Any good template to write down server access details? [closed]

I wonder how other fellow sysadmin, web developers manage their inventories. I usually write down all access details in text files, not following any practice or convention. Can someone tell me, if ...
1
vote
1answer
298 views

Configuring mod_security on Ubuntu 10.04

After spending ~24 hours trying and failing to setup mod_security in Ubuntu 10.04 LTS, I've finally decided that I'm going to need some help. I've tried pretty much every tutorial I can find with a ...
2
votes
1answer
50 views

centos yum repository package security information.. how do i find it?

Is there anywhere that shows which security updates are included in the patch levels for centos yum repository package version of httpd?
3
votes
4answers
135 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 ...
12
votes
6answers
359 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 ...
0
votes
1answer
38 views

Can I get a clear summary of how and when each part of a chef cookbook is loaded/executed?

Here's what a chef cookbook looks like: . ├── attributes │   ├── default.rb │   └── bla.rb ├── files │   ├── default │   │   └── some_file.txt │   └── windows │      └── some_file.txt ├── libraries ...
1
vote
0answers
45 views

HAProxy listen with two arguments?

I keep seeing HAProxy configuration examples with a two-argument syntax. Indeed, the default configuration file supplied with 1.4.18 contains this: listen appli1-rewrite 0.0.0.0:10001 cookie ...
0
votes
2answers
78 views

Copying files from one machine to another

I'm currently generating documentation on one machine, and publishing it to a web server using the following commands in a script: net use "\\someShare" PASSWORD /user:username del /S /Q ...
5
votes
1answer
289 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 ...
3
votes
2answers
117 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 ...
-1
votes
1answer
33 views

Can't Find Documentation for HTTPd Directory Directive

I've been searching through the httpd docs and google, and I simply cannot find ANYWHERE that documents the complete list of what may go inside of the Directory directive. Here's the main ...
1
vote
0answers
87 views

Infrastructure Wiki Documentation Diagram?

I am in the process of designing a documentation Wiki for Infrastructure. That is, the whole gamut of servers, networks, storage, and applications. I have been poking around with some ideas via ...
12
votes
2answers
7k 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 ...
3
votes
2answers
978 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: ...
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 ...
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 ...
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 ...
2
votes
1answer
1k views

Text template or tool for documentation of computer configurations [closed]

I regularly write and update technical documentation which will be used to set up a new virtual machine, or to have a lookup for system dependencies in networks with around 20-50 (server-side) ...
-2
votes
2answers
66 views

MS-SQL Server security document [closed]

I have to build sql- server security architecture doc based on our existing PROD server, what all it takes to build a doc from scratch. Is there any good website for the template for the doc?
-2
votes
1answer
65 views

Canonical way to describe server purpose [closed]

Is there a canonical way (no pun intended) to describe the purpose of a specific machine? I have to administer serveral hosts all with the same hostname ("www"). On the shell prompt i can not ...
2
votes
1answer
331 views

Racktables and DHCP

For those of you out there using Racktables, how do you handle DHCP scopes? I haven't been able to find a way to show the IP addresses as allocated.
7
votes
3answers
271 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 ...
4
votes
1answer
304 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 ...
1
vote
1answer
532 views

Standards for documenting/designing infrastructure

We have a moderately complex solution for which we need to construct a production environment. There are around a dozen components (and here I'm using a definition of "component" which means "can ...
4
votes
2answers
10k 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 ...
3
votes
1answer
424 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 ...
3
votes
2answers
212 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, ...
0
votes
4answers
669 views

Corporate Wiki Organization - Technical Documentation

Corporations have documents describing various aspects of their technical systems, including: Custom Applications Custom Development Frameworks Third Party Applications Accounting Bug Tracking ...
0
votes
3answers
547 views

Server (location, MAC, IP) documentation with Google Docs

I work for a shop with 300+ physcial servers and about the same number of VM guests. We use Puppet heavily and are mostly Centos5.5 and about 20% Centos6.2. We use Google docs for storing various ...
8
votes
4answers
6k 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 ...
5
votes
5answers
599 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 ...
3
votes
1answer
410 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 ...
0
votes
1answer
125 views

visually documenting web server configuration and infrastructure

I have just finished a large re-organization and update of our institutions web server(s). This server hosts 3 virtual hosts, 3-4 blogs, 2 wikis, some legacy static HTML pages, and many hosted ...
10
votes
4answers
475 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 ...
6
votes
3answers
3k 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 ...
10
votes
6answers
5k 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 ...
0
votes
1answer
238 views

ApplicationXtender?

Where can I find free technical documentation on EMC Application EXtender? This is a distributed system for "Storage, Organization, and Management of Business-Critical Information". The IT team where ...