fedora-docs / system-administrators-guide

Clone
Source Code
GIT

#16 Switch to Antora (rawhide)
Merged 5 years ago by bex. Opened 5 years ago by asamalik.
Unknown source antora_master  into  master

file modified
+3 -9 
@@ -1,9 +1,3 @@
 

- ## AsciiBinder-specific ignores
 

- _preview
 

- _package
 

- *.swp
 

- diag-*.png
 

- diag-*.png.cache
 

- 

- ## Project-specific ignores
 

- 

+ build
 

+ cache
 

+ public

file removed
-26 
@@ -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.

file modified
+32 -11 
@@ -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:
 

+ 

+ ```
 

+ $ ./build.sh && ./preview.sh
 

+ ```
 

+ 

+ The result will be available at http://localhost:8080
 

+ 

+ ### Installing docker on Fedora
 

  

  ```
 

- $ asciibinder package
 

- $ firefox _package/main/index.html
 

+ $ sudo dnf install docker
 

+ $ sudo systemctl start docker && sudo systemctl enable docker
 

  ```

file removed
-17 
@@ -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

file removed

file removed

file removed
-61 
@@ -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>

file removed

file removed

file removed
-6 
@@ -1,6 +0,0 @@
 

- $(document).ready(function () {
 

-   $('[data-toggle="offcanvas"]').click(function () {
 

-     $('.sidebar').show();
 

-     $('.row-offcanvas').toggleClass('active');
 

-   });
 

- });

file removed
-568 
@@ -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; } }

file removed
-3 
@@ -1,3 +0,0 @@
 

- <%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%>
 

-   <link href="<%= File.join(css_path, File.basename(sheet)) %>" rel="stylesheet" />
 

- <%- end -%>

file removed
-31 
@@ -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>&nbsp;<%= 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>

file removed
-182 
@@ -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">&reg;</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 &raquo;</a></p>
 

-                           <p class="copy">&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>

file removed
-114 
@@ -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

file added
+3 
@@ -0,0 +1,3 @@
 

+ ---
 

+ name: fedora
 

+ version: rawhide

file added
+16 
@@ -0,0 +1,16 @@
 

+ #!/bin/sh
 

+ 

+ if [ "$(uname)" == "Darwin" ]; then
 

+     # Running on macOS.
 

+     # Let's assume that the user has the Docker CE installed
 

+     # which doesn't require a root password.
 

+     docker run --rm -it -v $(pwd):/antora antora/antora --html-url-extension-style=indexify site.yml
 

+ 

+ elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
 

+     # Running on Linux.
 

+     # Let's assume that it's running the Docker deamon
 

+     # which requires root.
 

+     echo ""
 

+     echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it."
 

+ sudo docker run --rm -it -v $(pwd):/antora:z antora/antora --html-url-extension-style=indexify site.yml
 

+ fi

file removed
-105 
@@ -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 &copy; 2014&ndash;{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.

file removed
-144 
@@ -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">
 

-               &nbsp;Fedora 26 Documentation
 

-             </a>
 

-             <a href="f27/en-US/index.html" class="list-group-item">
 

-               &nbsp;Fedora 27 Documentation
 

-             </a>
 

-             <a href="rawhide/en-US/index.html" class="list-group-item">
 

-               &nbsp;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">&reg;</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 &raquo;</a></p>
 

-                             <p class="copy">&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>

modules/system-administrators-guide/assets/images/alt-f2_GNOME.png en-US/basic-system-configuration/images/alt-f2_GNOME.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/alt-f2_KDE.png en-US/basic-system-configuration/images/alt-f2_KDE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/alt-f2_LXDE.png en-US/basic-system-configuration/images/alt-f2_LXDE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/alt-f2_MATE.png en-US/basic-system-configuration/images/alt-f2_MATE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/alt-f2_XFCE.png en-US/basic-system-configuration/images/alt-f2_XFCE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-01.png en-US/servers/images/apache-mod_ssl-genkey-01.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-02.png en-US/servers/images/apache-mod_ssl-genkey-02.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-03.png en-US/servers/images/apache-mod_ssl-genkey-03.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-04.png en-US/servers/images/apache-mod_ssl-genkey-04.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-05.png en-US/servers/images/apache-mod_ssl-genkey-05.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-06.png en-US/servers/images/apache-mod_ssl-genkey-06.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-07.png en-US/servers/images/apache-mod_ssl-genkey-07.png
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/managing_users.png en-US/basic-system-configuration/images/managing_users.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/menu_GNOME.png en-US/basic-system-configuration/images/menu_GNOME.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/menu_KDE.png en-US/basic-system-configuration/images/menu_KDE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/menu_LXDE.png en-US/basic-system-configuration/images/menu_LXDE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/menu_MATE.png en-US/basic-system-configuration/images/menu_MATE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/menu_XFCE.png en-US/basic-system-configuration/images/menu_XFCE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/oprof-start-config.png en-US/monitoring-and-automation/images/oprof-start-config.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/oprof-start-setup.png en-US/monitoring-and-automation/images/oprof-start-setup.png
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/ptp_grandmaster_boundary_and_slaves.png en-US/servers/images/ptp_grandmaster_boundary_and_slaves.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-filter-enable.png en-US/monitoring-and-automation/images/redhat-filter-enable.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-filter-sample.png en-US/monitoring-and-automation/images/redhat-filter-sample.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-filters.png en-US/monitoring-and-automation/images/redhat-filters.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-logviewer-add.png en-US/monitoring-and-automation/images/redhat-logviewer-add.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-logviewer-monitoring.png en-US/monitoring-and-automation/images/redhat-logviewer-monitoring.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/redhat-logviewer.png en-US/monitoring-and-automation/images/redhat-logviewer.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/rsyslog_message_flow.png en-US/monitoring-and-automation/images/rsyslog_message_flow.png
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/searchmenu_GNOME.png en-US/basic-system-configuration/images/searchmenu_GNOME.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/searchmenu_KDE.png en-US/basic-system-configuration/images/searchmenu_KDE.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/system-monitor-file-systems.png en-US/monitoring-and-automation/images/system-monitor-file-systems.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/system-monitor-processes.png en-US/monitoring-and-automation/images/system-monitor-processes.png
file renamed
file was moved with no change to the file
modules/system-administrators-guide/assets/images/system-monitor-resources.png en-US/monitoring-and-automation/images/system-monitor-resources.png
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file added
+41 
@@ -0,0 +1,41 @@
 

+ * xref:index.adoc[System Administration Guide]
 

+ ** xref:Preface.adoc[Preface]
 

+ ** Basic System Configuration
 

+ *** xref:basic-system-configuration/intro-basic-system-configuration.adoc[Introduction]
 

+ *** 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]
 

+ ** Package Management
 

+ *** xref:package-management/intro-package-management.adoc[Introduction]
 

+ *** xref:package-management/DNF.adoc[DNF]
 

+ *** xref:package-management/rpm-ostree.adoc[rpm-ostree]
 

+ ** Infrastructure Services
 

+ *** xref:infrastructure-services/intro-infrastructure-services.adoc[Introduction]
 

+ *** xref:infrastructure-services/Services_and_Daemons.adoc[Services and Daemons]
 

+ *** xref:infrastructure-services/OpenSSH.adoc[OpenSSH]
 

+ *** xref:infrastructure-services/TigerVNC.adoc[TigerVNC]
 

+ ** Servers
 

+ *** xref:servers/intro-servers.adoc[Introduction]
 

+ *** 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]
 

+ ** Monitoring and Automation
 

+ *** xref:monitoring-and-automation/intro-monitoring-and-automation.adoc[Introduction]
 

+ *** 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]
 

+ ** Kernel, Module and Driver Configuration
 

+ *** xref:kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc[Introduction]
 

+ *** 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]

file added
+105 
@@ -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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[Gaining Privileges] covers ways to gain administrative privileges using setuid programs such as [command]#su# and [command]#sudo#.
 

+ 

+ xref:package-management/intro-package-management.adoc[Package Management]::  This part describes how to manage software packages on {MAJOROS} using [application]*DNF*.
 

+ +
 

+ xref:package-management/DNF.adoc[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.adoc[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.adoc[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.adoc[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.adoc[TigerVNC] describes the _virtual network computing_ (*VNC*) method of graphical desktop sharing which allows you to remotely control other computers.
 

+ 

+ xref:servers/intro-servers.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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.adoc[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 &copy; 2014&ndash;{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.adoc#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.

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-RPM]]
 

  = RPM

file renamed
file was moved with no change to the file
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  :hardbreaks:
 

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Wayland]]
 

  = The Wayland Display Server

file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
+1 -1 
@@ -34,7 +34,7 @@
 

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

file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
file renamed
file was moved with no change to the file
modules/system-administrators-guide/pages/basic-system-configuration/Configuring_the_Date_and_Time.adoc en-US/basic-system-configuration/Configuring_the_Date_and_Time.adoc
file renamed
+1 -1 
@@ -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

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[chap-Gaining_Privileges]]
 

  = Gaining Privileges

modules/system-administrators-guide/pages/basic-system-configuration/Managing_Users_and_Groups.adoc en-US/basic-system-configuration/Managing_Users_and_Groups.adoc
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Managing_Users_and_Groups]]
 

  = Managing Users and Groups

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Opening_GUI_Applications]]
 

  = Opening Graphical Applications

modules/system-administrators-guide/pages/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc en-US/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc
file renamed
+1 -1 
@@ -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

modules/system-administrators-guide/pages/basic-system-configuration/intro-basic-system-configuration.adoc en-US/basic-system-configuration/intro-basic-system-configuration.adoc
file renamed
file was moved with no change to the file
file renamed
+4 -4 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  = System Administrator's Guide
 

  
@@ -12,7 +12,7 @@
 

  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[]

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-OpenSSH]]
 

  = OpenSSH

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Services_and_Daemons]]
 

  = Services and Daemons

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-TigerVNC]]
 

  = TigerVNC

modules/system-administrators-guide/pages/infrastructure-services/intro-infrastructure-services.adoc en-US/infrastructure-services/intro-infrastructure-services.adoc
file renamed
file was moved with no change to the file
modules/system-administrators-guide/pages/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc en-US/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Manually_Upgrading_the_Kernel]]
 

  = Manually Upgrading the Kernel

modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc en-US/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Working_with_Kernel_Modules]]
 

  = Working with Kernel Modules

modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc en-US/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc
file renamed
+1 -1 
@@ -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

modules/system-administrators-guide/pages/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc en-US/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc
file renamed
file was moved with no change to the file
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Automating_System_Tasks]]
 

  = Automating System Tasks

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-OProfile]]
 

  = OProfile

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-System_Monitoring_Tools]]
 

  = System Monitoring Tools

modules/system-administrators-guide/pages/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc en-US/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Viewing_and_Managing_Log_Files]]
 

  = Viewing and Managing Log Files

modules/system-administrators-guide/pages/monitoring-and-automation/intro-monitoring-and-automation.adoc en-US/monitoring-and-automation/intro-monitoring-and-automation.adoc
file renamed
file was moved with no change to the file
file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-DNF]]
 

  = DNF

file renamed
+1 -1 
@@ -1,4 +1,4 @@
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  = Package Management

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-rpm-ostree]]
 

  = rpm-ostree

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Configuring_NTP_Using_ntpd]]
 

  = Configuring NTP Using ntpd

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Configuring_NTP_Using_the_chrony_Suite]]
 

  = Configuring NTP Using the chrony Suite

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Configuring_PTP_Using_ptp4l]]
 

  = Configuring PTP Using ptp4l

file renamed
+2 -1 
@@ -1,7 +1,8 @@
 

  

  :experimental:
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Directory_Servers]]
 

  = Directory Servers
 

  

- include::en-US/servers/OpenLDAP.adoc[]
 

+ include::{partialsdir}/servers/OpenLDAP.adoc[]

file renamed
+4 -4 
@@ -1,14 +1,14 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-File_and_Print_Servers]]
 

  = File and Print Servers
 

  

  This chapter guides you through the installation and configuration of [application]*Samba*, an open source implementation of the _Server Message Block_ (*SMB*) and _common Internet file system_ (`CIFS`) protocol, and [application]*vsftpd*, the primary FTP server shipped with {MAJOROS}. Additionally, it explains how to use the [application]*Printer* tool to configure printers.
 

  

- include::en-US/servers/Samba.adoc[]
 

+ include::{partialsdir}/servers/Samba.adoc[]
 

  

- include::en-US/servers/FTP.adoc[]
 

+ include::{partialsdir}/servers/FTP.adoc[]
 

  

- include::en-US/servers/Printer_Configuration.adoc[]
 

+ include::{partialsdir}/servers/Printer_Configuration.adoc[]

file renamed
+1 -1 
@@ -1,6 +1,6 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Mail_Servers]]
 

  = Mail Servers

file renamed
+2 -2 
@@ -1,10 +1,10 @@
 

  

  :experimental:
 

- include::en-US/entities.adoc[]
 

+ include::{partialsdir}/entities.adoc[]
 

  

  [[ch-Web_Servers]]
 

  = Web Servers
 

  indexterm:[HTTP server,Apache HTTP Server]indexterm:[web server,Apache HTTP Server]
 

  A _web server_ is a network service that serves content to a client over the web. This typically means web pages, but any other documents can be served as well. Web servers are also known as HTTP servers, as they use the _hypertext transport protocol_ (*HTTP*).
 

  

- include::en-US/servers/The_Apache_HTTP_Server.adoc[]
 

+ include::{partialsdir}/servers/The_Apache_HTTP_Server.adoc[]

file renamed
file was moved with no change to the file
file added
+18 
@@ -0,0 +1,18 @@
 

+ #!/bin/sh
 

+ 

+ if [ "$(uname)" == "Darwin" ]; then
 

+     # Running on macOS.
 

+     # Let's assume that the user has the Docker CE installed
 

+     # which doesn't require a root password.
 

+     echo "The preview will be available at http://localhost:8080/"
 

+     docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx
 

+ 

+ elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
 

+     # Running on Linux.
 

+     # Let's assume that it's running the Docker deamon
 

+     # which requires root.
 

+     echo ""
 

+     echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it."
 

+     echo "The preview will be available at http://localhost:8080/"
 

+     sudo docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx
 

+ fi

file added
+22 
@@ -0,0 +1,22 @@
 

+ site: 

+   title: Local Preview
 

+   start_page: fedora:system-administrators-guide:index
 

+ content:
 

+   sources:
 

+    - url: https://pagure.io/forks/bex/fedora-docs/docs-fp-o.git
 

+      branches: antora_rawhide
 

+    - url: .
 

+      branches: HEAD
 

+ ui:
 

+   bundle:
 

+     url: https://asamalik.fedorapeople.org/ui-bundle.zip
 

+     snapshot: true
 

+   default_layout: with_menu
 

+ output: 

+   clean: true 

+   dir: ./public
 

+   destinations: 

+   - provider: archive 

+ runtime:
 

+   pull: true
 

+   cache_dir: ./cache

Converting the structure of this repository so it can be consumed by the new build engine. This is related to the Antora migration happening this weekend: https://pagure.io/fedora-docs/docs-fp-o/issue/77

Content covered by this PR can be previewed in staging:

No actual content has been changed, only the new structure. Please merge this PR by the end of Sunday 29 July.

Pull-Request has been merged by bex
5 years ago
Metadata
None
No Tags
Changes Summary 117
+3 -9
file changed
.gitignore
-26
file removed
Common_Content/Feedback.adoc
+32 -11
file changed
README.md
-17
file removed
_distro_map.yml
-0
file removed
_images/favicon.ico
-0
file removed
_images/favicon32x32.png
-61
file removed
_images/fedora.svg
-0
file removed
_images/redhat-logo.png
-0
file removed
_javascripts/.gitkeep
-6
file removed
_javascripts/bootstrap-offcanvas.js
-568
file removed
_stylesheets/asciibinder.css
-3
file removed
_templates/_css.html.erb
-31
file removed
_templates/_nav.html.erb
-182
file removed
_templates/page.html.erb
-114
file removed
_topic_map.yml
+3
file added
antora.yml
+16
file added
build.sh
-105
file removed
en-US/Preface.adoc
-144
file removed
index-main.html
+0 -0
file renamed
en-US/basic-system-configuration/images/alt-f2_GNOME.png
modules/system-administrators-guide/assets/images/alt-f2_GNOME.png
+0 -0
file renamed
en-US/basic-system-configuration/images/alt-f2_KDE.png
modules/system-administrators-guide/assets/images/alt-f2_KDE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/alt-f2_LXDE.png
modules/system-administrators-guide/assets/images/alt-f2_LXDE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/alt-f2_MATE.png
modules/system-administrators-guide/assets/images/alt-f2_MATE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/alt-f2_XFCE.png
modules/system-administrators-guide/assets/images/alt-f2_XFCE.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-01.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-01.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-02.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-02.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-03.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-03.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-04.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-04.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-05.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-05.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-06.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-06.png
+0 -0
file renamed
en-US/servers/images/apache-mod_ssl-genkey-07.png
modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-07.png
+0 -0
file renamed
en-US/servers/images/gnome-print-queue.png
modules/system-administrators-guide/assets/images/gnome-print-queue.png
+0 -0
file renamed
en-US/basic-system-configuration/images/managing_users.png
modules/system-administrators-guide/assets/images/managing_users.png
+0 -0
file renamed
en-US/basic-system-configuration/images/menu_GNOME.png
modules/system-administrators-guide/assets/images/menu_GNOME.png
+0 -0
file renamed
en-US/basic-system-configuration/images/menu_KDE.png
modules/system-administrators-guide/assets/images/menu_KDE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/menu_LXDE.png
modules/system-administrators-guide/assets/images/menu_LXDE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/menu_MATE.png
modules/system-administrators-guide/assets/images/menu_MATE.png
+0 -0
file renamed
en-US/basic-system-configuration/images/menu_XFCE.png
modules/system-administrators-guide/assets/images/menu_XFCE.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/oprof-start-config.png
modules/system-administrators-guide/assets/images/oprof-start-config.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/oprof-start-setup.png
modules/system-administrators-guide/assets/images/oprof-start-setup.png
+0 -0
file renamed
en-US/servers/images/print_conf_window.png
modules/system-administrators-guide/assets/images/print_conf_window.png
+0 -0
file renamed
en-US/servers/images/printconf-add-printer.png
modules/system-administrators-guide/assets/images/printconf-add-printer.png
+0 -0
file renamed
en-US/servers/images/printconf-config1.png
modules/system-administrators-guide/assets/images/printconf-config1.png
+0 -0
file renamed
en-US/servers/images/printconf-config2.png
modules/system-administrators-guide/assets/images/printconf-config2.png
+0 -0
file renamed
en-US/servers/images/printconf-config3.png
modules/system-administrators-guide/assets/images/printconf-config3.png
+0 -0
file renamed
en-US/servers/images/printconf-config4.png
modules/system-administrators-guide/assets/images/printconf-config4.png
+0 -0
file renamed
en-US/servers/images/printconf-config5.png
modules/system-administrators-guide/assets/images/printconf-config5.png
+0 -0
file renamed
en-US/servers/images/printconf-config6.png
modules/system-administrators-guide/assets/images/printconf-config6.png
+0 -0
file renamed
en-US/servers/images/printconf-ipp.png
modules/system-administrators-guide/assets/images/printconf-ipp.png
+0 -0
file renamed
en-US/servers/images/printconf-jetdirect.png
modules/system-administrators-guide/assets/images/printconf-jetdirect.png
+0 -0
file renamed
en-US/servers/images/printconf-lpd.png
modules/system-administrators-guide/assets/images/printconf-lpd.png
+0 -0
file renamed
en-US/servers/images/printconf-main.png
modules/system-administrators-guide/assets/images/printconf-main.png
+0 -0
file renamed
en-US/servers/images/printconf-select-driver.png
modules/system-administrators-guide/assets/images/printconf-select-driver.png
+0 -0
file renamed
en-US/servers/images/printconf-select-model.png
modules/system-administrators-guide/assets/images/printconf-select-model.png
+0 -0
file renamed
en-US/servers/images/printconf-smb.png
modules/system-administrators-guide/assets/images/printconf-smb.png
+0 -0
file renamed
en-US/servers/images/ptp_grandmaster_boundary_and_slaves.png
modules/system-administrators-guide/assets/images/ptp_grandmaster_boundary_and_slaves.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-filter-enable.png
modules/system-administrators-guide/assets/images/redhat-filter-enable.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-filter-sample.png
modules/system-administrators-guide/assets/images/redhat-filter-sample.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-filters.png
modules/system-administrators-guide/assets/images/redhat-filters.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-logviewer-add.png
modules/system-administrators-guide/assets/images/redhat-logviewer-add.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-logviewer-monitoring.png
modules/system-administrators-guide/assets/images/redhat-logviewer-monitoring.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/redhat-logviewer.png
modules/system-administrators-guide/assets/images/redhat-logviewer.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/rsyslog_message_flow.png
modules/system-administrators-guide/assets/images/rsyslog_message_flow.png
+0 -0
file renamed
en-US/servers/images/samba-nautilus-domain.png
modules/system-administrators-guide/assets/images/samba-nautilus-domain.png
+0 -0
file renamed
en-US/basic-system-configuration/images/searchmenu_GNOME.png
modules/system-administrators-guide/assets/images/searchmenu_GNOME.png
+0 -0
file renamed
en-US/basic-system-configuration/images/searchmenu_KDE.png
modules/system-administrators-guide/assets/images/searchmenu_KDE.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/system-monitor-file-systems.png
modules/system-administrators-guide/assets/images/system-monitor-file-systems.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/system-monitor-processes.png
modules/system-administrators-guide/assets/images/system-monitor-processes.png
+0 -0
file renamed
en-US/monitoring-and-automation/images/system-monitor-resources.png
modules/system-administrators-guide/assets/images/system-monitor-resources.png
+0 -0
file renamed
Common_Content/images/title_logo.svg
modules/system-administrators-guide/assets/images/title_logo.svg
+41
file added
modules/system-administrators-guide/nav.adoc
+105
file added
modules/system-administrators-guide/pages/Preface.adoc
+1 -1
file renamed
en-US/RPM.adoc
modules/system-administrators-guide/pages/RPM.adoc
+0 -0
file renamed
en-US/Revision_History.adoc
modules/system-administrators-guide/pages/Revision_History.adoc
+1 -1
file renamed
en-US/Wayland.adoc
modules/system-administrators-guide/pages/Wayland.adoc
+0 -0
file renamed
en-US/Author_Group.adoc
modules/system-administrators-guide/pages/_partials/Author_Group.adoc
+0 -0
file renamed
en-US/Feedback.adoc
modules/system-administrators-guide/pages/_partials/Feedback.adoc
+0 -0
file renamed
Common_Content/Legal_Notice.adoc
modules/system-administrators-guide/pages/_partials/Legal_Notice.adoc
+0 -0
file renamed
en-US/entities.adoc
modules/system-administrators-guide/pages/_partials/entities.adoc
+1 -1
file renamed
en-US/servers/FTP.adoc
modules/system-administrators-guide/pages/_partials/servers/FTP.adoc
+0 -0
file renamed
en-US/servers/OpenLDAP.adoc
modules/system-administrators-guide/pages/_partials/servers/OpenLDAP.adoc
+0 -0
file renamed
en-US/servers/Printer_Configuration.adoc
modules/system-administrators-guide/pages/_partials/servers/Printer_Configuration.adoc
+0 -0
file renamed
en-US/servers/Samba.adoc
modules/system-administrators-guide/pages/_partials/servers/Samba.adoc
+0 -0
file renamed
en-US/servers/The_Apache_HTTP_Server.adoc
modules/system-administrators-guide/pages/_partials/servers/The_Apache_HTTP_Server.adoc
+1 -1
file renamed
en-US/basic-system-configuration/Configuring_the_Date_and_Time.adoc
modules/system-administrators-guide/pages/basic-system-configuration/Configuring_the_Date_and_Time.adoc
+1 -1
file renamed
en-US/basic-system-configuration/Gaining_Privileges.adoc
modules/system-administrators-guide/pages/basic-system-configuration/Gaining_Privileges.adoc
+1 -1
file renamed
en-US/basic-system-configuration/Managing_Users_and_Groups.adoc
modules/system-administrators-guide/pages/basic-system-configuration/Managing_Users_and_Groups.adoc
+1 -1
file renamed
en-US/basic-system-configuration/Opening_GUI_Applications.adoc
modules/system-administrators-guide/pages/basic-system-configuration/Opening_GUI_Applications.adoc
+1 -1
file renamed
en-US/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc
modules/system-administrators-guide/pages/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc
+0 -0
file renamed
en-US/basic-system-configuration/intro-basic-system-configuration.adoc
modules/system-administrators-guide/pages/basic-system-configuration/intro-basic-system-configuration.adoc
+4 -4
file renamed
en-US/index.adoc
modules/system-administrators-guide/pages/index.adoc
+1 -1
file renamed
en-US/infrastructure-services/OpenSSH.adoc
modules/system-administrators-guide/pages/infrastructure-services/OpenSSH.adoc
+1 -1
file renamed
en-US/infrastructure-services/Services_and_Daemons.adoc
modules/system-administrators-guide/pages/infrastructure-services/Services_and_Daemons.adoc
+1 -1
file renamed
en-US/infrastructure-services/TigerVNC.adoc
modules/system-administrators-guide/pages/infrastructure-services/TigerVNC.adoc
+0 -0
file renamed
en-US/infrastructure-services/intro-infrastructure-services.adoc
modules/system-administrators-guide/pages/infrastructure-services/intro-infrastructure-services.adoc
+1 -1
file renamed
en-US/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc
modules/system-administrators-guide/pages/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc
+1 -1
file renamed
en-US/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc
modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc
+1 -1
file renamed
en-US/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc
modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc
+0 -0
file renamed
en-US/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc
modules/system-administrators-guide/pages/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc
+1 -1
file renamed
en-US/monitoring-and-automation/Automating_System_Tasks.adoc
modules/system-administrators-guide/pages/monitoring-and-automation/Automating_System_Tasks.adoc
+1 -1
file renamed
en-US/monitoring-and-automation/OProfile.adoc
modules/system-administrators-guide/pages/monitoring-and-automation/OProfile.adoc
+1 -1
file renamed
en-US/monitoring-and-automation/System_Monitoring_Tools.adoc
modules/system-administrators-guide/pages/monitoring-and-automation/System_Monitoring_Tools.adoc
+1 -1
file renamed
en-US/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc
modules/system-administrators-guide/pages/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc
+0 -0
file renamed
en-US/monitoring-and-automation/intro-monitoring-and-automation.adoc
modules/system-administrators-guide/pages/monitoring-and-automation/intro-monitoring-and-automation.adoc
+1 -1
file renamed
en-US/package-management/DNF.adoc
modules/system-administrators-guide/pages/package-management/DNF.adoc
+1 -1
file renamed
en-US/package-management/intro-package-management.adoc
modules/system-administrators-guide/pages/package-management/intro-package-management.adoc
+1 -1
file renamed
en-US/package-management/rpm-ostree.adoc
modules/system-administrators-guide/pages/package-management/rpm-ostree.adoc
+1 -1
file renamed
en-US/servers/Configuring_NTP_Using_ntpd.adoc
modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_ntpd.adoc
+1 -1
file renamed
en-US/servers/Configuring_NTP_Using_the_chrony_Suite.adoc
modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_the_chrony_Suite.adoc
+1 -1
file renamed
en-US/servers/Configuring_PTP_Using_ptp4l.adoc
modules/system-administrators-guide/pages/servers/Configuring_PTP_Using_ptp4l.adoc
+2 -1
file renamed
en-US/servers/Directory_Servers.adoc
modules/system-administrators-guide/pages/servers/Directory_Servers.adoc
+4 -4
file renamed
en-US/servers/File_and_Print_Servers.adoc
modules/system-administrators-guide/pages/servers/File_and_Print_Servers.adoc
+1 -1
file renamed
en-US/servers/Mail_Servers.adoc
modules/system-administrators-guide/pages/servers/Mail_Servers.adoc
+2 -2
file renamed
en-US/servers/Web_Servers.adoc
modules/system-administrators-guide/pages/servers/Web_Servers.adoc
+0 -0
file renamed
en-US/servers/intro-servers.adoc
modules/system-administrators-guide/pages/servers/intro-servers.adoc
+18
file added
preview.sh
+22
file added
site.yml
Powered by Pagure 5.13.3
Documentation • File an Issue • About • SSH Hostkey/Fingerprint
© Red Hat, Inc. and others.