No edit summary |
(Update Anaconda team members) |
||
| (13 intermediate revisions by 10 users not shown) | |||
| Line 6: | Line 6: | ||
[[Anaconda]] is the installation program used by Fedora, Red Hat Enterprise Linux and [[Anaconda/Distros| some other distributions]]. | [[Anaconda]] is the installation program used by Fedora, Red Hat Enterprise Linux and [[Anaconda/Distros| some other distributions]]. | ||
During installation, a target computer's hardware is identified and configured and the appropriate file systems for the system's architecture are created. Finally, anaconda allows the user to install the operating system software on the target computer. anaconda can also upgrade existing installations of earlier versions of the same distribution. After the installation is complete, you can reboot into your installed system and continue doing customization using [https://fedoraproject.org/wiki/ | During installation, a target computer's hardware is identified and configured, and the appropriate file systems for the system's architecture are created. Finally, anaconda allows the user to install the operating system software on the target computer. anaconda can also upgrade existing installations of earlier versions of the same distribution. After the installation is complete, you can reboot into your installed system and continue doing customization using [https://fedoraproject.org/wiki/InitialSetup initial setup]. | ||
anaconda is a fairly sophisticated installer. It supports installation from local and remote sources such as CDs and DVDs, images stored on a hard drive, NFS, HTTP, and FTP. Installation can be scripted with [[Anaconda/Kickstart| kickstart]] to provide a fully unattended installation that can be duplicated on scores of machines. It can also be run over VNC on headless machines. A variety of advanced storage devices including LVM, RAID, iSCSI, and multipath are supported from the partitioning program. anaconda provides advanced debugging features such as remote logging, access to the python interactive debugger, and remote saving of exception dumps. | anaconda is a fairly sophisticated installer. It supports installation from local and remote sources such as CDs and DVDs, images stored on a hard drive, NFS, HTTP, and FTP. Installation can be scripted with [[Anaconda/Kickstart| kickstart]] to provide a fully unattended installation that can be duplicated on scores of machines. It can also be run over VNC on headless machines. A variety of advanced storage devices including LVM, RAID, iSCSI, and multipath are supported from the partitioning program. anaconda provides advanced debugging features such as remote logging, access to the python interactive debugger, and remote saving of exception dumps. | ||
| Line 12: | Line 12: | ||
== Users == | == Users == | ||
If you are a user having problems with anaconda, please use the user support forum for your distribution such as [http://forums.fedoraforum.org/forumdisplay.php?f=6 Fedora Forum] . | If you are a user having problems with anaconda, please use the user support forum for your distribution such as [http://forums.fedoraforum.org/forumdisplay.php?f=6 Fedora Forum] or [https://admin.fedoraproject.org/mailman/listinfo/users fedora-users]. | ||
From time to time, we may distribute updates for anaconda to fix problems in Fedora releases. The [[Anaconda/Updates| updates]] wiki page explains how to use these updates images. | From time to time, we may distribute updates for anaconda to fix problems in Fedora releases. The [[Anaconda/Updates| updates]] wiki page explains how to use these updates images. | ||
| Line 20: | Line 20: | ||
== Advanced Users == | == Advanced Users == | ||
If you are an advanced user of anaconda, you should check out [ | If you are an advanced user of anaconda, you should check out [https://anaconda-installer.readthedocs.io/en/latest/boot-options.html our reference to anaconda command line options],[https://anaconda-installer.readthedocs.io/en/latest/kickstart.html our kickstart file format documentation] and [[Anaconda/Logging| our reference to logging capabilities of anaconda]]. | ||
There is a mailing list devoted to the use of kickstart. You can find the list signup and archive information at [http://www.redhat.com/mailman/listinfo/kickstart-list kickstart list] . This is the best place to share tips and tricks about kickstart. | There is a mailing list devoted to the use of kickstart. You can find the list signup and archive information at [http://www.redhat.com/mailman/listinfo/kickstart-list kickstart list]. This is the best place to share tips and tricks about kickstart. | ||
== Distribution Builders == | == Distribution Builders == | ||
For information on how to customize anaconda and trees created with it, please see [[Anaconda/BuildDocProject| BuildDocProject]] and [[Anaconda/Customization| Customization]] . | For information on how to customize anaconda and trees created with it, please see [[Anaconda/ProductImage| product.img]], [[Anaconda/BuildDocProject| BuildDocProject]] and [[Anaconda/Customization| Customization]]. | ||
== Mailing Lists == | == Mailing Lists == | ||
There are | There are two mailing lists for Anaconda. The first is the development mailing list. This list is used to discuss development issues, submit patches and other activities related to extending anaconda. The sign up for the development list is located at [https://lists.fedoraproject.org/archives/list/anaconda-devel@lists.fedoraproject.org/ anaconda development list site]. Past discussions can be found in the [https://www.redhat.com/archives/anaconda-devel-list anaconda development archives] for old mailing list or [https://lists.fedoraproject.org/archives/list/anaconda-devel@lists.fedoraproject.org/ here on Fedora] for the current one. | ||
The second list is | The second list is a user oriented list of how to create kickstart files. The kickstart list is the place to discuss automated installation issues. The sign up for the kickstart list is located at [https://www.redhat.com/mailman/listinfo/kickstart-list anaconda kickstart list site]. Past discussions can be found in the [https://www.redhat.com/archives/kickstart-list anaconda kickstart archives]. | ||
Patch review used to take place on a mailing list dedicated to submitting and reviewing patches. Patch review now takes place on [https://github.com/rhinstaller/anaconda/pulls GitHub] via pull requests. | |||
== IRC == | == IRC and Matrix == | ||
There is also an | There is also an [https://web.libera.chat/#anaconda #anaconda] IRC channel on [https://libera.chat/ Libera.Chat] or Matrix channel on [https://matrix.to/#/#anaconda:fedora.im chat.fedoraproject.org]. This resource is for discussion of anaconda development, not for distribution customization questions. | ||
== How to Contribute == | |||
For how to contribute to Anaconda and related projects, see the [https://fedoraproject.org/wiki/Anaconda/Contribute Contributing to Anaconda and related projects] documentation. | |||
Please note that useful contributions are not limited to submitting patches for source code. You can also help with [https://anaconda-installer.readthedocs.io/en/latest/testing.html testing], reporting bugs, improving translations or extending the Anaconda documentation. | |||
== Developers' Guide == | == Developers' Guide == | ||
anaconda is now almost entirely written in Python | anaconda is now almost entirely written in Python 3. The graphical front end uses GTK+ 3 via gobject-introspection, and as much of the interface as possible is written using the glade interface builder. The earliest parts of anaconda are in shell for integration with dracut, and there's still a little bit of C thrown in for interfacing with certain libraries. | ||
Here are some documents if you are planning on working on anaconda. More | Here are some documents if you are planning on working on anaconda. More are in the works: | ||
* [[Anaconda/Devel/Translation]] | * [[Anaconda/Devel/Translation]] | ||
If you want to work on Anaconda, you should start with the [[Anaconda/SourceOverview|Source Overview]], which contains a high level discussion of the source files and what they do. Then look at the [ | * If you want to work on Anaconda, you should start with the [[Anaconda/SourceOverview|Source Overview]], which contains a high-level discussion of the source files and what they do. Then look at the [https://anaconda-installer.readthedocs.io/en/latest/ online documentation] for information on how to test, debug, and develop anaconda. | ||
Familiarize yourself with the tools that anaconda uses. Check out the following external reference documents: | Familiarize yourself with the tools that anaconda uses. Check out the following external reference documents: | ||
* [https://developer.gnome.org/gtk3/stable/ GTK+ reference] | * [https://developer.gnome.org/gtk3/stable/ GTK+ reference] | ||
* [ | * [https://docs.python.org/3/tutorial/ Python tutorial] | ||
* [ | * [https://docs.python.org/3/py-modindex.html Python module reference] | ||
== Getting the Source == | == Getting the Source == | ||
The primary methods of distributing the anaconda source are source RPMs in the [http://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/source/SRPMS/ Fedora development tree] and git. To access the current source code | The primary methods of distributing the anaconda source are source RPMs in the [http://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/source/SRPMS/ Fedora development tree] and git. To access the current source code in non-rpm format, you'll need to install git. | ||
dnf install git | |||
Note that several related packages will be installed as well. After the git source code management tool has been installed, then you use anonymous git access to the Anaconda repository. | Note that several related packages will be installed as well. After the git source code management tool has been installed, then you use anonymous git access to the Anaconda repository. | ||
git clone | git clone https://github.com/rhinstaller/anaconda.git | ||
The output may look similar to the following: | The output may look similar to the following: | ||
| Line 89: | Line 91: | ||
If you have committer access to anaconda, then you will want to use the git+ssh access url. | If you have committer access to anaconda, then you will want to use the git+ssh access url. | ||
git clone git+ssh://git. | git clone git+ssh://git@github.com/rhinstaller/anaconda.git | ||
| Line 96: | Line 98: | ||
git push | git push | ||
If you would just like to browse the Anaconda git repository via the web, then please use | If you would just like to browse the Anaconda git repository via the web, then please use the following [https://github.com/rhinstaller/anaconda.git Anaconda git URLs]. | ||
https://github.com/rhinstaller/anaconda | |||
Anaconda has an [https://github.com/rhinstaller/kickstart-tests extensive suite of tests] that is still growing. If you contribute new functionality, it's good practice to include some tests along with that. We have a [https://anaconda-installer.readthedocs.io/en/latest/testing.html document that outlines the test suite infrastructure and describes how to run tests]. | |||
To contribute you should read our [ | To contribute you should read our [https://anaconda-installer.readthedocs.io/en/latest/contributing.html guidelines for contributing]. | ||
== Reporting Problems == | == Reporting Problems == | ||
| Line 108: | Line 110: | ||
If you are having difficulty installing, please file the problem report with your distribution vendor. | If you are having difficulty installing, please file the problem report with your distribution vendor. | ||
Before filing a bug, please read up on [[How to debug installation problems]], which will tell you how to fill out useful bug reports that will help us quickly solve your problem. Also try searching | Before filing a bug, please read up on [[How to debug installation problems]], which will tell you how to fill out useful bug reports that will help us quickly solve your problem. Also try searching Bugzilla for other reports about your problem, as some bugs are often filed by several people. | ||
[[Anaconda/AnacondaBugWorkflow| AnacondaBugWorkflow]] is a guideline to how Fedora anaconda bugs pass through Bugzilla, and what all the various statuses really mean. This is '''only''' for Fedora. | |||
[[Anaconda/AnacondaBugWorkflow| AnacondaBugWorkflow]] is a guideline to how Fedora anaconda bugs pass through | |||
== Anaconda Team == | == Anaconda Team == | ||
[[Image: | [[Image:20170607-brq-anaconda-group-photo02.jpg | 500px]] | ||
From left to right, the following people are the anaconda team and are responsible for the majority of commits. Of course, we get help from other people both from Red Hat and from the volunteer community as well. | From left to right, the following people are the anaconda team and are responsible for the majority of commits. Of course, we get help from other people both from Red Hat and from the volunteer community as well. | ||
* [[User: | * [[User:Rvykydal|Radek Vykydal]] (rvykydal): Engineering | ||
* [[User: | * [[User:M4rtink|Martin Kolman]] (mkolman): Engineering | ||
* | * Jiri Konecny (jkonecny): Engineering | ||
* | * Garrett LeSage (Garrett): UX design | ||
* Katerina Koukiou (KKoukiou) : Engineering | |||
* Pawel Polawski (ppolawsk) : Engineering | |||
* | * Adam Kankovsky (akankovs) : Engineering Intern | ||
* ( | * [[User:bookwar|Aleksandra Fedorova]] (bookwar): Manager | ||
* ( | |||
* | |||
== Anaconda Team Emeritus == | == Anaconda Team Emeritus == | ||
* Matej Marusak (mmarusak): Manager | |||
* Vendula Poncova (vponcova): Engineering | |||
* Vladimír Slávik (vslavik): Engineering | |||
* Ondřej Zobal (ozobal): Engineering Intern | |||
* Liz Clayton (lclayton): UX design | |||
* Eleana Panayiotou (eleana): Manager | |||
* [[User:sbueno|Samantha N. Bueno]] (sbueno): Manager | |||
* [[User:Clumens|Chris Lumens]] (clumens) | |||
* [[User:Pjones|Peter Jones]] (pjones) | |||
* [[User:Bcl|Brian Lane]] (bcl) | |||
* [[User:Dcantrel|David Cantrell]] (dcantrell) | |||
* [[User:Wwoods|Will Woods]] (wwoods) | |||
* [[User:Dlehman|Dave Lehman]] (dlehman) | |||
* [[User:vpodzime|Vratislav Podzimek]] (vpodzime): | |||
* [[User:dshea|David Shea]] (dshea) | |||
* [[User:katzj|Jeremy Katz]] (katzj) | * [[User:katzj|Jeremy Katz]] (katzj) | ||
* Joel Andres Granados (jgranado) | * Joel Andres Granados (jgranado) | ||
| Line 144: | Line 155: | ||
== Design == | == Design == | ||
* [[Anaconda/UX Redesign | Anaconda UX Redesign]] | * [[Anaconda/UX Redesign | Anaconda UX Redesign]] | ||
* [[How to Create an Anaconda Banner | How to Create an Anaconda Banner]] | |||
[[Category:Anaconda]] | [[Category:Anaconda]] | ||
Latest revision as of 16:43, 19 November 2024
Anaconda is the installation program used by Fedora, Red Hat Enterprise Linux and some other distributions.
During installation, a target computer's hardware is identified and configured, and the appropriate file systems for the system's architecture are created. Finally, anaconda allows the user to install the operating system software on the target computer. anaconda can also upgrade existing installations of earlier versions of the same distribution. After the installation is complete, you can reboot into your installed system and continue doing customization using initial setup.
anaconda is a fairly sophisticated installer. It supports installation from local and remote sources such as CDs and DVDs, images stored on a hard drive, NFS, HTTP, and FTP. Installation can be scripted with kickstart to provide a fully unattended installation that can be duplicated on scores of machines. It can also be run over VNC on headless machines. A variety of advanced storage devices including LVM, RAID, iSCSI, and multipath are supported from the partitioning program. anaconda provides advanced debugging features such as remote logging, access to the python interactive debugger, and remote saving of exception dumps.
Users
If you are a user having problems with anaconda, please use the user support forum for your distribution such as Fedora Forum or fedora-users.
From time to time, we may distribute updates for anaconda to fix problems in Fedora releases. The updates wiki page explains how to use these updates images.
Need to see what's changed from release to release? See our migration guide which summarizes changes for users, rebuilders, and contributors.
Advanced Users
If you are an advanced user of anaconda, you should check out our reference to anaconda command line options,our kickstart file format documentation and our reference to logging capabilities of anaconda.
There is a mailing list devoted to the use of kickstart. You can find the list signup and archive information at kickstart list. This is the best place to share tips and tricks about kickstart.
Distribution Builders
For information on how to customize anaconda and trees created with it, please see product.img, BuildDocProject and Customization.
Mailing Lists
There are two mailing lists for Anaconda. The first is the development mailing list. This list is used to discuss development issues, submit patches and other activities related to extending anaconda. The sign up for the development list is located at anaconda development list site. Past discussions can be found in the anaconda development archives for old mailing list or here on Fedora for the current one.
The second list is a user oriented list of how to create kickstart files. The kickstart list is the place to discuss automated installation issues. The sign up for the kickstart list is located at anaconda kickstart list site. Past discussions can be found in the anaconda kickstart archives.
Patch review used to take place on a mailing list dedicated to submitting and reviewing patches. Patch review now takes place on GitHub via pull requests.
IRC and Matrix
There is also an #anaconda IRC channel on Libera.Chat or Matrix channel on chat.fedoraproject.org. This resource is for discussion of anaconda development, not for distribution customization questions.
How to Contribute
For how to contribute to Anaconda and related projects, see the Contributing to Anaconda and related projects documentation.
Please note that useful contributions are not limited to submitting patches for source code. You can also help with testing, reporting bugs, improving translations or extending the Anaconda documentation.
Developers' Guide
anaconda is now almost entirely written in Python 3. The graphical front end uses GTK+ 3 via gobject-introspection, and as much of the interface as possible is written using the glade interface builder. The earliest parts of anaconda are in shell for integration with dracut, and there's still a little bit of C thrown in for interfacing with certain libraries.
Here are some documents if you are planning on working on anaconda. More are in the works:
- If you want to work on Anaconda, you should start with the Source Overview, which contains a high-level discussion of the source files and what they do. Then look at the online documentation for information on how to test, debug, and develop anaconda.
Familiarize yourself with the tools that anaconda uses. Check out the following external reference documents:
Getting the Source
The primary methods of distributing the anaconda source are source RPMs in the Fedora development tree and git. To access the current source code in non-rpm format, you'll need to install git.
dnf install git
Note that several related packages will be installed as well. After the git source code management tool has been installed, then you use anonymous git access to the Anaconda repository.
git clone https://github.com/rhinstaller/anaconda.git
The output may look similar to the following:
Initialized empty Git repository in /home/drkludge/anacondatest/anaconda/.git/ remote: Generating pack... remote: Counting objects: 10861 remote: Done counting 91222 objects. remote: Deltifying 91222 objects... remote: 100% (91222/91222) done Indexing 91222 objects... 100% (91222/91222) done remote: Total 91222 (delta 68785), reused 90187 (delta 68059) Resolving 68785 deltas... 100% (68785/68785) done Checking 543 files out... 100% (543/543) done
If you have committer access to anaconda, then you will want to use the git+ssh access url.
git clone git+ssh://git@github.com/rhinstaller/anaconda.git
Once you've committed changes locally, you can push them with
git push
If you would just like to browse the Anaconda git repository via the web, then please use the following Anaconda git URLs.
https://github.com/rhinstaller/anaconda
Anaconda has an extensive suite of tests that is still growing. If you contribute new functionality, it's good practice to include some tests along with that. We have a document that outlines the test suite infrastructure and describes how to run tests.
To contribute you should read our guidelines for contributing.
Reporting Problems
If you are having difficulty installing, please file the problem report with your distribution vendor.
Before filing a bug, please read up on How to debug installation problems, which will tell you how to fill out useful bug reports that will help us quickly solve your problem. Also try searching Bugzilla for other reports about your problem, as some bugs are often filed by several people.
AnacondaBugWorkflow is a guideline to how Fedora anaconda bugs pass through Bugzilla, and what all the various statuses really mean. This is only for Fedora.
Anaconda Team
From left to right, the following people are the anaconda team and are responsible for the majority of commits. Of course, we get help from other people both from Red Hat and from the volunteer community as well.
- Radek Vykydal (rvykydal): Engineering
- Martin Kolman (mkolman): Engineering
- Jiri Konecny (jkonecny): Engineering
- Garrett LeSage (Garrett): UX design
- Katerina Koukiou (KKoukiou) : Engineering
- Pawel Polawski (ppolawsk) : Engineering
- Adam Kankovsky (akankovs) : Engineering Intern
- Aleksandra Fedorova (bookwar): Manager
Anaconda Team Emeritus
- Matej Marusak (mmarusak): Manager
- Vendula Poncova (vponcova): Engineering
- Vladimír Slávik (vslavik): Engineering
- Ondřej Zobal (ozobal): Engineering Intern
- Liz Clayton (lclayton): UX design
- Eleana Panayiotou (eleana): Manager
- Samantha N. Bueno (sbueno): Manager
- Chris Lumens (clumens)
- Peter Jones (pjones)
- Brian Lane (bcl)
- David Cantrell (dcantrell)
- Will Woods (wwoods)
- Dave Lehman (dlehman)
- Vratislav Podzimek (vpodzime):
- David Shea (dshea)
- Jeremy Katz (katzj)
- Joel Andres Granados (jgranado)
- Hans de Goede (hansg)
- Ales Kozumplik (akozumpl)
- Martin Gracik (mgracik)
- Jesse Keating (jlk)
- Martin Sivak (msivak)