diff --git a/.gitignore b/.gitignore index 462d167..9f3ebf5 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,3 @@ -## AsciiBinder-specific ignores -_preview -_package -*.swp -diag-*.png -diag-*.png.cache - -## Project-specific ignores - +build +cache +public diff --git a/Common_Content/Feedback.adoc b/Common_Content/Feedback.adoc deleted file mode 100644 index f438831..0000000 --- a/Common_Content/Feedback.adoc +++ /dev/null @@ -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. diff --git a/README.md b/README.md deleted file mode 100644 index 5103e68..0000000 --- a/README.md +++ /dev/null @@ -1,22 +0,0 @@ -# Fedora System Administrators Guide - -This is the content repository for the Fedora System Administrators Guide. - -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 - -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. - -## Testing your changes locally - -To test your changes, first install `asciibinder` - -$ gem install ascii_binder - -To build your changes, from the root directory: - -``` -$ asciibinder package -$ firefox _package/main/index.html -``` diff --git a/_distro_map.yml b/_distro_map.yml deleted file mode 100644 index fadc1fb..0000000 --- a/_distro_map.yml +++ /dev/null @@ -1,17 +0,0 @@ ---- -fedora: - name: Fedora System Administrators Guide - author: Fedora Documentation Project - 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 diff --git a/_images/favicon.ico b/_images/favicon.ico deleted file mode 100644 index a912017..0000000 Binary files a/_images/favicon.ico and /dev/null differ diff --git a/_images/favicon32x32.png b/_images/favicon32x32.png deleted file mode 100644 index d33bd5e..0000000 Binary files a/_images/favicon32x32.png and /dev/null differ diff --git a/_images/fedora.svg b/_images/fedora.svg deleted file mode 100644 index e8fd52b..0000000 --- a/_images/fedora.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - - - - - - - diff --git a/_images/redhat-logo.png b/_images/redhat-logo.png deleted file mode 100644 index f085f1a..0000000 Binary files a/_images/redhat-logo.png and /dev/null differ diff --git a/_javascripts/.gitkeep b/_javascripts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/_javascripts/bootstrap-offcanvas.js b/_javascripts/bootstrap-offcanvas.js deleted file mode 100644 index 62cf7b6..0000000 --- a/_javascripts/bootstrap-offcanvas.js +++ /dev/null @@ -1,6 +0,0 @@ -$(document).ready(function () { - $('[data-toggle="offcanvas"]').click(function () { - $('.sidebar').show(); - $('.row-offcanvas').toggleClass('active'); - }); -}); diff --git a/_stylesheets/asciibinder.css b/_stylesheets/asciibinder.css deleted file mode 100644 index 0e17a3d..0000000 --- a/_stylesheets/asciibinder.css +++ /dev/null @@ -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; } } diff --git a/_templates/_css.html.erb b/_templates/_css.html.erb deleted file mode 100644 index 0fca7ae..0000000 --- a/_templates/_css.html.erb +++ /dev/null @@ -1,3 +0,0 @@ -<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%> - -<%- end -%> diff --git a/_templates/_nav.html.erb b/_templates/_nav.html.erb deleted file mode 100644 index 95a7e5c..0000000 --- a/_templates/_nav.html.erb +++ /dev/null @@ -1,31 +0,0 @@ - diff --git a/_templates/page.html.erb b/_templates/page.html.erb deleted file mode 100644 index 9ebba77..0000000 --- a/_templates/page.html.erb +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - <%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %> - - - - - - <%= render("_templates/_css.html.erb", :css_path => css_path) %> - - - - - - " rel="shortcut icon" type="text/css"> - - - - - -
-

- -

-
    -
  1. - <%= site_name %> -
    2. - - - <%= breadcrumb_subgroup_block %> - -
-
-
- <%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %> -
-
-
-

<%= article_title %>

-
- <%= content %> -
-
-
-
-
-
-
-
-

About

-
-
-
About Fedora
-
Sponsors
-
Fedora Magazine
-
Legal
-
-
    -
  • - -
    • -
  • - -
    • -
  • - -
    • -
-
-
- -
-

Download

-
-
-
Get Fedora Workstation
-
Get Fedora Server
-
Get Fedora Atomic
-
Fedora Spins
-
Fedora Labs
-
Fedora ARM®
-
Alternative Downloads
- -
-
-
- -
-

Support

-
-
-
Get Help
-
Ask Fedora
-
Common Bugs
-
Fedora Developer Portal
-
Installation Guide
-
-
-
- -
-

Join

-
-
-
Join Fedora
-
Planet Fedora
-
Fedora SIGs
-
Fedora Account System
-
Fedora Community
-
-
-
-
- -
-
-
- " alt="Red Hat Logo" /> - -
-
-
-
- - -

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the websites team

-
-
-
- -
-
-
- - - - - - - - diff --git a/_topic_map.yml b/_topic_map.yml deleted file mode 100644 index 74635d2..0000000 --- a/_topic_map.yml +++ /dev/null @@ -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 / -# - Name: The Acrobatic Ascarid <= Sub-topic 2 name -# File: the_acrobatic_ascarid <= Sub-topic 2 file under / -# -# 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 diff --git a/antora.yml b/antora.yml new file mode 100644 index 0000000..225cfc6 --- /dev/null +++ b/antora.yml @@ -0,0 +1,3 @@ +--- +name: fedora +version: rawhide diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c9349e3 --- /dev/null +++ b/build.sh @@ -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 diff --git a/en-US/Preface.adoc b/en-US/Preface.adoc deleted file mode 100644 index b6eba94..0000000 --- a/en-US/Preface.adoc +++ /dev/null @@ -1,105 +0,0 @@ - -:experimental: -include::en-US/entities.adoc[] - -= Preface - -The [citetitle]_System Administrator's Guide_ contains information on how to customize the {MAJOROSVER} system to fit your needs. If you are looking for a comprehensive, task-oriented guide for configuring and customizing your system, this is the manual for you. - -This manual discusses many intermediate topics such as the following: - -* Installing and managing packages using [application]*DNF* - -* Configuring [application]*Apache HTTP Server*, [application]*Postfix*, [application]*Sendmail* and other enterprise-class servers and software - -* Working with kernel modules and upgrading the kernel - -[NOTE] -==== - -Some of the graphical procedures and menu locations are specific to GNOME, but most command line instructions will be universally applicable. - -==== - -[[sect-Preface-Target_Audience]] -== Target Audience - -The [citetitle]_System Administrator's Guide_ assumes you have a basic understanding of the {MAJOROS} operating system. If you need help with the installation of this system, refer to the link:++https://docs.fedoraproject.org/install-guide++[{MAJOROS} Installation Guide]. - -[[sect-Preface-Book_Organization]] -== How to Read this Book - -This manual is divided into the following main categories: - -link:++basic-system-configuration/intro-basic-system-configuration.html++[Basic System Configuration]:: This part covers basic system administration tasks such as keyboard configuration, date and time configuration, managing users and groups, and gaining privileges. -+ -link:++basic-system-configuration/Opening_GUI_Applications.html++[Opening Graphical Applications] describes methods for opening `Graphical User Interface`, or _GUI_, applications in various environments. -+ -link:++basic-system-configuration/System_Locale_and_Keyboard_Configuration.html++[System Locale and Keyboard Configuration] covers basic language and keyboard setup. Read this chapter if you need to configure the language of your desktop, change the keyboard layout, or add the keyboard layout indicator to the panel. -+ -link:++basic-system-configuration/Configuring_the_Date_and_Time.html++[Configuring the Date and Time] covers the configuration of the system date and time. Read this chapter if you need to set or change the date and time. -+ -link:++basic-system-configuration/Managing_Users_and_Groups.html++[Managing Users and Groups] covers the management of users and groups in a graphical user interface and on the command line. Read this chapter if you need to manage users and groups on your system, or enable password aging. -+ -link:++basic-system-configuration/Gaining_Privileges.html++[Gaining Privileges] covers ways to gain administrative privileges using setuid programs such as [command]#su# and [command]#sudo#. - -link:++package-management/intro-package-management.html++[Package Management]:: This part describes how to manage software packages on {MAJOROS} using [application]*DNF*. -+ -link:++package-management/DNF.html++[DNF] describes the [application]*DNF* package manager. Read this chapter for information how to search, install, update, and uninstall packages on the command line. - -link:++infrastructure-services/intro-infrastructure-services.html++[Infrastructure Services]:: This part provides information on how to configure services and daemons, configure authentication, and enable remote logins. -+ -link:++infrastructure-services/Services_and_Daemons.html++[Services and Daemons] covers the configuration of the services to be run when a system is started, and provides information on how to start, stop, and restart the services on the command line using the [command]#systemctl# utility. -+ -link:++infrastructure-services/OpenSSH.html++[OpenSSH] describes how to enable a remote login via the SSH protocol. It covers the configuration of the `sshd` service, as well as a basic usage of the [command]#ssh#, [command]#scp#, [command]#sftp# client utilities. Read this chapter if you need a remote access to a machine. -+ -link:++infrastructure-services/TigerVNC.html++[TigerVNC] describes the _virtual network computing_ (*VNC*) method of graphical desktop sharing which allows you to remotely control other computers. - -link:++servers/intro-servers.html++[Servers]:: This part discusses various topics related to servers such as how to set up a Web server or share files and directories over the network. -+ -link:++servers/Web_Servers.html++[Web Servers] focuses on the [application]*Apache HTTP Server*, a robust, full-featured open source web server developed by the Apache Software Foundation. Read this chapter if you need to configure a web server on your system. -+ -link:++servers/Mail_Servers.html++[Mail Servers] reviews modern email protocols in use today, and some of the programs designed to send and receive email, including [application]*Postfix*, [application]*Sendmail*, [application]*Fetchmail*, and [application]*Procmail*. Read this chapter if you need to configure a mail server on your system. -+ -link:++servers/Directory_Servers.html++[Directory Servers] covers the installation and configuration of [application]*OpenLDAP*, an open source implementation of the LDAPv2 and LDAPv3 protocols. Read this chapter if you need to configure a directory server on your system. -+ -link:++servers/File_and_Print_Servers.html++[File and Print Servers] guides you through the installation and configuration of [application]*Samba*, an open source implementation of the Server Message Block (SMB) protocol, and [application]*vsftpd*, the primary FTP server shipped with {MAJOROS}. Additionally, it explains how to use the [application]*Printer Configuration* tool to configure printers. Read this chapter if you need to configure a file or print server on your system. -+ -link:++servers/Configuring_NTP_Using_the_chrony_Suite.html++[Configuring NTP Using the chrony Suite] covers the installation and configuration of the [application]*chrony* suite, a client and a server for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system. -+ -link:++servers/Configuring_NTP_Using_ntpd.html++[Configuring NTP Using ntpd] covers the installation and configuration of the `NTP` daemon, `ntpd`, for the Network Time Protocol (`NTP`). Read this chapter if you need to configure the system to synchronize the clock with a remote `NTP` server, or set up an `NTP` server on this system, and you prefer not to use the [application]*chrony* application. -+ -link:++servers/Configuring_PTP_Using_ptp4l.html++[Configuring PTP Using ptp4l] covers the installation and configuration of the Precision Time Protocol application, [application]*ptp4l*, an application for use with network drivers that support the Precision Network Time Protocol (`PTP`). Read this chapter if you need to configure the system to synchronize the system clock with a master `PTP` clock. - -link:++monitoring-and-automation/intro-monitoring-and-automation.html++[Monitoring and Automation]:: This part describes various tools that allow system administrators to monitor system performance, automate system tasks, and report bugs. -+ -link:++monitoring-and-automation/System_Monitoring_Tools.html++[System Monitoring Tools] discusses applications and commands that can be used to retrieve important information about the system. Read this chapter to learn how to gather essential system information. -+ -link:++monitoring-and-automation/Viewing_and_Managing_Log_Files.html++[Viewing and Managing Log Files] describes the configuration of the `rsyslog` daemon, and explains how to locate, view, and monitor log files. Read this chapter to learn how to work with log files. -+ -link:++monitoring-and-automation/Automating_System_Tasks.html++[Automating System Tasks] provides an overview of the [command]#cron#, [command]#at#, and [command]#batch# utilities. Read this chapter to learn how to use these utilities to perform automated tasks. -+ -link:++monitoring-and-automation/OProfile.html++[OProfile] covers [application]*OProfile*, a low overhead, system-wide performance monitoring tool. Read this chapter for information on how to use [application]*OProfile* on your system. - -link:++kernel-module-driver-configuration/intro-kernel-module-driver-configuration.html++[Kernel, Module and Driver Configuration]:: This part covers various tools that assist administrators with kernel customization. -+ -link:++kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.html++[Working with the GRUB 2 Boot Loader] der>> describes the GNU GRand Unified Boot loader (GRUB) version 2 boot loader, which enables selecting an operating system or kernel to be loaded at system boot time. -+ -link:++kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.html++[Manually Upgrading the Kernel] provides important information on how to manually update a kernel package using the [command]#rpm# command instead of [command]#dnf#. Read this chapter if you cannot update a kernel package with the [application]*DNF* package manager. -+ -link:++kernel-module-driver-configuration/Working_with_Kernel_Modules.html++[Working with Kernel Modules] explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding. Read this chapter if you need to work with kernel modules. - -link:++RPM.html++[RPM]:: This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by {MAJOROS}, and the use of the [command]#rpm# utility. Read this appendix if you need to use [command]#rpm# instead of [command]#dnf#. - -link:++Wayland.html++[The Wayland Display Server]:: This appendix looks at Wayland, a new display server used in GNOME for {MAJOROS} and how to troubleshoot issues with the Wayland display server. - -include::en-US/Feedback.adoc[] - -[[pref-Acknowledgments]] -== Acknowledgments - -Certain portions of this text first appeared in the [citetitle]_Red{nbsp}Hat Enterprise{nbsp}Linux{nbsp}7 System Administrator's Guide_, copyright © 2014–{YEAR} Red{nbsp}Hat, Inc., available at link:++https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html++[]. - -link:++monitoring-and-automation/System_Monitoring_Tools.html#sect-System_Monitoring_Tools-Net-SNMP++[Monitoring Performance with Net-SNMP] is based on an article written by Michael Solberg. - -The authors of this book would like to thank the following people for their valuable contributions: Adam Tkáč, Andrew Fitzsimon, Andrius Benokraitis, Brian Cleary Edward Bailey, Garrett LeSage, Jeffrey Fearn, Joe Orton, Joshua Wulf, Karsten Wade, Lucy Ringland, Marcela Mašláňová, Mark Johnson, Michael Behm, Miroslav Lichvár, Radek Vokál, Rahul Kavalapara, Rahul Sundaram, Sandra Moore, Zbyšek Mráz, Jan Včelák, Peter Hutterer, T.C. Hollingsworth, and James Antill, among many others. diff --git a/en-US/servers/Directory_Servers.adoc b/en-US/servers/Directory_Servers.adoc deleted file mode 100644 index 08a36c4..0000000 --- a/en-US/servers/Directory_Servers.adoc +++ /dev/null @@ -1,7 +0,0 @@ - -:experimental: - -[[ch-Directory_Servers]] -= Directory Servers - -include::en-US/servers/OpenLDAP.adoc[] diff --git a/index-main.html b/index-main.html deleted file mode 100644 index 84ed5eb..0000000 --- a/index-main.html +++ /dev/null @@ -1,144 +0,0 @@ - - - - - - - - - Fedora Documentation Website - - - - - - - - - - - -
-
-
- -
-
-
-
-

Fedora Documentation Site

-

Test Build.

-
-
-
Fedora Documentation
-
- -  Fedora 26 Documentation - - -  Fedora 27 Documentation - - -  Rawhide Documentation - -
-
-
-
-
-
-
-
-
-

About

-
-
-
About Fedora
-
Sponsors
-
Fedora Magazine
-
Legal
-
-
    -
  • - -
    • -
  • - -
    • -
  • - -
    • -
-
-
- -
-

Download

-
-
-
Get Fedora Workstation
-
Get Fedora Server
-
Get Fedora Atomic
-
Fedora Spins
-
Fedora Labs
-
Fedora ARM®
-
Alternative Downloads
- -
-
-
- -
-

Support

-
-
-
Get Help
-
Ask Fedora
-
Common Bugs
-
Fedora Developer Portal
-
Installation Guide
-
-
-
- -
-

Join

-
-
-
Join Fedora
-
Planet Fedora
-
Fedora SIGs
-
Fedora Account System
-
Fedora Community
-
-
-
-
- -
-
-
- -
-
-
-
- - -

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the websites team

-
-
-
- -
-
-
- - - - - - diff --git a/en-US/basic-system-configuration/images/alt-f2_GNOME.png b/modules/system-administrators-guide/assets/images/alt-f2_GNOME.png similarity index 100% rename from en-US/basic-system-configuration/images/alt-f2_GNOME.png rename to modules/system-administrators-guide/assets/images/alt-f2_GNOME.png diff --git a/en-US/basic-system-configuration/images/alt-f2_KDE.png b/modules/system-administrators-guide/assets/images/alt-f2_KDE.png similarity index 100% rename from en-US/basic-system-configuration/images/alt-f2_KDE.png rename to modules/system-administrators-guide/assets/images/alt-f2_KDE.png diff --git a/en-US/basic-system-configuration/images/alt-f2_LXDE.png b/modules/system-administrators-guide/assets/images/alt-f2_LXDE.png similarity index 100% rename from en-US/basic-system-configuration/images/alt-f2_LXDE.png rename to modules/system-administrators-guide/assets/images/alt-f2_LXDE.png diff --git a/en-US/basic-system-configuration/images/alt-f2_MATE.png b/modules/system-administrators-guide/assets/images/alt-f2_MATE.png similarity index 100% rename from en-US/basic-system-configuration/images/alt-f2_MATE.png rename to modules/system-administrators-guide/assets/images/alt-f2_MATE.png diff --git a/en-US/basic-system-configuration/images/alt-f2_XFCE.png b/modules/system-administrators-guide/assets/images/alt-f2_XFCE.png similarity index 100% rename from en-US/basic-system-configuration/images/alt-f2_XFCE.png rename to modules/system-administrators-guide/assets/images/alt-f2_XFCE.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-01.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-01.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-01.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-01.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-02.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-02.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-02.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-02.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-03.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-03.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-03.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-03.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-04.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-04.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-04.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-04.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-05.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-05.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-05.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-05.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-06.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-06.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-06.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-06.png diff --git a/en-US/servers/images/apache-mod_ssl-genkey-07.png b/modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-07.png similarity index 100% rename from en-US/servers/images/apache-mod_ssl-genkey-07.png rename to modules/system-administrators-guide/assets/images/apache-mod_ssl-genkey-07.png diff --git a/en-US/servers/images/gnome-print-queue.png b/modules/system-administrators-guide/assets/images/gnome-print-queue.png similarity index 100% rename from en-US/servers/images/gnome-print-queue.png rename to modules/system-administrators-guide/assets/images/gnome-print-queue.png diff --git a/en-US/basic-system-configuration/images/managing_users.png b/modules/system-administrators-guide/assets/images/managing_users.png similarity index 100% rename from en-US/basic-system-configuration/images/managing_users.png rename to modules/system-administrators-guide/assets/images/managing_users.png diff --git a/en-US/basic-system-configuration/images/menu_GNOME.png b/modules/system-administrators-guide/assets/images/menu_GNOME.png similarity index 100% rename from en-US/basic-system-configuration/images/menu_GNOME.png rename to modules/system-administrators-guide/assets/images/menu_GNOME.png diff --git a/en-US/basic-system-configuration/images/menu_KDE.png b/modules/system-administrators-guide/assets/images/menu_KDE.png similarity index 100% rename from en-US/basic-system-configuration/images/menu_KDE.png rename to modules/system-administrators-guide/assets/images/menu_KDE.png diff --git a/en-US/basic-system-configuration/images/menu_LXDE.png b/modules/system-administrators-guide/assets/images/menu_LXDE.png similarity index 100% rename from en-US/basic-system-configuration/images/menu_LXDE.png rename to modules/system-administrators-guide/assets/images/menu_LXDE.png diff --git a/en-US/basic-system-configuration/images/menu_MATE.png b/modules/system-administrators-guide/assets/images/menu_MATE.png similarity index 100% rename from en-US/basic-system-configuration/images/menu_MATE.png rename to modules/system-administrators-guide/assets/images/menu_MATE.png diff --git a/en-US/basic-system-configuration/images/menu_XFCE.png b/modules/system-administrators-guide/assets/images/menu_XFCE.png similarity index 100% rename from en-US/basic-system-configuration/images/menu_XFCE.png rename to modules/system-administrators-guide/assets/images/menu_XFCE.png diff --git a/en-US/monitoring-and-automation/images/oprof-start-config.png b/modules/system-administrators-guide/assets/images/oprof-start-config.png similarity index 100% rename from en-US/monitoring-and-automation/images/oprof-start-config.png rename to modules/system-administrators-guide/assets/images/oprof-start-config.png diff --git a/en-US/monitoring-and-automation/images/oprof-start-setup.png b/modules/system-administrators-guide/assets/images/oprof-start-setup.png similarity index 100% rename from en-US/monitoring-and-automation/images/oprof-start-setup.png rename to modules/system-administrators-guide/assets/images/oprof-start-setup.png diff --git a/en-US/servers/images/print_conf_window.png b/modules/system-administrators-guide/assets/images/print_conf_window.png similarity index 100% rename from en-US/servers/images/print_conf_window.png rename to modules/system-administrators-guide/assets/images/print_conf_window.png diff --git a/en-US/servers/images/printconf-add-printer.png b/modules/system-administrators-guide/assets/images/printconf-add-printer.png similarity index 100% rename from en-US/servers/images/printconf-add-printer.png rename to modules/system-administrators-guide/assets/images/printconf-add-printer.png diff --git a/en-US/servers/images/printconf-config1.png b/modules/system-administrators-guide/assets/images/printconf-config1.png similarity index 100% rename from en-US/servers/images/printconf-config1.png rename to modules/system-administrators-guide/assets/images/printconf-config1.png diff --git a/en-US/servers/images/printconf-config2.png b/modules/system-administrators-guide/assets/images/printconf-config2.png similarity index 100% rename from en-US/servers/images/printconf-config2.png rename to modules/system-administrators-guide/assets/images/printconf-config2.png diff --git a/en-US/servers/images/printconf-config3.png b/modules/system-administrators-guide/assets/images/printconf-config3.png similarity index 100% rename from en-US/servers/images/printconf-config3.png rename to modules/system-administrators-guide/assets/images/printconf-config3.png diff --git a/en-US/servers/images/printconf-config4.png b/modules/system-administrators-guide/assets/images/printconf-config4.png similarity index 100% rename from en-US/servers/images/printconf-config4.png rename to modules/system-administrators-guide/assets/images/printconf-config4.png diff --git a/en-US/servers/images/printconf-config5.png b/modules/system-administrators-guide/assets/images/printconf-config5.png similarity index 100% rename from en-US/servers/images/printconf-config5.png rename to modules/system-administrators-guide/assets/images/printconf-config5.png diff --git a/en-US/servers/images/printconf-config6.png b/modules/system-administrators-guide/assets/images/printconf-config6.png similarity index 100% rename from en-US/servers/images/printconf-config6.png rename to modules/system-administrators-guide/assets/images/printconf-config6.png diff --git a/en-US/servers/images/printconf-ipp.png b/modules/system-administrators-guide/assets/images/printconf-ipp.png similarity index 100% rename from en-US/servers/images/printconf-ipp.png rename to modules/system-administrators-guide/assets/images/printconf-ipp.png diff --git a/en-US/servers/images/printconf-jetdirect.png b/modules/system-administrators-guide/assets/images/printconf-jetdirect.png similarity index 100% rename from en-US/servers/images/printconf-jetdirect.png rename to modules/system-administrators-guide/assets/images/printconf-jetdirect.png diff --git a/en-US/servers/images/printconf-lpd.png b/modules/system-administrators-guide/assets/images/printconf-lpd.png similarity index 100% rename from en-US/servers/images/printconf-lpd.png rename to modules/system-administrators-guide/assets/images/printconf-lpd.png diff --git a/en-US/servers/images/printconf-main.png b/modules/system-administrators-guide/assets/images/printconf-main.png similarity index 100% rename from en-US/servers/images/printconf-main.png rename to modules/system-administrators-guide/assets/images/printconf-main.png diff --git a/en-US/servers/images/printconf-select-driver.png b/modules/system-administrators-guide/assets/images/printconf-select-driver.png similarity index 100% rename from en-US/servers/images/printconf-select-driver.png rename to modules/system-administrators-guide/assets/images/printconf-select-driver.png diff --git a/en-US/servers/images/printconf-select-model.png b/modules/system-administrators-guide/assets/images/printconf-select-model.png similarity index 100% rename from en-US/servers/images/printconf-select-model.png rename to modules/system-administrators-guide/assets/images/printconf-select-model.png diff --git a/en-US/servers/images/printconf-smb.png b/modules/system-administrators-guide/assets/images/printconf-smb.png similarity index 100% rename from en-US/servers/images/printconf-smb.png rename to modules/system-administrators-guide/assets/images/printconf-smb.png diff --git a/en-US/servers/images/ptp_grandmaster_boundary_and_slaves.png b/modules/system-administrators-guide/assets/images/ptp_grandmaster_boundary_and_slaves.png similarity index 100% rename from en-US/servers/images/ptp_grandmaster_boundary_and_slaves.png rename to modules/system-administrators-guide/assets/images/ptp_grandmaster_boundary_and_slaves.png diff --git a/en-US/monitoring-and-automation/images/redhat-filter-enable.png b/modules/system-administrators-guide/assets/images/redhat-filter-enable.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-filter-enable.png rename to modules/system-administrators-guide/assets/images/redhat-filter-enable.png diff --git a/en-US/monitoring-and-automation/images/redhat-filter-sample.png b/modules/system-administrators-guide/assets/images/redhat-filter-sample.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-filter-sample.png rename to modules/system-administrators-guide/assets/images/redhat-filter-sample.png diff --git a/en-US/monitoring-and-automation/images/redhat-filters.png b/modules/system-administrators-guide/assets/images/redhat-filters.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-filters.png rename to modules/system-administrators-guide/assets/images/redhat-filters.png diff --git a/en-US/monitoring-and-automation/images/redhat-logviewer-add.png b/modules/system-administrators-guide/assets/images/redhat-logviewer-add.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-logviewer-add.png rename to modules/system-administrators-guide/assets/images/redhat-logviewer-add.png diff --git a/en-US/monitoring-and-automation/images/redhat-logviewer-monitoring.png b/modules/system-administrators-guide/assets/images/redhat-logviewer-monitoring.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-logviewer-monitoring.png rename to modules/system-administrators-guide/assets/images/redhat-logviewer-monitoring.png diff --git a/en-US/monitoring-and-automation/images/redhat-logviewer.png b/modules/system-administrators-guide/assets/images/redhat-logviewer.png similarity index 100% rename from en-US/monitoring-and-automation/images/redhat-logviewer.png rename to modules/system-administrators-guide/assets/images/redhat-logviewer.png diff --git a/en-US/monitoring-and-automation/images/rsyslog_message_flow.png b/modules/system-administrators-guide/assets/images/rsyslog_message_flow.png similarity index 100% rename from en-US/monitoring-and-automation/images/rsyslog_message_flow.png rename to modules/system-administrators-guide/assets/images/rsyslog_message_flow.png diff --git a/en-US/servers/images/samba-nautilus-domain.png b/modules/system-administrators-guide/assets/images/samba-nautilus-domain.png similarity index 100% rename from en-US/servers/images/samba-nautilus-domain.png rename to modules/system-administrators-guide/assets/images/samba-nautilus-domain.png diff --git a/en-US/basic-system-configuration/images/searchmenu_GNOME.png b/modules/system-administrators-guide/assets/images/searchmenu_GNOME.png similarity index 100% rename from en-US/basic-system-configuration/images/searchmenu_GNOME.png rename to modules/system-administrators-guide/assets/images/searchmenu_GNOME.png diff --git a/en-US/basic-system-configuration/images/searchmenu_KDE.png b/modules/system-administrators-guide/assets/images/searchmenu_KDE.png similarity index 100% rename from en-US/basic-system-configuration/images/searchmenu_KDE.png rename to modules/system-administrators-guide/assets/images/searchmenu_KDE.png diff --git a/en-US/monitoring-and-automation/images/system-monitor-file-systems.png b/modules/system-administrators-guide/assets/images/system-monitor-file-systems.png similarity index 100% rename from en-US/monitoring-and-automation/images/system-monitor-file-systems.png rename to modules/system-administrators-guide/assets/images/system-monitor-file-systems.png diff --git a/en-US/monitoring-and-automation/images/system-monitor-processes.png b/modules/system-administrators-guide/assets/images/system-monitor-processes.png similarity index 100% rename from en-US/monitoring-and-automation/images/system-monitor-processes.png rename to modules/system-administrators-guide/assets/images/system-monitor-processes.png diff --git a/en-US/monitoring-and-automation/images/system-monitor-resources.png b/modules/system-administrators-guide/assets/images/system-monitor-resources.png similarity index 100% rename from en-US/monitoring-and-automation/images/system-monitor-resources.png rename to modules/system-administrators-guide/assets/images/system-monitor-resources.png diff --git a/Common_Content/images/title_logo.svg b/modules/system-administrators-guide/assets/images/title_logo.svg similarity index 100% rename from Common_Content/images/title_logo.svg rename to modules/system-administrators-guide/assets/images/title_logo.svg diff --git a/modules/system-administrators-guide/nav.adoc b/modules/system-administrators-guide/nav.adoc new file mode 100644 index 0000000..9d26d23 --- /dev/null +++ b/modules/system-administrators-guide/nav.adoc @@ -0,0 +1,41 @@ +* xref:index.adoc[Book Information] +* 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] diff --git a/modules/system-administrators-guide/pages/Preface.adoc b/modules/system-administrators-guide/pages/Preface.adoc new file mode 100644 index 0000000..4e4a454 --- /dev/null +++ b/modules/system-administrators-guide/pages/Preface.adoc @@ -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 © 2014–{YEAR} Red{nbsp}Hat, Inc., available at link:++https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html++[]. + +xref:monitoring-and-automation/System_Monitoring_Tools.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. diff --git a/en-US/RPM.adoc b/modules/system-administrators-guide/pages/RPM.adoc similarity index 99% rename from en-US/RPM.adoc rename to modules/system-administrators-guide/pages/RPM.adoc index c205cc8..127584b 100644 --- a/en-US/RPM.adoc +++ b/modules/system-administrators-guide/pages/RPM.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-RPM]] = RPM diff --git a/en-US/Revision_History.adoc b/modules/system-administrators-guide/pages/Revision_History.adoc similarity index 100% rename from en-US/Revision_History.adoc rename to modules/system-administrators-guide/pages/Revision_History.adoc diff --git a/en-US/Wayland.adoc b/modules/system-administrators-guide/pages/Wayland.adoc similarity index 98% rename from en-US/Wayland.adoc rename to modules/system-administrators-guide/pages/Wayland.adoc index 241fb88..0e2e954 100644 --- a/en-US/Wayland.adoc +++ b/modules/system-administrators-guide/pages/Wayland.adoc @@ -1,6 +1,6 @@ :hardbreaks: :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Wayland]] = The Wayland Display Server diff --git a/en-US/Author_Group.adoc b/modules/system-administrators-guide/pages/_partials/Author_Group.adoc similarity index 100% rename from en-US/Author_Group.adoc rename to modules/system-administrators-guide/pages/_partials/Author_Group.adoc diff --git a/en-US/Feedback.adoc b/modules/system-administrators-guide/pages/_partials/Feedback.adoc similarity index 100% rename from en-US/Feedback.adoc rename to modules/system-administrators-guide/pages/_partials/Feedback.adoc diff --git a/Common_Content/Legal_Notice.adoc b/modules/system-administrators-guide/pages/_partials/Legal_Notice.adoc similarity index 100% rename from Common_Content/Legal_Notice.adoc rename to modules/system-administrators-guide/pages/_partials/Legal_Notice.adoc diff --git a/en-US/entities.adoc b/modules/system-administrators-guide/pages/_partials/entities.adoc similarity index 100% rename from en-US/entities.adoc rename to modules/system-administrators-guide/pages/_partials/entities.adoc diff --git a/en-US/servers/FTP.adoc b/modules/system-administrators-guide/pages/_partials/servers/FTP.adoc similarity index 99% rename from en-US/servers/FTP.adoc rename to modules/system-administrators-guide/pages/_partials/servers/FTP.adoc index d71219b..0e4216f 100644 --- a/en-US/servers/FTP.adoc +++ b/modules/system-administrators-guide/pages/_partials/servers/FTP.adoc @@ -34,7 +34,7 @@ indexterm:[FTP,server software,vsftpd]indexterm:[FTP,server software,Red Hat Con * [command]#vsftpd# — A fast, secure `FTP` daemon which is the preferred `FTP` server for {MAJOROS}. The remainder of this section focuses on [command]#vsftpd#. [[s3-ftp-servers-vsftpd]] -====== [command]#vsftpd# +==== [command]#vsftpd# _The Very Secure FTP Daemon_ ([command]#vsftpd#) is designed from the ground up to be fast, stable, and, most importantly, secure. [command]#vsftpd# is the only stand-alone `FTP` server distributed with {MAJOROS}, due to its ability to handle large numbers of connections efficiently and securely. diff --git a/en-US/servers/OpenLDAP.adoc b/modules/system-administrators-guide/pages/_partials/servers/OpenLDAP.adoc similarity index 100% rename from en-US/servers/OpenLDAP.adoc rename to modules/system-administrators-guide/pages/_partials/servers/OpenLDAP.adoc diff --git a/en-US/servers/Printer_Configuration.adoc b/modules/system-administrators-guide/pages/_partials/servers/Printer_Configuration.adoc similarity index 100% rename from en-US/servers/Printer_Configuration.adoc rename to modules/system-administrators-guide/pages/_partials/servers/Printer_Configuration.adoc diff --git a/en-US/servers/Samba.adoc b/modules/system-administrators-guide/pages/_partials/servers/Samba.adoc similarity index 100% rename from en-US/servers/Samba.adoc rename to modules/system-administrators-guide/pages/_partials/servers/Samba.adoc diff --git a/en-US/servers/The_Apache_HTTP_Server.adoc b/modules/system-administrators-guide/pages/_partials/servers/The_Apache_HTTP_Server.adoc similarity index 100% rename from en-US/servers/The_Apache_HTTP_Server.adoc rename to modules/system-administrators-guide/pages/_partials/servers/The_Apache_HTTP_Server.adoc diff --git a/en-US/basic-system-configuration/Configuring_the_Date_and_Time.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/Configuring_the_Date_and_Time.adoc similarity index 99% rename from en-US/basic-system-configuration/Configuring_the_Date_and_Time.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/Configuring_the_Date_and_Time.adoc index 428aa31..56aee45 100644 --- a/en-US/basic-system-configuration/Configuring_the_Date_and_Time.adoc +++ b/modules/system-administrators-guide/pages/basic-system-configuration/Configuring_the_Date_and_Time.adoc @@ -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 diff --git a/en-US/basic-system-configuration/Gaining_Privileges.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/Gaining_Privileges.adoc similarity index 99% rename from en-US/basic-system-configuration/Gaining_Privileges.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/Gaining_Privileges.adoc index 04f3c1f..daa2db6 100644 --- a/en-US/basic-system-configuration/Gaining_Privileges.adoc +++ b/modules/system-administrators-guide/pages/basic-system-configuration/Gaining_Privileges.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[chap-Gaining_Privileges]] = Gaining Privileges diff --git a/en-US/basic-system-configuration/Managing_Users_and_Groups.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/Managing_Users_and_Groups.adoc similarity index 99% rename from en-US/basic-system-configuration/Managing_Users_and_Groups.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/Managing_Users_and_Groups.adoc index 021609c..0e3b750 100644 --- a/en-US/basic-system-configuration/Managing_Users_and_Groups.adoc +++ b/modules/system-administrators-guide/pages/basic-system-configuration/Managing_Users_and_Groups.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Managing_Users_and_Groups]] = Managing Users and Groups diff --git a/en-US/basic-system-configuration/Opening_GUI_Applications.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/Opening_GUI_Applications.adoc similarity index 99% rename from en-US/basic-system-configuration/Opening_GUI_Applications.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/Opening_GUI_Applications.adoc index 411ef70..d4f7b27 100644 --- a/en-US/basic-system-configuration/Opening_GUI_Applications.adoc +++ b/modules/system-administrators-guide/pages/basic-system-configuration/Opening_GUI_Applications.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Opening_GUI_Applications]] = Opening Graphical Applications diff --git a/en-US/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc similarity index 99% rename from en-US/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc index d0527a3..28d2e83 100644 --- a/en-US/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc +++ b/modules/system-administrators-guide/pages/basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc @@ -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 diff --git a/en-US/basic-system-configuration/intro-basic-system-configuration.adoc b/modules/system-administrators-guide/pages/basic-system-configuration/intro-basic-system-configuration.adoc similarity index 100% rename from en-US/basic-system-configuration/intro-basic-system-configuration.adoc rename to modules/system-administrators-guide/pages/basic-system-configuration/intro-basic-system-configuration.adoc diff --git a/en-US/index.adoc b/modules/system-administrators-guide/pages/index.adoc similarity index 66% rename from en-US/index.adoc rename to modules/system-administrators-guide/pages/index.adoc index fab08f5..7bc1045 100644 --- a/en-US/index.adoc +++ b/modules/system-administrators-guide/pages/index.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] = System Administrator's Guide @@ -12,7 +12,7 @@ Deployment, Configuration, and Administration of {MAJOROSVER} The [citetitle]_System Administrator's Guide_ documents relevant information regarding the deployment, configuration, and administration of {MAJOROSVER}. It is oriented towards system administrators with a basic understanding of the system. -- -image:../../Common_Content/images/title_logo.svg[Fedora Documentation Team] -include::Common_Content/Legal_Notice.adoc[] +image:title_logo.svg[Fedora Documentation Team] +include::{partialsdir}/Legal_Notice.adoc[] -include::en-US/Author_Group.adoc[] +include::{partialsdir}/Author_Group.adoc[] diff --git a/en-US/infrastructure-services/OpenSSH.adoc b/modules/system-administrators-guide/pages/infrastructure-services/OpenSSH.adoc similarity index 99% rename from en-US/infrastructure-services/OpenSSH.adoc rename to modules/system-administrators-guide/pages/infrastructure-services/OpenSSH.adoc index 4fe3dda..7e51f40 100644 --- a/en-US/infrastructure-services/OpenSSH.adoc +++ b/modules/system-administrators-guide/pages/infrastructure-services/OpenSSH.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-OpenSSH]] = OpenSSH diff --git a/en-US/infrastructure-services/Services_and_Daemons.adoc b/modules/system-administrators-guide/pages/infrastructure-services/Services_and_Daemons.adoc similarity index 99% rename from en-US/infrastructure-services/Services_and_Daemons.adoc rename to modules/system-administrators-guide/pages/infrastructure-services/Services_and_Daemons.adoc index 8ec3a9e..7a3557c 100644 --- a/en-US/infrastructure-services/Services_and_Daemons.adoc +++ b/modules/system-administrators-guide/pages/infrastructure-services/Services_and_Daemons.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Services_and_Daemons]] = Services and Daemons diff --git a/en-US/infrastructure-services/TigerVNC.adoc b/modules/system-administrators-guide/pages/infrastructure-services/TigerVNC.adoc similarity index 99% rename from en-US/infrastructure-services/TigerVNC.adoc rename to modules/system-administrators-guide/pages/infrastructure-services/TigerVNC.adoc index 24e7d05..998d5d9 100644 --- a/en-US/infrastructure-services/TigerVNC.adoc +++ b/modules/system-administrators-guide/pages/infrastructure-services/TigerVNC.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-TigerVNC]] = TigerVNC diff --git a/en-US/infrastructure-services/intro-infrastructure-services.adoc b/modules/system-administrators-guide/pages/infrastructure-services/intro-infrastructure-services.adoc similarity index 100% rename from en-US/infrastructure-services/intro-infrastructure-services.adoc rename to modules/system-administrators-guide/pages/infrastructure-services/intro-infrastructure-services.adoc diff --git a/en-US/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc similarity index 99% rename from en-US/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc rename to modules/system-administrators-guide/pages/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc index c5ce001..e66a7cb 100644 --- a/en-US/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc +++ b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Manually_Upgrading_the_Kernel.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Manually_Upgrading_the_Kernel]] = Manually Upgrading the Kernel diff --git a/en-US/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc similarity index 99% rename from en-US/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc rename to modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc index 994d6c8..51018de 100644 --- a/en-US/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc +++ b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_Kernel_Modules.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Working_with_Kernel_Modules]] = Working with Kernel Modules diff --git a/en-US/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc similarity index 99% rename from en-US/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc rename to modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc index 17a1aa6..e5eebce 100644 --- a/en-US/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc +++ b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader.adoc @@ -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 diff --git a/en-US/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc b/modules/system-administrators-guide/pages/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc similarity index 100% rename from en-US/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc rename to modules/system-administrators-guide/pages/kernel-module-driver-configuration/intro-kernel-module-driver-configuration.adoc diff --git a/en-US/monitoring-and-automation/Automating_System_Tasks.adoc b/modules/system-administrators-guide/pages/monitoring-and-automation/Automating_System_Tasks.adoc similarity index 99% rename from en-US/monitoring-and-automation/Automating_System_Tasks.adoc rename to modules/system-administrators-guide/pages/monitoring-and-automation/Automating_System_Tasks.adoc index 39a5a06..00df526 100644 --- a/en-US/monitoring-and-automation/Automating_System_Tasks.adoc +++ b/modules/system-administrators-guide/pages/monitoring-and-automation/Automating_System_Tasks.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Automating_System_Tasks]] = Automating System Tasks diff --git a/en-US/monitoring-and-automation/OProfile.adoc b/modules/system-administrators-guide/pages/monitoring-and-automation/OProfile.adoc similarity index 99% rename from en-US/monitoring-and-automation/OProfile.adoc rename to modules/system-administrators-guide/pages/monitoring-and-automation/OProfile.adoc index 897883f..791bd40 100644 --- a/en-US/monitoring-and-automation/OProfile.adoc +++ b/modules/system-administrators-guide/pages/monitoring-and-automation/OProfile.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-OProfile]] = OProfile diff --git a/en-US/monitoring-and-automation/System_Monitoring_Tools.adoc b/modules/system-administrators-guide/pages/monitoring-and-automation/System_Monitoring_Tools.adoc similarity index 99% rename from en-US/monitoring-and-automation/System_Monitoring_Tools.adoc rename to modules/system-administrators-guide/pages/monitoring-and-automation/System_Monitoring_Tools.adoc index 6d58802..418c209 100644 --- a/en-US/monitoring-and-automation/System_Monitoring_Tools.adoc +++ b/modules/system-administrators-guide/pages/monitoring-and-automation/System_Monitoring_Tools.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-System_Monitoring_Tools]] = System Monitoring Tools diff --git a/en-US/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc b/modules/system-administrators-guide/pages/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc similarity index 99% rename from en-US/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc rename to modules/system-administrators-guide/pages/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc index 15e10e7..b8afdbd 100644 --- a/en-US/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc +++ b/modules/system-administrators-guide/pages/monitoring-and-automation/Viewing_and_Managing_Log_Files.adoc @@ -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 diff --git a/en-US/monitoring-and-automation/intro-monitoring-and-automation.adoc b/modules/system-administrators-guide/pages/monitoring-and-automation/intro-monitoring-and-automation.adoc similarity index 100% rename from en-US/monitoring-and-automation/intro-monitoring-and-automation.adoc rename to modules/system-administrators-guide/pages/monitoring-and-automation/intro-monitoring-and-automation.adoc diff --git a/en-US/package-management/DNF.adoc b/modules/system-administrators-guide/pages/package-management/DNF.adoc similarity index 99% rename from en-US/package-management/DNF.adoc rename to modules/system-administrators-guide/pages/package-management/DNF.adoc index 23c130e..378084f 100644 --- a/en-US/package-management/DNF.adoc +++ b/modules/system-administrators-guide/pages/package-management/DNF.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-DNF]] = DNF diff --git a/en-US/package-management/intro-package-management.adoc b/modules/system-administrators-guide/pages/package-management/intro-package-management.adoc similarity index 96% rename from en-US/package-management/intro-package-management.adoc rename to modules/system-administrators-guide/pages/package-management/intro-package-management.adoc index 2c17464..299d422 100644 --- a/en-US/package-management/intro-package-management.adoc +++ b/modules/system-administrators-guide/pages/package-management/intro-package-management.adoc @@ -1,4 +1,4 @@ -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] = Package Management diff --git a/en-US/package-management/rpm-ostree.adoc b/modules/system-administrators-guide/pages/package-management/rpm-ostree.adoc similarity index 89% rename from en-US/package-management/rpm-ostree.adoc rename to modules/system-administrators-guide/pages/package-management/rpm-ostree.adoc index d251e73..6b1bb4b 100644 --- a/en-US/package-management/rpm-ostree.adoc +++ b/modules/system-administrators-guide/pages/package-management/rpm-ostree.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-rpm-ostree]] = rpm-ostree diff --git a/en-US/servers/Configuring_NTP_Using_ntpd.adoc b/modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_ntpd.adoc similarity index 99% rename from en-US/servers/Configuring_NTP_Using_ntpd.adoc rename to modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_ntpd.adoc index 7b950cb..0e5db49 100644 --- a/en-US/servers/Configuring_NTP_Using_ntpd.adoc +++ b/modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_ntpd.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Configuring_NTP_Using_ntpd]] = Configuring NTP Using ntpd diff --git a/en-US/servers/Configuring_NTP_Using_the_chrony_Suite.adoc b/modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_the_chrony_Suite.adoc similarity index 99% rename from en-US/servers/Configuring_NTP_Using_the_chrony_Suite.adoc rename to modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_the_chrony_Suite.adoc index 0efd260..a3bd3c7 100644 --- a/en-US/servers/Configuring_NTP_Using_the_chrony_Suite.adoc +++ b/modules/system-administrators-guide/pages/servers/Configuring_NTP_Using_the_chrony_Suite.adoc @@ -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 diff --git a/en-US/servers/Configuring_PTP_Using_ptp4l.adoc b/modules/system-administrators-guide/pages/servers/Configuring_PTP_Using_ptp4l.adoc similarity index 99% rename from en-US/servers/Configuring_PTP_Using_ptp4l.adoc rename to modules/system-administrators-guide/pages/servers/Configuring_PTP_Using_ptp4l.adoc index f28eb38..c301468 100644 --- a/en-US/servers/Configuring_PTP_Using_ptp4l.adoc +++ b/modules/system-administrators-guide/pages/servers/Configuring_PTP_Using_ptp4l.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Configuring_PTP_Using_ptp4l]] = Configuring PTP Using ptp4l diff --git a/modules/system-administrators-guide/pages/servers/Directory_Servers.adoc b/modules/system-administrators-guide/pages/servers/Directory_Servers.adoc new file mode 100644 index 0000000..eb2e518 --- /dev/null +++ b/modules/system-administrators-guide/pages/servers/Directory_Servers.adoc @@ -0,0 +1,8 @@ + +:experimental: +include::{partialsdir}/entities.adoc[] + +[[ch-Directory_Servers]] += Directory Servers + +include::{partialsdir}/servers/OpenLDAP.adoc[] diff --git a/en-US/servers/File_and_Print_Servers.adoc b/modules/system-administrators-guide/pages/servers/File_and_Print_Servers.adoc similarity index 71% rename from en-US/servers/File_and_Print_Servers.adoc rename to modules/system-administrators-guide/pages/servers/File_and_Print_Servers.adoc index d21e1d0..599d3aa 100644 --- a/en-US/servers/File_and_Print_Servers.adoc +++ b/modules/system-administrators-guide/pages/servers/File_and_Print_Servers.adoc @@ -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[] diff --git a/en-US/servers/Mail_Servers.adoc b/modules/system-administrators-guide/pages/servers/Mail_Servers.adoc similarity index 99% rename from en-US/servers/Mail_Servers.adoc rename to modules/system-administrators-guide/pages/servers/Mail_Servers.adoc index 7d39959..fc0c3b1 100644 --- a/en-US/servers/Mail_Servers.adoc +++ b/modules/system-administrators-guide/pages/servers/Mail_Servers.adoc @@ -1,6 +1,6 @@ :experimental: -include::en-US/entities.adoc[] +include::{partialsdir}/entities.adoc[] [[ch-Mail_Servers]] = Mail Servers diff --git a/en-US/servers/Web_Servers.adoc b/modules/system-administrators-guide/pages/servers/Web_Servers.adoc similarity index 79% rename from en-US/servers/Web_Servers.adoc rename to modules/system-administrators-guide/pages/servers/Web_Servers.adoc index fd3ed07..23e46be 100644 --- a/en-US/servers/Web_Servers.adoc +++ b/modules/system-administrators-guide/pages/servers/Web_Servers.adoc @@ -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[] diff --git a/en-US/servers/intro-servers.adoc b/modules/system-administrators-guide/pages/servers/intro-servers.adoc similarity index 100% rename from en-US/servers/intro-servers.adoc rename to modules/system-administrators-guide/pages/servers/intro-servers.adoc diff --git a/preview.sh b/preview.sh new file mode 100755 index 0000000..acab783 --- /dev/null +++ b/preview.sh @@ -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 diff --git a/site.yml b/site.yml new file mode 100644 index 0000000..b016506 --- /dev/null +++ b/site.yml @@ -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