Main Page: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(91 intermediate revisions by 18 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 =
* [[Events]] - Developer and User Meetings, Workshops, Tutorials happening
 
* [[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)
* FAI CD https://fai-project.org/fai-cd/
* 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
* FAIme build service for customized installation and cloud images https://fai-project.org/FAIme
* practice wiki writing [[practice wiki writing|here]]
 
 
= 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 ==


== 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] or [http://layer-acht.de/fai/fai-guide-translations/ translated].
* [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]]
* [[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/questionnaire questionnaire]  (an easy to use webform should be available there some day...)
* [[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 [http://layer-acht.org/uploads/pics/FAI_logo.jpg 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]


== Developer information ==
* [[Howtos]]
[[Developers information]]
* [[helper scripts]] - add-on scripts that help using FAI
* [[user FAQ]] (from questions in the mailing list and on IRC #fai)
* [[Developers information]]


* [[developer FAQ]] from the mailing list and irc channel
* [[linux-fai-devel mailing list info]] -  netiquette, how to subscribe and use
* FAI BTS page on debian.org:
** [http://bugs.debian.org/cgi-bin/pkgreport.cgi?which=pkg&data=fai&archive=no&version=&dist=unstable unstable]
** [http://bugs.debian.org/cgi-bin/pkgreport.cgi?which=pkg&data=fai&archive=no&version=&dist=testing testing]
** [http://bugs.debian.org/cgi-bin/pkgreport.cgi?which=pkg&data=fai&archive=no&version=&dist=stable stable]
** http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=fai;pri0=tag:svn-trunk;pri1=severity:critical,grave,serious,important,normal,minor,wishlist - display fixed in svn-trunk bugs first, then open bugs ordered by priority
* FAI QA pages on debian.org:
** [http://packages.qa.debian.org/f/fai.html source package fai]
** [http://packages.qa.debian.org/f/fai-kernels.html source package fai-kernels]
* [[development plan]] - who is or will be doing doing what, and when?
** [[fai subversion howto]] - what you need to know to develop fai within the subversion repository on alioth
** [[people branches]] - people branches and what they're aimed at
* [[testing]] - general information on FAI development testing, and documentation of [[testcases]] and a [[test plan]] for the development - who tests what and how. Eventually we want to have a system so developers can report the results of their tests, as long as we don#t have that fully automated, which will take a while.


* Subversion repository access:
= Wiki Information =
** svn co svn://svn.debian.org/svn/fai/trunk fai-sources
** http://svn.debian.org/wsvn/fai


* [[FAI Wiki Administration Coordination]]
* [[wiki registration | register for this wiki]]
----
* [[editing rules | Editing rules]]
* TODO: fill pages linked here with content
* [[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