Added metadata, moved partials into main text body.
This commit is contained in:
parent
14818161db
commit
d0350f1159
13 changed files with 383 additions and 29 deletions
|
@ -79,9 +79,10 @@
|
|||
** xref:screenrecorder-apps-comparison.adoc[Screen Recorder – Comparison of Applications in Fedora and How to Use them]
|
||||
** xref:jitsi-getting-started.adoc[Jitsi – Getting Started]
|
||||
|
||||
** NVIDIA
|
||||
*** xref:bumblebee.adoc[NVIDIA Optimus Bumblebee]
|
||||
*** xref:how-to-set-nvidia-as-primary-gpu-on-optimus-based-laptops.adoc[How to Set NVIDIA as Primary GPU on Optimus-based Laptops]
|
||||
// ** NVIDIA
|
||||
// Outdated, no longer required.
|
||||
//*** xref:bumblebee.adoc[NVIDIA Optimus Bumblebee]
|
||||
** xref:how-to-set-nvidia-as-primary-gpu-on-optimus-based-laptops.adoc[How to Set NVIDIA as Primary GPU on Optimus-based Laptops]
|
||||
|
||||
* xref:selinux-getting-started.adoc[SELinux]
|
||||
** xref:selinux-changing-states-and-modes.adoc[Changing SELinux states and modes]
|
||||
|
|
|
@ -1,10 +1,20 @@
|
|||
= Anaconda
|
||||
Ankur Sinha ; Frank Sträter ; Timothée Ravier
|
||||
:revnumber: unspecified
|
||||
:revdate: 2022-01-12
|
||||
:category: Installation
|
||||
:tags: How-to, Anaconda
|
||||
//:page-aliases: anaconda/anaconda.adoc
|
||||
|
||||
|
||||
[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]
|
||||
|
||||
[abstract]
|
||||
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.
|
||||
|
|
|
@ -1,4 +1,12 @@
|
|||
= Anaconda Logging
|
||||
yohaan vakil; Frank Sträter ; Ben Cotton
|
||||
:revnumber: unspecified
|
||||
:revdate: 2022-05-04
|
||||
:category: Installation
|
||||
:tags: How-to, Troubleshooting, Anaconda
|
||||
//:page-aliases: anaconda/anaconda_logging.adoc
|
||||
|
||||
|
||||
|
||||
== Introduction
|
||||
Anaconda tracks all of its activities in logs.
|
||||
|
|
|
@ -1,9 +0,0 @@
|
|||
include::{partialsdir}/attributes.adoc[]
|
||||
|
||||
= NVIDIA Optimus Bumblebee
|
||||
|
||||
include::{partialsdir}/3rdparty-message.adoc[]
|
||||
|
||||
With recent releases of Xorg and the NVIDIA driver, Bumblebee is no longer required.
|
||||
Please refer to the https://rpmfusion.org/Howto/NVIDIA[RPM Fusion NVIDIA documentation] to see how you can get the best out of your NVIDIA Optimus hardware on Fedora.
|
||||
|
|
@ -1,21 +1,84 @@
|
|||
ifdef::context[:parent-context: {context}]
|
||||
:context: changing-hostname
|
||||
:imagesdir: ./images
|
||||
|
||||
[[changing-hostname]]
|
||||
= Changing Hostname
|
||||
Peter Lilley; Peter Boy (pboy)
|
||||
:revnumber: F36 onwards
|
||||
:revdate: 2021-01-30
|
||||
:category: Administration
|
||||
:tags: How-to, Network, Hostname
|
||||
//:page-aliases:
|
||||
|
||||
[abstract]
|
||||
A new installation of Fedora will assign a default hostname. You may wish to set a different name for easier identification of your host(s) on a network.
|
||||
|
||||
|
||||
There are three variations of a hostname in a Fedora system:
|
||||
|
||||
. A **static** name is used by default at system bootup. This name will typically be short and contain only letters, numbers and dashes.
|
||||
. An optional **pretty** name can be longer and more descriptive, like "Emily's 2nd dev laptop".
|
||||
. A **transient** name is assigned by the network. It is probably going to be the same as the static name, unless there are multiple hosts with the same static name on the local network. For example, if there are two hosts both with static name "localhost", one machine may be assigned a transient name of "localhost-1".
|
||||
|
||||
include::{partialsdir}/proc_displaying-current-hostname.adoc[leveloffset=0]
|
||||
== Displaying your current hostname
|
||||
|
||||
include::{partialsdir}/proc_changing-the-hostname.adoc[leveloffset=0]
|
||||
For Fedora Workstation, using the default GNOME desktop, open the Settings application and choose About.
|
||||
|
||||
image::displaying-current-hostname-1.png[GNOME Settings - About]
|
||||
|
||||
To see the hostname from the command line, use the command `hostnamectl` with no options. The example output below shows the static and transient hostnames. Your output may be slightly different depending on which hostname types have been set.
|
||||
|
||||
....
|
||||
Static hostname: localhost.localdomain
|
||||
Transient hostname: fedora
|
||||
Icon name: computer-laptop
|
||||
Chassis: laptop
|
||||
Machine ID: 15fc9e69d007013025f31bc5272c4ed1
|
||||
Boot ID: 41ac938872bae052294bcb277241ac93
|
||||
Operating System: Fedora 33 (Workstation Edition)
|
||||
CPE OS Name: cpe:/o:fedoraproject:fedora:33
|
||||
Kernel: Linux 5.10.10-200.fc33.x86_64
|
||||
Architecture: x86-64
|
||||
....
|
||||
|
||||
To see the current static, transient or pretty hostname, you can use the `hostnamectl` command with options, such as:
|
||||
|
||||
....
|
||||
hostnamectl --static
|
||||
hostnamectl --transient
|
||||
hostnamectl --pretty
|
||||
....
|
||||
|
||||
|
||||
|
||||
== Changing the hostname
|
||||
|
||||
For Fedora Workstation, using the default GNOME desktop, open the Settings application and choose About.
|
||||
|
||||
image::changing-hostname-1.png[GNOME Settings - About]
|
||||
|
||||
You can replace the value in the Device name field with the name of your choosing. The effect of this field is as follows:
|
||||
|
||||
* If you use a name that is shorter, contains only lowercase letters, numbers and/or dashes ("-"), this will set the host's static name, and the pretty name will be left blank.
|
||||
* If you enter a name that is more descriptive, contains mixed-case and other types of characters, this will set the pretty name, and a static name will be derived from that automatically.
|
||||
|
||||
You can see the effect of the change by using the `hostnamectl` command again:
|
||||
|
||||
....
|
||||
Static hostname: emilys-2nd-dev-laptop
|
||||
Pretty hostname: Emily's 2nd dev laptop
|
||||
Icon name: computer-laptop
|
||||
Chassis: laptop
|
||||
Machine ID: 15fc9e69d007013025f31bc5272c4ed1
|
||||
Boot ID: 41ac938872bae052294bcb277241ac93
|
||||
Operating System: Fedora 33 (Workstation Edition)
|
||||
CPE OS Name: cpe:/o:fedoraproject:fedora:33
|
||||
Kernel: Linux 5.10.10-200.fc33.x86_64
|
||||
Architecture: x86-64
|
||||
....
|
||||
|
||||
In the previous example, "Emily's 2nd dev laptop" was entered via the Settings app, and the static hostname "emilys-2nd-dev-laptop" was set automatically.
|
||||
|
||||
Hostnames can also be set at the command line with the `hostnamectl set-hostname` command. For example:
|
||||
|
||||
....
|
||||
sudo hostnamectl set-hostname --pretty "Emily's 2nd dev laptop"
|
||||
sudo hostnamectl set-hostname --static emily-dev-2
|
||||
....
|
||||
|
||||
ifdef::parent-context[:context: {parent-context}]
|
||||
ifndef::parent-context[:!context:]
|
||||
|
|
|
@ -1,15 +1,296 @@
|
|||
ifdef::context[:parent-context: {context}]
|
||||
:context: configuring-ip-networking-with-nmcli
|
||||
[id='Configuring-networking-with-nmcli']
|
||||
= Configuring IP networking with nmcli
|
||||
Richard Gregory; Peter Boy (pboy)
|
||||
:revnumber: F36 onwards
|
||||
:revdate: 2023-08-28
|
||||
:category: Administration
|
||||
:tags: How-to, Network, NetworkManager
|
||||
//:page-aliases:
|
||||
|
||||
|
||||
[abstract]
|
||||
How to configure networking using the [application]*nmcli* (NetworkManager Command Line Interface) command-line utility.
|
||||
|
||||
include::{partialsdir}/con_Getting-started-with-nmcli.adoc[leveloffset=+1]
|
||||
|
||||
include::{partialsdir}/proc_Brief-selection-of-nmcli-examples.adoc[leveloffset=+1]
|
||||
== Getting started with nmcli
|
||||
|
||||
include::{partialsdir}/con_Understanding-the-nmcli-options.adoc[leveloffset=+1]
|
||||
The [application]*nmcli* (NetworkManager Command Line Interface) command-line utility is used for controlling NetworkManager and reporting network status. It can be utilized as a replacement for [application]*nm-applet* or other graphical clients. [application]*nmcli* is used to create, display, edit, delete, activate, and deactivate network connections, as well as control and display network device status.
|
||||
|
||||
The [application]*nmcli* utility can be used by both users and scripts for controlling [application]*NetworkManager*:
|
||||
|
||||
* For servers, headless machines, and terminals, [application]*nmcli* can be used to control [application]*NetworkManager* directly, without GUI, including creating, editing, starting and stopping network connections and viewing network status.
|
||||
|
||||
* For scripts, [application]*nmcli* supports a terse output format which is better suited for script processing. It is a way to integrate network configuration instead of managing network connections manually.
|
||||
|
||||
The basic format of a [application]*nmcli* command is as follows:
|
||||
|
||||
[literal,subs="+quotes,verbatim"]
|
||||
....
|
||||
nmcli [OPTIONS] OBJECT { COMMAND | help }
|
||||
....
|
||||
|
||||
where OBJECT can be one of the following options: `general`, `networking`, `radio`, `connection`, `device`, `agent`, and `monitor`. You can use any prefix of these options in your commands. For example, [command]`nmcli con help`, [command]`nmcli c help`, [command]`nmcli connection help` generate the same output.
|
||||
|
||||
Some of useful optional OPTIONS to get started are:
|
||||
|
||||
-t, terse::
|
||||
+
|
||||
This mode can be used for computer script processing as you can see a terse output displaying only the values.
|
||||
+
|
||||
[[ex-Viewing_a_terse_output_for_scripts]]
|
||||
.Viewing a terse output
|
||||
====
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli -t device`
|
||||
ens3:ethernet:connected:Profile 1
|
||||
lo:loopback:unmanaged:
|
||||
....
|
||||
====
|
||||
|
||||
-f, field::
|
||||
+
|
||||
This option specifies what fields can be displayed in output. For example, NAME,UUID,TYPE,AUTOCONNECT,ACTIVE,DEVICE,STATE. You can use one or more fields. If you want to use more, do not use space after comma to separate the fields.
|
||||
+
|
||||
[[ex-Specifying_Fields_in_the_output]]
|
||||
.Specifying Fields in the output
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli -f DEVICE,TYPE device`
|
||||
DEVICE TYPE
|
||||
ens3 ethernet
|
||||
lo loopback
|
||||
....
|
||||
|
||||
or even better for scripting:
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli -t -f DEVICE,TYPE device`
|
||||
ens3:ethernet
|
||||
lo:loopback
|
||||
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
-p, pretty::
|
||||
+
|
||||
This option causes [application]*nmcli* to produce human-readable output. For example, values are aligned and headers are printed.
|
||||
+
|
||||
[[ex-Viewing_an_output_in_pretty_Mode]]
|
||||
.Viewing an output in pretty mode
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli -p device`
|
||||
=====================
|
||||
Status of devices
|
||||
=====================
|
||||
DEVICE TYPE STATE CONNECTION
|
||||
--------------------------------------------------------------
|
||||
ens3 ethernet connected Profile 1
|
||||
lo loopback unmanaged --
|
||||
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
-h, help::
|
||||
+
|
||||
Prints help information.
|
||||
|
||||
The [application]*nmcli* tool has some built-in context-sensitive help. To list the available options and object names:
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ [command]`nmcli help`
|
||||
....
|
||||
|
||||
To list available actions related to a specified object:
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ [command]`nmcli _object_ help`
|
||||
....
|
||||
|
||||
For example,
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ [command]`nmcli c help`
|
||||
....
|
||||
|
||||
[discrete]
|
||||
=== Additional resources
|
||||
* link:++https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/networking_guide/getting_started_with_networkmanager++[Getting Started With NetworkManager]
|
||||
|
||||
|
||||
|
||||
== Brief Selection of nmcli Examples
|
||||
|
||||
This section provides a brief selection of [application]*nmcli* examples.
|
||||
|
||||
[discrete]
|
||||
=== Prerequisites
|
||||
<<Getting-started-with-nmcli>>
|
||||
|
||||
|
||||
.Checking the overall status of NetworkManager
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli general status`
|
||||
STATE CONNECTIVITY WIFI-HW WIFI WWAN-HW WWAN
|
||||
connected full enabled enabled enabled enabled
|
||||
....
|
||||
|
||||
In terse mode:
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli -t -f STATE general`
|
||||
connected
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
.Viewing NetworkManager logging status
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim"]
|
||||
....
|
||||
~]$ [command]`nmcli general logging`
|
||||
LEVEL DOMAINS
|
||||
INFO PLATFORM,RFKILL,ETHER,WIFI,BT,MB,DHCP4,DHCP6,PPP,WIFI_SCAN,IP4,IP6,A
|
||||
UTOIP4,DNS,VPN,SHARING,SUPPLICANT,AGENTS,SETTINGS,SUSPEND,CORE,DEVICE,OLPC,
|
||||
WIMAX,INFINIBAND,FIREWALL,ADSL,BOND,VLAN,BRIDGE,DBUS_PROPS,TEAM,CONCHECK,DC
|
||||
B,DISPATCH
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
.Viewing all connections
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli connection show`
|
||||
NAME UUID TYPE DEVICE
|
||||
Profile 1 db1060e9-c164-476f-b2b5-caec62dc1b05 ethernet ens3
|
||||
ens3 aaf6eb56-73e5-4746-9037-eed42caa8a65 ethernet --
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
.Viewing only currently active connections
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli connection show --active`
|
||||
NAME UUID TYPE DEVICE
|
||||
Profile 1 db1060e9-c164-476f-b2b5-caec62dc1b05 ethernet ens3
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
.Viewing only devices recognized by [application]*NetworkManager* and their state
|
||||
====
|
||||
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
~]$ pass:attributes[{blank}][command]`nmcli device status`
|
||||
DEVICE TYPE STATE CONNECTION
|
||||
ens3 ethernet connected Profile 1
|
||||
lo loopback unmanaged --
|
||||
....
|
||||
|
||||
====
|
||||
|
||||
You can also use the following abbreviations of the [application]*nmcli* commands:
|
||||
|
||||
[[tabl-nmcli_examples]]
|
||||
.Abbreviations of some nmcli commands
|
||||
|
||||
[options="header"]
|
||||
|===
|
||||
|nmcli command|abbreviation
|
||||
|nmcli general status|nmcli g
|
||||
|nmcli general logging|nmcli g log
|
||||
|nmcli connection show|nmcli con show
|
||||
|nmcli connection show --active|nmcli con show -a
|
||||
|nmcli device status|nmcli dev
|
||||
|===
|
||||
|
||||
[discrete]
|
||||
=== Additional resources
|
||||
|
||||
* For more examples, see the
|
||||
[citetitle]_pass:attributes[{blank}]*nmcli-examples*(5)_
|
||||
man page.
|
||||
|
||||
|
||||
|
||||
|
||||
== The nmcli options
|
||||
|
||||
Following are some of the important [application]*nmcli* property options:
|
||||
|
||||
|
||||
[option]`connection.type`::
|
||||
+
|
||||
A connection type. Allowed values are: adsl, bond, bond-slave, bridge, bridge-slave, bluetooth, cdma, ethernet, gsm, infiniband, olpc-mesh, team, team-slave, vlan, wifi, wimax. Each connection type has type-specific command options. For example:
|
||||
+
|
||||
** A `gsm` connection requires the access point name specified in an [option]`apn`.
|
||||
+
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
nmcli c add connection.type gsm apn pass:quotes[_access_point_name_]
|
||||
....
|
||||
+
|
||||
** A `wifi` device requires the service set identifier specified in a [option]`ssid`.
|
||||
+
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
nmcli c add connection.type wifi ssid
|
||||
_My identifier_
|
||||
....
|
||||
|
||||
You can see the `TYPE_SPECIFIC_OPTIONS` list in the [citetitle]_pass:attributes[{blank}]*nmcli*(1)_ man page.
|
||||
|
||||
[option]`connection.interface-name`::
|
||||
+
|
||||
A device name relevant for the connection.
|
||||
+
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
nmcli con add connection.interface-name _eth0_ type _ethernet_
|
||||
....
|
||||
|
||||
[option]`connection.id`::
|
||||
+
|
||||
A name used for the connection profile. If you do not specify a connection name, one will be generated as follows:
|
||||
+
|
||||
[literal,subs="+quotes,verbatim,macros"]
|
||||
....
|
||||
_connection.type -connection.interface-name_
|
||||
....
|
||||
+
|
||||
The [option]`connection.id` is the name of a _connection profile_ and should not be confused with the interface name which denotes a device (`wlan0`, `ens3`, `em1`). However, users can name the connections after interfaces, but they are not the same thing. There can be multiple connection profiles available for a device. This is particularly useful for mobile devices or when switching a network cable back and forth between different devices. Rather than edit the configuration, create different profiles and apply them to the interface as needed. The [option]`id` option also refers to the connection profile name.
|
||||
|
||||
The most important options for [application]*nmcli* commands such as `show`, `up`, `down` are:
|
||||
|
||||
[option]`id`::
|
||||
+
|
||||
An identification string assigned by the user to a connection profile. Id can be used in nmcli connection commands to identify a connection. The NAME field in the command output always denotes the connection id. It refers to the same connection profile name that the con-name does.
|
||||
|
||||
[option]`uuid`::
|
||||
+
|
||||
A unique identification string assigned by the system to a connection profile. The `uuid` can be used in [command]`nmcli connection` commands to identify a connection.
|
||||
|
||||
[discrete]
|
||||
=== Additional resources
|
||||
|
||||
* See the comprehensive list in the [citetitle]_pass:attributes[{blank}]*nmcli*(1)_ man page.
|
||||
|
||||
ifdef::parent-context[:context: {parent-context}]
|
||||
ifndef::parent-context[:!context:]
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue