Main Page: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
(add link to FAI CD)
(45 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Hello and welcome to the FAI wiki.
Hello and welcome to the FAI wiki.


This is a public wiki for [http://www.informatik.uni-koeln.de/fai/ FAI - Fully Automatic Installation] - a tool for automatic installation of Debian and other Linux Distributions.
This is a public wiki for [http://fai-project.org FAI - Fully Automatic Installation].
It's a place for users and developers of FAI to share information. If you have some information on FAI to share, see the page [[wiki registration]] - you need to write a mail, because we can't handle the spam otherwise. Also, please read [[editing rules]].
It is a place for users and developers of FAI to share information. If you have some information on FAI to share, please register [[wiki registration]]. Also, please read [[editing rules]].


== getting FAI ==
= About FAI =  
if you want the latest and greatest version(instead of the versions contained in Debian apt repositores for the specific version of the distribution):
* download it from: http://www.informatik.uni-koeln.de/fai/download/
* add this to your /etc/apt/sources.list, as well as /etc/fai/apt/sources.list(to get the correct fai-nfsroot package into the nfsroot) - depending on which flavor you want:
<pre>
deb http://www.informatik.uni-koeln.de/fai/download sarge koeln
deb http://www.informatik.uni-koeln.de/fai/download etch koeln
deb http://www.informatik.uni-koeln.de/fai/download developers koeln
</pre>
* install it within debian sid
* check out the sources from subversion:
<pre>svn co svn://svn.debian.org/svn/fai/trunk fai-sources</pre>
(will require building the package by entering the directory and do something like "dpkg-buildpackage -rfakeroot")


== documentation and examples ==
FAI is a tool for fully automatic (unless you explicitly wish to get some questions on each install) installation of Debian and other Linux Distributions via network, custom install cd, or into a chroot environment. Some people also use it to install Windows.
* Main documentation for FAI is the fai guide - it's available in multipl languages:
 
** [http://www.informatik.uni-koeln.de/fai/fai-guide.html/ english]
FAI works script-based as opposed to full image based (if you wish so, we can also install any kind of image) - so it is very flexible, and can be used to install very heterogeneous infrastructures. It uses a class-based system (think of classes as system types that can be combined with each other, as long as they are not technically conflicting) to define configurations in some simple textfiles.
** [http://www.informatik.uni-koeln.de/fai/fai-guide-fr/ french]
 
** [http://pc.debian.ro/fai/ romanian]
It is also used to update running systems without completely reinstalling them with the softupdate functionality - so you have one single point of configuration for installation and updates.
** Search it via [http://www.google.com/advanced_search?as_sitesearch=http://www.informatik.uni-koeln.de/fai/fai-guide/ link google sitesearch ]
 
* [http://www.informatik.uni-koeln.de/fai/ FAI Homepage]
= Getting FAI =
* [[Howtos]]
 
* [[helper scripts]] - add-on scripts that help using FAI
* download the FAI CD from: http://fai-project.org/fai-cd/
* [[Resources]] - there are some information resources about FAI available &quot;out there&quot;, as well as some unofficial developer branches, that are handled somewhere else until that code is incoporated in the FAI main Branch - and we want to point to them.
* download the packages from: http://fai-project.org/download/
* [[user FAQ]] ( from questions in the mailing list and on IRC irc.debian.org #fai) - We took the contents of the old and somewhat unmaintained [http://faifaq.andrew.net.au/cache/index.html fai faqmatic] to this wiki to have all information more centralized. Please use the Wiki from now on.
* check out the sources from git:
* [[linux-fai mailing list infos]] (Netiquette, how to subscribe and use)
<pre>git clone git://github.com/faiproject/fai.git</pre>
* [[reporting bugs]] and also maybe find fixes for problems that you might encounter when using FAI.
 
= Documentation and examples =
 
== Official - from the FAI developer team ==
* [http://fai-project.org/guide/ FAI guide]
* [http://fai-project.org/doc/man/ Manpages in HTML Format]
* [[Variables]] List of useful variables inside FAI
 
== FAI in the real world ==
* [http://fai-project.org/reports User reports] by filling out the [http://fai-project.org/questionnaire FAI questionnaire]  
* [[Success Stories]] - who is using FAI, how and why - and, when available pictures of the machines installed with FAI :)
* [[Success Stories]] - who is using FAI, how and why - and, when available pictures of the machines installed with FAI :)
* [http://www.informatik.uni-koeln.de/fai/q-answers User reports] by filling out the [http://www.informatik.uni-koeln.de/fai/questionnaire FAI questionnaire]  (TODO: create a webform for this)
* this wiki needs a [[Logo]]


* [http://www.debian-administration.org/articles/240 a short tutorial on www.debian-administration.org]
== User contributed in this wiki ==
* [http://jijo.free.net.ph/files/talks/20050914-linuxworld2005.pdf a talk on fai and debian]


* [http://www.the-greenman.net/?q=node/7 A visual overview] of how all the pieces of an FAI installation fit together.
* [[Howtos]]
* [[helper scripts]] - add-on scripts that help using FAI
* [[user FAQ]] (from questions in the mailing list and on IRC #fai)
* [[reporting bugs]] and also maybe find fixes for problems.


* Two Articles of how people ue FAI for some clusters:
= Developer information =
** Graphical rendering: http://viz.aset.psu.edu/ga5in/DisplayWallBuild.html
* Moved to [[Developers information]]
** Global Optimization computing cluster: http://globopt.dsi.unifi.it/gol/cluster.html


== Developer information ==
= Wiki Information =
* Stuff for people interested in helping with FAI: [[Developers information]]
* A new partitioning tool: [[setup_harddisks_2]]
* An approach using [[FaiTemplates|template toolkit in FAI]]


== Wiki Information ==
* this wiki and FAI itself need a [[Logo]]
* [[FAIWiki:About | About this Wiki]] - info on this wiki
* [[FAIWiki:About | About this Wiki]] - info on this wiki
* [[help for editing]] (mainly mediawiki documentation links)
* [[help for editing]] (mainly mediawiki documentation links)
* [[editing rules]] - some ideas that make collaborative work here easier
* [[editing rules]] - some ideas that make collaborative work here easier
* practice wiki writing [[practice wiki writing|here]]
* [[FAI Wiki Administration Coordination]] - some infos on managing this wiki
* [[FAI Wiki Administration Coordination]] - some infos on managing this wiki

Revision as of 13:08, 14 February 2014

Hello and welcome to the FAI wiki.

This is a public wiki for FAI - Fully Automatic Installation. It is a place for users and developers of FAI to share information. If you have some information on FAI to share, please register wiki registration. Also, please read editing rules.

About FAI

FAI is a tool for fully automatic (unless you explicitly wish to get some questions on each install) installation of Debian and other Linux Distributions via network, custom install cd, or into a chroot environment. Some people also use it to install Windows.

FAI works script-based as opposed to full image based (if you wish so, we can also install any kind of image) - so it is very flexible, and can be used to install very heterogeneous infrastructures. It uses a class-based system (think of classes as system types that can be combined with each other, as long as they are not technically conflicting) to define configurations in some simple textfiles.

It is also used to update running systems without completely reinstalling them with the softupdate functionality - so you have one single point of configuration for installation and updates.

Getting FAI

git clone git://github.com/faiproject/fai.git

Documentation and examples

Official - from the FAI developer team

FAI in the real world

User contributed in this wiki

Developer information

Wiki Information