From cb01d17a20e2a6486d473df88efa099fd26fe70c Mon Sep 17 00:00:00 2001 From: Michael Calmer Date: Wed, 14 May 2025 17:25:20 +0200 Subject: [PATCH 1/3] Added initial version of the support data upload feature --- CHANGELOG.md | 1 + .../nav-administration-guide.adoc | 1 + modules/administration/pages/support.adoc | 36 +++++++++++++++++++ 3 files changed, 38 insertions(+) create mode 100644 modules/administration/pages/support.adoc diff --git a/CHANGELOG.md b/CHANGELOG.md index b2ff61065f6..9250d0dd6f8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,4 @@ +- Added initial version of the support data upload feature - Added SLE15 SP7 as supported client. - Updated Hub Online Synchronization section with the latest UI changes in Large Deployment Guide diff --git a/modules/administration/nav-administration-guide.adoc b/modules/administration/nav-administration-guide.adoc index 2fd414f05a8..639c5329962 100644 --- a/modules/administration/nav-administration-guide.adoc +++ b/modules/administration/nav-administration-guide.adoc @@ -67,6 +67,7 @@ endif::[] ** xref:task-schedules.adoc[Task Schedules] ** xref:tuning-changelogs.adoc[Tuning Changelogs] ** xref:users.adoc[Users] +** xref:support.adoc[Support] ** xref:troubleshooting/tshoot-intro.adoc[Troubleshooting] *** xref:troubleshooting/tshoot-autoinstallation.adoc[Autoinstallation] *** xref:troubleshooting/tshoot-bootstrap-repo-for-eol-products.adoc[Bootstrap Repository for End-of-Life Product] diff --git a/modules/administration/pages/support.adoc b/modules/administration/pages/support.adoc new file mode 100644 index 00000000000..f96638da335 --- /dev/null +++ b/modules/administration/pages/support.adoc @@ -0,0 +1,36 @@ +[[support]] += Collect and Upload Support Data from {productname} to SUSE + +When you manage systems in {productname} where you are entitled for support from SUSE, you can +get the support data like `supportconfig` or `sosreport` from the managed client and upload +it directly to SUSE using the Support Case Number. + +[NOTE] +==== +You first need to open a support case in SCC to get the case number. +==== + +.Procedure: Collecting the Support Data and upload them to SUSE via the {productname} {webui} + + +. In the {productname} {webui}, navigate to menu:Systems[System List > All] and select the client which support data should be added to the case. +. Then go to the [guimenu]``Details`` tab and select the [guimenu]``Support`` sub-tab +. In the field [literal]``Support Case Number`` enter the number from the SCC page. +. In the field [literal]``Upload Region`` select option [literal]``EU`` or [literal]``US`` depending on which server you want to upload your data. +. In the field [literal]``Command-line Arguments`` is optional. You can enter options for tool which is used to collect the data from the target system. + Which tool will be used can be found in the tip below this field. +. In the field [literal]``Earliest`` select the time of running this action. +. Click button btn:[Schedule]. + The action is scheduled and will be executed defined time. It will collect the data from the client and upload it directly to the upload server. + + +[NOTE] +==== +Supported Products where support data can be collected are: {productname} Proxy, all SLES and openSUSE, SUSE Liberty and compatible OSes as well as Ubuntu and Debian. +{productname} Server when it is registered as Peripheral Server in a Hub Scenario. +=== + +[NOTE] +==== +To upload the support data from the main {productname} Server please still use `mgradm support config` command from the host. +==== From 276c0de58668b4b37a163b989b2a9ffbfa8b53fc Mon Sep 17 00:00:00 2001 From: Michael Calmer Date: Wed, 14 May 2025 17:40:01 +0200 Subject: [PATCH 2/3] add description how to get a service request number --- modules/administration/pages/support.adoc | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/modules/administration/pages/support.adoc b/modules/administration/pages/support.adoc index f96638da335..09d59d1306c 100644 --- a/modules/administration/pages/support.adoc +++ b/modules/administration/pages/support.adoc @@ -1,21 +1,33 @@ [[support]] -= Collect and Upload Support Data from {productname} to SUSE += Support When you manage systems in {productname} where you are entitled for support from SUSE, you can get the support data like `supportconfig` or `sosreport` from the managed client and upload -it directly to SUSE using the Support Case Number. +it directly to SUSE Global Technical Support. + +== Creating a service request number + +Before handing over the support data to Global Technical Support, you need to generate a service request number first. + +To create a service request, go to https://scc.suse.com/support/requests and follow the instructions on the screen. +Write down the service request number. [NOTE] ==== -You first need to open a support case in SCC to get the case number. +Privacy statement + +SUSE treats system reports as confidential data. For details about our privacy commitment, see https://www.suse.com/company/policies/privacy/. ==== + +== Collect and Upload Support Data from {productname} to SUSE + .Procedure: Collecting the Support Data and upload them to SUSE via the {productname} {webui} . In the {productname} {webui}, navigate to menu:Systems[System List > All] and select the client which support data should be added to the case. . Then go to the [guimenu]``Details`` tab and select the [guimenu]``Support`` sub-tab -. In the field [literal]``Support Case Number`` enter the number from the SCC page. +. In the field [literal]``Support Case Number`` enter the service request number created above. . In the field [literal]``Upload Region`` select option [literal]``EU`` or [literal]``US`` depending on which server you want to upload your data. . In the field [literal]``Command-line Arguments`` is optional. You can enter options for tool which is used to collect the data from the target system. Which tool will be used can be found in the tip below this field. @@ -28,7 +40,8 @@ You first need to open a support case in SCC to get the case number. ==== Supported Products where support data can be collected are: {productname} Proxy, all SLES and openSUSE, SUSE Liberty and compatible OSes as well as Ubuntu and Debian. {productname} Server when it is registered as Peripheral Server in a Hub Scenario. -=== +==== + [NOTE] ==== From c1670c0b09ec6e446b2902585f81bf605ea6cf88 Mon Sep 17 00:00:00 2001 From: Karl Eichwalder Date: Thu, 15 May 2025 15:01:53 +0200 Subject: [PATCH 3/3] Apply suggestions from code review --- CHANGELOG.md | 2 +- modules/administration/pages/support.adoc | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9250d0dd6f8..b75363326b2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,4 @@ -- Added initial version of the support data upload feature +- Added support data upload feature to Administration Guide - Added SLE15 SP7 as supported client. - Updated Hub Online Synchronization section with the latest UI changes in Large Deployment Guide diff --git a/modules/administration/pages/support.adoc b/modules/administration/pages/support.adoc index 09d59d1306c..2a6b5774505 100644 --- a/modules/administration/pages/support.adoc +++ b/modules/administration/pages/support.adoc @@ -1,9 +1,8 @@ [[support]] = Support -When you manage systems in {productname} where you are entitled for support from SUSE, you can -get the support data like `supportconfig` or `sosreport` from the managed client and upload -it directly to SUSE Global Technical Support. +When you manage systems in {productname} where you are entitled for support from {suse}, you can get the support data like [command]``supportconfig`` or [command]``sosreport``. +You will get the data from the managed client and upload it directly to SUSE Global Technical Support. == Creating a service request number @@ -16,19 +15,20 @@ Write down the service request number. ==== Privacy statement -SUSE treats system reports as confidential data. For details about our privacy commitment, see https://www.suse.com/company/policies/privacy/. +{suse} treats system reports as confidential data. +For details about the {suse} privacy commitment, see https://www.suse.com/company/policies/privacy/. ==== == Collect and Upload Support Data from {productname} to SUSE -.Procedure: Collecting the Support Data and upload them to SUSE via the {productname} {webui} +.Procedure: Collecting the support data and uploading with the {productname} {webui} . In the {productname} {webui}, navigate to menu:Systems[System List > All] and select the client which support data should be added to the case. . Then go to the [guimenu]``Details`` tab and select the [guimenu]``Support`` sub-tab . In the field [literal]``Support Case Number`` enter the service request number created above. -. In the field [literal]``Upload Region`` select option [literal]``EU`` or [literal]``US`` depending on which server you want to upload your data. +. In the field [literal]``Upload Region`` select option [literal]``EU`` or [literal]``US`` depending on the server where you want to upload your data. . In the field [literal]``Command-line Arguments`` is optional. You can enter options for tool which is used to collect the data from the target system. Which tool will be used can be found in the tip below this field. . In the field [literal]``Earliest`` select the time of running this action. @@ -45,5 +45,5 @@ Supported Products where support data can be collected are: {productname} Proxy, [NOTE] ==== -To upload the support data from the main {productname} Server please still use `mgradm support config` command from the host. +To upload the support data from the main {productname} Server please still use [command]``mgradm support config`` from the container host. ====