Main Page: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
(→‎Developer information: add link to faiwiki admin site)
No edit summary
 
(93 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.


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!
= About FAI =
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 is a tool for fully automatic installation of Debian and other Linux Distributions via network, custom install CD, or into a chroot environment.
* [[FAIWiki:About | About this Wiki]] - info on this wiki
 
* [[help for editing]] (mainly mediawiki documentation links)
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.
* [[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.
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.
* [[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)
= Getting started =
* 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
 
* practice wiki writing [[practice wiki writing|here]]
* FAI CD https://fai-project.org/fai-cd/
* 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
 
== 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]]
* [[developer FAQ]] from the mailing list and irc channel
* [[helper scripts]] - add-on scripts that help using FAI
* [[linux-fai-devel mailing list info]] - netiquette, how to subscribe and use
* [[user FAQ]] (from questions in the mailing list and on IRC #fai)
* FAI BTS page on debian.org:
* [[Developers information]]
** [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:
** svn co svn://svn.debian.org/svn/fai/trunk fai-sources
** http://svn.debian.org/wsvn/fai


* [[FAI Wiki Administration Coordination]]
= Wiki Information =
----
 
* TODO: fill pages linked here with content
* [[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

Retrieved from "https://wiki.fai-project.org/index.php?title=Main_Page&oldid=3557"