First pass at converting Anaconda docs to asciidoc

This commit is contained in:
Jared Smith 2018-02-26 10:14:58 -05:00
parent 382881b0bb
commit 4c9d7e9285
6 changed files with 195 additions and 316 deletions

View file

@ -1,5 +1,5 @@
---
Name: Fedora Quick Docs
Name: Fedora Quick Docs
Dir: en-US
Topics:
- Name: Quick Docs in Progress (How to Help!)
@ -50,8 +50,13 @@ Topics:
File: grub2
- Name: (CHECK) Spotify
File: spotify
- Name: (FIX ME!) Anaconda
File: anaconda
- Name: (IN PROGRESS) Anaconda
Dir: anaconda
Topics:
- Name: Anaconda
File: anaconda
- Name: Anaconda based Distributions
File: anaconda_distros
- Name: (FIX ME!) AutoUpdates
File: autoupdates
- Name: (FIX ME!) Building a custom kernel

View file

@ -1,313 +0,0 @@
= Anaconda
'''
[IMPORTANT]
======
This page was automatically converted from https://fedoraproject.org/wiki/Anaconda
It is probably
* Badly formatted
* Missing graphics and tables that do not convert well from mediawiki
* Out-of-date
* In need of other love
Pull requests accepted at https://pagure.io/fedora-docs/quick-docs
Once you've fixed this page, remove this notice, and update
`_topic_map.yml`.
Once the document is live, go to the original wiki page and replace its text
with the following macro:
....
{{#fedoradocs: https://docs.fedoraproject.org/whatever-the-of-this-new-page}}
....
======
'''
image:DSC_3217.JPG[ 400px | Entering Anaconda, Montana. A city probably
named after this installation program. David Cantrell took this picture
in 2011. His grey VW Jetta is parked in the
background.,title=" 400px | Entering Anaconda, Montana. A city probably named after this installation program. David Cantrell took this picture in 2011. His grey VW Jetta is parked in the background."]
Anaconda is the installation program used by Fedora, Red Hat Enterprise
Linux and link: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/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
link: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.
[[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] 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 link:Anaconda/Updates[ updates] wiki
page explains how to use these updates images.
Need to see what's changed from release to release? See our
link:Anaconda/Changes[migration guide] which summarizes changes for
users, rebuilders, and contributors.
[[advanced-users]]
Advanced Users
~~~~~~~~~~~~~~
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 link: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.
[[distribution-builders]]
Distribution Builders
~~~~~~~~~~~~~~~~~~~~~
For information on how to customize anaconda and trees created with it,
please see link:Anaconda/ProductImage[ product.img],
link:Anaconda/BuildDocProject[ BuildDocProject] and
link:Anaconda/Customization[ Customization].
[[mailing-lists]]
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
https://listman.redhat.com/mailman/listinfo/anaconda-devel-list[anaconda
development list site] . Past discussions can be found in the
https://www.redhat.com/archives/anaconda-devel-list[anaconda development
archives] .
The second list is a user oriented list on 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.
Past discussions of patches can be found in the
https://lists.fedorahosted.org/pipermail/anaconda-patches/[anaconda-patches
archives], which is the main purpose this mailing list now serves.
[[irc]]
IRC
~~~
There is also an IRC channel on http://freenode.net. This resource is
for discussion of anaconda development, not for distribution
customization questions.
[[how-to-contribute]]
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 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:
* Anaconda/Devel/Translation
* If you want to work on Anaconda, you should start with the
link: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:
* https://developer.gnome.org/gtk3/stable/[GTK+ reference]
* https://docs.python.org/2/tutorial/[Python tutorial]
* https://docs.python.org/2/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 in 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[`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
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 infratructure and describes how to run
tests].
To contribute you should read our
https://anaconda-installer.readthedocs.io/en/latest/contributing.html[guidelines
for contributing].
[[reporting-problems]]
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
link:How_to_debug_installation_problems[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.
link: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-team]]
Anaconda Team
~~~~~~~~~~~~~
image:20170607-brq-anaconda-group-photo02.jpg[ 500px,title=" 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.
* Jiri Konecny (jkonecny): DUD, CI, UX, stuff.
* User:Rvykydal[Radek Vykydal] (rvykydal): Networking, Atomic,
packaging.
* User:M4rtink[Martin Kolman] (mkolman): initial-setup, password stuff,
UX, other stuff.
* User:sbueno[Samantha N. Bueno] (sbueno): Manager.
* Vendula Poncova (vponcova): s390x, storage tweaks, UX, other stuff.
[[anaconda-team-emeritus]]
Anaconda Team Emeritus
~~~~~~~~~~~~~~~~~~~~~~
* 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)
* Joel Andres Granados (jgranado)
* Hans de Goede (hansg)
* User:Akozumpl[Ales Kozumplik] (akozumpl)
* User:Mgracik[Martin Gracik] (mgracik)
* User:jkeating[Jesse Keating] (jlk)
* User:Msivak[Martin Sivak] (msivak)
[[design]]
Design
~~~~~~
* link:Anaconda/UX_Redesign[ Anaconda UX Redesign]
* link:How_to_Create_an_Anaconda_Banner[ How to Create an Anaconda
Banner]
Category:Anaconda
'''
See a typo, something missing or out of date, or anything else which can be
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.

View file

@ -0,0 +1,167 @@
= Anaconda
[caption="Entering Anaconda, Montana. A city probably named after this installation program. David Cantrell took this picture in 2011. His grey VW Jetta is parked in the background."]
image::DSC_3217.JPG[Anaconda,400]
Anaconda is the installation program used by Fedora, Red Hat Enterprise Linux and link:anaconda_distros.html[ 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/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 link: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.
[id="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] 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 link:Anaconda/Updates[ updates] wiki page explains how to use these updates images.
Need to see what's changed from release to release?
See our link:Anaconda/Changes[migration guide] which summarizes changes for users, rebuilders, and contributors.
[id="advanced-users"]
== Advanced Users
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 link: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.
[id="distribution-builders"]
== Distribution Builders
For information on how to customize Anaconda and trees created with it, please see link:Anaconda/ProductImage[product.img], link:Anaconda/BuildDocProject[BuildDocProject] and link:Anaconda/Customization[Customization].
[id="mailing-lists"]
== 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 https://listman.redhat.com/mailman/listinfo/anaconda-devel-list[anaconda development list site].
Past discussions can be found in the https://www.redhat.com/archives/anaconda-devel-list[anaconda development archives].
The second list is a user oriented list on 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.
Past discussions of patches can be found in the https://lists.fedorahosted.org/pipermail/anaconda-patches/[anaconda-patches archives], which is the main purpose this mailing list now serves.
[id="irc"]
== IRC
There is also an IRC channel on http://freenode.net.
This resource is for discussion of Anaconda development, not for distribution customization questions.
[id="how-to-contribute"]
== 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.
[id="developers-guide"]
== 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:
* Anaconda/Devel/Translation
* If you want to work on Anaconda, you should start with the link: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:
* https://developer.gnome.org/gtk3/stable/[GTK+ reference]
* https://docs.python.org/2/tutorial/[Python tutorial]
* https://docs.python.org/2/py-modindex.html[Python module reference]
[id="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 in 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 https://github.com/rhinstaller/anaconda.git[Anaconda git URLs].
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 infratructure and describes how to run tests].
To contribute you should read our https://anaconda-installer.readthedocs.io/en/latest/contributing.html[guidelines for contributing].
[id="reporting-problems"]
== 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 link:How_to_debug_installation_problems[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.
link: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.
[[design]]
Design
~~~~~~
* link:Anaconda/UX_Redesign[ Anaconda UX Redesign]
* link:How_to_Create_an_Anaconda_Banner[ How to Create an Anaconda Banner]

View file

@ -0,0 +1,20 @@
= Anaconda based Distributions
There are a number of distributions which currently use Anaconda. This is a list of the ones which we are aware of.
* Fedora
* Red Hat Enterprise Linux
* rpath Linux
* Progeny Componentized Linux, based on Debian (defunct)
* Vida linux, Gentoo variant using Anaconda
* Foresight Linux, originally derived from rpath Linux
* Sabayon Linux Installer
* Aurox
* Asianux
* Blag GNU/Linux
* ASPLinux
* Fedora derivatives
* FrameOS Linux
* Scientific Linux
There are likely many more distributions using Anaconda. Feel free to contact the authors to add to this list.

View file

Before

Width:  |  Height:  |  Size: 362 KiB

After

Width:  |  Height:  |  Size: 362 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 456 KiB