From 664d3469e14e6d084750a532121822e94df4c537 Mon Sep 17 00:00:00 2001 From: Stefano David Date: Mon, 25 Aug 2025 17:08:11 +0200 Subject: [PATCH 1/2] [ZTD-1284] add label for crossref --- source/carbonio/upgrade/toc.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/carbonio/upgrade/toc.rst b/source/carbonio/upgrade/toc.rst index 93d5e3e1..ba660f58 100644 --- a/source/carbonio/upgrade/toc.rst +++ b/source/carbonio/upgrade/toc.rst @@ -1,3 +1,5 @@ +.. _upgrade-procedure: + ================================ Upgrade to |product| |release| ================================ From 4b59c9c8b9c057f971aade30e232842ceb52e77e Mon Sep 17 00:00:00 2001 From: Stefano David Date: Mon, 25 Aug 2025 17:09:09 +0200 Subject: [PATCH 2/2] [ZTD-1284] let users upgrade before opening a ticket --- source/carbonio/report/toc.rst | 80 ++++++++++++++++++++++++++++++++-- 1 file changed, 77 insertions(+), 3 deletions(-) diff --git a/source/carbonio/report/toc.rst b/source/carbonio/report/toc.rst index 2a63d63e..1159ce45 100644 --- a/source/carbonio/report/toc.rst +++ b/source/carbonio/report/toc.rst @@ -31,9 +31,83 @@ activities: Before You Open a Ticket ------------------------ -Before you open a Support Ticket, you should gather some information -and configuration values from |product| and its Components, to collect -the information that will be relevant for the Technical Support Team. +Before you open a Support Ticket, ensure that your |product| +infrastructure is fully updated, that is, it features the latest +version released and has the latest packages installed. If your +|product| infrastructure is equipped with a version of |product| older +than |version|, please follow the :ref:`appropriate upgrade procedure +`. If you already run the latest version, make sure +all the latest packages are installed by carrying out these two-step +procedure on each Node of your |product| infrastructure. + +.. rubric:: Step 1. Update package list. + +.. tab-set:: + + .. tab-item:: Ubuntu 22.04 + :sync: ubu22 + + .. code:: console + + # apt update + + .. tab-item:: RHEL 8 + :sync: rhel8 + + .. code:: console + + # dnf check-update + + .. tab-item:: Ubuntu 24.04 + :sync: ubu24 + + .. code:: console + + # apt update + + .. tab-item:: RHEL 9 + :sync: rhel9 + + .. code:: console + + # dnf check-update + +.. rubric:: Step 2. Install new packages, if any. + +.. tab-set:: + + .. tab-item:: Ubuntu 22.04 + :sync: ubu22 + + .. code:: console + + # apt upgrade + + .. tab-item:: RHEL 8 + :sync: rhel8 + + .. code:: console + + # dnf upgrade --best --allowerasing + + .. tab-item:: Ubuntu 24.04 + :sync: ubu24 + + .. code:: console + + # apt upgrade + + .. tab-item:: RHEL 9 + :sync: rhel9 + + .. code:: console + + # dnf upgrade --best --allowerasing + +After you updated your |product| infrastructure, you should gather +some information and configuration values from |product| and its +Components, to collect the information that will be relevant for the +Technical Support Team. This section focuses on how to retrieve this information: You need to provide existing log files and the output of some commands and scripts