From 5695aa589932bcfc60d38c9bb36f4976eaeb8227 Mon Sep 17 00:00:00 2001 From: Christian Georgi Date: Thu, 8 May 2025 17:29:07 +0200 Subject: [PATCH 1/4] Details on CSV data recovery using HDI Instructions for MT apps were presented so prominently that customers got confused. So separate the single/multi tenant cases and give instructions for each one. --- get-started/troubleshooting.md | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 198ee3bee2..3568cfa719 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -397,11 +397,24 @@ On trial, your SAP HANA Cloud instance will be automatically stopped overnight, | _Root Cause_ | SAP HANA still claims exclusive ownership of the data that was once deployed through `hdbtabledata` artifacts, even though the CSV files are now deleted in your project. | _Solution_ | Add an _undeploy.json_ file to the root of your database module (the _db_ folder by default). This file defines the files **and data** to be deleted. See section [HDI Delta Deployment and Undeploy Allow List](https://help.sap.com/docs/HANA_CLOUD_DATABASE/c2b99f19e9264c4d9ae9221b22f6f589/ebb0a1d1d41e4ab0a06ea951717e7d3d.html) for more details. -::: tip -If you want to keep the data from _.csv_ files and data you've already added, see [SAP Note 2922271](https://me.sap.com/notes/2922271) for more details. -::: -You can apply this solution also when using the `cds-mtxs` library. You can either set the options via the environment variable [`HDI_DEPLOY_OPTIONS`](https://help.sap.com/docs/SAP_HANA_PLATFORM/4505d0bdaf4948449b7f7379d24d0f0d/a4bbc2dd8a20442387dc7b706e8d3070.html), the CDS configuration or you can add them to the model update request as `hdi` parameter: +#### How do I keep existing data? +If you want to keep the data from _.csv_ files and data you've already added, apply [SAP Note 2922271](https://me.sap.com/notes/2922271). +Depending on whether you have a single-tenant or multi-tenant application, see the following details for how to set the `path_parameter` and `undeploy` parameters: + +
Single-tenant applications + +Use the _db/undeploy.json_ file as given in the SAP note. +The _package.json_ file that is mentioned in the SAP note is located in the _db/_ folder. +- If you don't find a _db/package.json_ file, use _gen/db/package.json_ (created by `cds build`) as a template and copy it to _db/package.json_. +- After the modification, run `cds build --production` and verify your changes have been copied to _gen/db/package.json_. +- Don't modify _gen/db/package.json_ as it is overwritten on every build. + +
+ +
Multi-tenant applications + +Instead of configuring the static deployer application in _db/package.json_, use environment variable [`HDI_DEPLOY_OPTIONS`](https://help.sap.com/docs/SAP_HANA_PLATFORM/4505d0bdaf4948449b7f7379d24d0f0d/a4bbc2dd8a20442387dc7b706e8d3070.html), the `cds` configuration in _package.json_, or add the options to the model update request as `hdi` parameter: CDS configuration for [Deployment Service](../guides/multitenancy/mtxs#deployment-config) ```json @@ -439,6 +452,11 @@ Options in [Saas Provisioning Service upgrade API](../guides/multitenancy/mtxs#e } ``` +
+ +After you have successully deployed these changes to all affected HDI (tenant) containers (in all spaces, accounts etc.), you can remove the configuration again. + + ### How Do I Resolve Deployment Errors? #### Deployment fails — _Cyclic dependencies found_ or _Cycle between files_ From 3c646798096eef41f254504238d8ae4411c4ae4e Mon Sep 17 00:00:00 2001 From: ecklie <52252271+ecklie@users.noreply.github.com> Date: Thu, 8 May 2025 18:19:02 +0200 Subject: [PATCH 2/4] Update get-started/troubleshooting.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- get-started/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 3568cfa719..2178562a24 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -454,7 +454,7 @@ Options in [Saas Provisioning Service upgrade API](../guides/multitenancy/mtxs#e -After you have successully deployed these changes to all affected HDI (tenant) containers (in all spaces, accounts etc.), you can remove the configuration again. +After you have successfully deployed these changes to all affected HDI (tenant) containers (in all spaces, accounts etc.), you can remove the configuration again. ### How Do I Resolve Deployment Errors? From f64a6e6fe05424101239614b18cc566466042a90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ren=C3=A9=20Jeglinsky?= Date: Fri, 9 May 2025 07:44:02 +0200 Subject: [PATCH 3/4] Apply suggestions from code review --- get-started/troubleshooting.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 2178562a24..70c39691c9 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -402,7 +402,7 @@ On trial, your SAP HANA Cloud instance will be automatically stopped overnight, If you want to keep the data from _.csv_ files and data you've already added, apply [SAP Note 2922271](https://me.sap.com/notes/2922271). Depending on whether you have a single-tenant or multi-tenant application, see the following details for how to set the `path_parameter` and `undeploy` parameters: -
Single-tenant applications +:::details Single-tenant applications {open} Use the _db/undeploy.json_ file as given in the SAP note. The _package.json_ file that is mentioned in the SAP note is located in the _db/_ folder. @@ -410,9 +410,9 @@ The _package.json_ file that is mentioned in the SAP note is located in the _db/ - After the modification, run `cds build --production` and verify your changes have been copied to _gen/db/package.json_. - Don't modify _gen/db/package.json_ as it is overwritten on every build. -
+::: -
Multi-tenant applications +:::details Multi-tenant applications {open} Instead of configuring the static deployer application in _db/package.json_, use environment variable [`HDI_DEPLOY_OPTIONS`](https://help.sap.com/docs/SAP_HANA_PLATFORM/4505d0bdaf4948449b7f7379d24d0f0d/a4bbc2dd8a20442387dc7b706e8d3070.html), the `cds` configuration in _package.json_, or add the options to the model update request as `hdi` parameter: @@ -452,7 +452,7 @@ Options in [Saas Provisioning Service upgrade API](../guides/multitenancy/mtxs#e } ``` -
+::: After you have successfully deployed these changes to all affected HDI (tenant) containers (in all spaces, accounts etc.), you can remove the configuration again. From 625a6f321ae80780041b420344517a634f505560 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ren=C3=A9=20Jeglinsky?= Date: Fri, 9 May 2025 07:45:25 +0200 Subject: [PATCH 4/4] Update get-started/troubleshooting.md --- get-started/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 70c39691c9..9e4c539091 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -412,7 +412,7 @@ The _package.json_ file that is mentioned in the SAP note is located in the _db/ ::: -:::details Multi-tenant applications {open} +:::details Multi-tenant applications Instead of configuring the static deployer application in _db/package.json_, use environment variable [`HDI_DEPLOY_OPTIONS`](https://help.sap.com/docs/SAP_HANA_PLATFORM/4505d0bdaf4948449b7f7379d24d0f0d/a4bbc2dd8a20442387dc7b706e8d3070.html), the `cds` configuration in _package.json_, or add the options to the model update request as `hdi` parameter: