#19 Adding the Network Manager CLI quick doc
Closed 6 years ago by x3mboy. Opened 6 years ago by x3mboy.
Unknown source quicky  into  master

file modified
+4 -4
@@ -48,6 +48,10 @@

      File: repositories

    - Name: Configuring X Window System using the xorg.conf file

      File: configuring-x-window-system-using-the-xorg-conf-file

+   - Name: CLI

+     File: networking-cli

+   - Name: Fedora Release Life Cycle

+     File: fedora-life-cycle

    - Name: (CHECK) GRUB 2

      File: grub2

    - Name: (CHECK) Spotify
@@ -78,8 +82,6 @@

      File: edit-iptables-rules

    - Name: (FIX ME!) How to enable touchpad click

      File: enable-touchpad-click

-   - Name: (FIX ME!) Fedora Release Life Cycle

-     File: fedora-life-cycle

    - Name: (FIX ME!) Firewalld

      File: firewalld

    - Name: (FIX ME!) Flash
@@ -88,8 +90,6 @@

      File: kernel

    - Name: (FIX ME!) Mirroring

      File: mirroring

-   - Name: (FIX ME!) CLI

-     File: networking-cli

    - Name: (FIX ME!) OpenH264

      File: openh264

    - Name: (FIX ME!) PackageKit Items Not Found

file modified
+72 -262
@@ -1,329 +1,139 @@

  = Fedora Release Life Cycle

  

- '''

- 

- [IMPORTANT]

- ======

- 

- This page was automatically converted from https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle

- 

- 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}}

- ....

- 

- ======

- 

- '''

- 

- 

- The Fedora Project releases a new version of Fedora approximately every

- 6 months and provides updated packages (maintenance) to these releases

- for approximately 13 months. This allows users to "skip a release" while

- still being able to always have a system that is still receiving

- updates.

+ The Fedora Project releases a new version of Fedora approximately every 6 months and provides updated packages (maintenance) to these releases for approximately 13 months. This allows users to "skip a release" while still being able to always have a system that is still receiving updates.

  

  [[development-schedule]]

- Development Schedule

- ~~~~~~~~~~~~~~~~~~~~

+ == Development Schedule

  

- We say _approximately every 6 months_ because like many things, they

- don't always go exactly as planned. The schedule is not strictly

- time-based, but a hybrid of time and quality. The milestone releases are

- QA:Release_validation_test_plan[tested] for compliance with the

- link:Fedora_Release_Criteria[Fedora Release Criteria], and releases will

- be delayed if this is not the case.

+ We say _approximately every 6 months_ because like many things, they don't always go exactly as planned. The schedule is not strictly time-based, but a hybrid of time and quality. The milestone releases are QA:Release_validation_test_plan[tested] for compliance with the https://fedoraproject.org/wiki/Fedora_Release_Criteria[Fedora Release Criteria], and releases will be delayed if this is not the case.

  

- The schedule for the release currently under development, , is on its

- link:Releases/{{FedoraVersion[|next}}/Schedule| release schedule] page.

- Alpha, Beta, and General Availability (final) releases happen at 14:00

- UTC.

+ The schedule for the release currently under development, , is on its https://fedoraproject.org/wiki/Releases/{{FedoraVersion[|next}}/Schedule| release schedule] page. Beta, and General Availability (final) releases happen at 14:00 UTC.

  

  [[development-planning]]

- Development Planning

- ^^^^^^^^^^^^^^^^^^^^

+ === Development Planning

  

- Fedora development planning is handled by the

- link:Changes/Policy[Release Planning Process]. So-called _Changes_ are

- proposed, initially reviewed, and monitored through the development

- process by the link:Fedora_Engineering_Steering_Committee[engineering

- steering committee].

+ Fedora development planning is handled by the https://fedoraproject.org/wiki/Changes/Policy[Release Planning Process]. So-called _Changes_ are proposed, initially reviewed, and monitored through the development process by the https://fedoraproject.org/wiki/Fedora_Engineering_Steering_Committee[engineering steering committee].

  

  [[development-process]]

- Development Process

- ^^^^^^^^^^^^^^^^^^^

- 

- Fedora uses a system involving two 'development' trees.

- link:Releases/Rawhide[Rawhide] is a constantly rolling development tree.

- No releases are built directly from Rawhide. 14 weeks before the planned

- date of a Fedora release, a tree for that release is

- "link:Releases/Branched[Branched]" from the Rawhide tree. At that point

- the Rawhide tree is moving towards the release _after_ the new Branched

- release, and the pending release is stabilized in the Branched tree.

- 

- After the link:Updates_Policy#Bodhi_enabling[Bodhi enabling point], the

- Bodhi system is permanently active on the Branched release (all the way

- until it goes EOL), and requirements for updates to be marked as

- _stable_ are set out in the link:Updates_Policy[Updates Policy].

- Packages must go through the

- link:Repositories#updates-testing[_updates-testing_] repository for the

- release before entering its link:Repositories#stable[_stable_]

- repository, according to rules defined in the updates policy: these

- rules tighten gradually from Alpha through to post-GA (Final), but the

- basic process does not change.

- 

- For some time prior to a milestone (Alpha, Beta, Final) release a

- link:Milestone_freezes[freeze] is in effect which prevents packages

- moving from _updates-testing_ to _stable_ except in accordance with the

- QA:SOP_blocker_bug_process[blocker] and

- QA:SOP_freeze_exception_bug_process[freeze exception] bug policies. This

- freeze is lifted once the milestone is finished, and so packages begin

- to move from _updates-testing_ to _stable_ as normal again, until the

- next milestone's freeze date.

+ === Development Process

+ 

+ Fedora uses a system involving two 'development' trees. https://fedoraproject.org/wiki/Releases/Rawhide[Rawhide] is a constantly rolling development tree. No releases are built directly from Rawhide. Approximately 10 weeks before the planned date of a Fedora release, a tree for that release is "https://fedoraproject.org/wiki/Releases/Branched[Branched]" from the Rawhide tree. At that point the Rawhide tree is moving towards the release _after_ the new Branched release, and the pending release is stabilized in the Branched tree.

+ 

+ After the https://fedoraproject.org/wiki/Updates_Policy#Bodhi_enabling[Bodhi activation point], the Bodhi system is permanently active on the Branched release (all the way until it goes EOL), and requirements for updates to be marked as _stable_ are set out in the https://fedoraproject.org/wiki/Updates_Policy[Updates Policy]. Packages must go through the https://fedoraproject.org/wiki/Repositories#updates-testing[_updates-testing_] repository for the release before entering its https://fedoraproject.org/wiki/Repositories#stable[_stable_] repository, according to rules defined in the updates policy: these rules tighten gradually from Beta through to post-GA (Final), but the basic process does not change.

+ 

+ For some time prior to a milestone (Beta, Final) release a https://fedoraproject.org/wiki/Milestone_freezes[freeze] is in effect which prevents packages moving from _updates-testing_ to _stable_ except in accordance with the QA:SOP_blocker_bug_process[blocker] and QA:SOP_freeze_exception_bug_process[freeze exception] bug policies. This freeze is lifted once the milestone is finished, and so packages begin to move from _updates-testing_ to _stable_ as normal again, until the next milestone's freeze date.

  

  [[schedule-methodology]]

- Schedule Methodology

- ^^^^^^^^^^^^^^^^^^^^

+ === Schedule Methodology

  

- Fedora release schedules are proposed by the

- link:Fedora_Program_Management[Fedora Program Manager] and ratified by

- the link:FESCo[ Fedora Engineering Steering Committee (FESCo)], with

- input from other groups. FESCo is responsible for overseeing the

- technical direction of the Fedora distribution. A core schedule is

- created using the key tasks listed below. Detailed team schedules are

- built around these dates.

+ Fedora release schedules are proposed by the https://fedoraproject.org/wiki/Fedora_Program_Management[Fedora Program Manager] and ratified by the https://fedoraproject.org/wiki/FESCo[Fedora Engineering Steering Committee (FESCo)], with input from other groups. FESCo is responsible for overseeing the technical direction of the Fedora distribution. A core schedule is created using the key tasks listed below. Detailed team schedules are built around these dates.

+ 

+ _Note: When referring to *Beta/Final Target*, we refer to an planned date. When referring to *Beta/Final release* only, we refer to a date the release has actually happened._

  

  [cols=",,",options="header",]

  |=======================================================================

  |Task/Milestone |Start Day (Tuesdays or Thursdays) |Length

- |Planning and Development |_Branch point_ of _previous release_ plus

- *one day* |Variable

+ |Planning and Development |_Branch point_ of _previous release_ plus *one day* |Variable

  

- |link:Changes/Policy#For_Developers[Changes Checkpoint #1: Proposal

- deadline] |Tue: _Branch point_ minus *3 months* |n/a

+ |https://fedoraproject.org/wiki/Changes/Policy#For_Developers[Changes Checkpoint: Proposal deadline for Changes requiring _Mass rebuild_] |Tue: _Mass rebuild_ minus *3 weeks* |n/a

  

- |link:Releases/Branched[Branch point] |Tue: _Alpha Freeze_ minus *2

- weeks* |n/a

+ |https://fedoraproject.org/wiki/Changes/Policy#For_Developers[Changes Checkpoint: Proposal deadline for System Wide Changes] |Tue: _Mass rebuild_ minus *1 week* |n/a

  

- |link:Changes/Policy#For_Developers[Changes Checkpoint #2: Feature

- completion deadline] |Tue: *Same day* as _Branch point_ |N/A

+ |*Mass rebuild* |_Branch point_ minus *5 weeks* |Until _Branch point_

  

- |QA:SOP_compose_request[Alpha test composes] |Any time after _Branch

- point_ |Until _Alpha release candidates_

+ |https://fedoraproject.org/wiki/Changes/Policy#For_Developers[Changes Checkpoint: Proposal deadline for Self Contained Changes] |Tue: _Branch point_ minus *3 weeks* |n/a

  

- |link:Milestone_freezes[ Alpha Freeze] |Tue: _Alpha Release_ minus *2

- weeks* |QA:SOP_freeze_exception_bug_process and

- QA:SOP_blocker_bug_process in effect until _Alpha Release_

+ |*https://fedoraproject.org/wiki/Releases/Branched[Branch point]* |Tue: _Preferred Beta Release Target_ minus *5 weeks* |n/a

  

- |link:Updates_Policy#Bodhi_activation[Bodhi activation point] |Tue:

- *Same day* as _Alpha Freeze_ |Bodhi enabled and Updates_Policy

- requirements in effect until _EOL_

+ |https://fedoraproject.org/wiki/Changes/Policy#For_Developers[Changes Checkpoint: Completion deadline (testable)] |Tue: *Same day* as _Branch point_ |N/A

  

- |String Freeze |Tue: *Same day* as _Alpha Freeze_

- |link:Software_String_Freeze_Policy[Software String Freeze Policy] in

- effect until _GA Release_

+ |String Freeze |Tue: _Branch point_ plus *1 week* |https://fedoraproject.org/wiki/Software_String_Freeze_Policy[Software String Freeze Policy] in effect until _Final Release (GA)_

  

- |QA:SOP_compose_request[Alpha release candidates] |Any time after _Alpha

- Freeze_ |Until _Alpha Release_

+ |https://fedoraproject.org/wiki/Updates_Policy#Bodhi_activation[Bodhi activation point] |Tue: _Preferred Beta Target_ minus *3 weeks*, *Same day* as _Beta Freeze_ |Bodhi enabled and Updates_Policy requirements in effect until _EOL_

  

- |Alpha Go_No_Go_Meeting |*Thu* @ 13:00 E\{D,S}T: planned _Alpha Release_

- *minus five days* (repeats if No-Go) |n/a

+ |https://fedoraproject.org/wiki/Milestone_freezes[Beta Freeze] |Tue: _Preferred Beta Target_ minus *3 weeks* |QA:SOP_freeze_exception_bug_process and QA:SOP_blocker_bug_process in effect until _Beta Release_

  

- |Alpha Release |Tue: _Beta Release_ minus *5 weeks*, _Alpha Freeze_ plus

- *2 weeks* |Live until _Beta Release_

+ |https://fedoraproject.org/wiki/Changes/Policy#For_Developers[Changes Checkpoint: 100% code complete deadline ] |Tue: *Same day* as _Beta Freeze_ |N/A

  

- |QA:SOP_compose_request[Beta test composes] |Tue: _Beta Freeze_ minus *2

- weeks*, _Alpha Release_ plus *1 week* |Until _Beta release candidates_

+ |QA:SOP_compose_request[Beta release candidates] |Any time after _Beta Freeze_ |Until _Beta Release_

  

- |link:Milestone_freezes[ Beta Freeze] |Tue: _Beta Release_ minus *2

- weeks*, _Alpha Release_ plus *3 weeks*

- |QA:SOP_freeze_exception_bug_process and QA:SOP_blocker_bug_process in

- effect until _Beta Release_

+ |Beta Go_No_Go_Meeting |*Thu* @ 13:00 E\{D,S}T: planned _Preferred Beta Target_ *minus five days* (repeats if No-Go) |n/a

  

- |QA:SOP_compose_request[Beta release candidates] |Any time after _Beta

- Freeze_ |Until _Beta Release_

+ |*Preferred Beta Target* |Tue: _Preferred Final Target_ minus *5 weeks* |Live until _GA release_

  

- |link:Changes/Policy#For_Developers[Changes Checkpoint #3: 100% code

- complete deadline ] |Tue: *Same day* as _Beta Freeze_ |N/A

+ |Beta Target #1 |Tue: _Preferred Beta Target_ plus *1 week*, _Preferred Final Target_ minus *4 weeks* |n/a

  

- |Beta Go_No_Go_Meeting |*Thu* @ 13:00 E\{D,S}T: planned _Beta Release_

- *minus five days* (repeats if No-Go) |n/a

+ |https://fedoraproject.org/wiki/Milestone_freezes[Final Freeze] |Tue: _Preferred Final Target_ minus *2 weeks* |QA:SOP_freeze_exception_bug_process and QA:SOP_blocker_bug_process in effect until _Final Release (GA)_

  

- |Beta Release |Tue: _Beta Freeze_ plus *2 weeks*, _GA Release_ minus *5

- weeks* |Live until _GA release_

+ |QA:SOP_compose_request[Final release candidates] |Any time after _Final Freeze_ |Until _Final Release (GA)_

  

- |QA:SOP_compose_request[Final test composes] |Tue: _Final Freeze_ minus

- *2 weeks*, _Beta Release_ plus *1 week* |Until _Final release

- candidates_

+ |Final Go_No_Go_Meeting |*Thu* @ 13:00 E\{D,S}T: planned _Final Release (GA)_ *minus five days* (repeats if No-Go) |n/a

  

- |link:Milestone_freezes[ Final Freeze] |Tue: _Final Release_ minus *2

- weeks*, _Beta Release_ plus *3 weeks*

- |QA:SOP_freeze_exception_bug_process and QA:SOP_blocker_bug_process in

- effect until _GA Release_

+ |*Preferred Final Target* |Tue: *Primary date* from which rest of schedule derives + This date is either the Tuesday before May 1st or October 31st. |n/a

  

- |QA:SOP_compose_request[Final release candidates] |Any time after _Final

- Freeze_ |Until _GA Release_

+ |Final Target #1 |Tue: _Preferred Final Target_ plus *1 week* |n/a

  

- |Final Go_No_Go_Meeting |*Thu* @ 13:00 E\{D,S}T: planned _GA Release_

- *minus five days* (repeats if No-Go) |n/a

+ |Maintenance |Tue: *Same day* as _Final Release (GA)_ |~**13 Months**

  

- |GA Release |Tue: *Primary date* from which rest of schedule derives

- |n/a

+ |End of Life |_Final Release (GA) of next-but-one release_ plus *one month* |n/a

+ |=======================================================================

  

- |Maintenance |Tue: *Same day* as _GA release_ |~**13 Months**

+ [[development-schedule-rationale]]

+ === Development Schedule Rationale

  

- |End of Life |_GA of next-but-one release_ plus *one month* |n/a

- |=======================================================================

+ Fedora generally develops new releases over a six month period to provide a regular and predictable release schedule. The bi-annual targeted release dates are _May Day_ (May 1st) and _Halloween_ (October 31) making them easy to remember and for avoiding significant holiday breaks. Changes to this standard must be approved by the community-elected https://fedoraproject.org/wiki/FESCo[Fedora Engineering Steering Committee (FESCo)].

  

- [[steps-to-construct-a-new-schedule]]

- Steps to Construct a New Schedule

- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- 

- This is admittedly an unusual methodology, but it is fairly easy to

- generate using the the

- [https://fedorapeople.org/groups/schedule/f-%7B%7BFedoraVersionNumber%7Cnext%7D}

- TaskJuggler schedules] the Fedora Program Manager maintains.

- 

- 1.  Pick _GA release_ date (the Tuesday before May 1st or October 31st)

- * Check with Fedora PR to ensure that planned dates do not conflict with

- other ecosystem planned events (so we get the maximum press benefit)

- 2.  Work backwards using consistent spacing for freezes, composes, and

- releases for Alpha, Beta, and Final, as described above, to the _Branch

- point_

- 3.  Set the link:Changes/Policy[change proposal checkpoint/deadline]

- working backwards from the _Branch point_

- 4.  The time before the _change proposal checkpoint/deadline_ and after

- the _Branch point of the previous release_ is the time dedicated to

- _development_

- * Development time varies from from release to release based on when the

- previous release branched

- * The stabilization and testing time (from _Branch point_ until _GA

- release_) is held constant from release to release

- 

- Schedule draft is submitted to FESCo via its ticketing system for the

- approval. Initially, all milestones except "Change Checkpoint: Proposal

- submission deadline (System Wide Changes)" are scheduled as so called

- "no earlier than". Final schedule is set after the FESCo's review of

- proposed and accepted Changes proposals and "no earlier than" note is

- removed from schedule. This gives us opportunity to properly plan

- release, especially for changes with high impact on the release.

+ A six month release schedule also follows the precedence of Red Hat Linux (precursor to Fedora). Former Red Hat software engineer Havoc Pennington offers a historical perspective http://article.gmane.org/gmane.linux.redhat.fedora.advisory-board/1475/[here]. GNOME started following a time based release based on the ideas and success of Red Hat Linux and other distributions following Fedora having adopted a similar release cycle. Several other major components, including the Linux kernel, Openoffice.org, Xorg, have started following a time based release schedule. While the exact release schedules vary between these components and other upstream projects, the interactions between these components and Fedora makes a six month time based release schedule a good balance.

  

- [[development-schedule-rationale]]

- Development Schedule Rationale

- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- 

- Fedora generally develops new releases over a six month period to

- provide a regular and predictable release schedule. The bi-annual

- targeted release dates are _May Day_ (May 1st) and _Halloween_ (October

- 31) making them easy to remember and avoiding significant holiday

- breaks. Changes to this standard must be approved by the

- community-elected link:FESCo[ Fedora Engineering Steering Committee

- (FESCo)].

- 

- A six month release schedule also follows the precedence of Red Hat

- Linux (precursor to Fedora). Former Red Hat software engineer Havoc

- Pennington offers a historical perspective

- http://article.gmane.org/gmane.linux.redhat.fedora.advisory-board/1475/[here].

- GNOME started following a time based release based on the ideas and

- success of Red Hat Linux and other distributions following Fedora having

- adopted a similar release cycle. Several other major components,

- including the Linux kernel, Openoffice.org, Xorg, have started following

- a time based release schedule. While the exact release schedules vary

- between these components and other upstream projects, the interactions

- between these components and Fedora makes a six month time based release

- schedule a good balance.

- 

- Although due to how planning process and release validation works,

- Fedora is not a strictly time based distribution but uses combination of

- both time and feature based release paradigms. This way we can react to

- bigger changes aka new installed, way how we release bits (Fedora.Next)

- etc.

+ Although due to how planning process and release validation works, Fedora is not a strictly time based distribution, but uses combination of both time and feature based release paradigms. This way we can react to bigger changes aka new installed, way how we release bits (Fedora.Next) etc.

  

  [[schedule-contingency-planning]]

- Schedule Contingency Planning

- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+ === Schedule Contingency Planning

+ 

+ If _Mass rebuild_ is not completed on time, all the subsequent milestones starting with _Branch point_ are pushed back for one week until the _Mass rebuild_ is completed.

  

- If the Alpha, Beta, or Final link:Go_No_Go_Meeting[Go_No_Go_Meetings]

- result in a "No Go" determination, that milestone and subsequent

- milestones will be pushed back by one week.

+ If the Beta Go/No-Go Meeting results in a "No Go" determination, rescheduling of the milestone and subsequent milestones follows these rules:

  

- One week is added to the schedule to maintain the practice of releasing

- on Tuesdays. Tuesdays are the designated release day because they are

- good days for news coverage and the established day we synchronize our

- content with the mirrors that carry our releases. Be aware of holidays

- and of possible PR conflicts (contact Fedora PR) with the new proposed

- final date.

+ * Slip of the Beta from the Preferred Target to Target #1 does not affect Final Release (GA) date. The Final Release (GA) date remains on _Preferred Final Target_.

+ * Slip of the Beta to Target #1 adds a new _Beta Target #2_ and Final Release (GA) slips to _Final Target #1_ (and we don't yet add a _Final Target #2_).

+ * Slip of the Beta past Target #N (where N >= 2) adds a new _Beta Target #(N+1)_ and also adds a new _Final Target #N_

  

- Go/No Go meetings receive input from representatives of

- link:Fedora_Engineering_Steering_Committee[FESCo],

- link:ReleaseEngineering[Release Engineering], and link:QA[Quality

- Assurance].

+ If the Final Go_No_Go_Meeting results in a "No Go" determination, that milestone and subsequent milestones will be pushed back by one week.

+ 

+ One week is added to the schedule to maintain the practice of releasing on Tuesdays. Tuesdays are the designated release day because they are good days for news coverage and correspond to the established day we synchronize our content with the mirrors that carry our releases. Be aware of holidays and of possible PR conflicts (contact Fedora PR) with the new proposed final date.

+ 

+ Go/No Go meetings receive input from representatives of https://fedoraproject.org/wiki/Fedora_Engineering_Steering_Committee[FESCo],

+ https://fedoraproject.org/wiki/ReleaseEngineering[Release Engineering], and https://fedoraproject.org/wiki/QA[Quality Assurance].

  

  [[maintenance-schedule]]

- Maintenance Schedule

- ~~~~~~~~~~~~~~~~~~~~

+ == Maintenance Schedule

  

- We say maintained for _approximately 13 months_ because the supported

- period for releases is dependent on the date the release under

- development goes final. As a result, _Release X_ is supported until one

- month after the release of _Release X+2_.

+ We say maintained for _approximately 13 months_ because the supported period for releases is dependent on the date the release under development goes final. As a result, _Release X_ is supported until one month after the release of _Release X+2_.

  

  This translates into:

  

- * will be maintained until 1 month after the release of .

- * will be maintained until 1 month after the release of .

+ * Fedora 26 will be maintained until 1 month after the release of Fedora 28.

+ * Fedora 27 will be maintained until 1 month after the release of Fedora 29.

  

  [[maintenance-schedule-rationale]]

- Maintenance Schedule Rationale

- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+ === Maintenance Schedule Rationale

  

- Fedora is link:Objectives[ focused] on free and open source software

- link:Red_Hat_contributions[ innovations] and moves quickly. If you want

- a distribution that moves slower but has a longer lifecycle, Red Hat

- Enterprise Linux, which is derivative of Fedora or free rebuilds of that

- such as CentOS might be more suitable for you. Refer to the RHEL page

- for more details.

+ Fedora is https://fedoraproject.org/wiki/Objectives[focused] on free and open source software https://fedoraproject.org/wiki/Red_Hat_contributions[innovations] and moves quickly. If you want a distribution that moves slower but has a longer lifecycle, Red Hat Enterprise Linux, which is derivative of Fedora or free rebuilds of that such as CentOS might be more suitable for you. Refer to the RHEL page for more details.

  

- Historically, the Fedora Project has found supporting two releases plus

- Rawhide and the pre-release Branched code to be a manageable work load.

+ Historically, the Fedora Project has found that supporting two releases plus Rawhide and the pre-release Branched code to be a manageable work load.

  

  [[end-of-life-eol]]

- End of Life (EOL)

- ~~~~~~~~~~~~~~~~~

+ == End of Life (EOL)

  

- When a release reaches the point where it is no longer supported nor

- updates are created for it, then it is considered _End of Life_ (EOL).

- Branches for new packages in the SCM are not allowed for distribution X

- after the Fedora X+2 release and new builds are no longer allowed.

+ When a release reaches the point where it is no longer supported when no updates are created for it, then it is considered _End of Life_ (EOL). Branches for new packages in the SCM are not allowed for distribution X after the Fedora X+2 release and new builds are no longer allowed.

  

- The tasks performed at EOL are documented in the

- link:End_of_life_SOP[End of life SOP].

+ The tasks performed at EOL are documented in the https://fedoraproject.org/wiki/End_of_life_SOP[End of life SOP].

  

  [[additional-release-schedule-information]]

- Additional Release Schedule Information

- ---------------------------------------

+ == Additional Release Schedule Information

  

  * Overview of Releases, including currently supported releases

- * link:End_of_life[ Unsupported Releases]

- * link:Releases/HistoricalSchedules[ Historical Release Information]

- 

- Category:Distribution

- '''

+ * https://fedoraproject.org/wiki/End_of_life[Unsupported Releases]

+ * https://fedoraproject.org/wiki/Releases/HistoricalSchedules[Historical Release Information]

  

- 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.

+ 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.

file modified
+256 -22
@@ -1,39 +1,273 @@

  = CLI

  

- '''

+ [[description]]

+ == Description

  

- [IMPORTANT]

- ======

+ `nmcli` is a tool that allows NetworkManager management from command line.

  

- This page was automatically converted from https://fedoraproject.org/wiki/Networking/CLI

+ [[networkmanager-status]]

+ == NetworkManager status

  

- It is probably

+ Display overall status of NetworkManager

  

- * Badly formatted

- * Missing graphics and tables that do not convert well from mediawiki

- * Out-of-date

- * In need of other love

+ ----

+ nmcli general status

+ ----

  

+ Display active connections

  

- Pull requests accepted at https://pagure.io/fedora-docs/quick-docs

+ ----

+ nmcli connection show --active

+ ----

  

- Once you've fixed this page, remove this notice, and update

- `_topic_map.yml`.

+ Display all configured connections

  

- Once the document is live, go to the original wiki page and replace its text

- with the following macro:

+ ----

+ nmcli connection show configured

+ ----

  

- ....

- {{#fedoradocs: https://docs.fedoraproject.org/whatever-the-of-this-new-page}}

- ....

+ [[connectdisconnect-to-an-already-configured-connection]]

+ == Connect/disconnect to an already configured connection

  

- ======

+ Connect to a configured connection by name

  

- '''

+ ----

+ nmcli connection up id <connection name>

+ ----

  

+ Disconnection by name

  

+ ----

+ nmcli connection down id <connection name>

+ ----

  

- '''

+ [[wifi]]

+ == Wifi

+ 

+ Get Wifi status

+ 

+ ----

+ nmcli radio wifi

+ ----

+ 

+ Turn wifi on or off

+ 

+ ----

+ nmcli radio wifi <on|off>

+ ----

+ 

+ List available access points(AP) to connect to

+ 

+ ----

+ nmcli device wifi list

+ ----

+ 

+ Refresh previous list

+ 

+ ----

+ nmcli device wifi rescan

+ ----

+ 

+ Create a new connection to an open AP

+ 

+ ----

+ nmcli device wifi connect <SSID|BSSID>

+ ----

+ 

+ Create a new connection to a password protected AP

+ 

+ ----

+ nmcli device wifi connect <SSID|BSSID> password <password>

+ ----

+ 

+ [[network-interfaces]]

+ == Network interfaces

+ 

+ List available devices and their status

+ 

+ ----

+ nmcli device status

+ ----

+ 

+ Disconnect an interface

+ 

+ ----

+ nmcli device disconnect iface <interface>

+ ----

+ 

+ [[create-or-modify-a-connection]]

+ == Create or modify a connection

+ 

+ To create a new connection using an interactive editor

+ 

+ ----

+ nmcli connection edit con-name <name of new connection>

+ ----

+ 

+ To edit an already existing connection using an interactive editor

+ 

+ ----

+ nmcli connection edit <connection name>

+ ----

+ 

+ [[exampletutorial]]

+ === Example/Tutorial

+ 

+ Let's create a new connection

+ 

+ ----

+ nmcli connection edit con-name <name of new connection>

+ ----

+ 

+ It will ask us to define a connection type

+ 

+ ----

+ Valid connection types: 802-3-ethernet (ethernet), 802-11-wireless (wifi), wimax, gsm, cdma, infiniband, adsl, bluetooth, vpn, 802-11-olpc-mesh (olpc-mesh), vlan, bond, team, bridge, bond-slave, team-slave, bridge-slave

+ Enter connection type: 

+ ----

+ 

+ In this example we will use ethernet

+ 

+ ----

+ Enter connection type: ethernet

+ ----

+ 

+ Next this will appear, note that "nmcli>" is a prompt and that it lists the main settings available

+ 

+ ----

+ ===| nmcli interactive connection editor |===

+ 

+ Adding a new '802-3-ethernet' connection

+ 

+ Type 'help' or '?' for available commands.

+ Type 'describe [<setting>.<prop>]' for detailed property description.

+ 

+ You may edit the following settings: connection, 802-3-ethernet (ethernet), 802-1x, ipv4, ipv6

+ nmcli> 

+ ----

+ 

+ We will edit the setting "ipv4"

+ 

+ ----

+ nmcli> goto ipv4

+ ----

+ 

+ Note that after this our promt has changed to this to indicate that we are currently editing the "ipv4" setting

+ 

+ ----

+ nmcli ipv4>

+ ----

+ 

+ List available properties under the setting "ipv4" and describe the property "method"

+ 

+ 

+ ----

+ nmcli ipv4> describe

+ 

+ Available properties: method, dns, dns-search, addresses, routes, ignore-auto-routes, ignore-auto-dns, dhcp-client-id, dhcp-send-hostname, dhcp-hostname, never-default, may-fail

+ Property name?

+ 

+ Property name? method

+ ----

+ 

+ Let's set property "method" to "auto"

+ 

+ 

+ ----

+ nmcli ipv4> set method auto

+ ----

+ 

+ Now that we have finished editing the "ipv4" setting let's go back to the main level. Execute the following command until the prompt looks like this "nmcli>"

+ 

+ ----

+ nmcli> back

+ ----

+ 

+ If you need to list again the main settings use the "goto" command without any arguments. After that just press enter and ignore the error.

+ 

+ ----

+ nmcli> goto

+ 

+ Available settings: connection, 802-3-ethernet (ethernet), 802-1x, ipv4, ipv6

+ Setting name?

+ ----

+ 

+ It is possible to set a value for a property directly from the main level

+ 

+ ----

+ nmcli> set <setting>.<property> <value>

+ ----

+ 

+ For example:

+ 

+ ----

+ nmcli> set connection.autoconnect TRUE

+ 

+ nmcli> set connection.interface-name <interface name this connection is bound to>

+ 

+ nmcli> set ethernet.cloned-mac-address <Spoofed MAC address>

+ ----

+ 

+ Finally check the connection details, save and exit

+ 

+ ----

+ nmcli> print

+ 

+ nmcli> save

+ 

+ nmcli> quit

+ ----

+ 

+ [[manually-editing]]

+ === Manually editing

+ 

+ To manually edit a ifcfg connection configuration open or create with a text editor the configuration file of the connection located in `/etc/sysconfig/network-scripts/ifcfg-`

+ 

+ A description of most common configuration options is available at: http://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-networkscripts-interfaces.html

+ 

+ To modify a connection password open with a text editor and edit the file "keys-" located in "/etc/sysconfig/network-scripts/". The password is stored in plain text. For example

+ 

+ ----

+ $ cat /etc/sysconfig/network-scripts/keys-<connection name>

+ WPA_PSK='password'

+ ----

+ 

+ Or if using keyfile, simply edit the connection file located inside `/etc/NetworkManager/system-connections/`

+ 

+ Finally save the files and to apply changes to an already active connection execute

+ 

+ ----

+ nmcli connection up id <connection name>

+ ----

+ 

+ [[delete-a-connection-configuration]]

+ == Delete a connection configuration

+ 

+ Delete the connection

+ 

+ ----

+ nmcli connection delete id <connection name>

+ ----

+ 

+ Please note this also deactivates the connection.

+ 

+ [[documentation-for-networkmanager-command-line-interface-nmcli]]

+ == Documentation for NetworkManager Command Line Interface nmcli

+ 

+ The primary reference for nmcli are the manual pages nmcli and nmcli-examples. For a quick reference, the user can type `nmcli

+ [help]` to print the supported options and commands. The help parameter can also be used to obtain a more detailed description for the

+ individual commands. For example `nmcli connection help` and `nmcli connection add help` show a description for the possible connection operations and for how to add connections, respectively.

+ 

+ The newest version of the manual page can be found on https://developer.gnome.org/NetworkManager/unstable/nmcli.html[nmcli] and https://developer.gnome.org/NetworkManager/unstable/nmcli-examples.html[nmcli-examples].

+ 

+ [[notes]]

+ === Notes

+ 

+ nmcli maybe contain some bugs and lack some features graphical tools for NetworkManager have.

+ 

+ To see all available options for your version of nmcli

+ 

+ ----

+ info nmcli

+ ----

  

- 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.

Moving the Network CLI doc from wiki to the docs
#MadeInDocsFAD

1 new commit added

  • Fixing _topic_map.yml file
6 years ago

1 new commit added

  • Fixing networking-cli.adoc multiple lines paragraphs
6 years ago

Can we make "Name: CLI" be something more descriptive?

1 new commit added

  • Adding the Fedora Life Cycle document
6 years ago

Can we make "Name: CLI" be something more descriptive?

Sure, also the Title "CLI" is not to helpful. It should be "Network Manager CLI 'nmcli'"
Does it make sense?

Pull-Request has been closed by x3mboy

6 years ago

How about "NetworkManager Command Line Interface" or "How to use the NetworkManager Command Line Interface, nmtool"

How about "NetworkManager Command Line Interface" or "How to use the NetworkManager Command Line Interface, nmtool"

That defenitely sounds better.