Fix: Update WSO2_MB_STORE_DB H2 usage recommendation [master]

[wso2-engineering-bot]

This PR was automatically generated by Claude AI.

• Issue: WSO2_MB_STORE usage recommendation regarding H2 limitation #10493
• Type: Documentation / Suggestions
• Summary: Updated documentation to warn against using H2 database for WSO2_MB_STORE_DB in production environments due to a known bug that causes frequent database crashes. Changed recommendation from using H2 to using an external database, with a reference to the H2 database issue.

Changes made:

• Updated 5 database configuration files (Oracle, Oracle RAC, PostgreSQL, MSSQL, MySQL)
• Changed note type from !!! note to !!! warning to emphasize the importance
• Replaced recommendation to use H2 with warning about H2 limitations and recommendation to use external database
• Added reference link to H2 database issue (4.0.0 doc) Updating the Security Guidelines documentation #4052

Files modified:

• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle-rac.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-postgresql.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mssql.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated database setup guides to include warnings about known H2 database limitations that may cause production crashes.
  • Added recommendations to configure external databases for production environments.
  • Enhanced troubleshooting guidance with error examples and recovery steps.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Five database setup documentation files are updated to replace recommendations for using default H2 storage with warnings about a known H2 limitation causing production crashes. External database configuration is now advised, with references to the relevant H2 issue and troubleshooting guidance.

Changes

Cohort / File(s)	Summary
H2 Database Warning Updates en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-{mssql,mysql,oracle,oracle-rac,postgresql}.md	Replaced note/recommendation blocks advising default H2 use for WSO2_MB_STORE_DB with warnings about H2 production crash limitations. Added reference to H2 Database Issue #4052 and guidance to configure external database. Minor indentation adjustment in postgresql.md troubleshooting section.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A cautious note in hoppy code,
From H2's path we now erode.
External databases take the stage,
Keep production safe, turn a new page!
Warnings whisper: crash risk be gone,
Steady databases march ahead, strong! 🗄️

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description is largely incomplete; it lacks required sections like Purpose with linked issues, Goals, Approach, User stories, Release notes, and other critical template sections.	Complete the PR description by filling in all required template sections, particularly Purpose (with issue link), Goals, Approach, Release notes, and Documentation sections.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main change: updating H2 database usage recommendations in WSO2_MB_STORE_DB documentation from note to warning due to known limitations.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fixing-issue-10493-master-1766517333

---

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e4e2670 and cff23a7.

📒 Files selected for processing (5)

• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mssql.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle-rac.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle.md
• en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-postgresql.md

🔇 Additional comments (5)

en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-postgresql.md (1)

71-75: Effective warning: Clear H2 limitation guidance with actionable next steps.

The updated warning clearly articulates the H2 database limitation and directs users toward an external database configuration. The troubleshooting section provides concrete recovery steps for corrupted databases.

en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle.md (1)

62-74: Effective warning: Clear H2 limitation guidance with actionable next steps.

The updated warning clearly articulates the H2 database limitation and directs users toward an external database configuration. The troubleshooting section provides concrete recovery steps for corrupted databases.

en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md (1)

151-163: Effective warning: Clear H2 limitation guidance with actionable next steps.

The updated warning clearly articulates the H2 database limitation and directs users toward an external database configuration. The troubleshooting section provides concrete recovery steps for corrupted databases.

en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-oracle-rac.md (1)

60-72: Effective warning: Clear H2 limitation guidance with actionable next steps.

The updated warning clearly articulates the H2 database limitation and directs users toward an external database configuration. The troubleshooting section provides concrete recovery steps for corrupted databases.

en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mssql.md (1)

89-101: Effective warning: Clear H2 limitation guidance with actionable next steps.

The updated warning clearly articulates the H2 database limitation and directs users toward an external database configuration. The troubleshooting section provides concrete recovery steps for corrupted databases.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}