FAIBASE/10-misc and hostname

[George VerDuin]

Thanks Thomas.


On 03/13/2013 09:36 AM, Thomas Lange wrote:
>>>>>> On Tue, 12 Mar 2013 14:41:16 -0400, George VerDuin <gfv2008-home at yahoo.com> said:
>      >   * Is is safe to re-run fai-setup without re-installing from scratch?  Under what circumstances is it required to run
>      >     fai-setup again?  How do I reconcile a statements in existing documentation "Run fai-setup only once" and "after
>      >     ??? run fai-setup" (exact sources not remembered).
> Normally you run fai-setup once, and after that you run
> fai-make-nfsroot if you changed something in /etc/fai.
Now that I have been engaged in FAI for a short time, your answer makes 
perfect sense technically.  IMO it does presume that the first (only?) 
fai-setup was successful and a change to /etc/fai was for new user 
criteria.  Further, the answer may not go deep enough when fai-setup aborts.

But let's stop that thread and step back to review this transaction as 
it relates to documentation...

Here in the reflector we have gone thru a a partial Q&A exchange.  For 
those of us paying attention to the ebb and flow in mail it satisfies 
our needs.  For those absent from the conversation it presents a 
google-like challenge to find the same kernel of knowledge, while at the 
same time the source of the question has not changed.  Because the 
documentation has not changed, the potential of repeating the question 
remains.  Now consider the observation of others that FAI has a steep 
learning curve.  Steep?  True or false doesn't matter so much as does 
presentation.

My argument in favor of wiki as a tool centers on this exchange we just 
had.  If I had searched wiki for the exact source of my confusion and I 
developed a change you agreed satisfied my question, then all who follow 
us benefit from our work.  Less google. Better(?) document set.  Work to 
change happens mostly here on my IP not on your IP.  Perhaps not much 
different from a script change to fai-setup?  IMHO the approach 
describes a win-win.  And -- this does not work well for documents 
published like books...


>
>      > For my own part I will gladly contribute my success story soon
>      > as I find one.
> That would be very nice. We need more contributions for improving the documentation.
OK, but the untested part of my argument rests with the user community.  
If a user speaks bash and perl fluently, then fai-setup can be 
self-documenting and it is unfair to ask for duplicate knowledge in any 
other published document.  In fact, duplication is counter productive, 
and a negative score from a quality viewpoint. Under these conditions, 
nubies just need to understand the tools they need to bring to the table.

Cheers
Geo