Distribution Support: Difference between revisions

From Yocto Project
Jump to navigationJump to search
No edit summary
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Distribution Support ==
==Distribution Support ==
===Distribution Support ===
===Distribution Support ===
This page is to maintain a list of distributions validated work with Yocto. Everyone is welcomed to add distribution support information into this page.


NOTE:  This list is out dated. Please refer to the documentation for the release your using for a list of supported distributions. For example [http://www.yoctoproject.org/docs/1.4/ref-manual/ref-manual.html#detailed-supported-distros  http://www.yoctoproject.org/docs/1.4/ref-manual/ref-manual.html#detailed-supported-distros].
The poky.conf file tracks all the distros supported by the Yocto Project. (http://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta-poky/conf/distro/poky.conf) The supported, and subsequently sanity tested, distros are listed in the "SANITY_TEST_DISTROS" section in poky.conf. Each supported distro is deployed and used as a Yocto Autobuilder build worker. For more information on supported distros, please refer to the "[https://yoctoproject.org/docs/current/ref-manual/ref-manual.html#detailed-supported-distros Supported Linux Distributions]" section in the Yocto Project Reference Manual.


{|border="1"
|| '''OS version''' || '''Host Arch''' || '''Status'''
|-
|| openSUSE 11.2 "Emerald" || -- || align="center" style="color:green;" | PASS
|-
||[[Distro/centos5.7|CentOS 5.7]] || 64bit || align="center" style="color:red;" | FAIL
|-
||[[Distro/centos6.2|CentOS 6.2]] || 32bit || align="center" style="color:green;" | PASS
|-
||[[Distro/ubuntu7.04|Ubuntu 7.04]] || 64bit || align="center" style="color:red;" | FAIL
|-
||[[Distro/ubuntu8.04|Ubuntu 8.04 LTS]] || 64bit || align="center" style="color:red;" | FAIL
|-
||[[Distro/ubuntu10.04_32b|Ubuntu10.04]]  || 32bit || align="center" style="color:green;" | PASS
|-
||[[Distro/ubuntu11.04_64b|Ubuntu11.04]]  || 64bit || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora13_32b|Fedora 13]] || 32bit || align="center" style="color:green;" | PASS
|-
|| Fedora 14 || -- || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora15_32b|Fedora 15]] || 32bit || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora15_64b|Fedora 15]] || 64bit || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora16_64b|Fedora 16]] || 64bit || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora17_64b|Fedora 17]] || 64bit || align="center" style="color:green;" | PASS
|-
||[[Distro/fedora18_64b|Fedora 18]] || 64bit || align="center" style="color:green;" | PASS
|-
||[[Distro/opensuse11.3_32b|OpenSUSE 11.3]] || 32bit || align="center" style="color:green;" | PASS
|-
||[[Distro/opensuse11.4_64b|OpenSUSE 11.4]] || 64bit || align="center" style="color:red;" | FAIL
|-
||[[Distro/rhel6.2_64b|Red Hat Enterprise Linux Server 6.2]] || 64bit || align="center" style="color:green;" | PASS
|-
|[[Distro/DebianWheezy | Debian Wheezy]] || 64bit || align="center" style="color:red;" | FAIL
|}


<pre>Example of distro list in poky.conf:
SANITY_TESTED_DISTROS ?= " \
            poky-2.4 \n \
            poky-2.5 \n \
            ubuntu-15.04 \n \
            ubuntu-16.04 \n \
            ubuntu-16.10 \n \
            ubuntu-17.04 \n \
            fedora-26 \n \
            centos-7 \n \
            debian-8 \n \
            debian-9 \n \
            opensuse-42.1 \n \
            opensuse-42.2 \n \
            "
</pre>
Again, the previous listing is just an example and is not meant to be a definitive reference. 
<br>
<br>
=== How to add a new entry or additional distro information ===
=== How to add a new entry or additional distro information ===
* Check if there is already a distribution listed on this page
* If there is no such distribution, you could add a new entry in above matrix for the distribution and add following information in the sub-page of this entry:


* Distribution (Fedora15/Ubuntu10.04/Opensuse11.4... etc):
The criteria for adding a supported distro is quite rigid. Obviously, any candidate distro must be of production quality. In other words, the distro is capable of being used in a production environment on a Yocto Project Autobuilder build worker. A compelling reason must also exist for the Yocto Project to actually use the distro on a build worker. Obscure, poorly supported, or highly customized distros are not likely to be good candidates for submission. Major stable distros (e.g. Debian, Fedora, Ubunto, Centos, and so forth.) are generally already supported.  If they are not supported, they are likely on the list to become supported once sufficient criteria are met. Please be sure to check the latest supported distros beforehand to make sure the distro in question is not already supported.
* Arch (32/64):
* MACHINE (qemux86/qemuarm/qemuppc... etc):
* TARGET (core-image-sato/core-image-sato-sdk... etc):
* Commit/Release (7eea637db0.../master, 1.0.1 release):
* Validated by/DATE (user@email.com - 2011-09-14):
  * Bug ID: (If the status of your testing is failure, pls. help to file a bug in our bugzilla, http://bugzilla.pokylinux.org)


* If there is already a distribution in above matrix, it's better for you to check if your test result is consistent with the old result in matrix. You could update the "Status" field and add additional information with above format into sub-page of the distribution.
If you have a compelling reason to suggest a distro for support, please submit your request to the Yocto Project mailing list for discussion. You will likely be asked to provide the reasoning behind your request.  Along with your request, relevant bug reports, failed test cases, and so forth are helpful.  Have them ready in advance.  
<br>
 
If you are not already a member of the Yocto Project mailing list, you can find more information and subscription requirements here: [https://lists.yoctoproject.org/listinfo/yocto https://lists.yoctoproject.org/listinfo/yocto].
 
The Yocto Project mailing list is also the right place for more general questions or issues surrounding distro support.


== Distro Testing ==
== Distro Testing ==
=== Distro test coverage ===
=== Distro test coverage ===
Distro Testing is intended to catch bugs that are distribution specific using the yocto-autobuilder. The tests are all run on identical hardware and with all OS-es updated. The distributions used will be Fedora, Ubuntu, CentOS, OpenSuse with their latest update.
<br>
This is the list of the builds that are performed on Distro testing:
{| border="1" cellpadding="1" cellspacing="1" class="article-table" style="width: 500px;"
|-
! scope="col"|Build-set
! scope="col"|Images Built
! scope="col"|Target machine
|-
|nightly-world
|world
|qemux86
|-
|buildtools
|buildtools-tarball
|qemux86-64
|-
| colspan="1" rowspan="5"|nightly-arm
|core-image-sato
| colspan="1" rowspan="5"|qemuarm
|-
|core-image-sato-dev
|-
|core-image-sato-sdk
|-
|core-image-minimal
|-
|core-image-minimal-dev
|-
| colspan="1" rowspan="4"|nightly-multilib
|lib32-core-image-minimal
| colspan="1" rowspan="2"|qemux86-64
|-
|lib32-core-image-sato
|-
|lib64-core-image-minimal
| colspan="1" rowspan="2"|qemux86
|-
|lib64-core-image-sato
|-
|nightly-qa-systemd
|core-image-sato
|qemux86-64
|-
| colspan="1" rowspan="10"|nightly-x86
|core-image-sato
| colspan="1" rowspan="5"|qemux86
|-
|core-image-sato-dev
|-
|core-image-sato-sdk
|-
|core-image-minimal
|-
|core-image-minimal-dev
|-
|core-image-sato
| colspan="1" rowspan="5"|qemux86-64
|-
|core-image-sato-dev
|-
|core-image-sato-sdk
|-
|core-image-minimal
|-
|core-image-minimal-dev
|-
| colspan="1" rowspan="10"|nightly-x86-64
|core-image-sato
| colspan="1" rowspan="5"|qemux86
|-
|core-image-sato-dev
|-
|core-image-sato-sdk
|-
|core-image-minimal
|-
|core-image-minimal-dev
|-
|core-image-sato
| colspan="1" rowspan="5"|qemux86-64
|-
|core-image-sato-dev
|-
|core-image-sato-sdk
|-
|core-image-minimal
|-
|core-image-minimal-dev
|}


<br>
=== Distro Machines for 1.7 ===
Here is the list of the machines that Distro testing is being run against for 1.7
<br>


{| border="1" cellpadding="1" cellspacing="1" class="article-table" style="width: 500px;"
Distro Testing is intended to reveal bugs that are distribution-specific using the yocto-autobuilder. The tests all run on identical hardware and use each updated OS.
|-
 
! scope="col"|OS Version
For detailed information on Distro testing, please see [[Distro_Testing_Plan]].
! scope="col"|Host Arch
 
! scope="col"|Status
For more information on the overall QA testing plan, please see [[QA_Master_Test_Plan]]. (Comprehensive)
|-
|Ubuntu 14.04 LTS
|64 bit
|Pass
|-
|Fedora 20
|64 bit
|Pass
|-
|OpenSuse 13.1
|64 bit
|Pass
|-
|CentOS 6.5
|64 bit
|Pass
|}

Latest revision as of 02:07, 2 August 2018

Distribution Support

Distribution Support

The poky.conf file tracks all the distros supported by the Yocto Project. (http://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta-poky/conf/distro/poky.conf) The supported, and subsequently sanity tested, distros are listed in the "SANITY_TEST_DISTROS" section in poky.conf. Each supported distro is deployed and used as a Yocto Autobuilder build worker. For more information on supported distros, please refer to the "Supported Linux Distributions" section in the Yocto Project Reference Manual.


Example of distro list in poky.conf:

SANITY_TESTED_DISTROS ?= " \
            poky-2.4 \n \
            poky-2.5 \n \
            ubuntu-15.04 \n \
            ubuntu-16.04 \n \
            ubuntu-16.10 \n \
            ubuntu-17.04 \n \
            fedora-26 \n \
            centos-7 \n \
            debian-8 \n \
            debian-9 \n \
            opensuse-42.1 \n \
            opensuse-42.2 \n \
            "

Again, the previous listing is just an example and is not meant to be a definitive reference.

How to add a new entry or additional distro information

The criteria for adding a supported distro is quite rigid. Obviously, any candidate distro must be of production quality. In other words, the distro is capable of being used in a production environment on a Yocto Project Autobuilder build worker. A compelling reason must also exist for the Yocto Project to actually use the distro on a build worker. Obscure, poorly supported, or highly customized distros are not likely to be good candidates for submission. Major stable distros (e.g. Debian, Fedora, Ubunto, Centos, and so forth.) are generally already supported. If they are not supported, they are likely on the list to become supported once sufficient criteria are met. Please be sure to check the latest supported distros beforehand to make sure the distro in question is not already supported.

If you have a compelling reason to suggest a distro for support, please submit your request to the Yocto Project mailing list for discussion. You will likely be asked to provide the reasoning behind your request. Along with your request, relevant bug reports, failed test cases, and so forth are helpful. Have them ready in advance.

If you are not already a member of the Yocto Project mailing list, you can find more information and subscription requirements here: https://lists.yoctoproject.org/listinfo/yocto.

The Yocto Project mailing list is also the right place for more general questions or issues surrounding distro support.

Distro Testing

Distro test coverage

Distro Testing is intended to reveal bugs that are distribution-specific using the yocto-autobuilder. The tests all run on identical hardware and use each updated OS.

For detailed information on Distro testing, please see Distro_Testing_Plan.

For more information on the overall QA testing plan, please see QA_Master_Test_Plan. (Comprehensive)