Update landing pages, storage section (#227)

* Add new landing page for combined data and storage
* Update other landing pages
* Format toctrees consistently
* Fix broken link
This commit is contained in:
Sally
2025-04-17 10:32:30 +02:00
committed by GitHub
parent fc5b24d29d
commit c137387e74
8 changed files with 158 additions and 102 deletions

View File

@ -33,5 +33,5 @@ Bacula's advanced features and support for additional customization make it a go
You can fully tailor the backup process to your specific requirements with shell scripts. The advantage of shell scripts over using backup utilities is they offer full flexibility and customization.
Refer to this guide for instructions on {ref}`how to use shell scripts for backups <back-up-using-shell-scripts>` -- or you can take a look at these examples:
* `Basic backup shell script <https://discourse.ubuntu.com/t/basic-backup-shell-script/36419>`_
* [Basic backup shell script](https://discourse.ubuntu.com/t/basic-backup-shell-script/36419)
* {ref}`An example of archive rotation with shell scripts <archive-rotation-shell-script>`

View File

@ -3,17 +3,51 @@
Backups and version control
****************************
* :ref:`Install Bacula <install-bacula>`
* :ref:`Install rsnapshot <install-rsnapshot>`
* :ref:`Backup with shell scripts <back-up-using-shell-scripts>`
* :ref:`etckeeper <install-etckeeper>`
* :ref:`Install gitolite <install-gitolite>`
On Ubuntu, two primary ways of backing up your system are **backup utilities**
and **shell scripts**. For additional protection, you can combine backup
methods.
Backup utilities
================
* :ref:`Bacula <install-bacula>` has advanced features and customization support,
which makes it a good choice for enterprise systems or complex setups.
* :ref:`rsnapshot <install-rsnapshot>` is a simple and efficient solution, well
suited to individual users or small-scale organizations.
.. toctree::
:hidden:
:hidden:
Install Bacula <backups/install-bacula>
Install rsnapshot <backups/install-rsnapshot>
Backup with shell scripts <backups/back-up-using-shell-scripts>
etckeeper <backups/install-etckeeper>
Install gitolite <backups/install-gitolite>
Install Bacula <backups/install-bacula>
Install rsnapshot <backups/install-rsnapshot>
Shell scripts
=============
If you are looking for full flexibility and customization, another option is
to use shell scripts.
.. toctree::
:titlesonly:
Backup with shell scripts <backups/back-up-using-shell-scripts>
Version control
===============
* :ref:`install-etckeeper` stores the contents of ``/etc`` in a Version Control
System (VCS) repository
* :ref:`Install gitolite <install-gitolite>` for a traditional source control
management server for git, including multiple users and access rights
management
.. toctree::
:hidden:
etckeeper <backups/install-etckeeper>
Install gitolite <backups/install-gitolite>
See also
========
* Explanation: :ref:`introduction-to-backups`

View File

@ -0,0 +1,34 @@
.. _how-to-data-and-storage:
Data and storage
****************
Data management
===============
* :ref:`how-to-openldap` is a popular implementation of the Lightweight
Directory Access Protocol (LDAP), used for managing hierarchical data
* :ref:`how-to-databases` provides details on two of the most common databases
found in Ubuntu: MySQL and PostgreSQL
.. toctree::
:hidden:
openldap
databases
Storage and backups
===================
* :ref:`how-to-storage` shows how to set up and manage Logical Volumes
* :ref:`how-to-backups-and-version-control` presents common options for backing
up your data and your system
.. toctree::
:hidden:
storage
backups

View File

@ -3,11 +3,19 @@
Databases
**********
* :ref:`MySQL <install-mysql>`
* :ref:`PostgreSQL <install-postgresql>`
Ubuntu provides two popular database servers: MySQL and PostgreSQL. Both are
popular choices with similar feature sets, and both are equally supported in
Ubuntu.
These guides show you how to install and configure them.
.. toctree::
:hidden:
:titlesonly:
MySQL <databases/install-mysql>
PostgreSQL <databases/install-postgresql>
MySQL <databases/install-mysql>
PostgreSQL <databases/install-postgresql>
See also
========
* Explanation: :ref:`introduction-to-databases`

View File

@ -69,33 +69,18 @@ Managing software
Data and storage
================
OpenLDAP
--------
.. toctree::
:hidden:
:titlesonly:
.. include:: openldap.rst
:start-line: 4
:end-before: .. toctree::
data-and-storage.rst
Databases
---------
:ref:`The data and storage section <how-to-data-and-storage>` covers the
following:
.. include:: databases.rst
:start-line: 4
:end-before: .. toctree::
Storage
-------
.. include:: storage.rst
:start-line: 4
:end-before: .. toctree::
Backups and version control
---------------------------
.. include:: backups.rst
:start-line: 4
:end-before: .. toctree::
* **Managing data** in the OpenLDAP and databases topics
* **Storage and backups**, including partitioning (with LVM), backup utilities,
and version control
Mail services
=============
@ -157,12 +142,8 @@ Observability
:titlesonly:
software.rst
openldap.rst
databases.rst
mail-services.rst
backups.rst
web-services.rst
storage.rst
graphics.rst
observability.rst
virtualisation.rst

View File

@ -3,19 +3,25 @@
OpenLDAP
*********
* :ref:`Install and configure LDAP <install-openldap>`
* :ref:`Set up access control <ldap-access-control>`
* :ref:`Set up OpenLDAP with replication <ldap-replication>`
* :ref:`Simple LDAP user and group management <ldap-users-and-groups>`
* :ref:`OpenLDAP and Transport Layer Security (TLS) <ldap-and-tls>`
* :ref:`Backup and restore OpenLDAP <ldap-backup-and-restore>`
The Lightweight Directory Access Protocol, or LDAP, is a protocol for
managing hierarchical data and accessing directories. The open source
implementation used in Ubuntu is OpenLDAP.
These guides are intended to be sequential, so following them in the order
presented below is suggested.
.. toctree::
:hidden:
:titlesonly:
Install LDAP <openldap/install-openldap>
Set up access control <openldap/access-control>
Replication <openldap/replication>
LDAP users and groups <openldap/users-and-groups>
LDAP and TLS <openldap/ldap-and-tls>
Backup and restore <openldap/backup-and-restore>
Install OpenLDAP <openldap/install-openldap>
Set up access control <openldap/access-control>
OpenLDAP with replication <openldap/replication>
User and group management <openldap/users-and-groups>
OpenLDAP and TLS <openldap/ldap-and-tls>
Backup and restore <openldap/backup-and-restore>
See also
========
* How-to: :ref:`sssd-with-ldap`
* Explanation: :ref:`introduction-to-openldap`

View File

@ -20,6 +20,14 @@ General configuration
* :ref:`Console security <console-security>` for an additional physical
security barrier
.. toctree::
:hidden:
User management <security/user-management>
Firewalls <security/firewalls>
AppArmor <security/apparmor>
Console security <security/console-security>
Authentication
==============
@ -32,6 +40,13 @@ These tools are particularly useful for more advanced or complex setups.
* :ref:`Smart card authentication <smart-card-authentication>` provides a
physical authentication method
.. toctree::
:hidden:
kerberos.rst
sssd.rst
Smart cards <security/smart-card-authentication>
Cryptography
============
@ -40,8 +55,11 @@ an unsecured network. In Ubuntu, OpenSSH is the most commonly used
implementation of SSH. It provides a suite of utilities for encrypting data
transfers and can also be used for remote login and authentication.
* :ref:`OpenSSH <openssh-server>`
* :ref:`CA trust store <install-a-root-ca-certificate-in-the-trust-store>`
.. toctree::
:titlesonly:
OpenSSH <security/openssh-server>
Install a root CA certificate <security/install-a-root-ca-certificate-in-the-trust-store>
Virtual Private Network (VPN)
=============================
@ -54,41 +72,15 @@ of the most popular choices in Ubuntu are OpenVPN and WireGuard VPN.
* :ref:`how-to-wireguard-vpn` is a modern and performant option that removes a
lot of the complexity from configuring a VPN
.. toctree::
:hidden:
OpenVPN <security/install-openvpn>
wireguard-vpn
See also
========
* Explanation: :ref:`Introduction to security <introduction-to-security>`
* Explanation: :ref:`Security topics <explanation-security>`
.. toctree::
:hidden:
:caption: General security
User management <security/user-management>
Firewalls <security/firewalls>
AppArmor <security/apparmor>
Console security <security/console-security>
.. toctree::
:hidden:
:caption: Authentication and access
kerberos.rst
sssd.rst
Smart cards <security/smart-card-authentication>
.. toctree::
:hidden:
:caption: Cryptography
OpenSSH <security/openssh-server>
Install a root CA certificate in the trust store <security/install-a-root-ca-certificate-in-the-trust-store>
.. toctree::
:hidden:
:caption: Virtual Private Network (VPN}
OpenVPN <security/install-openvpn>
wireguard-vpn

View File

@ -3,16 +3,17 @@
Storage
********
* :ref:`Manage logical volumes <manage-logical-volumes>`
Related links
=============
Explanation:
* :ref:`About logical volume management <about-lvm>`
The Ubuntu Server installer can set up and install to Logical Volume Management
(LVM) partitions.
.. toctree::
:hidden:
:titlesonly:
Manage logical volumes <storage/manage-logical-volumes>
See also
========
* Explanation: :ref:`about-lvm`
Manage logical volumes <storage/manage-logical-volumes>