Compare commits
12 commits
| Author | SHA1 | Date | |
|---|---|---|---|
| a598b0faf1 | |||
| 369341856a | |||
| 44eb8393a7 | |||
| dc85f88423 | |||
|
a6c07962ff | ||
| 57de0e199d | |||
| db7500e547 | |||
|
6113761b1f | ||
| cdca2440f4 | |||
| 2d9b1e03c9 | |||
|
|
79f57c29d2 | ||
|
|
1fe8d93f1e |
118 changed files with 474 additions and 1455 deletions
12
.gitignore
vendored
12
.gitignore
vendored
|
|
@ -1,9 +1,3 @@
|
|||
## AsciiBinder-specific ignores
|
||||
_preview
|
||||
_package
|
||||
*.swp
|
||||
diag-*.png
|
||||
diag-*.png.cache
|
||||
|
||||
## Project-specific ignores
|
||||
|
||||
build
|
||||
cache
|
||||
public
|
||||
|
|
|
|||
|
|
@ -1,26 +0,0 @@
|
|||
|
||||
:experimental:
|
||||
|
||||
== We want feedback
|
||||
indexterm:[feedback,contact information for this manual]
|
||||
If you find errors or have suggestions for improvement, we want your advice. Submit a report in Bugzilla against the product `{PRODUCT}` and the component `{BOOKID}`. The following link automatically loads this information for you: {BZURL}.
|
||||
|
||||
In Bugzilla:
|
||||
|
||||
. Provide a short summary of the error or your suggestion in the `Summary` field.
|
||||
|
||||
. Copy the following template into the `Description` field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits.
|
||||
+
|
||||
[subs="quotes"]
|
||||
----
|
||||
Document URL:
|
||||
|
||||
Section number and name:
|
||||
|
||||
Error or suggestion:
|
||||
|
||||
Additional information:
|
||||
|
||||
----
|
||||
|
||||
. Click the btn:[Submit Bug] button.
|
||||
43
README.md
43
README.md
|
|
@ -1,22 +1,43 @@
|
|||
# Fedora System Administrators Guide
|
||||
# Fedora Modularity Docs
|
||||
|
||||
This is the content repository for the Fedora System Administrators Guide.
|
||||
Please report Issues and submit Pull Requests for **Content Fixes** here.
|
||||
Never done a pull request (or "PR")? Here's the [Pagure documentation for
|
||||
Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html).
|
||||
|
||||
Please report Issues and submit Pull Requests for **Content Fixes** here. General appearance issues and publishing issues should be reported against the [publisher](https://pagure.io/fedora-docs/docs-fp-o).
|
||||
|
||||
## How to edit this document
|
||||
General appearance issues and publishing issues should be reported against
|
||||
the [publishing software](https://pagure.io/fedora-docs/docs-fp-o).
|
||||
|
||||
This document is coded in AsciiDoc. The content is in the en-US directory. There is a shared entity file in the en-US directory. Do not edit the content in the Common_Content directory.
|
||||
## How to edit these documents
|
||||
|
||||
## Testing your changes locally
|
||||
All of this is written in AsciiDoc. It's a simple mostly-plain-text
|
||||
markup language. You may want to look at:
|
||||
|
||||
To test your changes, first install `asciibinder`
|
||||
|
||||
$ gem install ascii_binder
|
||||
* [AsciiDoc Syntax Quick Reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/)
|
||||
* [AsciiDoc Writer’s Guide](http://asciidoctor.org/docs/asciidoc-writers-guide/)
|
||||
* [Antora Documentation](https://docs.antora.org/antora/1.0/page/)
|
||||
|
||||
To build your changes, from the root directory:
|
||||
|
||||
## Local preview
|
||||
|
||||
This repo includes scripts to build and preview the contents of this repository.
|
||||
|
||||
**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.
|
||||
|
||||
Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions.
|
||||
|
||||
To build and preview the site, run:
|
||||
|
||||
```
|
||||
$ asciibinder package
|
||||
$ firefox _package/main/index.html
|
||||
$ ./build.sh && ./preview.sh
|
||||
```
|
||||
|
||||
The result will be available at http://localhost:8080
|
||||
|
||||
### Installing docker on Fedora
|
||||
|
||||
```
|
||||
$ sudo dnf install docker
|
||||
$ sudo systemctl start docker && sudo systemctl enable docker
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,17 +0,0 @@
|
|||
---
|
||||
fedora:
|
||||
name: Fedora System Administrators Guide
|
||||
author: Fedora Documentation Project <docs@lists.fedoraproject.org>
|
||||
site: main
|
||||
site_name: Home
|
||||
site_url: https://docs.fedoraproject.org/
|
||||
branches:
|
||||
master:
|
||||
name: Rawhide
|
||||
dir: rawhide
|
||||
f26:
|
||||
name: 26
|
||||
dir: f26
|
||||
f27:
|
||||
name: 27
|
||||
dir: f27
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 5.3 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.5 KiB |
|
|
@ -1,61 +0,0 @@
|
|||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<!-- Created with Inkscape (http://www.inkscape.org/) -->
|
||||
|
||||
<svg
|
||||
xmlns:svg="http://www.w3.org/2000/svg"
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
version="1.0"
|
||||
width="220"
|
||||
height="70"
|
||||
id="svg6180">
|
||||
<defs
|
||||
id="defs6182" />
|
||||
<g
|
||||
transform="translate(-266.55899,-345.34488)"
|
||||
id="layer1">
|
||||
<path
|
||||
d="m 316.7736,397.581 c 0,0 0,0 -20.53889,0 0.3327,4.45245 3.92157,7.77609 8.70715,7.77609 3.38983,0 6.31456,-1.39616 8.64094,-3.65507 0.46553,-0.46679 0.99726,-0.59962 1.59519,-0.59962 0.79781,0 1.59561,0.39932 2.12692,1.06388 0.3327,0.46553 0.53216,0.99726 0.53216,1.52857 0,0.73118 -0.3327,1.52857 -0.93106,2.12734 -2.7919,2.99052 -7.51086,4.98503 -12.16403,4.98503 -8.44149,0 -15.22074,-6.77967 -15.22074,-15.22158 0,-8.44149 6.58022,-15.22074 15.02171,-15.22074 8.37529,0 14.62323,6.51317 14.62323,15.08749 0,1.26418 -1.12924,2.12861 -2.39258,2.12861 z m -12.23065,-11.76512 c -4.45329,0 -7.51085,2.92473 -8.17499,7.17731 10.03626,0 16.35083,0 16.35083,0 -0.59836,-4.05355 -3.78874,-7.17731 -8.17584,-7.17731 z"
|
||||
id="path11"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 375.46344,410.80807 c -8.44106,0 -15.22074,-6.77968 -15.22074,-15.22159 0,-8.44149 6.77968,-15.22074 15.22074,-15.22074 8.44234,0 15.22159,6.77925 15.22159,15.22074 -4.2e-4,8.44149 -6.77968,15.22159 -15.22159,15.22159 z m 0,-24.65992 c -5.31688,0 -8.77377,4.25427 -8.77377,9.43833 0,5.18364 3.45689,9.43833 8.77377,9.43833 5.31731,0 8.77504,-4.25469 8.77504,-9.43833 -4.2e-4,-5.18406 -3.45773,-9.43833 -8.77504,-9.43833 z"
|
||||
id="path13"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 412.66183,380.36574 c -4.45963,0 -7.40966,1.319 -10.01391,4.62956 l -0.24036,-1.53995 0,0 c -0.20198,-1.60743 -1.57326,-2.84926 -3.23382,-2.84926 -1.80139,0 -3.26206,1.459 -3.26206,3.26081 0,0.003 0,0.005 0,0.008 l 0,0 0,0.003 0,0 0,23.40712 c 0,1.79464 1.46194,3.25743 3.257,3.25743 1.79465,0 3.25744,-1.46279 3.25744,-3.25743 l 0,-12.56209 c 0,-5.71621 4.98502,-8.57432 10.23613,-8.57432 1.59519,0 2.85726,-1.32953 2.85726,-2.92515 0,-1.59561 -1.26207,-2.85726 -2.85768,-2.85726 z"
|
||||
id="path15"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 447.02614,395.58648 c 0.0666,-8.17541 -5.78326,-15.22074 -15.222,-15.22074 -8.44192,0 -15.28779,6.77925 -15.28779,15.22074 0,8.44191 6.64684,15.22159 14.68985,15.22159 4.01434,0 7.62682,-2.06621 9.23846,-4.22518 l 0.79359,2.01434 0,0 c 0.42589,1.13177 1.5176,1.93717 2.7978,1.93717 1.65001,0 2.98756,-1.33671 2.99009,-2.98545 l 0,0 0,-7.80687 0,0 0,-4.1556 z m -15.222,9.43833 c -5.31773,0 -8.77419,-4.25469 -8.77419,-9.43833 0,-5.18406 3.45604,-9.43833 8.77419,-9.43833 5.3173,0 8.77419,4.25427 8.77419,9.43833 0,5.18364 -3.45689,9.43833 -8.77419,9.43833 z"
|
||||
id="path17"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 355.01479,368.3337 c 0,-1.7938 -1.46194,-3.18997 -3.25659,-3.18997 -1.79422,0 -3.25743,1.39659 -3.25743,3.18997 l 0,17.1499 c -1.66097,-3.05756 -5.25026,-5.11786 -9.50495,-5.11786 -8.64052,0 -14.42336,6.51318 -14.42336,15.22074 0,8.70757 5.98229,15.22159 14.42336,15.22159 3.76555,0 7.03057,-1.55429 8.98587,-4.25554 l 0.72317,1.83428 c 0.44782,1.25912 1.64917,2.16024 3.06051,2.16024 1.78621,0 3.24984,-1.45435 3.24984,-3.24815 0,-0.005 0,-0.009 0,-0.0139 l 0,0 0,-38.95128 -4.2e-4,0 z m -15.22116,36.69111 c -5.31731,0 -8.70715,-4.25469 -8.70715,-9.43833 0,-5.18406 3.38984,-9.43833 8.70715,-9.43833 5.31773,0 8.70714,4.0544 8.70714,9.43833 0,5.38309 -3.38941,9.43833 -8.70714,9.43833 z"
|
||||
id="path19"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 287.21553,365.34023 c -0.59414,-0.0877 -1.19966,-0.13198 -1.80097,-0.13198 -6.73118,0 -12.20746,5.4767 -12.20746,12.20788 l 0,3.8132 -3.98903,0 c -1.46237,0 -2.65908,1.19671 -2.65908,2.65781 0,1.46321 1.19671,2.93738 2.65908,2.93738 l 3.98819,0 0,20.46004 c 0,1.79464 1.46236,3.25743 3.25658,3.25743 1.79507,0 3.25744,-1.46279 3.25744,-3.25743 l 0,-20.46004 4.40986,0 c 1.46194,0 2.65823,-1.47417 2.65823,-2.93738 0,-1.46152 -1.19629,-2.65823 -2.65823,-2.65823 l -4.40733,0 0,-3.8132 c 0,-3.13852 2.55323,-6.11469 5.69175,-6.11469 0.28294,0 0.56757,0.0211 0.84672,0.062 1.78031,0.26355 3.4358,-0.54269 3.70019,-2.32342 0.2627,-1.77904 -0.96606,-3.43538 -2.74594,-3.69935 z"
|
||||
id="path21"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 482.01243,363.57426 c 0,-10.06788 -8.16108,-18.22938 -18.22897,-18.22938 -10.06282,0 -18.22179,8.15475 -18.22854,18.21631 l -4.2e-4,-4.2e-4 0,14.1071 4.2e-4,4.2e-4 c 0.005,2.28463 1.85832,4.13409 4.14463,4.13409 0.007,0 0.0127,-8.4e-4 0.0194,-8.4e-4 l 0.001,8.4e-4 14.07083,0 0,0 c 10.06409,-0.004 18.22138,-8.16276 18.22138,-18.22812 z"
|
||||
id="path25"
|
||||
style="fill:#294172" />
|
||||
<path
|
||||
d="m 469.13577,349.66577 c -4.72528,0 -8.55576,3.83049 -8.55576,8.55577 0,0.002 0,0.004 0,0.006 l 0,4.52836 -4.51444,0 c -8.5e-4,0 -8.5e-4,0 -0.001,0 -4.72528,0 -8.55576,3.81193 -8.55576,8.53678 0,4.72528 3.83048,8.55577 8.55576,8.55577 4.72486,0 8.55534,-3.83049 8.55534,-8.55577 0,-0.002 0,-0.004 0,-0.006 l 0,-4.54733 4.51444,0 c 8.5e-4,0 0.001,0 0.002,0 4.72486,0 8.55534,-3.79296 8.55534,-8.51781 0,-4.72528 -3.83048,-8.55577 -8.55534,-8.55577 z m -8.55576,21.63483 c -0.004,2.48998 -2.02446,4.50811 -4.51571,4.50811 -2.49378,0 -4.53426,-2.02193 -4.53426,-4.5157 0,-2.49421 2.04048,-4.55366 4.53426,-4.55366 0.002,0 0.004,4.2e-4 0.006,4.2e-4 l 3.86971,0 c 0.001,0 0.002,-4.2e-4 0.003,-4.2e-4 0.35209,0 0.63799,0.28505 0.63799,0.63715 0,4.2e-4 -4.2e-4,8.4e-4 -4.2e-4,0.001 l 0,3.92284 -4.2e-4,0 z m 8.55534,-8.5448 c -0.001,0 -0.003,0 -0.004,0 l -3.87223,0 c -8.4e-4,0 -0.002,0 -0.002,0 -0.35252,0 -0.63757,-0.28506 -0.63757,-0.63758 l 0,-4.2e-4 0,-3.90343 c 0.004,-2.49083 2.02446,-4.50854 4.51571,-4.50854 2.49378,0 4.53468,2.02193 4.53468,4.51613 4.2e-4,2.49336 -2.04048,4.53384 -4.53426,4.53384 z"
|
||||
id="path29"
|
||||
style="fill:#3c6eb4" />
|
||||
<path
|
||||
d="m 460.58001,362.7558 0,-4.52836 c 0,-0.002 0,-0.004 0,-0.006 0,-4.72528 3.83048,-8.55577 8.55576,-8.55577 0.71685,0 1.22623,0.0805 1.88952,0.25469 0.96774,0.25385 1.75796,1.04618 1.75838,1.96922 4.2e-4,1.11575 -0.80919,1.92621 -2.0194,1.92621 -0.57642,0 -0.78473,-0.11048 -1.62892,-0.11048 -2.49125,0 -4.51149,2.01771 -4.51571,4.50854 l 0,3.90385 0,4.2e-4 c 0,0.35252 0.28505,0.63758 0.63757,0.63758 4.3e-4,0 0.001,0 0.002,0 l 2.96521,0 c 1.10521,0 1.99747,0.88467 1.99832,1.99283 0,1.10816 -0.89353,1.99114 -1.99832,1.99114 l -3.60489,0 0,4.54733 c 0,0.002 0,0.004 0,0.006 0,4.72485 -3.83048,8.55534 -8.55534,8.55534 -0.71684,0 -1.22623,-0.0805 -1.88952,-0.25469 -0.96774,-0.25343 -1.75838,-1.04618 -1.7588,-1.9688 0,-1.11575 0.80919,-1.92663 2.01982,-1.92663 0.576,0 0.78473,0.11048 1.6285,0.11048 2.49125,0 4.51191,-2.01771 4.51613,-4.50811 0,0 0,-3.92368 0,-3.9241 0,-0.35168 -0.2859,-0.63673 -0.63799,-0.63673 -4.3e-4,0 -8.5e-4,0 -0.002,0 l -2.96521,-4.2e-4 c -1.10521,0 -1.99831,-0.88214 -1.99831,-1.9903 -4.3e-4,-1.11533 0.90238,-1.99367 2.01939,-1.99367 l 3.58339,0 0,0 z"
|
||||
id="path31"
|
||||
style="fill:#ffffff" />
|
||||
<path
|
||||
d="m 477.41661,378.55292 2.81558,0 0,0.37898 -1.18152,0 0,2.94935 -0.45254,0 0,-2.94935 -1.18152,0 0,-0.37898 m 3.26144,0 0.67101,0 0.84937,2.26496 0.85381,-2.26496 0.67102,0 0,3.32833 -0.43917,0 0,-2.9226 -0.85828,2.28279 -0.45255,0 -0.85827,-2.28279 0,2.9226 -0.43694,0 0,-3.32833"
|
||||
id="text6223"
|
||||
style="fill:#294172;enable-background:new" />
|
||||
</g>
|
||||
<path
|
||||
d="m 181.98344,61.675273 2.81558,0 0,0.37898 -1.18152,0 0,2.94935 -0.45254,0 0,-2.94935 -1.18152,0 0,-0.37898 m 3.26144,0 0.67101,0 0.84937,2.26496 0.85381,-2.26496 0.67102,0 0,3.32833 -0.43917,0 0,-2.9226 -0.85828,2.28279 -0.45255,0 -0.85827,-2.28279 0,2.9226 -0.43694,0 0,-3.32833"
|
||||
id="path2391"
|
||||
style="fill:#294172;enable-background:new" />
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 7.6 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 3.9 KiB |
6
_javascripts/bootstrap-offcanvas.js
vendored
6
_javascripts/bootstrap-offcanvas.js
vendored
|
|
@ -1,6 +0,0 @@
|
|||
$(document).ready(function () {
|
||||
$('[data-toggle="offcanvas"]').click(function () {
|
||||
$('.sidebar').show();
|
||||
$('.row-offcanvas').toggleClass('active');
|
||||
});
|
||||
});
|
||||
|
|
@ -1,568 +0,0 @@
|
|||
@import url(https://maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css);
|
||||
/* ------------------------------------------------------------
|
||||
Image: "Spin" https://www.flickr.com/photos/eflon/3655695161/
|
||||
Author: eflon https://www.flickr.com/photos/eflon/
|
||||
License: https://creativecommons.org/licenses/by/2.0/
|
||||
---------------------------------------------------------------*/
|
||||
.attribution {
|
||||
text-align: center;
|
||||
position: relative;
|
||||
bottom: -20px;
|
||||
}
|
||||
.attribution .btn {
|
||||
color: #808080;
|
||||
color: rgba(175,175,175, .65);
|
||||
font-size: 11px;
|
||||
}
|
||||
.attribution .btn:hover {
|
||||
text-decoration: none;
|
||||
color: #aaa;
|
||||
}
|
||||
.popover-content {
|
||||
font-size: 12px;
|
||||
line-height: 1.3;
|
||||
font-weight: normal;
|
||||
}
|
||||
|
||||
@media screen and (max-width: 980px) {
|
||||
body {
|
||||
margin-bottom: 200px;
|
||||
}
|
||||
footer {
|
||||
text-align: center;
|
||||
}
|
||||
footer .text-right {
|
||||
text-align: center !important;
|
||||
}
|
||||
#footer_social .first {
|
||||
margin-left: 0;
|
||||
}
|
||||
#footer_social > a {
|
||||
top: 24px;
|
||||
}
|
||||
}
|
||||
|
||||
.fa-inverse:hover {
|
||||
color: #ccc;
|
||||
}
|
||||
|
||||
.collapse a.active {
|
||||
background-color: #DEEAF4;
|
||||
color: #000;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
.collapse a.active:hover {
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.collapse a.active:before {
|
||||
background-color: #A0C3E5;
|
||||
content: "";
|
||||
display: inline-block;
|
||||
height: 100%;
|
||||
left: 0;
|
||||
position: absolute;
|
||||
top: 0;
|
||||
width: 3px;
|
||||
}
|
||||
|
||||
.main h2, .main .h2 {
|
||||
border-top: 0px;
|
||||
padding-top: 10px;
|
||||
}
|
||||
|
||||
.page-header {
|
||||
height: 100% !important;
|
||||
}
|
||||
|
||||
.page-header h2{
|
||||
font-size: 28px;
|
||||
}
|
||||
|
||||
.navbar-brand {
|
||||
padding: initial;
|
||||
height: initial;
|
||||
}
|
||||
|
||||
.nav > li > a.hover{
|
||||
background-color: none;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6, .h1, .h2, .h3, .h4, .h5, .h6 {
|
||||
position: relative;
|
||||
}
|
||||
|
||||
h2 > a.anchor, h3 > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor {
|
||||
display: block;
|
||||
font-weight: normal;
|
||||
margin-left: -1.5ex;
|
||||
position: absolute;
|
||||
text-align: center;
|
||||
text-decoration: none !important;
|
||||
visibility: hidden;
|
||||
width: 1.5ex;
|
||||
z-index: 1001;
|
||||
}
|
||||
|
||||
h2 > a.anchor:before, h3 > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before {
|
||||
content: "\f0c1";
|
||||
display: block;
|
||||
font-family: FontAwesome;
|
||||
font-size: 0.7em;
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
padding-top: 0.2em;
|
||||
}
|
||||
|
||||
h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before {
|
||||
font-size: 1em;
|
||||
}
|
||||
|
||||
h2:hover > a.anchor,
|
||||
h2 > a.anchor:hover,
|
||||
h3:hover > a.anchor,
|
||||
h3 > a.anchor:hover,
|
||||
h4:hover > a.anchor,
|
||||
h4 > a.anchor:hover,
|
||||
h5:hover > a.anchor,
|
||||
h5 > a.anchor:hover,
|
||||
h6:hover > a.anchor,
|
||||
h6 > a.anchor:hover {
|
||||
visibility: visible;
|
||||
}
|
||||
|
||||
.main {
|
||||
border-left: 1px solid #e7e7e7;
|
||||
margin-left: -1px;
|
||||
padding-left: 25px;
|
||||
}
|
||||
|
||||
|
||||
@media (min-width: 768px) {
|
||||
.main {
|
||||
padding-left: 30px;
|
||||
}
|
||||
}
|
||||
|
||||
/*
|
||||
* Sidebar
|
||||
*/
|
||||
|
||||
.nav-header {
|
||||
font-size: 16px;
|
||||
}
|
||||
|
||||
.nav-header ul {
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
.nav-header ul li a {
|
||||
display: block;
|
||||
padding: 5px 20px 5px 25px;
|
||||
font-size: 13px;
|
||||
font-weight: normal;
|
||||
}
|
||||
|
||||
.nav-sidebar .fa {
|
||||
text-align: center;
|
||||
top: -1px;
|
||||
width: 14px;
|
||||
}
|
||||
|
||||
.nav-sidebar li a {
|
||||
color: inherit;
|
||||
}
|
||||
|
||||
.nav-sidebar li a:hover {
|
||||
color: #000;
|
||||
}
|
||||
|
||||
.nav-sidebar ul li ul.nav-tertiary li a {
|
||||
padding-left: 50px;
|
||||
}
|
||||
|
||||
.nav-sidebar > li > a {
|
||||
padding: 7px 0;
|
||||
}
|
||||
|
||||
.nav-sidebar > li > a:focus, .nav-sidebar > li > a:hover {
|
||||
background: transparent;
|
||||
}
|
||||
|
||||
.sidebar {
|
||||
font-weight: 300;
|
||||
display: none;
|
||||
padding-top: 13px;
|
||||
}
|
||||
|
||||
@media screen and (max-width: 767px) {
|
||||
.sidebar {
|
||||
padding-left: 30px;
|
||||
padding-right: 0;
|
||||
}
|
||||
}
|
||||
|
||||
@media screen and (min-width: 768px) {
|
||||
.sidebar {
|
||||
border-right: 1px solid #e7e7e7;
|
||||
display: block;
|
||||
}
|
||||
}
|
||||
|
||||
/*
|
||||
* Off Canvas
|
||||
* --------------------------------------------------
|
||||
*/
|
||||
|
||||
body, html {
|
||||
overflow-x: hidden; /* Prevent scroll on narrow devices */
|
||||
}
|
||||
|
||||
.toggle-nav {
|
||||
margin-right: 20px;
|
||||
}
|
||||
|
||||
@media screen and (max-width: 767px) {
|
||||
.row-offcanvas {
|
||||
position: relative;
|
||||
-webkit-transition: all .25s ease-out;
|
||||
-o-transition: all .25s ease-out;
|
||||
transition: all .25s ease-out;
|
||||
}
|
||||
|
||||
.row-offcanvas-right {
|
||||
right: 0;
|
||||
}
|
||||
|
||||
.row-offcanvas-left {
|
||||
left: 0;
|
||||
}
|
||||
|
||||
.row-offcanvas-right
|
||||
.sidebar-offcanvas {
|
||||
right: -75%; /* 8 columns */
|
||||
}
|
||||
|
||||
.row-offcanvas-left
|
||||
.sidebar-offcanvas {
|
||||
left: -75%; /* 8 columns */
|
||||
}
|
||||
|
||||
.row-offcanvas-right.active {
|
||||
right: 75%; /* 8 columns */
|
||||
}
|
||||
|
||||
.row-offcanvas-left.active {
|
||||
left: 75%; /* 8 columns */
|
||||
}
|
||||
|
||||
.sidebar-offcanvas {
|
||||
overflow: hidden;
|
||||
position: absolute;
|
||||
top: 0;
|
||||
width: 75%; /* 8 columns */
|
||||
}
|
||||
}
|
||||
|
||||
p {
|
||||
margin: 0 0 1.6em;
|
||||
}
|
||||
|
||||
/* Remnants of Asciidoctor default stylesheet - remove styles as needed */
|
||||
|
||||
#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
|
||||
.left { float: left !important; }
|
||||
.right { float: right !important; }
|
||||
.text-left { text-align: left !important; }
|
||||
.text-right { text-align: right !important; }
|
||||
.text-center { text-align: center !important; }
|
||||
.text-justify { text-align: justify !important; }
|
||||
.hide { display: none; }
|
||||
.subheader, #content #toctitle, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 1.4; color: #7a2518; font-weight: 300; margin-top: 0.2em; margin-bottom: 0.5em; }
|
||||
abbr, acronym { text-transform: uppercase; font-size: 90%; color: #333333; border-bottom: 1px dotted #dddddd; cursor: help; }
|
||||
abbr { text-transform: none; }
|
||||
blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; }
|
||||
blockquote cite { display: block; font-size: inherit; color: #454545; }
|
||||
blockquote cite:before { content: "\2014 \0020"; }
|
||||
blockquote cite a, blockquote cite a:visited { color: #454545; }
|
||||
blockquote, blockquote p { line-height: 1.6; color: #6e6e6e; }
|
||||
@media only screen and (min-width: 768px) {
|
||||
#toctitle, .sidebarblock > .content > .title { line-height: 1.4; }
|
||||
#toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
|
||||
}
|
||||
table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
|
||||
table thead, table tfoot { background: whitesmoke; font-weight: bold; }
|
||||
table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #333333; text-align: left; }
|
||||
table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #333333; }
|
||||
table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
|
||||
table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.6; }
|
||||
.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
|
||||
.clearfix:after, .float-group:after { clear: both; }
|
||||
*:not(pre) > code { font-size: inherit; padding: 0; white-space: nowrap; background-color: inherit; border: 0 solid #dddddd; -webkit-border-radius: 4px; border-radius: 4px; text-shadow: none; line-height: 1; }
|
||||
.keyseq { color: #666666; }
|
||||
kbd:not(.keyseq) { display: inline-block; color: #333333; font-size: 0.75em; line-height: 1.4; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; margin: -0.15em 0.15em 0 0.15em; padding: 0.2em 0.6em 0.2em 0.5em; vertical-align: middle; white-space: nowrap; }
|
||||
.keyseq kbd:first-child { margin-left: 0; }
|
||||
.keyseq kbd:last-child { margin-right: 0; }
|
||||
.menuseq, .menu { color: #1a1a1a; }
|
||||
b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
|
||||
b.button:before { content: "["; padding: 0 3px 0 2px; }
|
||||
b.button:after { content: "]"; padding: 0 2px 0 3px; }
|
||||
p a > code:hover { color: #561309; }
|
||||
#header, #content, #footnotes, #footer { width: 100%; margin-left: auto; margin-right: auto; margin-top: 0; margin-bottom: 0; max-width: 62.5em; *zoom: 1; position: relative; padding-left: 0.9375em; padding-right: 0.9375em; }
|
||||
#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
|
||||
#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
|
||||
#content:before { content: none; }
|
||||
#header { margin-bottom: 2.5em; }
|
||||
#header > h1 { color: black; font-weight: 300; border-bottom: 1px solid #d8d8d8; margin-bottom: -28px; padding-bottom: 32px; }
|
||||
#header span { color: #6e6e6e; }
|
||||
#header #revnumber { text-transform: capitalize; }
|
||||
#header br { display: none; }
|
||||
#header br + span { padding-left: 3px; }
|
||||
#header br + span:before { content: "\2013 \0020"; }
|
||||
#header br + span.author { padding-left: 0; }
|
||||
#header br + span.author:before { content: ", "; }
|
||||
#toc { border-bottom: 3px double #e5e5e5; padding-top: 1em; padding-bottom: 1.25em; }
|
||||
#toc > ul { margin-left: 0.25em; }
|
||||
#toc ul.sectlevel0 > li > a { font-style: italic; }
|
||||
#toc ul.sectlevel0 ul.sectlevel1 { margin-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
|
||||
#toc ul { font-family: "Open Sans", "DejaVu Sans", "Sans", sans-serif; list-style-type: none; }
|
||||
#toc a { text-decoration: none; }
|
||||
#toc a:active { text-decoration: underline; }
|
||||
#toctitle { color: #7a2518; }
|
||||
@media only screen and (min-width: 768px) { body.toc2 { padding-left: 15em; padding-right: 0; }
|
||||
#toc.toc2 { background-color: #fafaf9; position: fixed; width: 15em; left: 0; top: 0; border-right: 1px solid #e5e5e5; border-bottom: 0; z-index: 1000; padding: 1.25em 1em; height: 100%; overflow: auto; }
|
||||
#toc.toc2 #toctitle { margin-top: 0; font-size: 1.2em; }
|
||||
#toc.toc2 > ul { font-size: .90em; margin-bottom: 0; }
|
||||
#toc.toc2 ul ul { margin-left: 0; padding-left: 1em; }
|
||||
#toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
|
||||
body.toc2.toc-right { padding-left: 0; padding-right: 15em; }
|
||||
body.toc2.toc-right #toc.toc2 { border-right: 0; border-left: 1px solid #e5e5e5; left: auto; right: 0; } }
|
||||
@media only screen and (min-width: 1280px) { body.toc2 { padding-left: 20em; padding-right: 0; }
|
||||
#toc.toc2 { width: 20em; }
|
||||
#toc.toc2 #toctitle { font-size: 1.375em; }
|
||||
#toc.toc2 > ul { font-size: 0.95em; }
|
||||
#toc.toc2 ul ul { padding-left: 1.25em; }
|
||||
body.toc2.toc-right { padding-left: 0; padding-right: 20em; } }
|
||||
#content #toc { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-bottom: 1.25em; padding: 1.25em; background: #fafaf9; border-width: 0; -webkit-border-radius: 4px; border-radius: 4px; }
|
||||
#content #toc > :first-child { margin-top: 0; }
|
||||
#content #toc > :last-child { margin-bottom: 0; }
|
||||
#content #toctitle { font-size: 1.375em; }
|
||||
#footer { max-width: 100%; background-color: #333333; padding: 1.25em; }
|
||||
#footer-text { color: #cccccc; line-height: 1.44; }
|
||||
.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .verseblock, .videoblock { margin-bottom: 2.5em; }
|
||||
.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left; font-family: "Noto Serif", "DejaVu Serif", "Serif", serif; font-weight: normal; font-style: italic; }
|
||||
table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0; }
|
||||
table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
|
||||
.admonitionblock > table { border: 0; background: none; width: 100%; }
|
||||
.admonitionblock > table td.icon { text-align: center; width: 80px; }
|
||||
.admonitionblock > table td.icon img { max-width: none; }
|
||||
.admonitionblock > table td.icon .title { font-weight: 300; text-transform: uppercase; }
|
||||
.admonitionblock > table td.content { padding-left: 0; padding-right: 1.25em; color: #6e6e6e; }
|
||||
.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
|
||||
.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background: white; -webkit-border-radius: 4px; border-radius: 4px; }
|
||||
.exampleblock > .content > :first-child { margin-top: 0; }
|
||||
.exampleblock > .content > :last-child { margin-bottom: 0; }
|
||||
.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6, .exampleblock > .content p { color: #333333; }
|
||||
.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6 { line-height: 1; margin-bottom: 0.625em; }
|
||||
.exampleblock > .content h1.subheader, .exampleblock > .content h2.subheader, .exampleblock > .content h3.subheader, .exampleblock > .content .subheader#toctitle, .sidebarblock.exampleblock > .content > .subheader.title, .exampleblock > .content h4.subheader, .exampleblock > .content h5.subheader, .exampleblock > .content h6.subheader { line-height: 1.4; }
|
||||
.exampleblock.result > .content { -webkit-box-shadow: 0 1px 8px #e3e3dd; box-shadow: 0 1px 8px #e3e3dd; }
|
||||
.sidebarblock { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-top: -1.0em; margin-bottom: 1.6em; padding: .5em; background: #F1F3F5; -webkit-border-radius: 4px; border-radius: 4px; overflow-x: auto; }
|
||||
.sidebarblock > :first-child { margin-top: 0; }
|
||||
.sidebarblock > :last-child { margin-bottom: 0; }
|
||||
.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6, .sidebarblock p { color: #333333; }
|
||||
.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6 { line-height: 1; margin-bottom: 0.625em; }
|
||||
.sidebarblock h1.subheader, .sidebarblock h2.subheader, .sidebarblock h3.subheader, .sidebarblock .subheader#toctitle, .sidebarblock > .content > .subheader.title, .sidebarblock h4.subheader, .sidebarblock h5.subheader, .sidebarblock h6.subheader { line-height: 1.4; }
|
||||
.sidebarblock > .content > .title { color: #7a2518; margin-top: 0; line-height: 1.6; }
|
||||
.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
|
||||
.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 0px; background-color: #F0F3F5; -webkit-border-radius: 5px; border-radius: 5px; padding: 1.5em 2.5em; word-wrap: break-word; }
|
||||
.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
|
||||
.literalblock pre > code, .literalblock pre[class] > code, .listingblock pre > code, .listingblock pre[class] > code { display: block; }
|
||||
.listingblock > .content { position: relative; }
|
||||
.listingblock:hover code[class*=" language-"]:before { text-transform: uppercase; font-size: 0.9em; color: #999; position: absolute; top: 0.375em; right: 0.375em; }
|
||||
.listingblock:hover code.asciidoc:before { content: "asciidoc"; }
|
||||
.listingblock:hover code.clojure:before { content: "clojure"; }
|
||||
.listingblock:hover code.css:before { content: "css"; }
|
||||
.listingblock:hover code.go:before { content: "go"; }
|
||||
.listingblock:hover code.groovy:before { content: "groovy"; }
|
||||
.listingblock:hover code.html:before { content: "html"; }
|
||||
.listingblock:hover code.java:before { content: "java"; }
|
||||
.listingblock:hover code.javascript:before { content: "javascript"; }
|
||||
.listingblock:hover code.python:before { content: "python"; }
|
||||
.listingblock:hover code.ruby:before { content: "ruby"; }
|
||||
.listingblock:hover code.sass:before { content: "sass"; }
|
||||
.listingblock:hover code.scss:before { content: "scss"; }
|
||||
.listingblock:hover code.xml:before { content: "xml"; }
|
||||
.listingblock:hover code.yaml:before { content: "yaml"; }
|
||||
.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
|
||||
.listingblock.terminal pre .command:not([data-prompt]):before { content: '$'; }
|
||||
table.pyhltable { border: 0; margin-bottom: 0; }
|
||||
table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; }
|
||||
table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
|
||||
.highlight.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #d8d8d8; }
|
||||
.highlight.pygments .lineno { display: inline-block; margin-right: .25em; }
|
||||
table.pyhltable .linenodiv { background-color: transparent !important; padding-right: 0 !important; }
|
||||
.quoteblock { margin: 0 0 1.25em 0; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; }
|
||||
.quoteblock blockquote { margin: 0 0 1.25em 0; padding: 0 0 0.625em 0; border: 0; }
|
||||
.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
|
||||
.quoteblock .attribution { margin-top: -0.625em; padding-bottom: 0.625em; font-size: inherit; color: #454545; line-height: 1.6; }
|
||||
.quoteblock .attribution br { display: none; }
|
||||
.quoteblock .attribution cite { display: block; }
|
||||
table.tableblock { max-width: 100%; }
|
||||
table.tableblock td .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
|
||||
table.spread { width: 100%; }
|
||||
table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; }
|
||||
table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; }
|
||||
table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
|
||||
table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
|
||||
table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
|
||||
table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
|
||||
table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0; }
|
||||
table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
|
||||
table.frame-all { border-width: 1px; }
|
||||
table.frame-sides { border-width: 0 1px; }
|
||||
table.frame-topbot { border-width: 1px 0; }
|
||||
th.halign-left, td.halign-left { text-align: left; }
|
||||
th.halign-right, td.halign-right { text-align: right; }
|
||||
th.halign-center, td.halign-center { text-align: center; }
|
||||
th.valign-top, td.valign-top { vertical-align: top; }
|
||||
th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
|
||||
th.valign-middle, td.valign-middle { vertical-align: middle; }
|
||||
table thead th, table tfoot th { font-weight: bold; }
|
||||
tbody tr th { display: table-cell; line-height: 1.6; background: whitesmoke; }
|
||||
tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #333333; font-weight: bold; }
|
||||
td > div.verse { white-space: pre; }
|
||||
ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
|
||||
ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
|
||||
ul.checklist li > p:first-child > .fa-check-square-o:first-child, ul.checklist li > p:first-child > input[type="checkbox"]:first-child { margin-right: 0.25em; }
|
||||
ul.checklist li > p:first-child > input[type="checkbox"]:first-child { position: relative; top: 1px; }
|
||||
ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
|
||||
ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
|
||||
ul.inline > li > * { display: block; }
|
||||
.unstyled dl dt { font-weight: normal; font-style: normal; }
|
||||
ol.arabic { list-style-type: decimal; }
|
||||
ol.decimal { list-style-type: decimal-leading-zero; }
|
||||
ol.loweralpha { list-style-type: lower-alpha; }
|
||||
ol.upperalpha { list-style-type: upper-alpha; }
|
||||
ol.lowerroman { list-style-type: lower-roman; }
|
||||
ol.upperroman { list-style-type: upper-roman; }
|
||||
ol.lowergreek { list-style-type: lower-greek; }
|
||||
.hdlist > table, .colist > table { border: 0; background: none; }
|
||||
.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
|
||||
td.hdlist1 { padding-right: .75em; font-weight: bold; }
|
||||
td.hdlist1, td.hdlist2 { vertical-align: top; }
|
||||
.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em; }
|
||||
.colist > table tr > td:first-of-type { padding: 0 .75em; line-height: 1; }
|
||||
.colist > table tr > td:last-of-type { padding: 0.25em 0; }
|
||||
.qanda > ol > li > p > em:only-child { color: #1d4b8f; }
|
||||
.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
|
||||
.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0; }
|
||||
.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em; }
|
||||
.imageblock > .title { margin-bottom: 0; }
|
||||
.imageblock.thumb, .imageblock.th { border-width: 6px; }
|
||||
.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
|
||||
.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
|
||||
.image.left { margin-right: 0.625em; }
|
||||
.image.right { margin-left: 0.625em; }
|
||||
a.image { text-decoration: none; }
|
||||
span.footnote, span.footnoteref { vertical-align: super; font-size: 0.875em; }
|
||||
span.footnote a, span.footnoteref a { text-decoration: none; }
|
||||
span.footnote a:active, span.footnoteref a:active { text-decoration: underline; }
|
||||
#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
|
||||
#footnotes hr { width: 20%; min-width: 6.25em; margin: -.25em 0 .75em 0; border-width: 1px 0 0 0; }
|
||||
#footnotes .footnote { padding: 0 0.375em; line-height: 1.3; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.2em; margin-bottom: .2em; }
|
||||
#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
|
||||
#footnotes .footnote:last-of-type { margin-bottom: 0; }
|
||||
#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
|
||||
.gist .file-data > table { border: none; background: #fff; width: 100%; margin-bottom: 0; }
|
||||
.gist .file-data > table td.line-data { width: 99%; }
|
||||
div.unbreakable { page-break-inside: avoid; }
|
||||
.replaceable { font-style: italic; font-color: inherit; font-family: inherit; }
|
||||
.parameter { font-style: italic; font-family: monospace; }
|
||||
.userinput { font-weight: bold; font-family: monospace; }
|
||||
.envar { font-weight: bold; font-family: monospace; font-size: 90%; }
|
||||
.sysitem { font-weight: bold; font-size: 90%; }
|
||||
.package { font-weight: bold; font-size: 90%; }
|
||||
.filename { font-weight: bold; font-style: italic; font-size: 90%; }
|
||||
.big { font-size: larger; }
|
||||
.small { font-size: smaller; }
|
||||
.underline { text-decoration: underline; }
|
||||
.overline { text-decoration: overline; }
|
||||
.line-through { text-decoration: line-through; }
|
||||
.aqua { color: #00bfbf; }
|
||||
.aqua-background { background-color: #00fafa; }
|
||||
.black { color: black; }
|
||||
.black-background { background-color: black; }
|
||||
.blue { color: #0000bf; }
|
||||
.blue-background { background-color: #0000fa; }
|
||||
.fuchsia { color: #bf00bf; }
|
||||
.fuchsia-background { background-color: #fa00fa; }
|
||||
.gray { color: #606060; }
|
||||
.gray-background { background-color: #7d7d7d; }
|
||||
.green { color: #006000; }
|
||||
.green-background { background-color: #007d00; }
|
||||
.lime { color: #00bf00; }
|
||||
.lime-background { background-color: #00fa00; }
|
||||
.maroon { color: #600000; }
|
||||
.maroon-background { background-color: #7d0000; }
|
||||
.navy { color: #000060; }
|
||||
.navy-background { background-color: #00007d; }
|
||||
.olive { color: #606000; }
|
||||
.olive-background { background-color: #7d7d00; }
|
||||
.purple { color: #600060; }
|
||||
.purple-background { background-color: #7d007d; }
|
||||
.red { color: #bf0000; }
|
||||
.red-background { background-color: #fa0000; }
|
||||
.silver { color: #909090; }
|
||||
.silver-background { background-color: #bcbcbc; }
|
||||
.teal { color: #006060; }
|
||||
.teal-background { background-color: #007d7d; }
|
||||
.white { color: #bfbfbf; }
|
||||
.white-background { background-color: #fafafa; }
|
||||
.yellow { color: #bfbf00; }
|
||||
.yellow-background { background-color: #fafa00; }
|
||||
span.icon > .fa { cursor: default; }
|
||||
.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; cursor: default; }
|
||||
.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #4E9FDD; }
|
||||
.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; color: #2C8596; }
|
||||
.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #ec7a08; }
|
||||
.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #ec7a08; }
|
||||
.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #c00; }
|
||||
.conum[data-value] { display: inline-block; color: white !important; background-color: #333333; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; width: 20px; height: 20px; font-size: 12px; line-height: 20px; font-family: "Open Sans", "Sans", sans-serif; font-style: normal; font-weight: bold; text-indent: -1px; }
|
||||
.conum[data-value] * { color: white !important; }
|
||||
.conum[data-value] + b { display: none; }
|
||||
.conum[data-value]:after { content: attr(data-value); }
|
||||
pre .conum[data-value] { position: relative; top: -2px; }
|
||||
b.conum * { color: inherit !important; }
|
||||
.conum:not([data-value]):empty { display: none; }
|
||||
.print-only { display: none !important; }
|
||||
@media print { @page { margin: 1.25cm 0.75cm; }
|
||||
* { -webkit-box-shadow: none !important; box-shadow: none !important; text-shadow: none !important; }
|
||||
a, a:visited { color: inherit !important; text-decoration: underline !important; }
|
||||
a[href^="http:"]:after, a[href^="https:"]:after { content: " (" attr(href) ")"; }
|
||||
a[href^="#"], a[href^="#"]:visited, a[href^="mailto:"], a[href^="mailto:"]:visited { text-decoration: none !important; }
|
||||
abbr[title]:after { content: " (" attr(title) ")"; }
|
||||
pre, blockquote { page-break-inside: avoid; }
|
||||
code { color: #191919; }
|
||||
thead { display: table-header-group; }
|
||||
tr, img { page-break-inside: avoid; }
|
||||
img { max-width: 100% !important; }
|
||||
p { orphans: 3; widows: 3; }
|
||||
h2, h3, #toctitle, .sidebarblock > .content > .title, #toctitle, .sidebarblock > .content > .title { page-break-after: avoid; }
|
||||
#toc, .sidebarblock { background: none !important; }
|
||||
#toc { border-bottom: 1px solid #d8d8d8 !important; padding-bottom: 0 !important; }
|
||||
.sect1 { padding-bottom: 0 !important; }
|
||||
.sect1 + .sect1 { border: none !important; }
|
||||
body.book #header { text-align: center; }
|
||||
body.book #header > h1 { border: none !important; margin: 2.5em 0 1em 0; padding: 0; }
|
||||
body.book #header span { line-height: 1.6; }
|
||||
body.book #header br { display: block; }
|
||||
body.book #header br + span { padding-left: 0; }
|
||||
body.book #header br + span:before { content: none !important; }
|
||||
body.book #toc { border: none !important; text-align: left !important; padding: 0 !important; }
|
||||
#footer { background: none !important; }
|
||||
#footer-text { color: #333333 !important; }
|
||||
.hide-on-print { display: none !important; }
|
||||
.print-only { display: block !important; }
|
||||
.hide-for-print { display: none !important; }
|
||||
.show-for-print { display: inherit !important; } }
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%>
|
||||
<link href="<%= File.join(css_path, File.basename(sheet)) %>" rel="stylesheet" />
|
||||
<%- end -%>
|
||||
|
|
@ -1,31 +0,0 @@
|
|||
<ul class="nav nav-sidebar">
|
||||
<%- navigation.each.with_index do |topic_group, groupidx| -%>
|
||||
<%- current_group = topic_group[:id] == group_id -%>
|
||||
<li class="nav-header">
|
||||
<a class="" href="#" data-toggle="collapse" data-target="#topicGroup<%= groupidx %>">
|
||||
<span id="tgSpan<%= groupidx %>" class="fa <%= current_group ? 'fa-angle-down' : 'fa-angle-right' %>"></span><%= topic_group[:name] %>
|
||||
</a>
|
||||
<ul id="topicGroup<%= groupidx %>" class="collapse <%= current_group ? 'in' : '' %> list-unstyled">
|
||||
<%- topic_group[:topics].each.with_index do |topic, topicidx| -%>
|
||||
<%- if not topic.has_key?(:topics) -%>
|
||||
<%- current_topic = current_group && (topic[:id] == topic_id) -%>
|
||||
<li><a class="<%= current_topic ? ' active' : '' %>" href="<%= subtopic_shim %><%= topic[:path] %>"><%= topic[:name] %></a></li>
|
||||
<%- else -%>
|
||||
<%- current_subgroup = topic[:id] == subgroup_id -%>
|
||||
<li class="nav-header">
|
||||
<a class="" href="#" data-toggle="collapse" data-target="#topicSubGroup-<%= groupidx %>-<%= topicidx %>">
|
||||
<span id="sgSpan-<%= groupidx %>-<%= topicidx %>" class="fa <%= current_subgroup ? 'fa-caret-down' : 'fa-caret-right' %>"></span> <%= topic[:name] %>
|
||||
</a>
|
||||
<ul id="topicSubGroup-<%= groupidx %>-<%= topicidx %>" class="nav-tertiary list-unstyled collapse<%= current_subgroup ? ' in' : '' %>">
|
||||
<%- topic[:topics].each do |subtopic| -%>
|
||||
<%- current_subtopic = current_group && current_subgroup && (subtopic[:id] == topic_id) %>
|
||||
<li><a class="<%= current_subtopic ? ' active' : '' %>" href="<%= subtopic_shim %><%= subtopic[:path] %>"><%= subtopic[:name] %></a></li>
|
||||
<%- end -%>
|
||||
</ul>
|
||||
</li>
|
||||
<%- end -%>
|
||||
<%- end -%>
|
||||
</ul>
|
||||
</li>
|
||||
<%- end -%>
|
||||
</ul>
|
||||
|
|
@ -1,182 +0,0 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta content="IE=edge" http-equiv="X-UA-Compatible">
|
||||
<meta content="width=device-width, initial-scale=1.0" name="viewport">
|
||||
<title><%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %></title>
|
||||
|
||||
<!-- Bootstrap -->
|
||||
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
|
||||
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-theme.min.css">
|
||||
|
||||
<%= render("_templates/_css.html.erb", :css_path => css_path) %>
|
||||
|
||||
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
|
||||
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
|
||||
<!--[if lt IE 9]>
|
||||
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
|
||||
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
|
||||
<![endif]-->
|
||||
|
||||
<link href="<%= File.join(images_path, "favicon32x32.png") %>" rel="shortcut icon" type="text/css">
|
||||
<!--[if IE]><link rel="shortcut icon" href="<%= File.join(images_path, "favicon.ico") %>"><![endif]-->
|
||||
<meta content="AsciiBinder" name="application-name">
|
||||
</head>
|
||||
<body>
|
||||
<div class="navbar navbar-default" role="navigation">
|
||||
<div class="container-fluid">
|
||||
<div class="navbar-header">
|
||||
<a class="navbar-brand" href="https://docs.fedoraproject.org/"><img alt="Fedora Documentation" src="<%= File.join(images_path, "fedora.svg") %>"></a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="container">
|
||||
<p class="toggle-nav visible-xs pull-left">
|
||||
<button class="btn btn-default btn-sm" type="button" data-toggle="offcanvas">Toggle nav</button>
|
||||
</p>
|
||||
<ol class="breadcrumb">
|
||||
<li class="sitename">
|
||||
<a href="<%= site_home_path %>"><%= site_name %></a>
|
||||
</li>
|
||||
<li class="hidden-xs active">
|
||||
<%= breadcrumb_root %>
|
||||
</li>
|
||||
<li class="hidden-xs active">
|
||||
<%= breadcrumb_group %>
|
||||
</li>
|
||||
<%= breadcrumb_subgroup_block %>
|
||||
<li class="hidden-xs active">
|
||||
<%= breadcrumb_topic %>
|
||||
</li>
|
||||
</ol>
|
||||
<div class="row row-offcanvas row-offcanvas-left">
|
||||
<div class="col-xs-8 col-sm-3 col-md-3 sidebar sidebar-offcanvas">
|
||||
<%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %>
|
||||
</div>
|
||||
<div class="col-xs-12 col-sm-9 col-md-9 main">
|
||||
<div class="page-header">
|
||||
<h2><%= article_title %></h2>
|
||||
</div>
|
||||
<%= content %>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="bottom" class="text-muted py-3" >
|
||||
<div class="foot">
|
||||
<div class="container">
|
||||
<div class="row footerlinks">
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">About</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Overview">About Fedora</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/sponsors">Sponsors</a></dd>
|
||||
<dd><a href="https://fedoramagazine.org">Fedora Magazine</a></dd>
|
||||
<dd><a href="https:https://fedoraproject.org/wiki/Legal:Main#Legal">Legal</a></dd>
|
||||
</dl>
|
||||
<ul class="list-inline">
|
||||
<li>
|
||||
<a href="https:https://www.facebook.com/TheFedoraProject" class="btn-social btn-outline"><i class="fa fa-fw fa-facebook"></i></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https:https://plus.google.com/112917221531140868607" class="btn-social btn-outline"><i class="fa fa-fw fa-google-plus"></i></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https:https://twitter.com/fedora" class="btn-social btn-outline"><i class="fa fa-fw fa-twitter"></i></a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title uppercase">Download</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://getfedora.org/en/workstation/download">Get Fedora Workstation</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/server/download">Get Fedora Server</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/atomic/download">Get Fedora Atomic</a></dd>
|
||||
<dd><a href="https://spins.fedoraproject.org">Fedora Spins</a></dd>
|
||||
<dd><a href="https://labs.fedoraproject.org">Fedora Labs</a></dd>
|
||||
<dd><a href="https://arm.fedoraproject.org">Fedora ARM<span class="sup">®</span></a></dd>
|
||||
<dd><a href="https://alt.fedoraproject.org/">Alternative Downloads</a></dd>
|
||||
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">Support</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Communicating_and_getting_help">Get Help</a></dd>
|
||||
<dd><a href="https://ask.fedoraproject.org/">Ask Fedora</a></dd>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Common_F${global_variables.release['curr_id']}_bugs">Common Bugs</a></dd>
|
||||
<dd><a href="https://developer.fedoraproject.org/">Fedora Developer Portal</a></dd>
|
||||
<dd><a href="https://docs.fedoraproject.org/en-US/Fedora/${global_variables.release['curr_id']}/html/Installation_Guide">Installation Guide</a></dd>
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">Join</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Join">Join Fedora</a></dd>
|
||||
<dd><a href="http://fedoraplanet.org">Planet Fedora</a></dd>
|
||||
<dd><a href="https://fedoraproject.org/wiki/SIGs">Fedora SIGs</a></dd>
|
||||
<dd><a href="https://admin.fedoraproject.org/accounts/">Fedora Account System</a></dd>
|
||||
<dd><a href="http://fedoracommunity.org/">Fedora Community</a></dd>
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
</div> <!-- /row of widgets -->
|
||||
|
||||
<div class="row">
|
||||
<div class="col-md-2">
|
||||
<div class="widget-body">
|
||||
<a href="http://www.redhat.com/"><img class="rh-logo" src="<% File.join(images_path, "redhat-logo.png") %>" alt="Red Hat Logo" /></a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="col-md-7">
|
||||
<div class="widget-body">
|
||||
<p class="sponsor">Fedora is sponsored by Red Hat.</p>
|
||||
<p class="sponsor"><a href="https://www.redhat.com/en/technologies/linux-platforms/articles/relationship-between-fedora-and-rhel">Learn more about the relationship between Red Hat and Fedora »</a></p>
|
||||
<p class="copy">© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the <a href="https://fedorahosted.org/fedora-websites/">websites team</a></p>
|
||||
</div>
|
||||
</div>
|
||||
</div> <!-- /row of widgets -->
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
|
||||
<!-- Latest compiled and minified JavaScript -->
|
||||
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
|
||||
<script src="<%= File.join(javascripts_path, "bootstrap-offcanvas.js") %>" type="text/javascript"></script>
|
||||
<script type="text/javascript">
|
||||
/*<![CDATA[*/
|
||||
$(document).ready(function() {
|
||||
$("[id^='topicGroup']").on('show.bs.collapse', function (event) {
|
||||
if (!($(event.target).attr('id').match(/^topicSubGroup/))) {
|
||||
$(this).parent().find("[id^='tgSpan']").toggleClass("fa-angle-right fa-angle-down");
|
||||
}
|
||||
});
|
||||
$("[id^='topicGroup']").on('hide.bs.collapse', function (event) {
|
||||
if (!($(event.target).attr('id').match(/^topicSubGroup/))) {
|
||||
$(this).parent().find("[id^='tgSpan']").toggleClass("fa-angle-right fa-angle-down");
|
||||
}
|
||||
});
|
||||
$("[id^='topicSubGroup']").on('show.bs.collapse', function () {
|
||||
$(this).parent().find("[id^='sgSpan']").toggleClass("fa-caret-right fa-caret-down");
|
||||
});
|
||||
$("[id^='topicSubGroup']").on('hide.bs.collapse', function () {
|
||||
$(this).parent().find("[id^='sgSpan']").toggleClass("fa-caret-right fa-caret-down");
|
||||
});
|
||||
});
|
||||
/*]]>*/
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
114
_topic_map.yml
114
_topic_map.yml
|
|
@ -1,114 +0,0 @@
|
|||
# This configuration file dictates the organization of the topic groups and
|
||||
# topics on the main page of the doc site for this branch. Each record
|
||||
# consists of the following:
|
||||
#
|
||||
# --- <= Record delimiter
|
||||
# Name: Origin of the Species <= Display name of topic group
|
||||
# Dir: origin_of_the_species <= Directory name of topic group
|
||||
# Topics:
|
||||
# - Name: The Majestic Marmoset <= Topic name
|
||||
# File: the_majestic_marmoset <= Topic file under group dir +/-
|
||||
# - Name: The Curious Crocodile <= Topic 2 name
|
||||
# File: the_curious_crocodile <= Topic 2 file
|
||||
# - Name: The Numerous Nematodes <= Sub-topic group name
|
||||
# Dir: the_numerous_nematodes <= Sub-topic group dir
|
||||
# Topics:
|
||||
# - Name: The Wily Worm <= Sub-topic name
|
||||
# File: the_wily_worm <= Sub-topic file under <group dir>/<subtopic dir>
|
||||
# - Name: The Acrobatic Ascarid <= Sub-topic 2 name
|
||||
# File: the_acrobatic_ascarid <= Sub-topic 2 file under <group dir>/<subtopic dir>
|
||||
#
|
||||
# The ordering of the records in this document determines the ordering of the
|
||||
# topic groups and topics on the main page.
|
||||
---
|
||||
Name: Fedora System Administration Guide
|
||||
Dir: en-US
|
||||
Topics:
|
||||
- Name: Book Information
|
||||
File: index
|
||||
- Name: Preface
|
||||
File: Preface
|
||||
- Name: Basic System Configuration
|
||||
Dir: basic-system-configuration
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-basic-system-configuration
|
||||
- Name: Opening Graphical Applications
|
||||
File: Opening_GUI_Applications
|
||||
- Name: System Locale and Keyboard Configuration
|
||||
File: System_Locale_and_Keyboard_Configuration
|
||||
- Name: Configuring the Date and Time
|
||||
File: Configuring_the_Date_and_Time
|
||||
- Name: Managing Users and Groups
|
||||
File: Managing_Users_and_Groups
|
||||
- Name: Gaining Privileges
|
||||
File: Gaining_Privileges
|
||||
- Name: Package Management
|
||||
Dir: package-management
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-package-management
|
||||
- Name: DNF
|
||||
File: DNF
|
||||
- Name: rpm-ostree
|
||||
File: rpm-ostree
|
||||
- Name: Infrastructure Services
|
||||
Dir: infrastructure-services
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-infrastructure-services
|
||||
- Name: Services and Daemons
|
||||
File: Services_and_Daemons
|
||||
- Name: OpenSSH
|
||||
File: OpenSSH
|
||||
- Name: TigerVNC
|
||||
File: TigerVNC
|
||||
- Name: Servers
|
||||
Dir: servers
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-servers
|
||||
- Name: Web Servers
|
||||
File: Web_Servers
|
||||
- Name: Mail Servers
|
||||
File: Mail_Servers
|
||||
- Name: Directory Servers
|
||||
File: Directory_Servers
|
||||
- Name: File and Print Servers
|
||||
File: File_and_Print_Servers
|
||||
- Name: Configuring NTP Using the chrony Suite
|
||||
File: Configuring_NTP_Using_the_chrony_Suite
|
||||
- Name: Configuring NTP Using ntpd
|
||||
File: Configuring_NTP_Using_ntpd
|
||||
- Name: Configuring PTP Using ptp4l
|
||||
File: Configuring_PTP_Using_ptp4l
|
||||
- Name: Monitoring and Automation
|
||||
Dir: monitoring-and-automation
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-monitoring-and-automation
|
||||
- Name: System Monitoring Tools
|
||||
File: System_Monitoring_Tools
|
||||
- Name: Viewing and Managing Log Files
|
||||
File: Viewing_and_Managing_Log_Files
|
||||
- Name: Automating System Tasks
|
||||
File: Automating_System_Tasks
|
||||
- Name: OProfile
|
||||
File: OProfile
|
||||
- Name: Kernel, Module and Driver Configuration
|
||||
Dir: kernel-module-driver-configuration
|
||||
Topics:
|
||||
- Name: Introduction
|
||||
File: intro-kernel-module-driver-configuration
|
||||
- Name: Working with the GRUB 2 Boot Loader
|
||||
File: Working_with_the_GRUB_2_Boot_Loader
|
||||
- Name: Manually Upgrading the Kernel
|
||||
File: Manually_Upgrading_the_Kernel
|
||||
- Name: Working with Kernel Modules
|
||||
File: Working_with_Kernel_Modules
|
||||
- Name: RPM
|
||||
File: RPM
|
||||
- Name: The Wayland Display Server
|
||||
File: Wayland
|
||||
- Name: Revision History
|
||||
File: Revision_History
|
||||
3
antora.yml
Normal file
3
antora.yml
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
---
|
||||
name: fedora
|
||||
version: f28
|
||||
55
build.sh
Executable file
55
build.sh
Executable file
|
|
@ -0,0 +1,55 @@
|
|||
#!/bin/sh
|
||||
|
||||
image="antora/antora"
|
||||
cmd="--html-url-extension-style=indexify site.yml"
|
||||
|
||||
if uname | grep -iwq darwin; then
|
||||
# Running on macOS.
|
||||
# Let's assume that the user has the Docker CE installed
|
||||
# which doesn't require a root password.
|
||||
echo ""
|
||||
echo "This build script is using Docker container runtime to run the build in an isolated environment."
|
||||
echo ""
|
||||
docker run --rm -it -v "$(pwd):/antora" "${image}" ${cmd}
|
||||
|
||||
elif uname | grep -iq linux; then
|
||||
# Running on Linux.
|
||||
# Let's assume that it's running the Docker deamon
|
||||
# which requires root.
|
||||
|
||||
if [ -f /usr/local/bin/antora ]; then
|
||||
/usr/local/bin/antora "${cmd}"
|
||||
elif uname -m | grep -iwq aarch64; then
|
||||
echo "no antora/aarch64 container try just \`npm install -g @antora/cli @antora/site-generator-default\`"
|
||||
elif [ -f /usr/bin/podman ]; then
|
||||
echo ""
|
||||
echo "This build script is using Podman to run the build in an isolated environment."
|
||||
echo ""
|
||||
podman run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd}
|
||||
|
||||
elif [ -f /usr/bin/docker ]; then
|
||||
echo ""
|
||||
echo "This build script is using Docker to run the build in an isolated environment."
|
||||
echo ""
|
||||
|
||||
if groups | grep -wq "docker"; then
|
||||
docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd}
|
||||
else
|
||||
echo "You might be asked for your password."
|
||||
echo "You can avoid this by adding your user to the 'docker' group,"
|
||||
echo "but be aware of the security implications."
|
||||
echo "See https://docs.docker.com/install/linux/linux-postinstall/"
|
||||
echo ""
|
||||
sudo docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd}
|
||||
fi
|
||||
else
|
||||
runtime="docker"
|
||||
fi
|
||||
if groups | grep -wq "docker"; then
|
||||
# Check if the current user is in the "docker" group. If true, no sudo is needed.
|
||||
echo ""
|
||||
echo "Error: Container runtime haven't been found on your system. Fix it by:"
|
||||
echo "$ sudo dnf install podman"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
|
@ -1,105 +0,0 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
|
||||
= Preface
|
||||
|
||||
The [citetitle]_System Administrator's Guide_ contains information on how to customize the {MAJOROSVER} system to fit your needs. If you are looking for a comprehensive, task-oriented guide for configuring and customizing your system, this is the manual for you.
|
||||
|
||||
This manual discusses many intermediate topics such as the following:
|
||||
|
||||
* Installing and managing packages using [application]*DNF*
|
||||
|
||||
* Configuring [application]*Apache HTTP Server*, [application]*Postfix*, [application]*Sendmail* and other enterprise-class servers and software
|
||||
|
||||
* Working with kernel modules and upgrading the kernel
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
|
||||
Some of the graphical procedures and menu locations are specific to GNOME, but most command line instructions will be universally applicable.
|
||||
|
||||
====
|
||||
|
||||
[[sect-Preface-Target_Audience]]
|
||||
== Target Audience
|
||||
|
||||
The [citetitle]_System Administrator's Guide_ assumes you have a basic understanding of the {MAJOROS} operating system. If you need help with the installation of this system, refer to the link:++https://docs.fedoraproject.org/install-guide++[{MAJOROS} Installation Guide].
|
||||
|
||||
[[sect-Preface-Book_Organization]]
|
||||
== How to Read this Book
|
||||
|
||||
This manual is divided into the following main categories:
|
||||
|
||||
link:++basic-system-configuration/intro-basic-system-configuration.html++[Basic System Configuration]:: This part covers basic system administration tasks such as keyboard configuration, date and time configuration, managing users and groups, and gaining privileges.
|
||||
+
|
||||
link:++basic-system-configuration/Opening_GUI_Applications.html++[Opening Graphical Applications] describes methods for opening `Graphical User Interface`, or _GUI_, applications in various environments.
|
||||
+
|
||||
link:++basic-system-configuration/System_Locale_and_Keyboard_Configuration.html++[System Locale and Keyboard Configuration] covers basic language and keyboard setup. Read this chapter if you need to configure the language of your desktop, change the keyboard layout, or add the keyboard layout indicator to the panel.
|
||||
+
|
||||
link:++basic-system-configuration/Configuring_the_Date_and_Time.html++[Configuring the Date and Time] covers the configuration of the system date and time. Read this chapter if you need to set or change the date and time.
|
||||
+
|
||||
link:++basic-system-configuration/Managing_Users_and_Groups.html++[Managing Users and Groups] covers the management of users and groups in a graphical user interface and on the command line. Read this chapter if you need to manage users and groups on your system, or enable password aging.
|
||||
+
|
||||
link:++basic-system-configuration/Gaining_Privileges.html++[Gaining Privileges] covers ways to gain administrative privileges using setuid programs such as [command]#su# and [command]#sudo#.
|
||||
|
||||
link:++package-management/intro-package-management.html++[Package Management]:: This part describes how to manage software packages on {MAJOROS} using [application]*DNF*.
|
||||
+
|
||||
link:++package-management/DNF.html++[DNF] describes the [application]*DNF* package manager. Read this chapter for information how to search, install, update, and uninstall packages on the command line.
|
||||
|
||||
link:++infrastructure-services/intro-infrastructure-services.html++[Infrastructure Services]:: This part provides information on how to configure services and daemons, configure authentication, and enable remote logins.
|
||||
+
|
||||
link:++infrastructure-services/Services_and_Daemons.html++[Services and Daemons] covers the configuration of the services to be run when a system is started, and provides information on how to start, stop, and restart the services on the command line using the [command]#systemctl# utility.
|
||||
+
|
||||
link:++infrastructure-services/OpenSSH.html++[OpenSSH] describes how to enable a remote login via the SSH protocol. It covers the configuration of the `sshd` service, as well as a basic usage of the [command]#ssh#, [command]#scp#, [command]#sftp# client utilities. Read this chapter if you need a remote access to a machine.
|
||||
+
|
||||
link:++infrastructure-services/TigerVNC.html++[TigerVNC] describes the _virtual network computing_ (*VNC*) method of graphical desktop sharing which allows you to remotely control other computers.
|
||||
|
||||
link:++servers/intro-servers.html++[Servers]:: This part discusses various topics related to servers such as how to set up a Web server or share files and directories over the network.
|
||||
+
|
||||
link:++servers/Web_Servers.html++[Web Servers] focuses on the [application]*Apache HTTP Server*, a robust, full-featured open source web server developed by the Apache Software Foundation. Read this chapter if you need to configure a web server on your system.
|
||||
+
|
||||
link:++servers/Mail_Servers.html++[Mail Servers] reviews modern email protocols in use today, and some of the programs designed to send and receive email, including [application]*Postfix*, [application]*Sendmail*, [application]*Fetchmail*, and [application]*Procmail*. Read this chapter if you need to configure a mail server on your system.
|
||||
+
|
||||
link:++servers/Directory_Servers.html++[Directory Servers] covers the installation and configuration of [application]*OpenLDAP*, an open source implementation of the LDAPv2 and LDAPv3 protocols. Read this chapter if you need to configure a directory server on your system.
|
||||
+
|
||||
link:++servers/File_and_Print_Servers.html++[File and Print Servers] guides you through the installation and configuration of [application]*Samba*, an open source implementation of the Server Message Block (SMB) protocol, and [application]*vsftpd*, the primary FTP server shipped with {MAJOROS}. Additionally, it explains how to use the [application]*Printer Configuration* tool to configure printers. Read this chapter if you need to configure a file or print server on your system.
|
||||
+
|
||||
link:++servers/Configuring_NTP_Using_the_chrony_Suite.html++[Configuring NTP Using the chrony Suite] covers the installation and configuration of the [application]*chrony* suite, a client and a server for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system.
|
||||
+
|
||||
link:++servers/Configuring_NTP_Using_ntpd.html++[Configuring NTP Using ntpd] covers the installation and configuration of the `NTP` daemon, `ntpd`, for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system, and you prefer not to use the [application]*chrony* application.
|
||||
+
|
||||
link:++servers/Configuring_PTP_Using_ptp4l.html++[Configuring PTP Using ptp4l] covers the installation and configuration of the Precision Time Protocol application, [application]*ptp4l*, an application for use with network drivers that support the Precision Network Time Protocol (`PTP`). Read this chapter if you need to configure the system to synchronize the system clock with a master `PTP` clock.
|
||||
|
||||
link:++monitoring-and-automation/intro-monitoring-and-automation.html++[Monitoring and Automation]:: This part describes various tools that allow system administrators to monitor system performance, automate system tasks, and report bugs.
|
||||
+
|
||||
link:++monitoring-and-automation/System_Monitoring_Tools.html++[System Monitoring Tools] discusses applications and commands that can be used to retrieve important information about the system. Read this chapter to learn how to gather essential system information.
|
||||
+
|
||||
link:++monitoring-and-automation/Viewing_and_Managing_Log_Files.html++[Viewing and Managing Log Files] describes the configuration of the `rsyslog` daemon, and explains how to locate, view, and monitor log files. Read this chapter to learn how to work with log files.
|
||||
+
|
||||
link:++monitoring-and-automation/Automating_System_Tasks.html++[Automating System Tasks] provides an overview of the [command]#cron#, [command]#at#, and [command]#batch# utilities. Read this chapter to learn how to use these utilities to perform automated tasks.
|
||||
+
|
||||
link:++monitoring-and-automation/OProfile.html++[OProfile] covers [application]*OProfile*, a low overhead, system-wide performance monitoring tool. Read this chapter for information on how to use [application]*OProfile* on your system.
|
||||
|
||||
link:++kernel-module-driver-configuration/intro-kernel-module-driver-configuration.html++[Kernel, Module and Driver Configuration]:: This part covers various tools that assist administrators with kernel customization.
|
||||
+
|
||||
link:++kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.html++[Working with the GRUB 2 Boot Loader] der>> describes the GNU GRand Unified Boot loader (GRUB) version 2 boot loader, which enables selecting an operating system or kernel to be loaded at system boot time.
|
||||
+
|
||||
link:++kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.html++[Manually Upgrading the Kernel] provides important information on how to manually update a kernel package using the [command]#rpm# command instead of [command]#dnf#. Read this chapter if you cannot update a kernel package with the [application]*DNF* package manager.
|
||||
+
|
||||
link:++kernel-module-driver-configuration/Working_with_Kernel_Modules.html++[Working with Kernel Modules] explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding. Read this chapter if you need to work with kernel modules.
|
||||
|
||||
link:++RPM.html++[RPM]:: This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by {MAJOROS}, and the use of the [command]#rpm# utility. Read this appendix if you need to use [command]#rpm# instead of [command]#dnf#.
|
||||
|
||||
link:++Wayland.html++[The Wayland Display Server]:: This appendix looks at Wayland, a new display server used in GNOME for {MAJOROS} and how to troubleshoot issues with the Wayland display server.
|
||||
|
||||
include::en-US/Feedback.adoc[]
|
||||
|
||||
[[pref-Acknowledgments]]
|
||||
== Acknowledgments
|
||||
|
||||
Certain portions of this text first appeared in the [citetitle]_Red{nbsp}Hat Enterprise{nbsp}Linux{nbsp}7 System Administrator's Guide_, copyright © 2014–{YEAR} Red{nbsp}Hat, Inc., available at link:++https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html++[].
|
||||
|
||||
link:++monitoring-and-automation/System_Monitoring_Tools.html#sect-System_Monitoring_Tools-Net-SNMP++[Monitoring Performance with Net-SNMP] is based on an article written by Michael Solberg.
|
||||
|
||||
The authors of this book would like to thank the following people for their valuable contributions: Adam Tkáč, Andrew Fitzsimon, Andrius Benokraitis, Brian Cleary Edward Bailey, Garrett LeSage, Jeffrey Fearn, Joe Orton, Joshua Wulf, Karsten Wade, Lucy Ringland, Marcela Mašláňová, Mark Johnson, Michael Behm, Miroslav Lichvár, Radek Vokál, Rahul Kavalapara, Rahul Sundaram, Sandra Moore, Zbyšek Mráz, Jan Včelák, Peter Hutterer, T.C. Hollingsworth, and James Antill, among many others.
|
||||
|
|
@ -1,7 +0,0 @@
|
|||
|
||||
:experimental:
|
||||
|
||||
[[ch-Directory_Servers]]
|
||||
= Directory Servers
|
||||
|
||||
include::en-US/servers/OpenLDAP.adoc[]
|
||||
144
index-main.html
144
index-main.html
|
|
@ -1,144 +0,0 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
|
||||
|
||||
<title>Fedora Documentation Website</title>
|
||||
|
||||
<!-- Bootstrap -->
|
||||
<link rel="stylesheet" href="_stylesheets/asciibinder.css">
|
||||
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
|
||||
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-theme.min.css">
|
||||
|
||||
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
|
||||
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
|
||||
<!--[if lt IE 9]>
|
||||
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
|
||||
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
|
||||
<![endif]-->
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="page-header">
|
||||
<img src="_images/fedora.svg" class="img-responsive" />
|
||||
</div>
|
||||
</div>
|
||||
<div class="row">
|
||||
<div class="col-md-8">
|
||||
<h4><strong>Fedora Documentation Site</strong></h4>
|
||||
<p>Test Build.</p>
|
||||
</div>
|
||||
<div class="col-md-4">
|
||||
<h5><strong>Fedora Documentation</strong></h5>
|
||||
<div class="list-group">
|
||||
<a href="f26/en-US/index.html" class="list-group-item">
|
||||
Fedora 26 Documentation
|
||||
</a>
|
||||
<a href="f27/en-US/index.html" class="list-group-item">
|
||||
Fedora 27 Documentation
|
||||
</a>
|
||||
<a href="rawhide/en-US/index.html" class="list-group-item">
|
||||
Rawhide Documentation
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="bottom" class="text-muted py-3" >
|
||||
<div class="foot">
|
||||
<div class="container">
|
||||
<div class="row footerlinks">
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">About</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Overview">About Fedora</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/sponsors">Sponsors</a></dd>
|
||||
<dd><a href="https://fedoramagazine.org">Fedora Magazine</a></dd>
|
||||
<dd><a href="https:https://fedoraproject.org/wiki/Legal:Main#Legal">Legal</a></dd>
|
||||
</dl>
|
||||
<ul class="list-inline">
|
||||
<li>
|
||||
<a href="https:https://www.facebook.com/TheFedoraProject" class="btn-social btn-outline"><i class="fa fa-fw fa-facebook"></i></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https:https://plus.google.com/112917221531140868607" class="btn-social btn-outline"><i class="fa fa-fw fa-google-plus"></i></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https:https://twitter.com/fedora" class="btn-social btn-outline"><i class="fa fa-fw fa-twitter"></i></a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title uppercase">Download</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://getfedora.org/en/workstation/download">Get Fedora Workstation</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/server/download">Get Fedora Server</a></dd>
|
||||
<dd><a href="https://getfedora.org/en/atomic/download">Get Fedora Atomic</a></dd>
|
||||
<dd><a href="https://spins.fedoraproject.org">Fedora Spins</a></dd>
|
||||
<dd><a href="https://labs.fedoraproject.org">Fedora Labs</a></dd>
|
||||
<dd><a href="https://arm.fedoraproject.org">Fedora ARM<span class="sup">®</span></a></dd>
|
||||
<dd><a href="https://alt.fedoraproject.org/">Alternative Downloads</a></dd>
|
||||
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">Support</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Communicating_and_getting_help">Get Help</a></dd>
|
||||
<dd><a href="https://ask.fedoraproject.org/">Ask Fedora</a></dd>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Common_F${global_variables.release['curr_id']}_bugs">Common Bugs</a></dd>
|
||||
<dd><a href="https://developer.fedoraproject.org/">Fedora Developer Portal</a></dd>
|
||||
<dd><a href="https://docs.fedoraproject.org/en-US/Fedora/${global_variables.release['curr_id']}/html/Installation_Guide">Installation Guide</a></dd>
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-sm-3 col-xs-6 widget">
|
||||
<h3 class="widget-title">Join</h3>
|
||||
<div class="widget-body">
|
||||
<dl>
|
||||
<dd><a href="https://fedoraproject.org/wiki/Join">Join Fedora</a></dd>
|
||||
<dd><a href="http://fedoraplanet.org">Planet Fedora</a></dd>
|
||||
<dd><a href="https://fedoraproject.org/wiki/SIGs">Fedora SIGs</a></dd>
|
||||
<dd><a href="https://admin.fedoraproject.org/accounts/">Fedora Account System</a></dd>
|
||||
<dd><a href="http://fedoracommunity.org/">Fedora Community</a></dd>
|
||||
</dl>
|
||||
</div>
|
||||
</div>
|
||||
</div> <!-- /row of widgets -->
|
||||
|
||||
<div class="row">
|
||||
<div class="col-md-2">
|
||||
<div class="widget-body">
|
||||
<a href="http://www.redhat.com/"><img class="rh-logo" src="_images/redhat-logo.png" alt="Red Hat Logo" /></a>
|
||||
</div>
|
||||
</div>
|
||||
<div class="col-md-7">
|
||||
<div class="widget-body">
|
||||
<p class="sponsor">Fedora is sponsored by Red Hat.</p>
|
||||
<p class="sponsor"><a href="https://www.redhat.com/en/technologies/linux-platforms/articles/relationship-between-fedora-and-rhel">Learn more about the relationship between Red Hat and Fedora »</a></p>
|
||||
<p class="copy">© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the <a href="https://fedorahosted.org/fedora-websites/">websites team</a></p>
|
||||
</div>
|
||||
</div>
|
||||
</div> <!-- /row of widgets -->
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
|
||||
<!-- Include all compiled plugins (below), or include individual files as needed -->
|
||||
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
|
||||
</body>
|
||||
</html>
|
||||
|
Before Width: | Height: | Size: 163 KiB After Width: | Height: | Size: 163 KiB |
|
Before Width: | Height: | Size: 196 KiB After Width: | Height: | Size: 196 KiB |
|
Before Width: | Height: | Size: 176 KiB After Width: | Height: | Size: 176 KiB |
|
Before Width: | Height: | Size: 177 KiB After Width: | Height: | Size: 177 KiB |
|
Before Width: | Height: | Size: 200 KiB After Width: | Height: | Size: 200 KiB |
|
Before Width: | Height: | Size: 140 KiB After Width: | Height: | Size: 140 KiB |
|
Before Width: | Height: | Size: 145 KiB After Width: | Height: | Size: 145 KiB |
|
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 93 KiB |
|
Before Width: | Height: | Size: 147 KiB After Width: | Height: | Size: 147 KiB |
|
Before Width: | Height: | Size: 138 KiB After Width: | Height: | Size: 138 KiB |
|
Before Width: | Height: | Size: 149 KiB After Width: | Height: | Size: 149 KiB |
|
Before Width: | Height: | Size: 144 KiB After Width: | Height: | Size: 144 KiB |
|
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 40 KiB |
|
Before Width: | Height: | Size: 34 KiB After Width: | Height: | Size: 34 KiB |
|
Before Width: | Height: | Size: 880 KiB After Width: | Height: | Size: 880 KiB |
|
Before Width: | Height: | Size: 936 KiB After Width: | Height: | Size: 936 KiB |
|
Before Width: | Height: | Size: 241 KiB After Width: | Height: | Size: 241 KiB |
|
Before Width: | Height: | Size: 250 KiB After Width: | Height: | Size: 250 KiB |
|
Before Width: | Height: | Size: 477 KiB After Width: | Height: | Size: 477 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
|
Before Width: | Height: | Size: 52 KiB After Width: | Height: | Size: 52 KiB |
|
Before Width: | Height: | Size: 26 KiB After Width: | Height: | Size: 26 KiB |
|
Before Width: | Height: | Size: 35 KiB After Width: | Height: | Size: 35 KiB |
|
Before Width: | Height: | Size: 32 KiB After Width: | Height: | Size: 32 KiB |
|
Before Width: | Height: | Size: 37 KiB After Width: | Height: | Size: 37 KiB |
|
Before Width: | Height: | Size: 23 KiB After Width: | Height: | Size: 23 KiB |
|
Before Width: | Height: | Size: 71 KiB After Width: | Height: | Size: 71 KiB |
|
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
|
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 84 KiB After Width: | Height: | Size: 84 KiB |
|
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 67 KiB After Width: | Height: | Size: 67 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 33 KiB |
|
Before Width: | Height: | Size: 38 KiB After Width: | Height: | Size: 38 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 58 KiB After Width: | Height: | Size: 58 KiB |
|
Before Width: | Height: | Size: 945 KiB After Width: | Height: | Size: 945 KiB |
|
Before Width: | Height: | Size: 350 KiB After Width: | Height: | Size: 350 KiB |
|
Before Width: | Height: | Size: 302 KiB After Width: | Height: | Size: 302 KiB |
|
Before Width: | Height: | Size: 943 KiB After Width: | Height: | Size: 943 KiB |
|
Before Width: | Height: | Size: 945 KiB After Width: | Height: | Size: 945 KiB |
|
Before Width: | Height: | Size: 943 KiB After Width: | Height: | Size: 943 KiB |
|
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 72 KiB |
|
Before Width: | Height: | Size: 82 KiB After Width: | Height: | Size: 82 KiB |
|
Before Width: | Height: | Size: 796 KiB After Width: | Height: | Size: 796 KiB |
|
Before Width: | Height: | Size: 900 KiB After Width: | Height: | Size: 900 KiB |
|
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 17 KiB |
|
Before Width: | Height: | Size: 62 KiB After Width: | Height: | Size: 62 KiB |
|
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 47 KiB |
|
Before Width: | Height: | Size: 7.6 KiB After Width: | Height: | Size: 7.6 KiB |
35
modules/system-administrators-guide/nav.adoc
Normal file
35
modules/system-administrators-guide/nav.adoc
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
* xref:index.adoc[System Administration Guide]
|
||||
** xref:Preface.adoc[Preface]
|
||||
** xref:basic-system-configuration/intro-basic-system-configuration.adoc[Basic System Configuration]
|
||||
*** xref:basic-system-configuration/Opening_GUI_Applications.adoc[Opening Graphical Applications]
|
||||
*** xref:basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc[System Locale and Keyboard Configuration]
|
||||
*** xref:basic-system-configuration/Configuring_the_Date_and_Time.adoc[Configuring the Date and Time]
|
||||
*** xref:basic-system-configuration/Managing_Users_and_Groups.adoc[Managing Users and Groups]
|
||||
*** xref:basic-system-configuration/Gaining_Privileges.adoc[Gaining Privileges]
|
||||
** xref:package-management/intro-package-management.adoc[Package Management]
|
||||
*** xref:package-management/DNF.adoc[DNF]
|
||||
*** xref:package-management/rpm-ostree.adoc[rpm-ostree]
|
||||
** xref:infrastructure-services/intro-infrastructure-services.adoc[Infrastructure Services]
|
||||
*** xref:infrastructure-services/Services_and_Daemons.adoc[Services and Daemons]
|
||||
*** xref:infrastructure-services/OpenSSH.adoc[OpenSSH]
|
||||
*** xref:infrastructure-services/TigerVNC.adoc[TigerVNC]
|
||||
** xref:servers/intro-servers.adoc[Servers]
|
||||
*** xref:servers/Web_Servers.adoc[Web Servers]
|
||||
*** xref:servers/Mail_Servers.adoc[Mail Servers]
|
||||
*** xref:servers/Directory_Servers.adoc[Directory Servers]
|
||||
*** xref:servers/File_and_Print_Servers.adoc[File and Print Servers]
|
||||
*** xref:servers/Configuring_NTP_Using_the_chrony_Suite.adoc[Configuring NTP Using the chrony Suite]
|
||||
*** xref:servers/Configuring_NTP_Using_ntpd.adoc[Configuring NTP Using ntpd]
|
||||
*** xref:servers/Configuring_PTP_Using_ptp4l.adoc[Configuring PTP Using ptp4l]
|
||||
** xref:monitoring-and-automation/intro-monitoring-and-automation.adoc[Monitoring and Automation]
|
||||
*** xref:monitoring-and-automation/System_Monitoring_Tools.adoc[System Monitoring Tools]
|
||||
*** xref:monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc[Viewing and Managing Log Files]
|
||||
*** xref:monitoring-and-automation/Automating_System_Tasks.adoc[Automating System Tasks]
|
||||
*** xref:monitoring-and-automation/OProfile.adoc[OProfile]
|
||||
** xref:kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc[Kernel, Module and Driver Configuration]
|
||||
*** xref:kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc[Working with the GRUB 2 Boot Loader]
|
||||
*** xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc[Manually Upgrading the Kernel]
|
||||
*** xref:kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc[Working with Kernel Modules]
|
||||
** xref:RPM.adoc[RPM]
|
||||
** xref:Wayland.adoc[The Wayland Display Server]
|
||||
** xref:Revision_History.adoc[Revision History]
|
||||
105
modules/system-administrators-guide/pages/Preface.adoc
Normal file
105
modules/system-administrators-guide/pages/Preface.adoc
Normal file
|
|
@ -0,0 +1,105 @@
|
|||
|
||||
:experimental:
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Preface
|
||||
|
||||
The [citetitle]_System Administrator's Guide_ contains information on how to customize the {MAJOROSVER} system to fit your needs. If you are looking for a comprehensive, task-oriented guide for configuring and customizing your system, this is the manual for you.
|
||||
|
||||
This manual discusses many intermediate topics such as the following:
|
||||
|
||||
* Installing and managing packages using [application]*DNF*
|
||||
|
||||
* Configuring [application]*Apache HTTP Server*, [application]*Postfix*, [application]*Sendmail* and other enterprise-class servers and software
|
||||
|
||||
* Working with kernel modules and upgrading the kernel
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
|
||||
Some of the graphical procedures and menu locations are specific to GNOME, but most command line instructions will be universally applicable.
|
||||
|
||||
====
|
||||
|
||||
[[sect-Preface-Target_Audience]]
|
||||
== Target Audience
|
||||
|
||||
The [citetitle]_System Administrator's Guide_ assumes you have a basic understanding of the {MAJOROS} operating system. If you need help with the installation of this system, refer to the link:https://docs.fedoraproject.org/install-guide[{MAJOROS} Installation Guide].
|
||||
|
||||
[[sect-Preface-Book_Organization]]
|
||||
== How to Read this Book
|
||||
|
||||
This manual is divided into the following main categories:
|
||||
|
||||
xref:basic-system-configuration/intro-basic-system-configuration.html[Basic System Configuration]:: This part covers basic system administration tasks such as keyboard configuration, date and time configuration, managing users and groups, and gaining privileges.
|
||||
+
|
||||
xref:basic-system-configuration/Opening_GUI_Applications.html[Opening Graphical Applications] describes methods for opening `Graphical User Interface`, or _GUI_, applications in various environments.
|
||||
+
|
||||
xref:basic-system-configuration/System_Locale_and_Keyboard_Configuration.html[System Locale and Keyboard Configuration] covers basic language and keyboard setup. Read this chapter if you need to configure the language of your desktop, change the keyboard layout, or add the keyboard layout indicator to the panel.
|
||||
+
|
||||
xref:basic-system-configuration/Configuring_the_Date_and_Time.html[Configuring the Date and Time] covers the configuration of the system date and time. Read this chapter if you need to set or change the date and time.
|
||||
+
|
||||
xref:basic-system-configuration/Managing_Users_and_Groups.html[Managing Users and Groups] covers the management of users and groups in a graphical user interface and on the command line. Read this chapter if you need to manage users and groups on your system, or enable password aging.
|
||||
+
|
||||
xref:basic-system-configuration/Gaining_Privileges.html[Gaining Privileges] covers ways to gain administrative privileges using setuid programs such as [command]#su# and [command]#sudo#.
|
||||
|
||||
xref:package-management/intro-package-management.html[Package Management]:: This part describes how to manage software packages on {MAJOROS} using [application]*DNF*.
|
||||
+
|
||||
xref:package-management/DNF.html[DNF] describes the [application]*DNF* package manager. Read this chapter for information how to search, install, update, and uninstall packages on the command line.
|
||||
|
||||
xref:infrastructure-services/intro-infrastructure-services.html[Infrastructure Services]:: This part provides information on how to configure services and daemons, configure authentication, and enable remote logins.
|
||||
+
|
||||
xref:infrastructure-services/Services_and_Daemons.html[Services and Daemons] covers the configuration of the services to be run when a system is started, and provides information on how to start, stop, and restart the services on the command line using the [command]#systemctl# utility.
|
||||
+
|
||||
xref:infrastructure-services/OpenSSH.html[OpenSSH] describes how to enable a remote login via the SSH protocol. It covers the configuration of the `sshd` service, as well as a basic usage of the [command]#ssh#, [command]#scp#, [command]#sftp# client utilities. Read this chapter if you need a remote access to a machine.
|
||||
+
|
||||
xref:infrastructure-services/TigerVNC.html[TigerVNC] describes the _virtual network computing_ (*VNC*) method of graphical desktop sharing which allows you to remotely control other computers.
|
||||
|
||||
xref:servers/intro-servers.html[Servers]:: This part discusses various topics related to servers such as how to set up a Web server or share files and directories over the network.
|
||||
+
|
||||
xref:servers/Web_Servers.html[Web Servers] focuses on the [application]*Apache HTTP Server*, a robust, full-featured open source web server developed by the Apache Software Foundation. Read this chapter if you need to configure a web server on your system.
|
||||
+
|
||||
xref:servers/Mail_Servers.html[Mail Servers] reviews modern email protocols in use today, and some of the programs designed to send and receive email, including [application]*Postfix*, [application]*Sendmail*, [application]*Fetchmail*, and [application]*Procmail*. Read this chapter if you need to configure a mail server on your system.
|
||||
+
|
||||
xref:servers/Directory_Servers.html[Directory Servers] covers the installation and configuration of [application]*OpenLDAP*, an open source implementation of the LDAPv2 and LDAPv3 protocols. Read this chapter if you need to configure a directory server on your system.
|
||||
+
|
||||
xref:servers/File_and_Print_Servers.html[File and Print Servers] guides you through the installation and configuration of [application]*Samba*, an open source implementation of the Server Message Block (SMB) protocol, and [application]*vsftpd*, the primary FTP server shipped with {MAJOROS}. Additionally, it explains how to use the [application]*Printer Configuration* tool to configure printers. Read this chapter if you need to configure a file or print server on your system.
|
||||
+
|
||||
xref:servers/Configuring_NTP_Using_the_chrony_Suite.html[Configuring NTP Using the chrony Suite] covers the installation and configuration of the [application]*chrony* suite, a client and a server for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system.
|
||||
+
|
||||
xref:servers/Configuring_NTP_Using_ntpd.html[Configuring NTP Using ntpd] covers the installation and configuration of the `NTP` daemon, `ntpd`, for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system, and you prefer not to use the [application]*chrony* application.
|
||||
+
|
||||
xref:servers/Configuring_PTP_Using_ptp4l.html[Configuring PTP Using ptp4l] covers the installation and configuration of the Precision Time Protocol application, [application]*ptp4l*, an application for use with network drivers that support the Precision Network Time Protocol (`PTP`). Read this chapter if you need to configure the system to synchronize the system clock with a master `PTP` clock.
|
||||
|
||||
xref:monitoring-and-automation/intro-monitoring-and-automation.html[Monitoring and Automation]:: This part describes various tools that allow system administrators to monitor system performance, automate system tasks, and report bugs.
|
||||
+
|
||||
xref:monitoring-and-automation/System_Monitoring_Tools.html[System Monitoring Tools] discusses applications and commands that can be used to retrieve important information about the system. Read this chapter to learn how to gather essential system information.
|
||||
+
|
||||
xref:monitoring-and-automation/Viewing_and_Managing_Log_Files.html[Viewing and Managing Log Files] describes the configuration of the `rsyslog` daemon, and explains how to locate, view, and monitor log files. Read this chapter to learn how to work with log files.
|
||||
+
|
||||
xref:monitoring-and-automation/Automating_System_Tasks.html[Automating System Tasks] provides an overview of the [command]#cron#, [command]#at#, and [command]#batch# utilities. Read this chapter to learn how to use these utilities to perform automated tasks.
|
||||
+
|
||||
xref:monitoring-and-automation/OProfile.html[OProfile] covers [application]*OProfile*, a low overhead, system-wide performance monitoring tool. Read this chapter for information on how to use [application]*OProfile* on your system.
|
||||
|
||||
xref:kernel-module-driver-configuration/intro-kernel-module-driver-configuration.html[Kernel, Module and Driver Configuration]:: This part covers various tools that assist administrators with kernel customization.
|
||||
+
|
||||
xref:kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.html[Working with the GRUB 2 Boot Loader] der>> describes the GNU GRand Unified Boot loader (GRUB) version 2 boot loader, which enables selecting an operating system or kernel to be loaded at system boot time.
|
||||
+
|
||||
xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.html[Manually Upgrading the Kernel] provides important information on how to manually update a kernel package using the [command]#rpm# command instead of [command]#dnf#. Read this chapter if you cannot update a kernel package with the [application]*DNF* package manager.
|
||||
+
|
||||
xref:kernel-module-driver-configuration/Working_with_Kernel_Modules.html[Working with Kernel Modules] explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding. Read this chapter if you need to work with kernel modules.
|
||||
|
||||
xref:RPM.html[RPM]:: This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by {MAJOROS}, and the use of the [command]#rpm# utility. Read this appendix if you need to use [command]#rpm# instead of [command]#dnf#.
|
||||
|
||||
xref:Wayland.html[The Wayland Display Server]:: This appendix looks at Wayland, a new display server used in GNOME for {MAJOROS} and how to troubleshoot issues with the Wayland display server.
|
||||
|
||||
include::{partialsdir}/Feedback.adoc[]
|
||||
|
||||
[[pref-Acknowledgments]]
|
||||
== Acknowledgments
|
||||
|
||||
Certain portions of this text first appeared in the [citetitle]_Red{nbsp}Hat Enterprise{nbsp}Linux{nbsp}7 System Administrator's Guide_, copyright © 2014–{YEAR} Red{nbsp}Hat, Inc., available at link:https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html[].
|
||||
|
||||
xref:monitoring-and-automation/System_Monitoring_Tools.html#sect-System_Monitoring_Tools-Net-SNMP[Monitoring Performance with Net-SNMP] is based on an article written by Michael Solberg.
|
||||
|
||||
The authors of this book would like to thank the following people for their valuable contributions: Adam Tkáč, Andrew Fitzsimon, Andrius Benokraitis, Brian Cleary Edward Bailey, Garrett LeSage, Jeffrey Fearn, Joe Orton, Joshua Wulf, Karsten Wade, Lucy Ringland, Marcela Mašláňová, Mark Johnson, Michael Behm, Miroslav Lichvár, Radek Vokál, Rahul Kavalapara, Rahul Sundaram, Sandra Moore, Zbyšek Mráz, Jan Včelák, Peter Hutterer, T.C. Hollingsworth, and James Antill, among many others.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-RPM]]
|
||||
= RPM
|
||||
|
|
@ -348,12 +348,12 @@ indexterm:[packages,finding Fedora RPM packages]indexterm:[RPM,finding Fedora RP
|
|||
Although there are many [application]*RPM* repositories on the Internet, for security and compatibility reasons, you should consider installing only official Fedora-provided RPM packages. The following is a list of sources for [application]*RPM* packages:
|
||||
|
||||
* indexterm:[{MAJOROS} installation media,installable packages]
|
||||
indexterm:[packages,{MAJOROS} installation media]
|
||||
Official {MAJOROS} installation media.
|
||||
indexterm:[packages,{MAJOROS} installation media]
|
||||
Official {MAJOROS} installation media.
|
||||
|
||||
* indexterm:[initial RPM repositories,installable packages]
|
||||
indexterm:[packages,initial RPM repositories]
|
||||
Official [application]*RPM* repositories provided with the [application]*DNF* package manager. See xref:package-management/DNF.adoc#ch-DNF[DNF] for details on how to use the official {MAJOROS} package repositories.
|
||||
indexterm:[packages,initial RPM repositories]
|
||||
Official [application]*RPM* repositories provided with the [application]*DNF* package manager. See xref:package-management/DNF.adoc#ch-DNF[DNF] for details on how to use the official {MAJOROS} package repositories.
|
||||
|
||||
* Unofficial, third-party repositories not affiliated with {OSORG} also provide RPM packages.
|
||||
|
||||
|
|
@ -413,44 +413,49 @@ indexterm:[RPM,tips]indexterm:[packages,RPM,tips]
|
|||
[application]*RPM* is a useful tool for both managing your system and diagnosing and fixing problems. See the following examples for an overview of some of the most-used options.
|
||||
|
||||
* To verify your entire system and see what files are missing, issue the following command as `root`:
|
||||
indexterm:[RPM,finding deleted files with]indexterm:[packages,finding deleted files from]
|
||||
indexterm:[RPM,finding deleted files with]indexterm:[packages,finding deleted files from]
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -Va#
|
||||
----
|
||||
|
||||
+
|
||||
If some files are missing or appear corrupted, consider reinstalling relevant packages.
|
||||
|
||||
* To determine which package owns a file, enter:
|
||||
indexterm:[RPM,determining file ownership with]indexterm:[packages,determining file ownership with]
|
||||
indexterm:[RPM,determining file ownership with]indexterm:[packages,determining file ownership with]
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -qf _file_pass:attributes[{blank}]#
|
||||
----
|
||||
|
||||
* To verify the package that owns a particular file, enter as `root`:
|
||||
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -Vf _file_pass:attributes[{blank}]#
|
||||
----
|
||||
|
||||
* To locate documentation files that are a part of a package to which a file belongs, enter:
|
||||
indexterm:[RPM,documentation with]indexterm:[packages,locating documentation for]indexterm:[documentation,finding installed]
|
||||
indexterm:[RPM,documentation with]indexterm:[packages,locating documentation for]indexterm:[documentation,finding installed]
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -qdf _file_pass:attributes[{blank}]#
|
||||
----
|
||||
|
||||
* To find information about a (non-installed) package file, use the following command:
|
||||
indexterm:[RPM,querying uninstalled packages]indexterm:[packages,querying uninstalled]
|
||||
indexterm:[RPM,querying uninstalled packages]indexterm:[packages,querying uninstalled]
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -qip _package.rpm_pass:attributes[{blank}]#
|
||||
----
|
||||
|
||||
* To list files contained in a package, use:
|
||||
indexterm:[RPM,querying for file list]indexterm:[packages,obtaining list of files]
|
||||
indexterm:[RPM,querying for file list]indexterm:[packages,obtaining list of files]
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
[command]#rpm -qlp _package.rpm_pass:attributes[{blank}]#
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
:hardbreaks:
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Wayland]]
|
||||
= The Wayland Display Server
|
||||
|
|
@ -4,8 +4,8 @@
|
|||
:MAJOROS: Fedora
|
||||
:MAJOROSVER: Fedora Rawhide
|
||||
:OSORG: The Fedora Project
|
||||
:PKGOS: fcRawhide
|
||||
:PKGOS: fc28
|
||||
:PRODUCT: Fedora Documentation
|
||||
:PRODVER: Rawhide
|
||||
:YEAR: 2017
|
||||
:PRODVER: 28
|
||||
:YEAR: 2018
|
||||
:nbsp: pass:q[ ]
|
||||
|
|
@ -34,7 +34,7 @@ indexterm:[FTP,server software,vsftpd]indexterm:[FTP,server software,Red Hat Con
|
|||
* [command]#vsftpd# — A fast, secure `FTP` daemon which is the preferred `FTP` server for {MAJOROS}. The remainder of this section focuses on [command]#vsftpd#.
|
||||
|
||||
[[s3-ftp-servers-vsftpd]]
|
||||
====== [command]#vsftpd#
|
||||
==== [command]#vsftpd#
|
||||
|
||||
_The Very Secure FTP Daemon_ ([command]#vsftpd#) is designed from the ground up to be fast, stable, and, most importantly, secure. [command]#vsftpd# is the only stand-alone `FTP` server distributed with {MAJOROS}, due to its ability to handle large numbers of connections efficiently and securely.
|
||||
|
||||
|
|
@ -110,7 +110,7 @@ To conditionally restart the server, as `root` type:
|
|||
[command]#systemctl condrestart vsftpd.service#
|
||||
----
|
||||
|
||||
By default, the [command]#vsftpd# service does *not* start automatically at boot time. To configure the [command]#vsftpd# service to start at boot time, use a service manager such as [command]#systemctl#. See xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
By default, the [command]#vsftpd# service does *not* start automatically at boot time. To configure the [command]#vsftpd# service to start at boot time, use a service manager such as [command]#systemctl#. See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
|
||||
[[s3-ftp-firewalld]]
|
||||
==== Configuring the Firewall for FTP
|
||||
|
|
@ -125,7 +125,7 @@ For example, to perform the basic LDAP server installation, type the following a
|
|||
~]#{nbsp}dnf install openldap openldap-clients openldap-servers
|
||||
----
|
||||
|
||||
Note that you must have superuser privileges (that is, you must be logged in as `root`) to run this command. For more information on how to install new packages in {MAJOROS}, see xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
Note that you must have superuser privileges (that is, you must be logged in as `root`) to run this command. For more information on how to install new packages in {MAJOROS}, see xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
[[s3-ldap-packages-openldap-servers]]
|
||||
==== Overview of OpenLDAP Server Utilities
|
||||
|
|
@ -499,7 +499,7 @@ Re-enter new password:
|
|||
|
||||
[subs="quotes"]
|
||||
----
|
||||
olcRootPW: {SSHA}WczWsyPEnMchFf1GRTweq2q7XJcvmSxD
|
||||
olcRootPW: \{SSHA}WczWsyPEnMchFf1GRTweq2q7XJcvmSxD
|
||||
----
|
||||
|
||||
====
|
||||
|
|
@ -765,7 +765,7 @@ The [option]`-P` option makes this setting persistent across system reboots. See
|
|||
[[s2-ldap-running]]
|
||||
=== Running an OpenLDAP Server
|
||||
indexterm:[slapd,OpenLDAP]
|
||||
This section describes how to start, stop, restart, and check the current status of the [application]*Standalone LDAP Daemon*. For more information on how to manage system services in general, see xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons].
|
||||
This section describes how to start, stop, restart, and check the current status of the [application]*Standalone LDAP Daemon*. For more information on how to manage system services in general, see xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons].
|
||||
|
||||
[[s3-ldap-running-starting]]
|
||||
==== Starting the Service
|
||||
|
|
@ -784,7 +784,7 @@ To configure the service to start automatically at the boot time, use the follow
|
|||
~]#{nbsp}systemctl enable slapd.service
|
||||
----
|
||||
|
||||
See xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
|
||||
[[s3-ldap-running-stopping]]
|
||||
==== Stopping the Service
|
||||
|
|
@ -804,7 +804,7 @@ To prevent the service from starting automatically at the boot time, type as `ro
|
|||
rm '/etc/systemd/system/multi-user.target.wants/slapd.service'
|
||||
----
|
||||
|
||||
See xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
|
||||
[[s3-ldap-running-restarting]]
|
||||
==== Restarting the Service
|
||||
|
|
@ -182,7 +182,7 @@ Note that in order to add a Samba printer, you need to have the [package]*samba-
|
|||
[command]#dnf install samba-client#
|
||||
----
|
||||
|
||||
For more information on installing packages with DNF, refer to xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
For more information on installing packages with DNF, refer to xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -15,7 +15,7 @@ In order to use [application]*Samba*, first ensure the [package]*samba* package
|
|||
~]#{nbsp}dnf install samba
|
||||
----
|
||||
|
||||
For more information on installing packages with DNF, see xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
For more information on installing packages with DNF, see xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -147,7 +147,7 @@ The [application]*mount.cifs* utility is a separate RPM (independent from Samba)
|
|||
~]#{nbsp}dnf install cifs-utils
|
||||
----
|
||||
|
||||
For more information on installing packages with DNF, see xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
For more information on installing packages with DNF, see xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
Note that the [package]*cifs-utils* package also contains the [application]*cifs.upcall* binary called by the kernel in order to perform kerberized CIFS mounts. For more information on [application]*cifs.upcall*, see the *cifs.upcall*(8) manual page.
|
||||
|
||||
|
|
@ -296,7 +296,7 @@ By default, the `smb` service does *not* start automatically at boot time. To co
|
|||
~]#{nbsp}systemctl enable smb.service
|
||||
----
|
||||
|
||||
See xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information regarding this tool.
|
||||
See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information regarding this tool.
|
||||
|
||||
[[sect-Samba-Server_Types_and_the_smb.conf_File]]
|
||||
=== Samba Server Types and the `smb.conf` File
|
||||
|
|
@ -801,11 +801,11 @@ Plain Text:: Plain text back ends are nothing more than the `/etc/passwd` type
|
|||
+
|
||||
The `tdbsam` back end is recommended for 250 users at most. Larger organizations should require Active Directory or LDAP integration due to scalability and possible network infrastructure concerns.
|
||||
|
||||
`ldapsam`:: The `ldapsam` back end provides an optimal distributed account installation method for Samba. LDAP is optimal because of its ability to replicate its database to any number of servers such as the [application]*Red{nbsp}Hat Directory Server* or an [application]*OpenLDAP Server*. LDAP databases are light-weight and scalable, and as such are preferred by large enterprises. Installation and configuration of directory servers is beyond the scope of this chapter. For more information on the [application]*Red{nbsp}Hat Directory Server*, see the [citetitle]_link:++https://access.redhat.com/documentation/en-us/red_hat_directory_server/10/html/deployment_guide/index++[Red Hat Directory Server 10 Deployment Guide]_. For more information on LDAP, see xref:Directory_Servers.adoc#s1-OpenLDAP[OpenLDAP].
|
||||
`ldapsam`:: The `ldapsam` back end provides an optimal distributed account installation method for Samba. LDAP is optimal because of its ability to replicate its database to any number of servers such as the [application]*Red{nbsp}Hat Directory Server* or an [application]*OpenLDAP Server*. LDAP databases are light-weight and scalable, and as such are preferred by large enterprises. Installation and configuration of directory servers is beyond the scope of this chapter. For more information on the [application]*Red{nbsp}Hat Directory Server*, see the [citetitle]_link:++https://access.redhat.com/documentation/en-us/red_hat_directory_server/10/html/deployment_guide/index++[Red Hat Directory Server 10 Deployment Guide]_. For more information on LDAP, see xref:servers/Directory_Servers.adoc#s1-OpenLDAP[OpenLDAP].
|
||||
+
|
||||
If you are upgrading from a previous version of Samba to 3.0, note that the OpenLDAP schema file (`/usr/share/doc/samba-_version_pass:attributes[{blank}]/LDAP/samba.schema`) and the Red{nbsp}Hat Directory Server schema file (`/usr/share/doc/samba-_version_pass:attributes[{blank}]/LDAP/samba-schema-FDS.ldif`) have changed. These files contain the _attribute syntax definitions_ and _objectclass definitions_ that the `ldapsam` back end needs in order to function properly.
|
||||
+
|
||||
As such, if you are using the `ldapsam` back end for your Samba server, you will need to configure `slapd` to include one of these schema file. See xref:Directory_Servers.adoc#s3-ldap-configuration-schema[Extending Schema] for directions on how to do this.
|
||||
As such, if you are using the `ldapsam` back end for your Samba server, you will need to configure `slapd` to include one of these schema file. See xref:servers/Directory_Servers.adoc#s3-ldap-configuration-schema [Extending Schema] for directions on how to do this.
|
||||
+
|
||||
.Make sure the openldap-servers package is installed
|
||||
[NOTE]
|
||||
|
|
@ -131,7 +131,7 @@ This section describes how to start, stop, restart, and check the current status
|
|||
|
||||
For more information on the concept of targets and how to manage system services in {MAJOROS} in general, see
|
||||
//link to systemd section when ready
|
||||
xref:../infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons].
|
||||
xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons].
|
||||
|
||||
[[s3-apache-running-starting]]
|
||||
==== Starting the Service
|
||||
|
|
@ -2348,7 +2348,7 @@ Due to the SSL3.0 protocol vulnerability CVE-2014-3566, described in link:++http
|
|||
[[s3-apache-Enabling_and_Disabling_SSL_and_TLS_in_mod_ssl]]
|
||||
==== Enabling and Disabling SSL and TLS in mod_ssl
|
||||
|
||||
To disable and enable specific versions of the SSL and TLS protocol, either do it globally by adding the [command]#SSLProtocol# directive in the "## SSL Global Context" section of the configuration file and removing it everywhere else, or edit the default entry under "# SSL Protocol support" in all "VirtualHost" sections. If you do not specify it in the per-domain VirtualHost section then it will inherit the settings from the global section. To make sure that a protocol version is being disabled the administrator should either *only* specify [command]#SSLProtocol# in the "SSL Global Context" section, or specify it in *all* per-domain VirtualHost sections.
|
||||
To disable and enable specific versions of the SSL and TLS protocol, either do it globally by adding the [command]#SSLProtocol# directive in the "\#\# SSL Global Context" section of the configuration file and removing it everywhere else, or edit the default entry under "\# SSL Protocol support" in all "VirtualHost" sections. If you do not specify it in the per-domain VirtualHost section then it will inherit the settings from the global section. To make sure that a protocol version is being disabled the administrator should either *only* specify [command]#SSLProtocol# in the "SSL Global Context" section, or specify it in *all* per-domain VirtualHost sections.
|
||||
|
||||
[[proc-Disable_SSLv2_and_SSLv3]]
|
||||
.Disable SSLv2 and SSLv3
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Configuring_the_Date_and_Time]]
|
||||
= Configuring the Date and Time
|
||||
|
|
@ -196,7 +196,7 @@ To enable automatic synchronization of the system clock with a remote server, ty
|
|||
~]#{nbsp}timedatectl set-ntp yes
|
||||
----
|
||||
|
||||
The command will fail if an `NTP` service is not installed. See xref:../servers/Configuring_NTP_Using_the_chrony_Suite.adoc#sect-Installing_chrony[Installing chrony] for more information.
|
||||
The command will fail if an `NTP` service is not installed. See xref:servers/Configuring_NTP_Using_the_chrony_Suite.adoc#sect-Installing_chrony[Installing chrony] for more information.
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -357,7 +357,7 @@ Precision Time Protocol (PTP), the kernel automatically synchronizes the hardwar
|
|||
|
||||
====
|
||||
|
||||
For details about NTP, see xref:../servers/Configuring_NTP_Using_the_chrony_Suite.adoc#ch-Configuring_NTP_Using_the_chrony_Suite[Configuring NTP Using the chrony Suite] and xref:../servers/Configuring_NTP_Using_ntpd.adoc#ch-Configuring_NTP_Using_ntpd[Configuring NTP Using ntpd]. For information about PTP, see xref:../servers/Configuring_PTP_Using_ptp4l.adoc#ch-Configuring_PTP_Using_ptp4l[Configuring PTP Using ptp4l]. For information about setting the hardware clock after executing [application]*ntpdate*, see xref:../servers/Configuring_NTP_Using_ntpd.adoc#s1-Configuring_the_Hardware_Clock_update[Configuring the Hardware Clock Update].
|
||||
For details about NTP, see xref:servers/Configuring_NTP_Using_the_chrony_Suite.adoc#ch-Configuring_NTP_Using_the_chrony_Suite[Configuring NTP Using the chrony Suite] and xref:servers/Configuring_NTP_Using_ntpd.adoc#ch-Configuring_NTP_Using_ntpd[Configuring NTP Using ntpd]. For information about PTP, see xref:servers/Configuring_PTP_Using_ptp4l.adoc#ch-Configuring_PTP_Using_ptp4l[Configuring PTP Using ptp4l]. For information about setting the hardware clock after executing [application]*ntpdate*, see xref:servers/Configuring_NTP_Using_ntpd.adoc#s1-Configuring_the_Hardware_Clock_update[Configuring the Hardware Clock Update].
|
||||
|
||||
[[sect2-displaying-time-hwclock]]
|
||||
=== Displaying the Current Date and Time
|
||||
|
|
@ -473,4 +473,4 @@ For more information on how to configure the date and time in {MAJOROSVER}, see
|
|||
|
||||
.See Also
|
||||
|
||||
* xref:System_Locale_and_Keyboard_Configuration.adoc#ch-System_Locale_and_Keyboard_Configuration[System Locale and Keyboard Configuration] documents how to configure the keyboard layout.
|
||||
* xref:basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc#ch-System_Locale_and_Keyboard_Configuration[System Locale and Keyboard Configuration] documents how to configure the keyboard layout.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[chap-Gaining_Privileges]]
|
||||
= Gaining Privileges
|
||||
|
|
@ -37,7 +37,7 @@ You can also use the [application]*Users* settings tool to modify group membersh
|
|||
|
||||
. Change the Account Type from `Standard` to `Administrator`. This will add the user to the `wheel` group.
|
||||
|
||||
See xref:Managing_Users_and_Groups.adoc#s1-users-configui[Managing Users in a Graphical Environment] for more information about the [application]*Users* tool.
|
||||
See xref:basic-system-configuration/Managing_Users_and_Groups.adoc#s1-users-configui[Managing Users in a Graphical Environment] for more information about the [application]*Users* tool.
|
||||
|
||||
After you add the desired users to the `wheel` group, it is advisable to only allow these specific users to use the [command]#su# command. To do this, edit the PAM configuration file for [command]#su#, `/etc/pam.d/su`. Open this file in a text editor and uncomment the following line by removing the `#` character:
|
||||
|
||||
|
|
@ -76,7 +76,7 @@ Each successful authentication using the [command]#sudo# command is logged to th
|
|||
[subs="macros"]
|
||||
----
|
||||
session required pam_tty_audit.so disable=pass:quotes[_pattern_] enable=pass:quotes[_pattern_]
|
||||
|
||||
|
||||
----
|
||||
|
||||
where _pattern_ represents a comma-separated listing of users with an optional use of globs. For example, the following configuration will enable TTY auditing for the `root` user and disable it for all other users:
|
||||
|
|
@ -154,4 +154,4 @@ While programs allowing users to gain administrative privileges are a potential
|
|||
|
||||
.See Also
|
||||
|
||||
* xref:Managing_Users_and_Groups.adoc#ch-Managing_Users_and_Groups[Managing Users and Groups] documents how to manage system users and groups in the graphical user interface and on the command line.
|
||||
* xref:basic-system-configuration/Managing_Users_and_Groups.adoc#ch-Managing_Users_and_Groups[Managing Users and Groups] documents how to manage system users and groups in the graphical user interface and on the command line.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Managing_Users_and_Groups]]
|
||||
= Managing Users and Groups
|
||||
|
|
@ -72,7 +72,7 @@ When a new user is created, the account is disabled until a password is set. The
|
|||
[[s1-users-tools]]
|
||||
== Using Command Line Tools
|
||||
indexterm:[users,tools for management of,useradd]indexterm:[users,tools for management of,the Users setting tool]indexterm:[groups,tools for management of,groupadd]
|
||||
Apart from the [application]*Users* settings tool described in xref:Managing_Users_and_Groups.adoc#s1-users-configui[Managing Users in a Graphical Environment], which is designed for basic managing of users, you can use command line tools for managing users and groups that are listed in xref:Managing_Users_and_Groups.adoc#table-users-tools[Command line utilities for managing users and groups].
|
||||
Apart from the [application]*Users* settings tool described in xref:basic-system-configuration/Managing_Users_and_Groups.adoc#s1-users-configui[Managing Users in a Graphical Environment], which is designed for basic managing of users, you can use command line tools for managing users and groups that are listed in xref:Managing_Users_and_Groups.adoc#table-users-tools[Command line utilities for managing users and groups].
|
||||
|
||||
[[table-users-tools]]
|
||||
.Command line utilities for managing users and groups
|
||||
|
|
@ -351,7 +351,7 @@ Especially when the user is logged in as `root`, an unattended login session may
|
|||
[command]#dnf# [option]`install` [option]`screen`
|
||||
----
|
||||
+
|
||||
For more information on how to install packages in {MAJOROS}, refer to xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
For more information on how to install packages in {MAJOROS}, refer to xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
. As `root`, add the following line at the beginning of the `/etc/profile` file to make sure the processing of this file cannot be interrupted:
|
||||
+
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Opening_GUI_Applications]]
|
||||
= Opening Graphical Applications
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-System_Locale_and_Keyboard_Configuration]]
|
||||
= System Locale and Keyboard Configuration
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= System Administrator's Guide
|
||||
|
||||
|
|
@ -12,7 +12,7 @@ Deployment, Configuration, and Administration of {MAJOROSVER}
|
|||
The [citetitle]_System Administrator's Guide_ documents relevant information regarding the deployment, configuration, and administration of {MAJOROSVER}. It is oriented towards system administrators with a basic understanding of the system.
|
||||
|
||||
--
|
||||
image:../../Common_Content/images/title_logo.svg[Fedora Documentation Team]
|
||||
include::Common_Content/Legal_Notice.adoc[]
|
||||
image:title_logo.svg[Fedora Documentation Team]
|
||||
include::{partialsdir}/Legal_Notice.adoc[]
|
||||
|
||||
include::en-US/Author_Group.adoc[]
|
||||
include::{partialsdir}/Author_Group.adoc[]
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-OpenSSH]]
|
||||
= OpenSSH
|
||||
|
|
@ -187,7 +187,7 @@ indexterm:[OpenSSH,server]
|
|||
[NOTE]
|
||||
====
|
||||
|
||||
To run an OpenSSH server, you must have the [package]*openssh-server* package installed. See xref:../package-management/DNF.adoc#sec-Installing[Installing Packages] for more information on how to install new packages in {MAJOROSVER}.
|
||||
To run an OpenSSH server, you must have the [package]*openssh-server* package installed. See xref:package-management/DNF.adoc#sec-Installing[Installing Packages] for more information on how to install new packages in {MAJOROSVER}.
|
||||
|
||||
====
|
||||
indexterm:[OpenSSH,server,starting]
|
||||
|
|
@ -213,7 +213,7 @@ If you want the daemon to start automatically at the boot time, type as `root`:
|
|||
ln -s '/usr/lib/systemd/system/sshd.service' '/etc/systemd/system/multi-user.target.wants/sshd.service'
|
||||
----
|
||||
|
||||
See xref:Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
|
||||
Note that if you reinstall the system, a new set of identification keys will be created. As a result, clients who had connected to the system with any of the OpenSSH tools before the reinstall will see the following message:
|
||||
|
||||
|
|
@ -254,7 +254,7 @@ To disable running these services at startup, type:
|
|||
[command]#systemctl disable vsftpd.service#
|
||||
----
|
||||
|
||||
See xref:Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
See xref:infrastructure-services/Services_and_Daemons.adoc#ch-Services_and_Daemons[Services and Daemons] for more information on how to configure services in {MAJOROS}.
|
||||
|
||||
[[s2-ssh-configuration-keypairs]]
|
||||
=== Using Key-based Authentication
|
||||
|
|
@ -1031,7 +1031,7 @@ indexterm:[OpenSSH,client]
|
|||
[NOTE]
|
||||
====
|
||||
|
||||
To connect to an OpenSSH server from a client machine, you must have the [package]*openssh-clients* package installed. See xref:../package-management/DNF.adoc#sec-Installing[Installing Packages] for more information on how to install new packages in {MAJOROSVER}.
|
||||
To connect to an OpenSSH server from a client machine, you must have the [package]*openssh-clients* package installed. See xref:package-management/DNF.adoc#sec-Installing[Installing Packages] for more information on how to install new packages in {MAJOROSVER}.
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Services_and_Daemons]]
|
||||
= Services and Daemons
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-TigerVNC]]
|
||||
= TigerVNC
|
||||
|
|
@ -37,7 +37,7 @@ To install the [application]*TigerVNC* server, issue the following command as `r
|
|||
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}dnf install tigervnc-server
|
||||
# dnf install tigervnc-server
|
||||
----
|
||||
|
||||
[[s3-configuring-vnc-server]]
|
||||
|
|
@ -50,24 +50,24 @@ To install the [application]*TigerVNC* server, issue the following command as `r
|
|||
[subs="macros, attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}pass:quotes[`cp /lib/systemd/system/vncserver@.service /etc/systemd/system/vncserver@.service`]
|
||||
|
||||
# cp /lib/systemd/system/vncserver@.service /etc/systemd/system/vncserver@.service
|
||||
|
||||
----
|
||||
+
|
||||
There is no need to include the display number in the file name because `systemd` automatically creates the appropriately named instance in memory on demand, replacing `'%i'` in the service file by the display number. For a single user it is not necessary to rename the file. For multiple users, a uniquely named service file for each user is required, for example, by adding the user name to the file name in some way. See xref:TigerVNC.adoc#configuring-vncserver-2users[Configuring VNC Server for Two Users] for details.
|
||||
|
||||
. Edit `/etc/systemd/system/vncserver@.service`,
|
||||
replacing _USER_ with the actual user name.
|
||||
Leave the remaining lines of the file unmodified.
|
||||
The [option]`-geometry` argument specifies the size of the VNC desktop to
|
||||
be created; by default, it is set to `1024x768`.
|
||||
replacing _USER_ with the actual user name.
|
||||
Leave the remaining lines of the file unmodified.
|
||||
The [option]`-geometry` argument specifies the size of the VNC desktop to
|
||||
be created; by default, it is set to `1024x768`.
|
||||
+
|
||||
[subs="quotes, macros"]
|
||||
----
|
||||
|
||||
ExecStart=/sbin/runuser -l _USER_ -c "/usr/bin/vncserver %i -geometry 1280x1024"
|
||||
PIDFile=/home/pass:attributes[{blank}]_USER_pass:attributes[{blank}]/.vnc/%H%i.pid
|
||||
|
||||
|
||||
----
|
||||
|
||||
. Save the changes.
|
||||
|
|
@ -77,18 +77,18 @@ PIDFile=/home/pass:attributes[{blank}]_USER_pass:attributes[{blank}]/.vnc/%H%i.p
|
|||
[subs="macros, attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}pass:quotes[`systemctl daemon-reload`]
|
||||
# pass:quotes[`systemctl daemon-reload`]
|
||||
|
||||
----
|
||||
|
||||
. Set the password for the user or users defined in the configuration file. Note
|
||||
that you need to switch from `root` to _USER_ first.
|
||||
. Set the password for the user or users defined in the configuration file. Note
|
||||
that you need to switch from `root` to _USER_ first.
|
||||
+
|
||||
[subs="macros, attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}su - pass:quotes[_USER_]
|
||||
~]${nbsp}pass:quotes[`vncpasswd`]
|
||||
# su - pass:quotes[_USER_]
|
||||
$ pass:quotes[`vncpasswd`]
|
||||
Password:
|
||||
Verify:
|
||||
|
||||
|
|
@ -111,20 +111,20 @@ If you want to configure more than one user on the same machine,
|
|||
create different template-type service files, one for each user.
|
||||
|
||||
. Create two service files, for example `vncserver-_USER_1_pass:attributes[{blank}]@.service`
|
||||
and `vncserver-_USER_2_pass:attributes[{blank}]@.service`.
|
||||
In both these files substitute _USER_ with the correct user name.
|
||||
and `vncserver-_USER_2_pass:attributes[{blank}]@.service`.
|
||||
In both these files substitute _USER_ with the correct user name.
|
||||
|
||||
. Set passwords for both users:
|
||||
+
|
||||
[subs="macros, attributes"]
|
||||
----
|
||||
|
||||
~]${nbsp}su - USER_1
|
||||
~]${nbsp}pass:quotes[`vncpasswd`]
|
||||
$ su - USER_1
|
||||
$ vncpasswd
|
||||
Password:
|
||||
Verify:
|
||||
~]${nbsp}su - USER_2
|
||||
~]${nbsp}pass:quotes[`vncpasswd`]
|
||||
$ su - USER_2
|
||||
$ vncpasswd
|
||||
Password:
|
||||
Verify:
|
||||
|
||||
|
|
@ -141,7 +141,7 @@ With a valid display number, execute the following command:
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}systemctl start vncserver@:display_number.service
|
||||
# systemctl start vncserver@:display_number.service
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -150,7 +150,7 @@ You can also enable the service to start automatically at system start. Then, wh
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}systemctl enable vncserver@:display_number.service
|
||||
# systemctl enable vncserver@:display_number.service
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -166,8 +166,8 @@ start on display 3, and a VNC server for USER_2 to start on display 5:
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}systemctl start vncserver-USER_1@:3.service
|
||||
~]#{nbsp}systemctl start vncserver-USER_2@:5.service
|
||||
# systemctl start vncserver-USER_1@:3.service
|
||||
# systemctl start vncserver-USER_2@:5.service
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -180,7 +180,7 @@ the automatic start of the service at system start:
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}systemctl disable vncserver@:display_number.service
|
||||
# systemctl disable vncserver@:display_number.service
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -190,7 +190,7 @@ command as `root`:
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]#{nbsp}systemctl stop vncserver@:display_number.service
|
||||
# systemctl stop vncserver@:display_number.service
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -212,7 +212,7 @@ To install the [application]*TigerVNC* client, [command]#vncviewer#pass:attribut
|
|||
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}dnf install tigervnc
|
||||
# dnf install tigervnc
|
||||
----
|
||||
|
||||
[[s6-connecting-vnc-viewer]]
|
||||
|
|
@ -238,7 +238,7 @@ the command looks as follows:
|
|||
[subs="quotes, macros, attributes"]
|
||||
----
|
||||
|
||||
[command]#~]${nbsp}vncviewer 192.168.0.4:3#
|
||||
[command]#$ vncviewer 192.168.0.4:3#
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -264,12 +264,12 @@ For displays `0` to `3`, make use of `firewalld`pass:attributes[{blank}]'s suppo
|
|||
[[proc-Enabling_VNC_Service_in_firewalld]]
|
||||
.Enabling VNC Service in firewalld
|
||||
. Run the following command to see the information concerning `firewalld`
|
||||
settings:
|
||||
settings:
|
||||
+
|
||||
[subs="quotes, macros, attributes"]
|
||||
----
|
||||
|
||||
[command]#~]${nbsp}firewall-cmd --list-all#
|
||||
[command]#$ firewall-cmd --list-all#
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -277,7 +277,7 @@ settings:
|
|||
+
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}firewall-cmd --add-rich-rule='rule family="ipv4" source address="192.168.122.116" service name=vnc-server accept'
|
||||
# firewall-cmd --add-rich-rule='rule family="ipv4" source address="192.168.122.116" service name=vnc-server accept'
|
||||
success
|
||||
----
|
||||
+
|
||||
|
|
@ -287,7 +287,7 @@ See the link:++https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_
|
|||
+
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}firewall-cmd --list-all
|
||||
# firewall-cmd --list-all
|
||||
public (default, active)
|
||||
interfaces: bond0 bond0.192
|
||||
sources:
|
||||
|
|
@ -308,7 +308,7 @@ To open a specific port or range of ports make use of the [option]`--add-port` o
|
|||
+
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}firewall-cmd --zone=public --add-port=5904/tcp
|
||||
# firewall-cmd --zone=public --add-port=5904/tcp
|
||||
success
|
||||
----
|
||||
|
||||
|
|
@ -316,7 +316,7 @@ success
|
|||
+
|
||||
[subs="attributes"]
|
||||
----
|
||||
~]#{nbsp}firewall-cmd --zone=public --list-ports
|
||||
# firewall-cmd --zone=public --list-ports
|
||||
5904/tcp
|
||||
----
|
||||
|
||||
|
|
@ -334,7 +334,7 @@ The format of the command to encrypt a VNC server-client connection is as follow
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]${nbsp}vncviewer -via user@host:display_number
|
||||
$ vncviewer -via user@host:display_number
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -347,7 +347,7 @@ The format of the command to encrypt a VNC server-client connection is as follow
|
|||
[subs="attributes"]
|
||||
----
|
||||
|
||||
~]${nbsp}vncviewer -via USER_2@192.168.2.101:3
|
||||
$ vncviewer -via USER_2@192.168.2.101:3
|
||||
|
||||
----
|
||||
|
||||
|
|
@ -369,7 +369,7 @@ ExecStart=/sbin/runuser -l _user_ -c "/usr/bin/vncserver -localhost %i"
|
|||
|
||||
This will stop `vncserver` from accepting connections from anything but the local host and port-forwarded connections sent using `SSH` as a result of the [option]`-via` option.
|
||||
|
||||
For more information on using `SSH`, see xref:OpenSSH.adoc#ch-OpenSSH[OpenSSH].
|
||||
For more information on using `SSH`, see xref:infrastructure-services/OpenSSH.adoc#ch-OpenSSH[OpenSSH].
|
||||
|
||||
[[s9-additional-sources]]
|
||||
== Additional Resources
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Manually_Upgrading_the_Kernel]]
|
||||
= Manually Upgrading the Kernel
|
||||
|
|
@ -20,7 +20,7 @@ Whenever possible, use either the [application]*DNF* or [application]*PackageKit
|
|||
|
||||
====
|
||||
indexterm:[kernel,installing kernel packages]
|
||||
For more information on installing kernel packages with [application]*DNF*, see xref:../package-management/DNF.adoc#sec-Updating_Packages[Updating Packages].
|
||||
For more information on installing kernel packages with [application]*DNF*, see xref:package-management/DNF.adoc#sec-Updating_Packages[Updating Packages].
|
||||
|
||||
[[s1-kernel-packages]]
|
||||
== Overview of Kernel Packages
|
||||
|
|
@ -166,7 +166,7 @@ At a shell prompt, change to the directory that contains the kernel RPM packages
|
|||
~]#{nbsp}rpm -ivh kernel-kernel_version.arch.rpm
|
||||
----
|
||||
|
||||
The next step is to verify that the initial RAM disk image has been created. See xref:Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image] for details.
|
||||
The next step is to verify that the initial RAM disk image has been created. See xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image] for details.
|
||||
|
||||
[[sec-Verifying_the_Initial_RAM_Disk_Image]]
|
||||
== Verifying the Initial RAM Disk Image
|
||||
|
|
@ -347,7 +347,7 @@ The kernel version number as given on the `linux /vmlinuz-_kernel_version_pass:a
|
|||
|
||||
In `menuentry` blocks, the `initrd` directive must point to the location (relative to the `/boot` directory if it is on a separate partition) of the `initramfs` file corresponding to the same kernel version. This directive is called `initrd` because the previous tool which created initial RAM disk images, [command]#mkinitrd#, created what were known as `initrd` files. The `grub.cfg` directive remains `initrd` to maintain compatibility with other tools. The file-naming convention of systems using the [command]#dracut# utility to create the initial RAM disk image is `initramfs-_kernel_version_.img`.
|
||||
|
||||
For information on using [application]*Dracut*, refer to xref:Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
For information on using [application]*Dracut*, refer to xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Working_with_Kernel_Modules]]
|
||||
= Working with Kernel Modules
|
||||
|
|
@ -35,7 +35,7 @@ In order to use the kernel module utilities described in this chapter, first ens
|
|||
|
||||
----
|
||||
|
||||
For more information on installing packages with DNF, see xref:../package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
For more information on installing packages with DNF, see xref:package-management/DNF.adoc#sec-Installing[Installing Packages].
|
||||
|
||||
====
|
||||
|
||||
|
|
@ -429,13 +429,21 @@ During boot, the kernel loads X.509 keys into the system key ring or the system
|
|||
|===
|
||||
|Source of X.509 Keys|User Ability to Add Keys|UEFI Secure Boot State|Keys Loaded During Boot
|
||||
|Embedded in kernel|No|-|`.system_keyring`
|
||||
|UEFI Secure Boot "db"|Limited|Not enabled|No
|
||||
.2+|UEFI Secure Boot "db"
|
||||
.2+|Limited
|
||||
|Not enabled|No
|
||||
|Enabled|`.system_keyring`
|
||||
|UEFI Secure Boot "dbx"|Limited|Not enabled|No
|
||||
.2+|UEFI Secure Boot "dbx"
|
||||
.2+|Limited
|
||||
|Not enabled|No
|
||||
|Enabled|`.system_keyring`
|
||||
|Embedded in `shim.efi` boot loader|No|Not enabled|No
|
||||
.2+|Embedded in `shim.efi` boot loader
|
||||
.2+|No
|
||||
|Not enabled|No
|
||||
|Enabled|`.system_keyring`
|
||||
|Machine Owner Key (MOK) list|Yes|Not enabled|No
|
||||
.2+|Machine Owner Key (MOK) list
|
||||
.2+|Yes
|
||||
|Not enabled|No
|
||||
|Enabled|`.system_keyring`
|
||||
|===
|
||||
|
||||
|
|
@ -486,13 +494,19 @@ If UEFI Secure Boot is enabled or if the [option]`module.sig_enforce` kernel par
|
|||
[options="header"]
|
||||
|===
|
||||
|Module Signed|Public Key Found and Signature Valid|UEFI Secure Boot State|module.sig_enforce|Module Load|Kernel Tainted
|
||||
|Unsigned|-|Not enabled|Not enabled|Succeeds|Yes
|
||||
.3+|Unsigned
|
||||
.3+|-
|
||||
|Not enabled|Not enabled|Succeeds|Yes
|
||||
|Not enabled|Enabled|Fails|
|
||||
|Enabled|-|Fails|-
|
||||
|Signed|No|Not enabled|Not enabled|Succeeds|Yes
|
||||
.3+|Signed
|
||||
.3+|No
|
||||
|Not enabled|Not enabled|Succeeds|Yes
|
||||
|Not enabled|Enabled|Fails|-
|
||||
|Enabled|-|Fails|-
|
||||
|Signed|Yes|Not enabled|Not enabled|Succeeds|No
|
||||
.3+|Signed
|
||||
.3+|Yes
|
||||
|Not enabled|Not enabled|Succeeds|No
|
||||
|Not enabled|Enabled|Succeeds|No
|
||||
|Enabled|-|Succeeds|No
|
||||
|===
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::en-US/entities.adoc[]
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[ch-Working_with_the_GRUB_2_Boot_Loader]]
|
||||
= Working with the GRUB 2 Boot Loader
|
||||
|
|
@ -43,14 +43,14 @@ menuentry 'Fedora, with Linux 3.17.4-301.fc21.x86_64' --class fedora --class gnu
|
|||
|
||||
Each `menuentry` block that represents an installed Linux kernel contains `linux` on 64-bit IBM POWER Series, `linux16` on x86_64 BIOS-based systems, and `linuxefi` on UEFI-based systems. Then the `initrd` directives followed by the path to the kernel and the `initramfs` image respectively. If a separate `/boot` partition was created, the paths to the kernel and the `initramfs` image are relative to `/boot`. In the example above, the `initrd /initramfs-3.17.4-301.fc21.x86_64.img` line means that the `initramfs` image is actually located at `/boot/initramfs-3.17.4-301.fc21.x86_64.img` when the `root` file system is mounted, and likewise for the kernel path.
|
||||
|
||||
The kernel version number as given on the `linux16 /vmlinuz-kernel_version` line must match the version number of the `initramfs` image given on the `initrd /initramfs-kernel_version.img` line of each `menuentry` block. For more information on how to verify the initial RAM disk image, see xref:Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
The kernel version number as given on the `linux16 /vmlinuz-kernel_version` line must match the version number of the `initramfs` image given on the `initrd /initramfs-kernel_version.img` line of each `menuentry` block. For more information on how to verify the initial RAM disk image, see xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
|
||||
In `menuentry` blocks, the `initrd` directive must point to the location (relative to the `/boot/` directory if it is on a separate partition) of the `initramfs` file corresponding to the same kernel version. This directive is called `initrd` because the previous tool which created initial RAM disk images, [command]#mkinitrd#, created what were known as `initrd` files. The `grub.cfg` directive remains `initrd` to maintain compatibility with other tools. The file-naming convention of systems using the [command]#dracut# utility to create the initial RAM disk image is `initramfs-_kernel_version_.img`.
|
||||
|
||||
For information on using [application]*Dracut*, see xref:Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
For information on using [application]*Dracut*, see xref:kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc#sec-Verifying_the_Initial_RAM_Disk_Image[Verifying the Initial RAM Disk Image].
|
||||
|
||||
====
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue