다운로드 및 설치 방법 Cassandra on Windows

⚡ 스마트 요약

다운로드 및 설치 Cassandra on Windows 기존 스크린샷에 나와 있는 DataStax Community Edition 설치 프로그램은 2017년에 서비스가 종료되었으므로, 공식 Apache 바이너리 배포판을 압축 해제하여 설치해야 합니다. 이 페이지에서는 필수 조건, 두 가지 설치 방법, 그리고 시작 검증에 대해 설명합니다.

  • ⚠️ 설치 프로그램 상태: DataStax Community Edition MSI는 더 이상 배포되지 않으므로 현재는 Apache 바이너리 아카이브를 이용해야 합니다.
  • Java 요구 사항 : 지원되는 JDK가 설치되어 있어야 하고 JAVA_HOME이 설정되어 있어야 합니다. Cassandra 시작할 것이다.
  • 🐍 cqlsh 요구 사항: CQL 셸은 다음과 같습니다. Python 대본, 그래서 Python 명령줄에서 쿼리를 실행하려면 해당 권한이 있어야 합니다.
  • 📂 바이너리 설치: Extrac압축 파일을 열고 CASSANDRA_HOME을 설정하면 설치가 완료됩니다. 설치 마법사는 필요하지 않습니다.
  • 🐳 컨테이너 옵션: Docker 명령 하나로 작업 노드를 실행할 수 있으며, Windows-특정 문제에 한해서만요.
  • 확인 : nodetool status 명령으로 UN 상태를 확인하고, cqlsh 프롬프트가 연결되면 노드가 정상임을 확인할 수 있습니다.

다운로드 및 설치 Cassandra on Windows

아파치 Cassandra DataStax Enterprise는 대규모 조직에서 방대한 양의 데이터를 저장하기 위해 사용되는 반면, 일반 버전은 소규모 조직에서 사용됩니다.

Apache Cassandra Apache 소프트웨어에서 관리합니다. Foundation.

전제조건 Apache Cassandra 설치

세 가지 항목이 충족되어야 합니다. Cassandra 에 시작됩니다 Windows.

  • Apache Cassandra 바이너리. 여러분의 시간과 재능으로 다운로드 Cassandra 아파치 웹사이트에서 현재 안정 버전의 바이너리 tarball을 다운로드하세요.
  • 지원되는 JDK입니다. Java JDK가 설치되어 있어야 하며, JAVA_HOME 환경 변수가 JDK 폴더를 가리키도록 설정되어 있어야 합니다. Cassandra 4.x는 다음에서 실행됩니다. Java 8 또는 11; Cassandra 5.x는 다음에서 실행됩니다. Java 11 또는 17.
  • Python. cqlsh 명령줄 클라이언트는 다음과 같습니다. Python 프로그램, 그래서 Python 3. CQL 셸을 열려면 설치가 필요합니다.

64비트 Windows 플랫폼은 전체적으로 가정됩니다. 참고하세요. Windows 가볍게 테스트된 플랫폼입니다. Cassandra그렇기 때문에 나중에 설명할 컨테이너 방식이 더 원활한 경우가 많습니다.

다운로드 및 설치 방법 Cassandra

두 가지 설치 방법이 있습니다. 이 섹션의 스크린샷은 대부분의 기존 튜토리얼에서 설명하는 DataStax Community Edition 마법사에서 가져온 것입니다. 해당 설치 프로그램은 더 이상 배포되지 않으므로, 먼저 현재 사용 가능한 바이너리 설치 방법을 설명하고, 아카이브 버전을 사용하는 독자를 위해 마법사 화면은 나중에 다시 제공합니다.

방법 1: Apache 바이너리 아카이브에서 설치 (현재 방법)

단계 1) 위 링크된 Apache 다운로드 페이지에서 apache-cassandra-xyz-bin.tar.gz와 같은 바이너리 tarball을 다운로드하십시오. 다운로드한 파일의 체크섬을 해당 페이지에 게시된 정보와 비교하여 확인하십시오.

단계 2) Extrac압축 파일을 C:\cassandra와 같이 공백이 없는 경로에 저장하십시오. 경로에 공백이 있으면 시작 스크립트가 실패합니다.

단계 3) 두 개의 환경 변수를 생성합니다. Cassandra 예상되는 경우 bin 폴더를 PATH에 추가하세요.

setx CASSANDRA_HOME "C:\cassandra"
setx JAVA_HOME "C:\Program Files\Java\jdk-17"
setx PATH "%PATH%;C:\cassandra\bin"

단계 4) 변수가 적용되도록 새 명령 프롬프트를 열고 노드를 포그라운드에서 시작하십시오.

cd C:\cassandra\bin
cassandra -f

그 창을 열어 두세요. 시작 로그의 마지막 줄에 노드가 9042번 포트에서 CQL 클라이언트의 응답을 기다리고 있다는 내용이 나옵니다.

단계 5) 두 번째 명령 프롬프트에서 노드가 실행 중인지 확인한 다음 셸을 엽니다.

nodetool status
cqlsh 127.0.0.1 9042

다음으로 시작하는 상태 표시줄 UN 이는 노드가 정상적으로 작동 중임을 의미합니다. cqlsh 프롬프트는 설치가 완료되었음을 확인시켜 줍니다.

방법 2: DataStax 커뮤니티 에디션 마법사(기존 방식)

아래 스크린샷은 더 이상 사용되지 않는 MSI 설치 프로그램의 모습입니다. 이미 설치 프로그램을 보유하고 계신 분들에게는 여전히 유용하며, 설치 후 나타나는 셸은 이전과 동일하게 작동합니다.

단계 1) DataStax 커뮤니티 에디션 설치 프로그램을 실행하세요. 설치 프로그램 실행 후 다음 페이지가 표시됩니다. 스크린샷에서는 64비트 버전이 설치되고 있습니다. 필요에 따라 32비트 버전도 다운로드할 수 있지만, 64비트 버전을 권장합니다.

다운로드 및 설치 Cassandra

이 페이지에서는 다음에 대한 정보를 제공합니다. Cassandra 버전을 설치하려고 합니다. '다음' 버튼을 누르세요.

단계 2) '다음' 버튼을 누르세요. '다음' 버튼을 누르면 다음 페이지가 표시됩니다.

다운로드 및 설치 Cassandra

이 페이지는 라이센스 계약에 관한 것입니다. 체크박스를 체크하고 다음 버튼을 누르세요.

단계 3) '다음' 버튼을 누르세요. 다음 페이지에서 설치 위치를 묻습니다.

  1. 기본 위치는 C:\Program Files입니다. 변경을 원하시면 설치 위치를 변경하시면 됩니다. 설치 위치를 변경하지 않는 것이 좋습니다.
  2. 설치 위치 설정 후 '다음' 버튼을 눌러주세요

다운로드 및 설치 Cassandra

단계 4) 스타트 Cassandra 그리고 OpsCenter를 선택하세요. 위 단계에서 '다음' 버튼을 누르면 다음 페이지가 표시됩니다. 이 페이지에서는 자동으로 시작할지 여부를 묻습니다. Cassandra 그리고 OpsCenter.

  1. 자동으로 시작하려면 확인란을 선택하십시오. Cassandra 그리고 OpsCenter.
  2. 해당 정보를 입력하신 후 '다음' 버튼을 눌러주세요.

다운로드 및 설치 Cassandra

단계 5) 설치 버튼을 클릭하세요. 설치 프로그램이 필요한 모든 정보를 수집했으며 이제 설치를 시작할 준비가 되었습니다. 설치 버튼을 누르세요.

다운로드 및 설치 Cassandra

단계 6) '다음'을 클릭하세요. '설치' 버튼을 누르면 다음 페이지가 표시됩니다.

다운로드 및 설치 Cassandra

DataStax 커뮤니티 에디션이 설치되고 있습니다. 설치가 완료되면 '다음' 버튼을 클릭하십시오. 설치가 성공적으로 완료되면 '완료' 버튼을 누르십시오.

다운로드 및 설치 Cassandra

Windows 시작 프로그램으로 이동하여 검색하세요. Cassandra CQL 쉘을 실행하고 Cassandra 껍데기. 달리고 난 후 Cassandra 쉘에서 다음 명령줄이 표시됩니다.

다운로드 및 설치 Cassandra

이제 키스페이스, 테이블을 생성하고 쿼리를 작성할 수 있습니다.

달리는 Cassandra Docker에서 Windows

위의 두 가지 방법 모두 실행됩니다. Cassandra 직접 Windows이는 프로젝트에서 가장 테스트가 덜 된 플랫폼입니다. 컨테이너를 사용하면 이러한 문제를 피할 수 있습니다. Java 경로, 서비스 등록 및 파일 권한 문제는 대부분의 문제를 야기합니다. Windows 설치 오류가 발생하며, 이후 노드를 깔끔하게 제거합니다.

Docker Desktop이 설치되어 있으면 단 하나의 명령으로 단일 노드를 시작할 수 있습니다.

docker run --name cassandra-node -p 9042:9042 -d cassandra:latest

노드가 부트스트랩되는 데 약 1분 정도 기다린 후 상태를 확인하고 컨테이너 내부에서 셸을 여세요.

docker exec -it cassandra-node nodetool status
docker exec -it cassandra-node cqlsh

이렇게 기록된 데이터는 컨테이너 내부에 저장되며 컨테이너가 제거되면 사라집니다. 데이터를 보존하려면 데이터 디렉터리에 볼륨을 연결하십시오.

docker run --name cassandra-node -p 9042:9042 \
  -v cassandra-data:/var/lib/cassandra -d cassandra:latest

이 경로는 학습 및 로컬 개발에 실용적인 선택입니다. 왜냐하면 손상된 노드는 몇 초 만에 폐기되고 다시 생성되기 때문입니다.

문제 해결 Cassandra 에 설치 Windows

스타트업 실패 사례 Windows 몇 가지 반복적인 원인으로 분류됩니다. 각 원인은 콘솔에 고유한 메시지를 표시합니다.

징후 원인 및 해결책
“JAVA_HOME이 설정되지 않았습니다.” 해당 변수가 없거나 JDK가 아닌 JRE를 가리키고 있습니다. 변수를 JDK 폴더로 설정하고 새 명령 프롬프트를 여십시오.
프로세스가 로그 없이 즉시 종료됩니다. 설치 경로에 공백이 있습니다. 해당 폴더를 C:\cassandra와 같은 경로로 이동하십시오.
"또래들과 험담을 나눌 수 없다" 이전 시작 실패로 인해 오래된 데이터가 남아 있습니다. 노드를 중지하고 설치 디렉터리 아래의 data 및 commitlog 폴더를 삭제하십시오.
"이미 사용 중인 주소입니다." 포트 9042 또는 7000은 다른 프로세스, 종종 이전 프로세스에서 사용 중입니다. Cassandra 실행하세요. 닫거나 cassandra.yaml 파일에서 포트를 변경하세요.
cqlsh는 "cqlshlib라는 모듈을 찾을 수 없습니다"라고 보고합니다. Python PATH에 해당 파일이 없거나 잘못된 버전이 먼저 설정되어 있습니다. 설치하세요. Python 3을 입력하고 `python –version`으로 확인하세요.

노드가 UN을 보고하고 cqlsh 연결이 완료되면 다음 단계는 스토리지 구조를 생성하는 것입니다. 이 부분은 다음에서 다룹니다. Cassandra 키 스페이스 튜토리얼에 이어 Cassandra 테이블 튜토리얼.

자주 묻는 질문

아니요. DataStax는 2017년 이후로 Community Edition 발행을 중단했습니다. Windows MSI 파일은 더 이상 다운로드할 수 없습니다. 대신 Apache 바이너리 아카이브 또는 컨테이너 이미지를 사용하십시오.

Cassandra 4.x 지원 Java 8 및 11. Cassandra 5.x 지원 Java 11번과 17번. JRE 대신 JDK가 필요하며, JAVA_HOME은 JDK를 가리켜야 합니다.

함께 제공되는 cassandra.bat 파일은 서비스 등록을 위한 install 플래그를 허용하지만, 이 경로는 테스트가 거의 이루어지지 않았습니다. 실험 목적 이상의 사용을 위해서는 다음 명령어를 실행하세요. Cassandra 리눅스 또는 컨테이너 환경에서 실행됩니다.

시스템 로그 스택을 붙여넣습니다. tracAI 비서에 접속하면 시작 오류가 잘 기록되어 있기 때문에 원인을 빠르게 파악할 수 있습니다. 제안된 수정 사항을 적용하기 전에 cassandra.yaml 파일과 비교하여 확인하십시오.

이 값들을 시작점으로 활용하세요. 힙 크기, 동시 읽기, 압축 처리량은 실제 하드웨어에 따라 달라지므로 생성된 모든 값은 대상 시스템에서 테스트해야 합니다.

이 게시물을 요약하면 다음과 같습니다.