How do you do....it? Thread, Documentation in Technical; Hi,
Does anyone know and this may be a big ask because I don't know of anything like this that ...
10th March 2014, 12:33 PM #1
Does anyone know and this may be a big ask because I don't know of anything like this that exists... Is there a way to generate Documentation based on Linux Config files ?
For example: if I built a web server based on CentOS, I could download the config files from the server and Import them to something web based perhaps, from there generate something like a web page with a Contents, Index and Search. Then A new starter technician or apprentice could build a web server and the documentation is based around the config files, the files could even be viewed on page too ?
I'm hoping this makes sense!
Anyone know of anything ?
10th March 2014, 12:36 PM #2
I don't think that'd necessarily help...it'd tell you how a box is configured, but not WHY it's configured like that.
I also think there's way to many package/config options for anything like that to be viable, but someone else may be able to prove me wrong...
10th March 2014, 12:40 PM #3
Yeah, its because some of our servers are setup in certain ways, and our documentation can be a nightmare, the main one is some of our public servers are setup in such a way that they have to adhere to certain standards due to the data we hold. I was thinking of a sort of way I can document how we build our servers and why they are built like that, from config files something I can generate from config or export config files too.
10th March 2014, 12:47 PM #4
Blueprint (Blueprint) will let you capture an existing server and use it as a template. You can also dump info from the template. I've used it in the past to port odd server configs onto newer hardware.
You could also (by comparing against the packaged versions) determine which config files have been altered from the default.
However, both methods lack the "Why" component - your documentation needs to say (at least briefly) why something is configured a particular way, especially for a noob technician, so you don't end up with a cargo cult mentality.
Does Spacewalk (which IIRC you were posting on here about?) allow you to create a webserver template down to the level of "this file should contain $foo"?
TLDR: It's better to automagically tell the server "you should be like this" when deploying it and document what config you're pushing and why.
*realises he's left the tab open too long*
Thanks to pete from:
cpjitservices (10th March 2014)
10th March 2014, 12:52 PM #5
Blueprint sounds just the ticket, I was using a web server as an example, as we have a wide variety of Linux servers doing different things.
I'll check it out, see what Blueprint does. I don't need the rollback / track functionality but should still do the job.
By russdev in forum School ICT Policies
Last Post: 20th March 2006, 12:29 PM
By tosca925 in forum Windows
Last Post: 17th January 2006, 06:13 PM
By mseaney in forum Windows
Last Post: 9th January 2006, 08:43 PM
By eejit in forum Windows
Last Post: 5th December 2005, 02:03 PM
By mattpant in forum Windows
Last Post: 7th October 2005, 07:12 PM
Users Browsing this Thread
There are currently 1 users browsing this thread. (0 members and 1 guests)