#14 Provided some initial content for discussion
Merged 3 years ago by pboy. Opened 3 years ago by pboy.
pboy/fedora-server main  into  main

empty or binary file added
file modified
+7 -4
@@ -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]

  

@@ -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.

@@ -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

@@ -1,1 +0,0 @@ 

- == Mission 

\ No newline at end of file

@@ -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

docs/modules/ROOT/pages/serverCommunicating.adoc docs/modules/ROOT/pages/communicating.adoc
file renamed
file was moved with no change to the file
@@ -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

@@ -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)

+ 

+ 

+ 

docs/modules/ROOT/pages/serverFaq.adoc docs/modules/ROOT/pages/faq.adoc
file renamed
+3 -1
@@ -1,7 +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. Writing documentation in asciidoc is very simple and straightforward. And in fact, writing documentation makes you very happy. Just try and see for yourself!

+     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!

@@ -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

@@ -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