Skip to content

docs: add Windows(WSL2) source build and verification guide - #414

Open
George060915 wants to merge 2 commits into
IvorySQL:masterfrom
George060915:docs/wsl2-source-build
Open

George060915 wants to merge 2 commits into
IvorySQL:masterfrom
George060915:docs/wsl2-source-build

Conversation

@George060915

@George060915 George060915 commented Nov 15, 2026 •

Copy link
Copy Markdown

What

Adds master/installation_wsl2.adoc in CN and EN, registered under
"安装部署 / Installation" in both nav.adoc files.

Why

The installation guide only covers Linux (yum / docker / rpm / source / deb), and
its source-install section uses dnf groupinstall 'Development Tools', which does
not apply to Debian/Ubuntu. Windows developers are expected to build inside WSL2,
but there is no page describing that path.

Coverage

  • WSL2 + Ubuntu 24.04 setup, including the 0x80370102 virtualization failure
  • Debian/Ubuntu build dependency list
  • configure / make / install, and why --with-uuid is mandatory
  • initdb in Oracle and PG modes; 1521 vs 5432 and ivorysql.compatible_mode
  • Verification queries (dual, sys_context, version())
  • Connecting from Windows over WSL2 localhost forwarding
  • Common failures: missing --with-uuid, initdb as root, port 1521 in use
  • Cleanup

Status

Ready for review. Verified on Windows 11 + WSL2 (Ubuntu 24.04) against a clean
master checkout (PostgreSQL 19beta1, IvorySQL 5beta1); the outputs in the page
are copied from those runs.

Fixes #413

Signed-off-by: George060915 <2799975121@qq.com>
@github-actions
github-actions Bot temporarily deployed to pull request November 15, 2026 09:00 Inactive
@github-actions

Copy link
Copy Markdown

🚀 IvorySQL-Docs Preview Ready

Signed-off-by: George060915 <2799975121@qq.com>
@github-actions
github-actions Bot temporarily deployed to pull request November 15, 2026 09:52 Inactive
@github-actions

Copy link
Copy Markdown

🚀 IvorySQL-Docs Preview Ready

@George060915
George060915 marked this pull request as ready for review November 15, 2026 09:58
@George060915

Copy link
Copy Markdown
Author

@gaoxueyu @bigplaice Ready for review.

背景:安装指南目前完全没有 Windows 路径,而且“源码安装”那节用的是 dnf groupinstall,
在 Debian/Ubuntu 上照抄必失败。这一页把 WSL2 的完整路径补齐了。

验证是在 Windows 11 + WSL2(Ubuntu 24.04) 上全新 checkout 跑的:
configure --with-uuid=e2fs --enable-debug → make -j12 → make install →
initdb → pg_ctl start → psql -p 1521。页面里的输出都是实际结果
(psql (19beta1)、[ORA]ivorysql=#、compatible_mode = oracle)。

Fixes #413

@github-actions

Copy link
Copy Markdown

🚀 IvorySQL-Docs Preview Ready

This branch was successfully deployed

1 active deployment
pull request — 46cb8a84 Deployed Nov 15, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant