1. 안정적인 ZooKeeper 버전 다운로드 최신 안정 버전인 zookeeper-3.5.7을 공식 사이트에서 다운로드합니다. 다운로드 파일명: apache-zookeeper-3.5.7-bin.tar.gz ⚠️ 주의: -bin.tar.gz 확장자가 포함된 파일만 정상적으로 실행 가능합니다. 다른 형식은 사용 불가.

2. 압축 해제 및 디렉터리 준비 압축 파일을 원하는 위치(예: C:\zookeeper)에 추출합니다. 명령 프롬프트에서 다음 명령어를 실행하여 해제:

tar -zxvf apache-zookeeper-3.5.7-bin.tar.gz

3. 구성 파일 설정 (zoo.cfg 수정) conf 폴더 내부의 zoo_sample.cfg 파일을 복사하여 이름을 zoo.cfg로 변경합니다. 아래와 같이 필수 항목을 수정합니다:

tickTime=2000
initLimit=10
syncLimit=5
dataDir=C:\\zookeeper\\apache-zookeeper-3.5.7-bin\\data
dataLogDir=C:\\zookeeper\\apache-zookeeper-3.5.7-bin\\log
clientPort=2181
admin.serverPort=8082

• dataDir: 스냅샷 저장 경로 (디렉터리 미리 생성 필요).
• dataLogDir: 로그 파일 저장 경로.
• clientPort: 클라이언트 접속 포트 (기본 2181).
• admin.serverPort: 관리 서버 포트 (기본 8080 → 8082로 변경).

4. Java 환경 변수 설정 (zkEnv.cmd 편집) bin\zkEnv.cmd 파일을 열고, 아래 줄을 추가하여 JAVA_HOME를 지정합니다:

set JAVA_HOME="C:\java\jdk1.8.0_212-X64"

완성된 부분 예시:

@REM setup java environment variables
set JAVA_HOME="C:\java\jdk1.8.0_212-X64"

if not defined JAVA_HOME (
  echo Error: JAVA_HOME is not set.
  goto :eof
)

set JAVA_HOME=%JAVA_HOME:"=%

if not exist "%JAVA_HOME%"\bin\java.exe (
  echo Error: JAVA_HOME is incorrectly set: %JAVA_HOME%
  echo Expected to find java.exe here: %JAVA_HOME%\bin\java.exe
  goto :eof
)

5. ZooKeeper 시작 bin 폴더로 이동 후, 명령 프롬프트에서 다음 명령어 실행:

zkServer.cmd

정상적으로 실행되면 콘솔에 초기화 메시지와 함께 서비스가 시작됩니다.

6. 실행 상태 확인

6.1 프로세스 확인 (jps 명령어)

명령 프롬프트에서 다음 명령어 실행:

jps -l -v

출력 결과에 다음 문자열이 포함되면 성공:

org.apache.zookeeper.server.quorum.QuorumPeerMain

6.2 포트 열림 여부 확인

2181 포트가 정상적으로 열려 있는지 확인:

netstat -ano | findstr 2181

결과로 연결 정보(예: LISTENING)가 표시되면 정상 작동 중입니다.