[CUBRIDMAN-354] CUBRID installer for Windows with WSL by hwany7seo · Pull Request #773 · CUBRID/cubrid-manual

hwany7seo · 2026-09-11T00:55:51Z

http://jira.cubrid.org/browse/CUBRIDMAN-354
http://jira.cubrid.org/browse/TOOLS-4930

CUBRID WSL Installer 설치 관련 사항을 추가합니다.

http://jira.cubrid.org/browse/CUBRIDMAN-354 http://jira.cubrid.org/browse/TOOLS-4930 - add WSL decription for install

greptile-apps · 2026-09-11T00:58:22Z

한국어 문서의 기존 내부 참조가 잘못된 WSL 절로 이동하므로, 앵커 위치를 복원한 뒤 병합해야 합니다.

_{Reviews (1) · Last reviewed commit: "[CUBRIDMAN-354] CUBRID installer for Win..."}

github-actions · 2026-09-11T05:42:53Z

✅ CUBRID Manual Preview is Ready!

All docs (KO/EN) are successfully built and deployed.

Type	🇰🇷 Korean (KO)	🇺🇸 English (EN)
🌐 Web	View Docs	View Docs
📄 PDF	Download	Download

bagus-kim · 2026-09-11T08:22:46Z

내용추가를 고려해주세요. 개인의견이니 검토 하셔도 반영이 필요한 부분만 해주셔도 괜찮습니다.

1. 네트워크 구성 모드와 Windows 호스트에서의 접속 방법
: TOOLS-4930에 4번.WSL2와 서버상태를 확인하기 위한 기본 네트워크 구성 방법을 선택하여 고를 수 있도록 한다.(Default : NAT이며 Bridge, Mirrored 모드는 설정 Tray 프로그램에서 가이드 메뉴로 제공) 이나 문서에 없습니다. 이 설치 프로그램의 목적 자체가 Windows 네이티브 서버를 대체하는 것이므로,사용자에게 가장 먼저 필요한 정보는 「Windows에서 돌던 응용이 어떤 주소로 붙는가」일 것 같습니다.
2. Tray 애플리케이션 사용 방법
: Tray 애플리케이션을 세 번 언급하지만, 전부 「설치된다」,「실행할지 선택한다」, 「자동 실행을 끄는 방법」뿐입니다. 실행한 뒤 무엇을 할 수 있는지가 없어, 사용자는 배포판 안에 직접 접속해 cubrid service 명령을 쓰는 방법 밖에 없는 것 같습니다. TOOLS-4930이 정의한 기능(CUBRID 서버 상태 확인, 서버 재시작, 네트워크 모드 설정 가이드 메뉴)을 각각 어떤 메뉴에서 수행되는지 추가되었으면 합니다.
3. 설치 직후 정상 동작 확인 절차
: 「3단계: 설치 완료」 다음에 설치 확인 절차를 추가하면 어떠할까요? Windows 명령 프롬프트에서 wsl -l -v로 배포판이 Running 상태인지 확인하고, wsl -d <배포판 이름> -u cubrid -- cubrid service status로 마스터·브로커 프로세스가 떠 있는지 확인하는 순서와 정상 출력 예시를 함께 적으면 좋겠습니다.
WSL 절만 설치 완료 뒤 곧바로 「배포판 관련」 설명으로 넘어가, 사용자가 설치가 제대로 됐는지 스스로 판단할 수 있도록 하는 것이 좋겠습니다.

4. 제거 전 데이터베이스 백업 절차
: ko 265~266행의 백업 경고에 실제 절차를 덧붙이는 것입니다. 배포판 안에 접속해 cubrid backupdb로 백업 파일을 만든 뒤, 그 파일을 Windows 파일 시스템(/mnt/c/... 경로)으로 복사해 배포판 밖에 보관하는 순서를 작성하는 것입입니다.

현재 문서는 「제거 전에 데이터베이스를 백업해야 한다」로 끝맺고 있습니다. 백업 파일을 배포판 안에 그대로 두면 제거 시 함께 제거될 수 있습니다. 백업을 배포판 밖으로 꺼내는 단계가 빠지면 경고를 따른 사용자도 데이터를 잃을 수 있을 것 같습니다. WSL 환경 고유의 절차라서 Linux 절을 참고하라는 안내만으로는 부족하지 않을까 합니다.

bagus-kim · 2026-09-11T07:53:17Z

+Windows에서 WSL(Windows Subsystem for Linux) 환경을 이용한 설치와 실행
+-----------------------------------------------------------------------
+
+Windows의 WSL(Windows Subsystem for Linux) 환경에서 CUBRID를 설치하고 실행할 수 있는 설치 프로그램을 제공한다. (https://www.cubrid.com/downloads)


Suggested change

Windows의 WSL(Windows Subsystem for Linux) 환경에서 CUBRID를 설치하고 실행할 수 있는 설치 프로그램을 제공한다. (https://www.cubrid.com/downloads)

11.4.6 이상 버전부터 Windows의 WSL(Windows Subsystem for Linux) 환경에서 CUBRID를 설치하고 실행할 수 있는 설치 프로그램을 제공한다. (https://www.cubrid.org/downloads)

다른 PR에서 버전을 기입하자고 의견냈으나 반려한적이 있습니다.
연구소내에서는 위와 같이 특정 버전 기입을 하지 않는 것이 좋다 라는 의견이신지요??

신규 기능과 같은 부분에서는 넣어야 하지 않을까 하는게 개인적인 생각입니다.
이것은 꼭 반영할 필요는 없고, PM팀과 기술본부팀의 의견을 구해보고 전달하려 합니다.

bagus-kim · 2026-09-11T08:01:43Z

-| * Windows 64 Bit Windows 7 이상                              | 1G 이상          | 2G 이상(\*)          |
-| * Linux 계열 64 Bit(Linux kernel 2.4 및 glibc 2.3.4 이상)    |                  |                      |
-+--------------------------------------------------------------+------------------+----------------------+
+------------------------------------------------------------------+-----------------+----------------------+


영문과 국문이 같은가요?? 조금 달라보입니다. 순서오류

bagus-kim · 2026-09-11T08:03:14Z

+    *   자동 실행 목록에 Tray 애플리케이션 등록 여부 선택
+    *   바탕화면 바로가기 생성 여부
+    *   샘플 데이터베이스 생성 여부
+    *   WSL2 모드 선택 (체크시 WSL2 모드로 설치, 체크 해제시 WSL1 모드로 설치) 


WSL1을 선택해야 하는 경우와 WSL1에서의 제약을 추가했으면 합니다.

WSL2 모드 선택(기본값: 체크됨). 체크하면 WSL2 모드로, 체크를 해제하면 WSL1 모드로 설치한다.
위의 지원 플랫폼 요구 사양과 동작 검증은 WSL2 모드를 기준으로 한다. WSL1 모드는 <WSL1에서의 제약 사항을 여기에 명시>.

bagus-kim · 2026-09-11T08:05:52Z

+
+**배포판 관련**
+
+    *   설치 프로그램은 배포판 이름을 설정할 수 있으며, 배포판 이름은 Windows 명령 프롬프트에서 wsl -l 명령으로 확인 가능하다.


Suggested change

* 설치 프로그램은 배포판 이름을 설정할 수 있으며, 배포판 이름은 Windows 명령 프롬프트에서 wsl -l 명령으로 확인 가능하다.

* 설치 프로그램은 배포판 이름을 설정할 수 있으며, 배포판 이름은 Windows 명령 프롬프트에서 ``wsl -l`` 명령으로 확인할 수 있다.

어디까지가 명령어인지 강조되면 좋겠습니다.

bagus-kim · 2026-09-11T08:07:30Z

+    *   설치 프로그램은 배포판 이름을 설정할 수 있으며, 배포판 이름은 Windows 명령 프롬프트에서 wsl -l 명령으로 확인 가능하다.
+    *   배포판의 CUBRID는 cubrid 사용자 계정으로 설치되며, cubrid 사용자의 홈 디렉터리는 /home/cubrid 이다.
+    *   배포판의 CUBRID 설치 경로는 /home/cubrid/CUBRID 이며, CUBRID 환경 변수는 /home/cubrid/.cubrid.sh 에 설정되어 있다.
+    *   배포판 안으로 접속하려면 Windows 명령 프롬프트에서 wsl -d <배포판 이름> -u cubrid명령으로 접속 가능하다.


Suggested change

* 배포판 안으로 접속하려면 Windows 명령 프롬프트에서 wsl -d <배포판 이름> -u cubrid명령으로 접속 가능하다.

* 배포판 안으로 접속하려면 Windows 명령 프롬프트에서 ``wsl -d <배포판 이름> -u cubrid`` 명령을 실행한다.

bagus-kim · 2026-09-11T08:11:34Z

+    *   설치 완료 후 Tray 애플리케이션을 실행할 지 선택 할 수 있다.
+    *   설치 프로그램은 설치와 제거 기능만 제공된다. 제거 시에는 WSL 배포판과 Tray 애플리케이션을 제거되어,
+        배포판 내부의 데이터베이스 및 설정 파일은 모두 삭제되므로, 제거 전에 데이터베이스를 백업해야 한다.
+    *   업그레이드 및 기타 사용 방법은 Linux 와 동일하게 진행하면 된다.


265라인의 설치/제거와 267 업그레이드 있어서 새 버전의 EXE 설치 프로그램을 실행했을 때 기존 배포판을 덮어쓰는지, 다른 이름의 배포판이 하나 더 생기는지, 아니면 설치가 중단되는지가 빠져 있어 사용자가 판단할 수 없습니다.

[제안]

설치 프로그램은 설치와 제거 기능만 제공한다. 제거하면 WSL 배포판과 Tray 애플리케이션이 함께 제거되고 배포판 내부의 데이터베이스 및 설정 파일도 모두 삭제되므로, 제거 전에 데이터베이스를 백업해야 한다.

CUBRID를 업그레이드할 때에는 설치 프로그램을 다시 실행하지 않고, 배포판 안에 접속하여 Linux용 설치 파일로 Linux와 동일한 절차로 진행한다. 자세한 내용은 :ref:Installing-and-Running-on-Linux\ 의 CUBRID 업그레이드를 참고한다.

「설치 프로그램을 다시 실행하지 않고」 부분은 확인필요합니다.

bagus-kim · 2026-09-11T08:11:58Z

+
+**설치 전 확인 사항**
+
+Windows 버전의 CUBRID 데이터베이스를 설치하기 전에 다음 사항을 점검한다.


Suggested change

Windows 버전의 CUBRID 데이터베이스를 설치하기 전에 다음 사항을 점검한다.

WSL 환경에 CUBRID를 설치하기 전에 다음 사항을 점검한다.

[CUBRIDMAN-354] CUBRID installer for Windows with WSL

9f565f0

http://jira.cubrid.org/browse/CUBRIDMAN-354 http://jira.cubrid.org/browse/TOOLS-4930 - add WSL decription for install

hwany7seo requested review from bagus-kim, hiclass, junsklee, kavin0718, kwonhoil and mhoh3963 as code owners September 11, 2026 00:55

greptile-apps Bot reviewed Sep 11, 2026

View reviewed changes

Comment thread ko/install.rst

Comment thread ko/install.rst Outdated

Comment thread ko/install.rst Outdated

Comment thread en/install.rst

Comment thread en/install.rst Outdated

greptile review

747990f

bagus-kim requested a review from manyoung-jeong September 11, 2026 07:36

bagus-kim approved these changes Sep 11, 2026

View reviewed changes

	Windows의 WSL(Windows Subsystem for Linux) 환경에서 CUBRID를 설치하고 실행할 수 있는 설치 프로그램을 제공한다. (https://www.cubrid.com/downloads)
	11.4.6 이상 버전부터 Windows의 WSL(Windows Subsystem for Linux) 환경에서 CUBRID를 설치하고 실행할 수 있는 설치 프로그램을 제공한다. (https://www.cubrid.org/downloads)


		배포판 관련

		* 설치 프로그램은 배포판 이름을 설정할 수 있으며, 배포판 이름은 Windows 명령 프롬프트에서 wsl -l 명령으로 확인 가능하다.

	* 배포판 안으로 접속하려면 Windows 명령 프롬프트에서 wsl -d <배포판 이름> -u cubrid명령으로 접속 가능하다.
	* 배포판 안으로 접속하려면 Windows 명령 프롬프트에서 ``wsl -d <배포판 이름> -u cubrid`` 명령을 실행한다.


		설치 전 확인 사항

		Windows 버전의 CUBRID 데이터베이스를 설치하기 전에 다음 사항을 점검한다.

	Windows 버전의 CUBRID 데이터베이스를 설치하기 전에 다음 사항을 점검한다.
	WSL 환경에 CUBRID를 설치하기 전에 다음 사항을 점검한다.

Uh oh!

Conversation

hwany7seo commented Sep 11, 2026

Uh oh!

greptile-apps Bot commented Sep 11, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Sep 11, 2026

Uh oh!

bagus-kim commented Sep 11, 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!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants