From 46fff18060b0be3a4dfa5ac1d96d6271ef082c23 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Mar 08 2021 12:52:54 +0000 Subject: [PATCH 1/2] Added some basic initial content for discussion --- diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index a6bd5cb..a80bce9 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,6 +1,9 @@ * xref:index.adoc[Welcome] -* xref:mission.adoc[Mission] -* xref:communicating.adoc[Getting in Touch] -* xref:community.adoc[Server Community] -* xref:faq.adoc[FAQ] +* xref:serverAdministration.adoc[Server Administration] +* xref:serverExamplesUseCases.adoc[Example Use Cases] +* xref:serverTutorials.adoc[Tutorials] +* xref:serverTroubleshooting.adoc[Troubleshooting / Known Issues] +* xref:serverCommunity.adoc[Community, Policies, and working methods] +* xref:serverFaq.adoc[FAQ] +* xref:serverCommunicating.adoc[Getting in Touch] diff --git a/docs/modules/ROOT/pages/communicating.adoc b/docs/modules/ROOT/pages/communicating.adoc deleted file mode 100644 index 6dc222c..0000000 --- a/docs/modules/ROOT/pages/communicating.adoc +++ /dev/null @@ -1,14 +0,0 @@ -= Communicating and Getting Help - -For general troubleshooting help related to Fedora, please refer to link:https://ask.fedoraproject.org[Ask Fedora Forum]. - -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 server can be filed at link:https://pagure.io/fedora-server/issues[ticketing repository on Pagure]. - -* You can chat with us at link:https://webchat.freenode.net/?channels=#fedora-server[#fedora-server on irc.freenode.net]. - -* You can discuss server issues at link:https://discussion.fedoraproject.org/c/server[Server Discussion Forum]. - -* You can e-mail us on the Server mailing list at link:https://lists.fedoraproject.org/admin/lists/server@lists.fedoraproject.org/[server@lists.fedoraproject.org]. \ No newline at end of file diff --git a/docs/modules/ROOT/pages/community.adoc b/docs/modules/ROOT/pages/community.adoc deleted file mode 100644 index 632c4e5..0000000 --- a/docs/modules/ROOT/pages/community.adoc +++ /dev/null @@ -1,3 +0,0 @@ -= Server Community - -Our community is basically the same as the community of Fedora Docs. That's mostly because this is a template for new pieces of the Fedora Docs. diff --git a/docs/modules/ROOT/pages/faq.adoc b/docs/modules/ROOT/pages/faq.adoc deleted file mode 100644 index 32a9d51..0000000 --- a/docs/modules/ROOT/pages/faq.adoc +++ /dev/null @@ -1,7 +0,0 @@ -= Frequently Asked Questions (FAQ) - -[qanda] -Can I see a built preview of this template to get a better idea about the result?:: - Of course you can! Just look at the README of the repository — it should tell you everything. -Is writing documentation hard and dreadful?:: - Absolutely not. Writing documentation in asciidoc is very simple and straightforward. And in fact, writing documentation makes you very happy. Just try and see for yourself! diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index b96d7a3..bc15012 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -2,8 +2,51 @@ Peter Boy; Jan Kuparinen :page-authors: {author}, {author_2} -== Welcome +image::Logo_server.png[Server] -Just a shot of a penguin. + -image::penguin.jpg[Penguin] \ No newline at end of file +== Our Mission + +### As a user, you gain the opportunity to use the server of the future right now. + +Fedora Server provides a stable, flexible and universally adaptable basis for the everyday provision of digital services and information of all kinds by organizations and individuals, based on the latest technology and makes them available as early as possible. + +### As a developer or system integrator, you gain an eye on the server of the future. + +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 and For Whom Is Is + +Just a shot + +== What's Cooking + +Currently, we work on several projects + +- We are preparing Fedora Server 34 +- We are working on improving Server's documentation (you currently get a first blimpse) +- We are exploring opportunities of aligning cloud images and server installation more closely with each other and further harmonising technical details. +- Technically we are revisiting defaults ... filesystem / partitioning + +Stay tuned. The results will soon be visible. + +== 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 +- People, policies, and working methods + +== How You Can Contriburte + +- 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 + +- System Administration Guide +- Wiki pages +- General ogoing work / change requests? \ No newline at end of file diff --git a/docs/modules/ROOT/pages/mission.adoc b/docs/modules/ROOT/pages/mission.adoc deleted file mode 100644 index 49bbc48..0000000 --- a/docs/modules/ROOT/pages/mission.adoc +++ /dev/null @@ -1 +0,0 @@ -== Mission \ No newline at end of file From 09c52302b4e3fbdb554a0dd31f9dc3970b2304b1 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Mar 08 2021 12:55:22 +0000 Subject: [PATCH 2/2] Added further basic initial content for discussion --- diff --git a/docs/modules/ROOT/assets/images/Logo_server.png b/docs/modules/ROOT/assets/images/Logo_server.png new file mode 100644 index 0000000..27db819 Binary files /dev/null and b/docs/modules/ROOT/assets/images/Logo_server.png differ diff --git a/docs/modules/ROOT/pages/serverAdministration.adoc b/docs/modules/ROOT/pages/serverAdministration.adoc new file mode 100644 index 0000000..28d1942 --- /dev/null +++ b/docs/modules/ROOT/pages/serverAdministration.adoc @@ -0,0 +1,49 @@ += Fedora Server Administration Guides +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + +== What You finde 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 System Installation +(to be decided: alternatively: expand Fedora central Installation and System Administration Guides) + +=== Disk Partitioning + +- What default partitioning does +- Raid system +- Hard disk larger as 2 TB in Raid set ups +- UEFI boot + +=== Networking +- Static configuration, appropriate for servers +- Post F32 network config file locations + +== Post Installation security enhancements +- Installing fail2ban (short step-by-step installation guide the Fedora way) +- Disabling ssh password based login all users but a small number of fallbacks (short guide ho 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) ) +- 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 + +== Specific System Administration Tasks + +=== Cockpit +- recommended documentation for specific types of installation / use case +- how to secure access / login page (integration into fail2ban, access via ssh tunnel, access via VPN) + +=== SELinux issues + +=== How to manage storage + +== Introducing Virtualisation + +=== Install Virtualisation Support +=== Install a Virtual Machine using Cockpit +=== Install a Virtual Machine using libvirt version 3 --cloud-init option + + +Further topics of this kind to be added diff --git a/docs/modules/ROOT/pages/serverCommunicating.adoc b/docs/modules/ROOT/pages/serverCommunicating.adoc new file mode 100644 index 0000000..6dc222c --- /dev/null +++ b/docs/modules/ROOT/pages/serverCommunicating.adoc @@ -0,0 +1,14 @@ += Communicating and Getting Help + +For general troubleshooting help related to Fedora, please refer to link:https://ask.fedoraproject.org[Ask Fedora Forum]. + +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 server can be filed at link:https://pagure.io/fedora-server/issues[ticketing repository on Pagure]. + +* You can chat with us at link:https://webchat.freenode.net/?channels=#fedora-server[#fedora-server on irc.freenode.net]. + +* You can discuss server issues at link:https://discussion.fedoraproject.org/c/server[Server Discussion Forum]. + +* You can e-mail us on the Server mailing list at link:https://lists.fedoraproject.org/admin/lists/server@lists.fedoraproject.org/[server@lists.fedoraproject.org]. \ No newline at end of file diff --git a/docs/modules/ROOT/pages/serverCommunity.adoc b/docs/modules/ROOT/pages/serverCommunity.adoc new file mode 100644 index 0000000..ac2a07d --- /dev/null +++ b/docs/modules/ROOT/pages/serverCommunity.adoc @@ -0,0 +1,14 @@ += Server Community, Policies, and Working Methods +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + +(We should make the working group more "tangible" and transparent, not just refer to an (anonymous) mailing list.) + + + 1 SIG / Link to SIG Wiki + 1.1 Members of SIG + 2 WG / Link to WG Wiki + 2.1 Members of WG incl. Tasks / area of commitment + 2.1.1 Governance Charter + 3 Product Requirement Document + 4 Various other suitable contents of the Fedora Server Wiki pages \ No newline at end of file diff --git a/docs/modules/ROOT/pages/serverExamplesUseCases.adoc b/docs/modules/ROOT/pages/serverExamplesUseCases.adoc new file mode 100644 index 0000000..73c917c --- /dev/null +++ b/docs/modules/ROOT/pages/serverExamplesUseCases.adoc @@ -0,0 +1,18 @@ += Fedora Server Example Use Cases +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + + 1 Setup a Fedora Local Home Server, including + 1.1 Security considerations + 1.2 Considerations organizing storage + 1.3 Configuring local network + 1.4 file services Windows. Apple, Fedora Workstation + 1.5 media server + 1.6 (personal web server, perhaps rather a bit off the mark ) + 1.7 Again, propably providing a configurable / adaptable Ansible playbook + 2 Setup a Home Server Mail Service +(items according above) + 3 More to come (hopefully) + + + diff --git a/docs/modules/ROOT/pages/serverFaq.adoc b/docs/modules/ROOT/pages/serverFaq.adoc new file mode 100644 index 0000000..3534741 --- /dev/null +++ b/docs/modules/ROOT/pages/serverFaq.adoc @@ -0,0 +1,9 @@ += Frequently Asked Questions (FAQ) +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + +[qanda] +Can I see a built preview of this template to get a better idea about the result?:: + Of course you can! Just look at the README of the repository — it should tell you everything. +Is writing documentation hard and dreadful?:: + Absolutely not (OK, just joking). Writing documentation in asciidoc is very simple and straightforward. And in fact, writing documentation makes you very happy. Just try and see for yourself! diff --git a/docs/modules/ROOT/pages/serverTroubleshooting.adoc b/docs/modules/ROOT/pages/serverTroubleshooting.adoc new file mode 100644 index 0000000..905017d --- /dev/null +++ b/docs/modules/ROOT/pages/serverTroubleshooting.adoc @@ -0,0 +1,23 @@ += Communicating and Getting Help +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + + +Some examples from latest discussions + 1. The well known BIOSboot partition issue + 2. systemnd-oomd and httpd / jBoss/wildfly + 3. UEFI – one ESP for /boot/efi requirement in software RAID 1 / RAID x + + +For general troubleshooting help related to Fedora, please refer to link:https://ask.fedoraproject.org[Ask Fedora Forum]. + +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 server can be filed at link:https://pagure.io/fedora-server/issues[ticketing repository on Pagure]. + +* You can chat with us at link:https://webchat.freenode.net/?channels=#fedora-server[#fedora-server on irc.freenode.net]. + +* You can discuss server issues at link:https://discussion.fedoraproject.org/c/server[Server Discussion Forum]. + +* You can e-mail us on the Server mailing list at link:https://lists.fedoraproject.org/admin/lists/server@lists.fedoraproject.org/[server@lists.fedoraproject.org]. \ No newline at end of file diff --git a/docs/modules/ROOT/pages/serverTutorials.adoc b/docs/modules/ROOT/pages/serverTutorials.adoc new file mode 100644 index 0000000..3c70ea0 --- /dev/null +++ b/docs/modules/ROOT/pages/serverTutorials.adoc @@ -0,0 +1,15 @@ += Fedora Server Tutorials +Peter Boy; Jan Kuparinen +:page-authors: {author}, {author_2} + + +Some ideas: + +- Setting up a dedicated rented off premise Internet Server (example Hetzner) +- Setting up a private local (on premise) Internet server +- Setting up an Internet server for SMEs +- Setting up a homelab / worklab Server +- Setting up a simple private Mail Server +- Setting up a full features Mail Server +- Backup Guide +- (more to come) \ No newline at end of file