Main Page: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
No edit summary
 
(64 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Hello and welcome to the FAI wiki.
This is a public wiki for users and developers of FAI.


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.
= About FAI =
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]].


== getting FAI ==
FAI is a tool for fully automatic installation of Debian and other Linux Distributions via network, custom install CD, or into a chroot environment.
if you want the latest and greatest version:
* download it from: http://www.informatik.uni-koeln.de/fai/download/
* add this to your /etc/apt/sources.list:
<pre>deb http://www.informatik.uni-koeln.de/fai/download sarge 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 works script-based as opposed to full image based - 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.
* Main documentation for FAI is the fai guide: Either in [http://www.informatik.uni-koeln.de/fai/fai-guide.html/ english], [http://www.informatik.uni-koeln.de/fai/fai-guide-fr/ french], [http://pc.debian.ro/fai/ romanian]
 
* [http://www.informatik.uni-koeln.de/fai/ FAI Homepage]
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.
* [[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.
 
* [[Wishlist]] (for those users that can't use the debian bts for reporting a bug of type wishlist and for developers who want to know what users wish)
= Getting started =
* [[reporting bugs]] and also maybe find fixes for problems that you might encounter when using FAI.
 
* [[example classes]] and [[helper scripts]] - classes and small code contributions that are not (already) part of the FAI distribution
* FAI CD https://fai-project.org/fai-cd/
* tips and tricks - other hints for users by users that are not exactly written in code like the above - general advice, configuration hints
* FAIme build service for customized installation and cloud images https://fai-project.org/FAIme
** smaller [[tips and tricks]]
 
** Install Ubuntu and other distributions with FAI by using [[FAI multi-distribution]]
 
** [[Using gpg-authenticated debian-archives]]
= Documentation and examples =
** [[Using FAI to set up XEN domains]]
 
** [[Using FAI to set up VServers]]
== Official - from the FAI developer team ==
** [http://faiwiki.informatik.uni-koeln.de/index.php/User:Svamberg/Software_RAID Software-RAID with mdadm]
* [http://fai-project.org/guide/ FAI guide]
** [http://www.informatik.uni-koeln.de/fai/download/developers/setup_harddisks patched version of setup_harddisks]: Code refactoring, LVM/RAID support and POD manual page: Copyright (c) 2003, Sam Vilain]
* [http://fai-project.org/doc/man/ Manpages in HTML Format]
** [http://www.linuxma.com/fai_raid/ LVM & RAID]
* [[Variables]] List of useful variables inside FAI
** [http://faiwiki.informatik.uni-koeln.de/index.php/User:Svamberg/Logs_to_mail FAI-Logs via Mail]
 
** [http://faiwiki.informatik.uni-koeln.de/index.php/User:Svamberg/Making_documentation Creating class-based documentaion]
== FAI in the real world ==
** [[Using_customized_kernels_with_FAI]]
 
** [[Variables|Variables used in FAI]]
* [http://fai-project.org/references/ References]
** [[Fai-updater|Perform FAI softupdates on many machines at the same time]]
* [http://fai-project.org/reports User reports]
** [[Installing laptops with PCMCIA cards using a floppy disk]]
** [http://faiwiki.informatik.uni-koeln.de/index.php/User:Mrjazzman/DellServers Installing onto Dell PowerEdge Servers]  
** Automatic find out and use MAC addresses insted of IP addresses for PXE booting [[MAC_based_Booting_PXE]]  
* [[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)
* [[user FAQ]] ( from questions in the mailing list and on IRC oftc.net #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.
* [[linux-fai mailing list infos]] (Netiquette, how to subscribe and use)
* 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]
 
* [[Howtos]]
* [[helper scripts]] - add-on scripts that help using FAI
* [[user FAQ]] (from questions in the mailing list and on IRC #fai)
* [[Developers information]]
 


== Developer information ==
= Wiki Information =
* Stuff for people interested in helping with FAI: [[Developers information]]
* A new partitioning tool: [[setup_harddisks_2]]


== Wiki Information ==
* [[wiki registration | register for this wiki]]
* [[editing rules | Editing rules]]
* [[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

Latest revision as of 21:28, 30 January 2019

This is a public wiki for users and developers of FAI.

About FAI

FAI is a tool for fully automatic installation of Debian and other Linux Distributions via network, custom install CD, or into a chroot environment.

FAI works script-based as opposed to full image based - 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 started


Documentation and examples

Official - from the FAI developer team

FAI in the real world

User contributed in this wiki


Wiki Information