Merge branch 'staging' into MON-24024-debian-12

cloud/alerts-notifications/dashboards.md

@@ -3,8 +3,6 @@ id: dashboards
 title: Dashboards Beta
 ---
 
-> Centreon Dashboards is now available as a beta feature.
-
 Get started with creating dashboards and adding widgets specially designed to optimize your user experience. Then benefit from data visualization options to display and monitor your resources in real time.
 
 ![image](../assets/alerts/dashboard-view.png)
@@ -93,14 +91,61 @@ The users you have just added now have access to your dashboard sharing, accordi
 
 > Use the **Copy link** feature to share the dashboard URL directly with users who have access to your platform.
 
+## Managing playlists
+
+Playlists are lists of selected dashboards to be broadcast in the order of your choice. This feature is useful for instance when you want to display your dashboards on a full-screen TV in public spaces.
+
+### Create a playlist
+
+> Before creating a playlist, make sure the dashboards you want to include have been created.
+
+1. Click the **Playlists** link to access the playlists interface.
+2. Click the **Create a playlist** button (or the **Add** button if it is not your first playlist).
+3. Fill in the properties:
+   - **Name**
+   - **Description** 
+   - Add your dashboards from the **Select dashboards** drop-down list.
+   - In the **Define the order of dashboards** section, drag and drop the dashboards as you want.
+   - Define the rotation time in seconds.
+4. Click **Save**.
+Your playlist is now added to the list of playlist.
+
+### Display the playlist
+
+- From the **Playlists** interface, click the row for your playlist.
+Your playlist is now displayed and a control banner appears when you hover over the bottom of the interface.
+
+> Get a better visualization by displaying the page in full screen mode (F).
+
+The control banner allows you to:
+- Play/Pause the broadcast.
+- Go to the previous or next dashboard.
+- Go directly to a specific dashboard by clicking its name.
+
+### Share the playlist
+
+> You can only share your playlist with contacts who have access to your Centreon platform and are authorized Dashboards viewers.
+
+- Click the **Share with contacts** button from the line of your playlist.
+The **Playlist access rights** modal is displayed.
+- You can now add contacts or contact groups and define their rights as viewer or editor in the **Share with** section.
+- Use the **trash** button in the **User rights** section to remove a contact or contact group.
+- Use the **Copy link** button to share the playlist URL directly with users who have access to your platform.
+
+### Edit/Delete a playlist
+
+The three dots action menu at the end of a playlist row allows you to edit properties or delete the playlist.
+
 ## List of widgets
 
 | Widget                   | Description                                                                                                                                                                                                                                                                                                    |
 |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Generic text           | Allows you to add free text to your dashboards (section titles, information, etc.).   |
+| Group monitoring	|  Displays the distribution of current statuses on selected groups of resources, as a table.   |
 | MAP - Display a view            |  Allows you to select and visualize a map created from the MAP module.  |
 | Metrics graph         | Displays metrics for a given time period.                                                                                |
 | Resource table                 | Displays data on resource status and events, centralized in a table.
 | Single metric          | Displays the value of a single metric as a text, a gauge or a bar chart.   |
+| Status chart     | Displays the distribution of current statuses on selected resources, as a chart.      |
 | Status grid     | Displays the current status of selected resources, as a grid.      |
 | Top/bottom              | Displays the top or bottom x hosts, for a selected metric.   |

cloud/installation/poller-secure.md

@@ -6,6 +6,8 @@ title: Securing your poller
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
+> **IMPORTANT**: It is the customer's resonsibility to secure the OS of the poller's host machine, and to [update its OS](https://thewatch.centreon.com/product-how-to-21/os-updates-security-3136).
+
 ## Strengthen user account security
 
 After installing Centreon, you must change the default passwords of the following users:
@@ -245,27 +247,7 @@ public (active)
 
 ### Centreon Gorgone communication
 
-Make sure that the **/etc/centreon-gorgone/config.d/40-gorgoned.yaml** file (on each poller) contains the following lines:
-
-```shell
-name: action
-package: "gorgone::modules::core::action::hooks"
-enable: true
-command_timeout: 30
-whitelist_cmds: true
-allowed_cmds:
-  - ^sudo\s+(/bin/)?systemctl\s+(reload|restart)\s+(centengine|centreontrapd|cbd)\s*$
-  - ^(sudo\s+)?(/usr/bin/)?service\s+(centengine|centreontrapd|cbd|cbd-sql)\s+(reload|restart)\s*$
-  - ^/usr/sbin/centenginestats\s+-c\s+/etc/centreon-engine/centengine\.cfg\s*$
-  - ^cat\s+/var/lib/centreon-engine/[a-zA-Z0-9\-]+-stats\.json\s*$
-  - ^/usr/lib/centreon/plugins/.*$
-  - ^/bin/perl /usr/share/centreon/bin/anomaly_detection --seasonality >> /var/log/centreon/anomaly_detection\.log 2>&1\s*$
-  - ^/usr/bin/php -q /usr/share/centreon/cron/centreon-helios\.php >> /var/log/centreon-helios\.log 2>&1\s*$
-  - ^centreon
-  - ^mkdir
-  - ^/usr/share/centreon/www/modules/centreon-autodiscovery-server/script/run_save_discovered_host --all --job-id=\d+ --export-conf --token=\S+$
-  - ^/usr/share/centreon/bin/centreon -u "centreon-gorgone" -p \S+ -w -o CentreonWorker -a processQueue$
-```
+On each poller, the **/etc/centreon-gorgone/config.d/whitelist.conf.d/centreon.yaml** file contains the whitelists for Gorgone. If you want to customize the allowed commands, do not edit this file. Create a new one in the same folder, e.g. **/etc/centreon-gorgone/config.d/whitelist.conf.d/custom.yaml**.
 
 ## Security Information and Event Management - SIEM
 

cloud/installation/poller-update-upgrade.md

@@ -0,0 +1,32 @@
+---
+id: poller-update-upgrade
+title: Updating/upgrading a poller
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+> **IMPORTANT**: It is the customer's resonsibility to [update the OS of the poller's host machine](https://thewatch.centreon.com/product-how-to-21/os-updates-security-3136). Also, Centreon provides application updates for pollers, but it is the customer’s responsibility to apply these updates to their pollers.
+
+Your poller should always be in the latest available version (i.e. in the latest minor version of the latest major version).
+
+* If your poller is already in the latest major version but not in its latest minor version, performing this procedure will update it to the latest minor version. Example: if the latest version is 23.10.y and your poller is in version 23.10.x, then it will be updated to 23.10.y.
+* If your poller is in another major version than the latest, this procedure will not update it to the latest minor version of this major version. The poller will be upgraded to the latest minor version of the latest major version available instead (e.g. it will be upgraded from 23.04.x to 23.10.y).
+
+## Updating or upgrading a poller
+
+1. On your central server, click the arrow next to **Pollers** at the left of the header bar.
+
+2. In the pop-up that appears, click **Copy install command**. The command is copied to your clipboard.
+
+3. On your poller, in your terminal, paste the install command and execute it.
+
+4. [Deploy the poller's configuration](../monitoring/monitoring-servers/deploying-a-configuration.md),
+and choose the **Restart** method for the Engine process.
+
+5. Finally, restart the Gorgone service if it is used on the poller:
+
+  ```shell
+  systemctl restart gorgoned
+  ```
+

cloud/installation/prerequisites.md

@@ -3,6 +3,8 @@ id: prerequisites
 title: Prerequisites
 ---
 
+> **IMPORTANT**: The poller is a component that is deployed in the customers' infrastructure. Its administration (material and virtual infrastructure, OS, security, monitoring and Centreon applicative layers, etc) is solely the responsibility of the customers, as per the [Terms and Conditions](https://www.centreon.com/legal/en/centreon-cloud-services-terms-row).
+
 ## OS
 
 The poller must be installed on a dedicated fresh Alma Linux/RHEL/Oracle Linux 8 or 9, or Debian 11 server.