Main Page: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
No edit summary
 
(81 intermediate revisions by 17 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.


'''important note: due to spam we were forced to change the registration policy for the wiki. please contact [[User:Lazyboy]] or [http://www.informatik.uni-koeln.de/ls_juenger/people/lange/ Thomas Lange] to get an account, or ask on the FAI mailing list. we are trying to find more convenient solutions for that problem, but it will take a while... Henning'''
= About FAI =


This is a public wiki for [http://www.informatik.uni-koeln.de/fai/ 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, create an account and go ahead!
FAI is a tool for fully automatic installation of Debian and other Linux Distributions via network, custom install CD, or into a chroot environment.
Below is a first start for the contents that we want to provide here. Most pages, colored in red, have not been started yet. If you can contribute something to them, do it, after reading the [[editing rules]]):


== Common Information ==
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.
* [[FAIWiki:About | About this Wiki]] - info on this wiki
 
* [[help for editing]] (mainly mediawiki documentation links)
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.
* [[editing rules]] - some ideas that make collaborative work here easier
 
* [[Resources]] - there are some information resources about FAI available "out there", 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.
= Getting started =
* [[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)
 
* for now, the [http://www.informatik.uni-koeln.de/fai/ FAI Homepage] is still the biggest source of information, eventually lots of the stuff there will migrate into the wiki
* FAI CD https://fai-project.org/fai-cd/
* practice wiki writing [[practice wiki writing|here]]
* FAIme build service for customized installation and cloud images https://fai-project.org/FAIme
 
 
= 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


* getting FAI - if you want the latest and greatest version:
== FAI in the real world ==
** download ist from: http://www.informatik.uni-koeln.de/fai/download/
** add this to your /etc/apt/sources.list: "deb http://www.informatik.uni-koeln.de/fai/ download"
** install it within debian sid


== User documentation and examples ==
* [http://fai-project.org/references/ References]
* 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://fai-project.org/reports User reports]
* [[reporting bugs]] and also maybe find fixes for problems that you might encounter when using FAI. '''Think about it, you can help make FAI better by telling us what's wrong with it!'''
* [[example classes]] and [[helper scripts]] - classes and small code contributions that are not (already) part of the FAI distribution
* tips and tricks - other hints for users by users that are not exactly written in code like the above - general advice, configuration hints
** smaller [[tips and tricks]]
** [[Installing Ubuntu Linux with FAI]]
** [[Using gpg-authenticated debian-archives]]
** [[Using FAI to set up XEN domains]]
** [http://faiwiki.informatik.uni-koeln.de/index.php/User:Svamberg/Software_RAID Software-RAID with mdadm]
** [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://www.linuxma.com/fai_raid/ LVM & RAID]
** [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]
* [[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 freenode #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 =
[[Developers information]]
 
* [[wiki registration | register for this wiki]]
* [[editing rules | Editing rules]]
* [[FAIWiki:About | About this Wiki]] - info on this wiki
* [[help for editing]] (mainly mediawiki documentation links)
* [[editing rules]] - some ideas that make collaborative work here easier
* [[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