Troubleshooting empty HDI if subscribed on Windows by vkozyura · Pull Request #2550 · capire/docs

vkozyura · 2026-05-04T08:23:39Z

No description provided.

renejeglinsky · 2026-05-04T08:30:45Z

 ```
 On macOS and Linux, the built-in implementation continues to be used.

+### Why are tenant HDI containers empty after subscription on Windows?


This is only valid for hybrid testing, right?

yes, in production you usually sibscribe in CF cockpit

what difference does this make? If you have built your app on windows, then the resources.tgz is missing (or empty), and then nothing gets deployed to the HDI container, no matter how you subscribe.
So I think this applies also to production.
Or am I wrong here?

What I mean: it doesn't matter how you subscribe, but how the app is built

@stewsk: Agree, then we should change from "troubleshooting empty HDI" - just copied it from the issue :) - to "issues building MTX resources". And for the last one we already have troubleshooting item above - I will modify it.

But the visible impact is on the deployed application

@ecklie: In some cases we obtain an explicite error "tar: Error is not recoverable" by cds build. In some other cases cds build may silently fail, which can be seen only on the deployed application. My question for now: In troubleshooting guide - should it be one or two sections?

For the error message we do have the troubleshooting info already. So this can be found. How would we describe the other case? How would one notice on the deployed application if the build doesn't throw an error?

How would we describe the other case? How would one notice on the deployed application if the build doesn't throw an error?

This is exactly what the newly added section does: "Why are tenant HDI containers empty after building app on Windows?"

My question was if we should merge those two section?

ok, two different errors -> two sections

ecklie

Yes, the problem is caused by the build. It also has impact on the productive app. We need to check if we can improve the build and add a consistency check.

renejeglinsky · 2026-05-04T10:33:15Z

 ```
 On macOS and Linux, the built-in implementation continues to be used.

+### Why are tenant HDI containers empty after building app on Windows?


I might be wrong or simplify it too much, but to me this reads as if there's is already a first analysis done and I found that HDI containers are empty.
What is it that makes me investigate? Like "Can't get/read data from customer tenant"?. So folks who have not done an initial analysis and found the empty containers, what would they look for in our troubleshooting?

Here the ticket describibg the issue: https://github.tools.sap/cap/issues/issues/19999.

in my case the "symptom" was that I got funny runtime errors from the Node.js runtime saying that table xyz is not there (don't remember the precise error message)

Right. It is not after building an app but after subscription.
"Why are tenant HDI containers empty after tenant subscription"
It think the error message is something like "table not found". I will check it.

SqlError: invalid table name: Could not find table/view ...

@renejeglinsky: i changed the title. In your suggestion I didn't like "Most likely you're using Windows" - using Windows is rather an exceptional situation. i merged your changes from the suggestion.

@vkozyura If I understand the issue correctly, Windows is the "most likely" case when someone encounters this error, or? There might be other situations where a similar error occurs, but this is then not OS-specific. Probably. We don't know for sure. And this is what I wanted to express.

renejeglinsky · 2026-05-05T05:47:59Z

+### Why are tenant HDI containers empty after building app on Windows?
+
+On Windows, cds build --production may silently fail to create resources.tgz in the MTX sidecar build output. 
+The build log will incorrectly report the file as written. 
+
+Install the tar library to fix this:
+
+```sh
+npm add -D tar
+```
+On macOS and Linux, the built-in implementation continues to be used.
+


I'd also suggest to move this entry to the MTXS section of this guide. WDYT?

Suggested change

### Why are tenant HDI containers empty after building app on Windows?

On Windows, cds build --production may silently fail to create resources.tgz in the MTX sidecar build output.

The build log will incorrectly report the file as written.

Install the tar library to fix this:

```sh

npm add -D tar

```

On macOS and Linux, the built-in implementation continues to be used.

### Why do I get "SqlError: invalid table name" after subscription?

Most likely you're using Windows to build your project. On Windows there's a known issue, where `cds build --production` may silently fail to create the _resources.tgz_ in the MTX sidecar build output. After deployment and subscription, you can then notice the mentioned SqlError or similar error messages that point to tables/views not being available.

:::warning The build log will incorrectly report the file as written.

:::

To fix this on Windows, install the tar library:

```sh

npm add -D tar

Even with this dependency added, on macOS and Linux the built-in implementation continues to be used.

The error message I got (cds watch on node RT) was
"Could not find table/view ...... in schema ......:

Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>

Troubleshooting empty HDI if subscribed on Windows

6aa4ddc

vkozyura requested a review from renejeglinsky as a code owner May 4, 2026 08:23

vkozyura requested a review from stewsk May 4, 2026 08:24

renejeglinsky requested review from ecklie and swaldmann May 4, 2026 08:29

renejeglinsky reviewed May 4, 2026

View reviewed changes

ecklie approved these changes May 4, 2026

View reviewed changes

title changed

3f3192a

renejeglinsky reviewed May 4, 2026

View reviewed changes

renejeglinsky reviewed May 5, 2026

View reviewed changes

vkozyura added 3 commits May 5, 2026 17:50

Update get-help.md

e2cbc7a

Update get-help.md

107f684

Update get-help.md

f830f15

renejeglinsky reviewed May 6, 2026

View reviewed changes

Comment thread get-started/get-help.md Outdated

renejeglinsky reviewed May 6, 2026

View reviewed changes

Comment thread get-started/get-help.md Outdated

vkozyura and others added 3 commits May 6, 2026 09:30

Update get-started/get-help.md

52e2ea9

Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>

Update get-started/get-help.md

5b40d1d

Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>

Merge branch 'main' into troubleshooting-empty-hdi

3304ebc

Conversation

vkozyura commented May 4, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vkozyura May 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ecklie left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vkozyura May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

renejeglinsky May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

vkozyura May 4, 2026 •

edited

Loading

vkozyura May 5, 2026 •

edited

Loading

renejeglinsky May 5, 2026 •

edited

Loading