From be97e1375fc2a2ec2bffa050e0ba1a759daf5544 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Mar 28 2021 15:30:32 +0000 Subject: [PATCH 1/3] Updated index page to beta 1 --- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 7a2d2e4..567c239 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -7,11 +7,11 @@ image::Logo_server2.png[Server] [sidebar] **** -Creation Date: 2021-03-10 | Last update: N/A | Related Fedora Version(s): 33 +Creation Date: 2021-xx-yy | Last update: N/A | Related Fedora Version(s): 33,34 **** [NOTE] ==== -First Draft! Please comment on server mailing list +Draft! Please comment on server mailing list ==== == Our Mission @@ -24,9 +24,6 @@ Fedora Server provides a stable, flexible and universally adaptable basis for th Fedora Server is a platform for developers and system integrators, which provides an implementation of the latest server technology for further evaluation and practical appropriation. -== Why Use Fedora Server - -Just a shot == What's Cooking @@ -39,22 +36,56 @@ Currently, we work on several projects Stay tuned. The results will soon be visible. + +== Why Use Fedora Server + +Fedora Server Edition offers users and system administrators several attractive features + +* The biannual release cycle allows the latest stable versions of system and application software with new or improved features to be used almost immediately. Users and system administrators can swiftly respond to new market options and changing or expanding customer requirements. + +* A sophisticated and highly engineered release and quality assurance process enables a high level of reliability and stability, despite a comparatively fast release cycle. This achieves an excellent balance between 'bleeding edge' and maturity for productive use in mainstream deployments. + +* Enterprise-grade security minded, the Fedora release engineering results in carefully pre-configured releases, offering uncompromising security without prior extensive configuration work by system administrators. + +* A great variety of available packages, all of them included in that elaborated release process, opens up a wide range of possibilities for building a server very flexibly according to customer specific needs and wishes. + +* Inclusion of modern sysadmin tools (i.e. cockpit, dnf, systemd) in their latest stable version noticeably reduces the burden of system administration. + +* Due to the release cycle less disruptive release jumps combine a very easy update process without re-installation requirements, and the option to skip one release jump, in case new capabilities are not immediately needed. Several small updates are easier to manage than a few but big updates. + +* Utmost freedom from restrictions imposed by commercial interests or corporate feature management and excellent backwards hardware compatibility (including a complete set of standard kernel drivers). + +* Developer find an excellent development environment for the next generation server as well as application software with the latest software versions available. + == What You Will Find Here -- Server Administration (todo: One sentence short description) -- Example Use Cases (todo: One sentence short description) -- Tutorials (todo: One sentence short description) -- Trouble shooting guide / known issues +- Server installation and administration guides ++ +You find information about installation and basic system administration supplementing the general Fedora Installation Guide and System Administration Guide. Several other sections cover specific Fedora Server Edition related options and solutions. This includes virtualisation and containerisation in particular. + +- Example Use Cases ++ +Users describe how they use Fedora Server for a wide variety of tasks as well as solutions for special tasks. Hopefully, this will provide inspiration for your own assignments. + +- Tutorials ++ +Detailed step-by-step instructions are given for various typical areas of application. They are intended to enable not only experienced system administrators but also inexperienced users to safely install and configure the system. + - People, policies, and working methods == How You Can Contribute +You don't have to be a programmer, a developer or a technical nerd to contribute to the development of Fedora Server. We are especially interested in feedback from our users and potential new users. + - Please, tell us about your usage of Fedora Server - Tell us about problems you found and how you resolved it -- (Easy Contact opportunity ) -== Where Else You Find Related Information +The easiest way is to write on our mailing list. It is a low traffic list specifically for Fedora Server Edition. It is open to everyone. + +Another option is our ticket system at https://pagure.io/fedora-server/issues. However, this requires a FAS account. + +You can also chat with us at +https://webchat.freenode.net/?channels=#fedora-server[#fedora-server] on irc.freenode.net. + +For additional information refer to https://docs.fedoraproject.org/en-US/fedora-server/server-communicating/[Getting in Touch] -- System Administration Guide -- Wiki pages -- General ongoing work / change requests? \ No newline at end of file From 7592f9006ff1be6a9c64102ecfd2d3d77b903018 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Mar 28 2021 15:51:04 +0000 Subject: [PATCH 2/3] Fixed Note --- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 567c239..71c98e4 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -11,7 +11,7 @@ Creation Date: 2021-xx-yy | Last update: N/A | Related Fedora Version(s): 33,34 **** [NOTE] ==== -Draft! Please comment on server mailing list +**Beta 1**! Please comment on server mailing list ==== == Our Mission @@ -89,3 +89,4 @@ https://webchat.freenode.net/?channels=#fedora-server[#fedora-server] on irc.fre For additional information refer to https://docs.fedoraproject.org/en-US/fedora-server/server-communicating/[Getting in Touch] + From 25966f4b54e51e71da5ebdfd449a3a7e2e65c993 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Mar 28 2021 16:15:26 +0000 Subject: [PATCH 3/3] Updated index page to Beta 1, various minor fixes --- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 71c98e4..68993fe 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -7,7 +7,7 @@ image::Logo_server2.png[Server] [sidebar] **** -Creation Date: 2021-xx-yy | Last update: N/A | Related Fedora Version(s): 33,34 +Creation Date: 2021-03-10 | Last update: 2021-03-28 | Related Fedora Version(s): 34 **** [NOTE] ==== @@ -88,5 +88,3 @@ You can also chat with us at https://webchat.freenode.net/?channels=#fedora-server[#fedora-server] on irc.freenode.net. For additional information refer to https://docs.fedoraproject.org/en-US/fedora-server/server-communicating/[Getting in Touch] - - diff --git a/docs/modules/ROOT/pages/server-administration.adoc b/docs/modules/ROOT/pages/server-administration.adoc index a55dbe2..b817fbc 100644 --- a/docs/modules/ROOT/pages/server-administration.adoc +++ b/docs/modules/ROOT/pages/server-administration.adoc @@ -4,7 +4,7 @@ Peter Boy; Jan Kuparinen [sidebar] **** -Author: Peter Boy (pboy) | Creation Date: 2021-03-10 | Last update: N/A | Related Fedora Version(s): 33 +Author: Peter Boy (pboy) | Creation Date: 2021-03-10 | Last update: 2021-03-26 | Related Fedora Version(s): 34 **** [NOTE] ==== @@ -13,7 +13,7 @@ First Draft! Please comment on server mailing list == What You Find Here -Basic installation and system administration is covered by Fedora's overall Installation Guide (link) and System Administration Guide (link). But there are several of Fedora Server specific topics which are not included. There are such basic items as harddisk partitioning to more advanced security considerations up to virtualisation. +Basic installation and system administration is covered by Fedora's overall Installation Guide (link) and System Administration Guide (link). But there are several of Fedora Server specific topics which are not included. There are such basic items as hard disk partitioning to more advanced security considerations up to virtualization. == Basic System Installation (to be decided: alternatively: expand Fedora central Installation and System Administration Guides) @@ -22,7 +22,7 @@ Basic installation and system administration is covered by Fedora's overall Inst - What default partitioning does - Raid system -- Hard disk larger as 2 TB in Raid set ups +- Hard disk larger than 2 TB in Raid set-ups - UEFI boot === Networking @@ -31,12 +31,12 @@ Basic installation and system administration is covered by Fedora's overall Inst == Post Installation security enhancements - Installing fail2ban (short step-by-step installation guide the Fedora way) -- Disabling ssh password based login for all users but a small number of fallbacks (short guide how to do) +- Disabling ssh password based login for all users except some fallbacks (short guide how to do) - Protecting Cockpit password login -- Don't deactivate SELinux but resolve issues (link to cockpit SELinux page and description how to resolve on CLI (or link) ) +- Don't deactivate SELinux but resolve issues (link to cockpit SELinux page and description how to resolve on CLI (or link)) - Reduce the number of system users (If certain system users are required, move each (or all) to a lightweight system container, e.g. systemd-nspawn, or even a (semi-lightweight) Cloud Image VM) - Would be nice to offer some configurable Ansible scripts for those repetitive tasks (downloadable from server-wg home page) -- links to existing script at github system roles und a guide how to use that script for this purpose +- links to existing script at GitHub system roles and a guide how to use that script for this purpose == Specific System Administration Tasks diff --git a/docs/modules/ROOT/pages/server-communicating.adoc b/docs/modules/ROOT/pages/server-communicating.adoc index f73dad3..27e5fbe 100644 --- a/docs/modules/ROOT/pages/server-communicating.adoc +++ b/docs/modules/ROOT/pages/server-communicating.adoc @@ -18,7 +18,7 @@ For general troubleshooting help related to Fedora, please refer to link:https:/ If you found a bug, report it! * link:https://docs.fedoraproject.org/en-US/quick-docs/howto-file-a-bug/[How to file a bug]. -* Issues about a server can be filed at link:https://pagure.io/fedora-server/issues[ticketing repository on Pagure]. +* Issues about a server can be filed at link:https://pagure.io/fedora-server/issues[the ticketing repository on Pagure]. * You can chat with us at link:https://webchat.freenode.net/?channels=#fedora-server[#fedora-server on irc.freenode.net]. diff --git a/docs/modules/ROOT/pages/server-community.adoc b/docs/modules/ROOT/pages/server-community.adoc index ab02f73..ffa39d2 100644 --- a/docs/modules/ROOT/pages/server-community.adoc +++ b/docs/modules/ROOT/pages/server-community.adoc @@ -4,7 +4,7 @@ Peter Boy; Jan Kuparinen [sidebar] **** -Creation Date: N/A | Last update: N/A | Related Fedora Version(s): 33 +Creation Date: 2021-03-09 | Last update: 2021-03-26 | Related Fedora Version(s): 34 **** [NOTE] ==== @@ -12,7 +12,7 @@ First Collection of Ideas! Please comment on server mailing list ==== [TIP] ==== -Intended content: Basic information how work on Server is organiszed. In a first version probably just the most importent content of the Working Group and the SIG and a collection of annotated links to the most important information sources (WG wiki, SIG wiki, pagure, fedora calendar, anything else?) +Intended content: Basic information on how work on Server is organized. In a first version probably just the most important content of the Working Group and the SIG and a collection of annotated links to the most important information sources (WG wiki, SIG wiki, Pagure, Fedora calendar, anything else?) ==== diff --git a/docs/modules/ROOT/pages/server-containers.adoc b/docs/modules/ROOT/pages/server-containers.adoc index 31c0321..aa9c4f1 100644 --- a/docs/modules/ROOT/pages/server-containers.adoc +++ b/docs/modules/ROOT/pages/server-containers.adoc @@ -4,7 +4,7 @@ Peter Boy; Jan Kuparinen [sidebar] **** -Author: Peter Boy (pboy) | Creation Date: N/A | Last update: N/A | Related Fedora Version(s): 33 +Author: Peter Boy (pboy) | Creation Date: 2021-03-10 | Last update: 2021-03-26 | Related Fedora Version(s): 34 **** [NOTE] ==== @@ -41,30 +41,30 @@ Planned content: * application container * dependent on a Damon with ROOT privileges * huge trove of pre-built containers for all sorts of software -* no native support in Fedora Server, but a *vendor repository* maintained for Fedora +* no native support for Fedora Server, but a *vendor repository* maintained for Fedora == LXC (libvirt) * system container * support of container runtime based on kernel capabilities -* rough toolset support (requires to compose various xml files) +* rough toolset support (requires composing various xml files) * *natively supported by Fedora Server* (via libvirt as default virtualization tool) -== LXC (linuxcontainers) +== LXC (linux containers) -* systemcontainer +* system container * one of the first implementations of containers * system containers * originally base of Docker * complete toolset, container images, community * *natively supported by Fedora Server* (just LTS versions) -== LXD (linuxcontainers) +== LXD (linux containers) * system container * LXC with advanced toolset * not natively supported by Fedora, but a *COPR project* available -* *vendor support* for Fedory by third party packagemanager +* *vendor support* for Fedora by third party package manager == systemd-nspawn container diff --git a/docs/modules/ROOT/pages/server-troubleshooting.adoc b/docs/modules/ROOT/pages/server-troubleshooting.adoc index c0edae2..bd32880 100644 --- a/docs/modules/ROOT/pages/server-troubleshooting.adoc +++ b/docs/modules/ROOT/pages/server-troubleshooting.adoc @@ -4,7 +4,7 @@ Peter Boy; Jan Kuparinen [sidebar] **** -Author: Jan Kuparinen (copperi) | Creation Date: 2021-03-09 | Last update: N/A | Related Fedora Version(s): 33 +Author: Jan Kuparinen (copperi) | Creation Date: 2021-03-09 | Last update: 2021-03-26 | Related Fedora Version(s): 34 **** [NOTE] ==== @@ -14,7 +14,7 @@ First Collection of Ideas! Please comment on server mailing list Some examples from the latest discussions -1. The well known BIOSboot partition issue +1. The well known BIOS boot partition issue 2. systemnd-oomd and httpd / jBoss/wildfly 3. UEFI – one ESP for /boot/efi requirement in software RAID 1 / RAID x @@ -25,7 +25,7 @@ If you found a bug, report it! * link:https://docs.fedoraproject.org/en-US/quick-docs/howto-file-a-bug/[How to file a bug]. -* Issues about a server can be filed at link:https://pagure.io/fedora-server/issues[ticketing repository on Pagure]. +* Issues about a server can be filed at link:https://pagure.io/fedora-server/issues[the ticketing repository on Pagure]. * You can chat with us at link:https://webchat.freenode.net/?channels=#fedora-server[#fedora-server on irc.freenode.net].