M
M
m2_viktor2015-06-19 08:57:18
Documentation
m2_viktor, 2015-06-19 08:57:18

Where should a system administrator store documentation and server configs, as well as his own observations and thoughts?

Hello. Sysadmins, where do you keep documentation on setting up servers? And do you store the sequence of actions when setting up your servers, configs and personal observations?
update: I myself keep configs and documentation in text files, passwords in keepass2 and plus btsync sync to read it on all my devices.

Answer the question

In order to leave comments, you need to log in

13 answer(s)
E
Edward Tibet, 2015-09-14
@m2_viktor

I will answer according to the documentation...
1. Format.
It is better for you to do this in plain text, because even being in the console, you can always read them.
Formats: any of .md, .rst, asciidoc (because it is possible to render them in pretty format) inside various systems.
2. Storage
The storage method is SCM only (which one: git, svn, hg or older - I don't know what you are using). Let me explain why not the file system:
- it is important for you to know the state of your equipment at a certain moment. Those. you can always look at the configuration that was current a month or two ago and identify problems.
- you can always diff and see the changes. Often, this should be done not just now, but "suddenly" :)
I STRONGLY DO NOT recommend using atlassian confluence, as they say above, for your tasks. Reason:
- you are tied to a vendor (even for 10 bucks for a min. license). If you drop the vendor you will NOT be able to get it - just copy/paste or buy plugins for hundreds of bucks.
- Atlassian's markup is hard-coded into the software. You can't upload wiki markup there (except when buying hundreds of bucks plugins like scroll)
- and best of all, you can't view text in the console!
3. Visualization
It all depends on the amount of time you are willing to spend. I know there are md rendering solutions for a normal wiki. Here you better google the best option for the previous two points.

V
Valentine, 2015-06-19
@vvpoloskin

I actively use Onenote now, it's convenient.
When I worked with Linux, I stored it in text files in md-format, I kept my blog.

K
kale, 2015-06-19
@kale

I use Zim desktop - wiki application, very convenient.
Alternatively, BitBucket is a personal storage..

I
Ivan, 2015-06-19
@LiguidCool

Paper will endure everything :)
In general, Google Keep.

D
Disen, 2015-06-19
@Disen

tekstovichki-blogiki-sveenochki, no? :)

K
Konkase, 2015-06-19
@Konkase

private git

A
athacker, 2015-06-19
@athacker

Passwords - in KeePass, the database of which is stored on the TrueCrypt cryptocontainer :-)
Configs - in Subversion.
Notes and more - in a cozy blog: at-hacker.in

P
Puma Thailand, 2015-06-19
@opium

wiki
ansible

V
Vladimir, 2015-06-20
@MechanID

Passwords Keepas
configs txt and attach to the wiki
thoughts / docs - wiki
All this must be backed up somewhere remotely to the cloud or to a server / vps somewhere so that there are always 2+ instances in total.

T
Thomas Storm, 2015-06-20
@v_sadist

atlassian confluence
cvs
one note

R
Rad1us, 2015-06-21
@rad1us

All configs, instructions, and so on, except for passwords, I store in a tree-like (very convenient for an IT-person) CherryTree editor.

Y
yukpun, 2015-06-25
@LeganSV

Passwords - Safe-In-Cloud
Configs, entries, other - Evernote
Tasks - Wunderlist ( Toodledo as an option)
Quick Notes - Google Keep

A
anatolii_krasnov, 2015-06-25
@anatolii_krasnov

Passwords in a text file - in an encrypted archive in the cloud
Notes - and tasks - todist (android + web) sycamore version very much good 1200 per year

Didn't find what you were looking for?

Ask your question

Ask a Question

731 491 924 answers to any question