Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

M #-: 6.10 Prometheus and Restic in CE #2998

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion source/intro_release_notes/release_notes/whats_new.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ What’s New in |version|

.. Attention: Substitutions doesn't work for emphasized text

**OpenNebula 6.10 “Bubble”** is the sixth stable release of the OpenNebula 6 series. This new release features the first complete implementation of the Sunstone UI functionality on the FireEdge server, as well as improvements in backups, support for new versions of operating systems for the Front-end node, and streamlining by removing obsolete or little-used components, or providing them as legacy components.
**OpenNebula 6.10 “Bubble”** is the sixth stable release of the OpenNebula 6 series. This new release features the first complete implementation of the Sunstone UI functionality on the FireEdge server, as well as improvements in backups, support for new versions of operating systems for the Front-end node, new features included in the Community Edition, and streamlining by removing obsolete or little-used components, or providing them as legacy components.

The first major highlight in this release is the new Sunstone UI. The full power of OpenNebula’s web UI is now provided by the FireEdge server, which delivers the complete set of features previously offered by legacy Ruby-based Sunstone. The new Sunstone UI brings a clean, fast, highly-customizable and easy-to-use UI.

Expand Down Expand Up @@ -52,6 +52,11 @@ The components in the table below are now included in the distribution as legacy

For the full documentation please refer to the :ref:`Legacy Components <legacy_components>` section.

Beginning on version 6.10, users of the :ref:`Community Edition <what_is_community>` can access two features previously only available in the Enterprise Edition:

* **Backups** using `Restic <https://restic.net/>`__, an open-source backup program designed for speed and security. The Community Edition now includes the possibility of using Restic as a backend for backup operations.
* **System monitoring** using `Prometheus <https://prometheus.io/>`__, a set of open-source monitoring and alerting tools. The Community edition now includes the possibility of using Prometheus as a backend for monitoring infrastructure.

OpenNebula 6.10 is named after the `Bubble Nebula <https://www.constellation-guide.com/bubble-nebula-ngc-7635/>`__ (NGC 7635) in the constellation Cassiopeia. It is a young, glowing emission nebula energized by a hot, massive central star. Partly located in a group of stars between 7000 and 8000 light-years away from Earth, the Bubble Nebula is in expansion, with a central “bubble” measuring between six and ten light-years and an estimated temperature of more than 37,000 degrees Celsius (67,000 Fahrenheit). It was discovered by the celebrated astronomer William Herschel in 1787.

.. important:: This is the first beta version for 6.10, intended for testers and developers to try the new features. All new functionality is present in this release, and only bug fixes will be implemented between this release and the final 6.10 version. Please check the `known issues <https://github.com/OpenNebula/one/issues?q=is%3Aopen+is%3Aissue+label%3A%22Type%3A+Bug%22+label%3A%22Status%3A+Accepted%22>`__ before submitting an issue through GitHub. Also note that being a development version, there is no migration path from the previous stable version (6.8.x) nor migration path to the final stable version (6.10.0). A list of open issues may be found at the `GitHub development portal <https://github.com/OpenNebula/one/milestone/76>`__.
Expand Down
2 changes: 1 addition & 1 deletion source/management_and_operations/backups/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Virtual Machine Backups
:maxdepth: 2

Overview <overview>
Backup Datastore: Restic (EE) <restic>
Backup Datastore: Restic <restic>
Backup Datastore: Rsync <rsync>
VM Backup Operations <operations>
Backup Jobs <backup_jobs>
2 changes: 1 addition & 1 deletion source/management_and_operations/backups/overview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Overview

This chapter contains documentation on how to create and manage Virtual Machines Backups. Backups are managed through the datastore and image abstractions. In this way, all the concepts that apply to these objects also apply to backups like access control or quotas. Backup datastores can be defined using two backends (datastore drivers):

- restic (**Only EE**) based on the `restic backup tool <https://restic.net/>`_
- restic, based on the `restic backup tool <https://restic.net/>`_
- rsync, that uses the `rsync utility <https://rsync.samba.org/>`_ to transfer backup files.


Expand Down
6 changes: 3 additions & 3 deletions source/management_and_operations/backups/restic.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
.. _vm_backups_restic:

================================================================================
Backup Datastore: Restic (EE)
Backup Datastore: Restic
================================================================================

`Restic is an open source (BSD 2-Clause License) backup tool <https://restic.net/>`_ designed to be fast, secure and efficient. The current implementation of the driver uses the SFTP storage type. Restic offers interesting features to store backups, like deduplication (only transferring image blobs not already present in the repository) or compression (enabled by default).
`Restic <https://restic.net/>`__ is an open source (BSD 2-Clause License) backup tool designed for speed, security and efficiency. The current implementation of the driver uses the SFTP storage type. Restic offers interesting features to store backups, like deduplication (only transferring image blobs not already present in the repository) or compression (enabled by default).

If you are using the enterprise edition (EE) of OpenNebula, the right version of restic has been already downloaded and installed in your system as a dependency. In this guide we will use the following terminology (introduce by restic):
In both the Enterprise and Community editions of OpenNebula, the correct version of restic is included as a dependency. In this guide we will use the following terminology (introduced by restic):

- *Repository*: This is the storage volume where the disk images backups will be stored. Restic creates an specific interval structure to store the backups efficiently. The restic driver access to the repository through the sftp. protocol. OpenNebula will create a separate restic repository for each VM or backup job.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ Subsequently, a quota can be enforced for a user, e.g. ``GOLD_QOS = 5``, signify

Each generic quota is also automatically prefixed with ``RUNNING_``. For instance, ``RUNNING_GOLD_QOS`` would specify the number of VMs in an ``ACTIVE`` state with the GOLD_QOS attribute. This allows the establishment of quotas specifically tailored for running VMs.

Additionally, it's important to note that each generic quota defined via ``QUOTA_VM_ATTRIBUTE`` is automatically included in the ``VM_RESTICTED_ATTR`` set. This inclusion prevents regular users from circumventing the quota system by altering the attributes related to these generic quotas.
Additionally, it's important to note that each generic quota defined via ``QUOTA_VM_ATTRIBUTE`` is automatically included in the ``VM_RESTRICTED_ATTR`` set. This inclusion prevents regular users from circumventing the quota system by altering the attributes related to these generic quotas.

Network Quotas
--------------------------------------------------------------------------------
Expand Down
2 changes: 1 addition & 1 deletion source/management_and_operations/monitor_alert/index.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
============================
Monitoring and Alerting (EE)
Monitoring and Alerting
============================

.. toctree::
Expand Down
2 changes: 1 addition & 1 deletion source/management_and_operations/monitor_alert/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Installation and Configuration
================================================================================

This page describes how to install the OpenNebula Prometheus integration packages available in the :ref:`Enterprise Edition software repositories <repositories>`.
This page describes how to install the OpenNebula Prometheus integration packages available in the :ref:`OpenNebula software repositories <repositories>`.

Step 1. OpenNebula Repositories [Front-end, Hosts]
================================================================================
Expand Down
4 changes: 1 addition & 3 deletions source/management_and_operations/monitor_alert/overview.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. _monitor_alert_overview:

================================================================================
Monitoring and Alerting (EE)
Monitoring and Alerting
================================================================================

This chapter contains documentation on how to configure OpenNebula to work with `Prometheus monitoring and alerting toolkit <http://prometheus.io>`_. The integration consists of four components:
Expand All @@ -11,8 +11,6 @@ This chapter contains documentation on how to configure OpenNebula to work with
- Alert rules sample files based on the provided metrics
- `Grafana <https://grafana.com/>`_ dashboards to visualize VM, Host and OpenNebula information in a convenient way.

.. important:: This feature is only available for OpenNebula Enterprise Edition.

How Should I Read This Chapter
================================================================================

Expand Down
Loading