ダウンロードとインストール方法 Cassandra on Windows

⚡ スマートサマリー

ダウンロードしてインストール Cassandra on Windows 従来のスクリーンショットに表示されている DataStax Community Edition インストーラーは 2017 年に廃止されたため、公式の Apache バイナリディストリビューションを展開して使用します。このページでは、前提条件、2 つのインストール方法、および起動時の検証について説明します。

  • ⚠️ インストーラーの状態: 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 Softwareによって管理されています Foundation.

の前提条件 Apache Cassandra 設置

3つの項目が揃っている必要があります Cassandra 開始します Windows.

  • Apache Cassandra バイナリ。 また、ご購読はいつでも停止することが可能です ダウンロード Cassandra Apacheのウェブサイトから入手してください。最新の安定版リリースのバイナリtarballを取得してください。
  • サポートされているJDK。 Java インストールされている必要があり、JAVA_HOME環境変数はJDKフォルダを指している必要があります。 Cassandra 4.x は Java 8 または 11; Cassandra 5.x は Java 11または17。
  • Python. cqlsh コマンドライン クライアントは Python プログラムなので、 Python CQLシェルを開くには、3つのインストールが必要です。

64ビット Windows プラットフォームは全体を通して前提としています。 Windows 軽くテストされたプラットフォーム Cassandraそのため、後述するコンテナ輸送ルートの方が多くの場合、よりスムーズな選択肢となる。

ダウンロードとインストールの方法 Cassandra

インストール方法は2つあります。このセクションのスクリーンショットは、DataStax Community Editionのウィザードから取得したもので、既存のチュートリアルのほとんどで説明されている方法です。このインストーラーは現在公開されていないため、まず最新のバイナリインストール方法を示し、その後、アーカイブ版を使用する読者のためにウィザードの手順を示します。

方法1:Apacheバイナリアーカイブからインストールする(現在の方法)

ステップ1) 上記リンク先のApacheダウンロードページから、例えばapache-cassandra-xyz-bin.tar.gzのようなバイナリtarballをダウンロードしてください。同じページに掲載されているチェックサムと照らし合わせて、ファイルの内容を検証してください。

ステップ2) Extracアーカイブを、C:\cassandra のようにスペースを含まないパスに保存してください。パスにスペースが含まれていると、起動スクリプトが失敗します。

ステップ3) 2つの環境変数を作成する 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 Community Editionウィザード(従来版)

以下のスクリーンショットは、廃止されたMSIインストーラーに関するものです。既にMSIインストーラーをお持ちの方にとっては依然として有用な情報であり、起動後のシェル動作も以前のものと全く同じです。

ステップ1) DataStax Community Editionのセットアップを実行してください。セットアップを実行すると、次のページが表示されます。このスクリーンショットでは、64ビット版がインストールされています。必要に応じて32ビット版をダウンロードすることもできますが、64ビット版の使用をお勧めします。

ダウンロードとインストール Cassandra

このページでは、 Cassandra インストールするバージョン。 「次へ」ボタンを押してください。

ステップ2) 「次へ」ボタンを押してください。「次へ」ボタンを押すと、次のページが表示されます。

ダウンロードとインストール Cassandra

このページはライセンス契約に関するものです。チェックボックスをオンにして次へボタンを押してください。

ステップ3) 「次へ」ボタンを押してください。次のページが表示され、インストール場所を選択するよう求められます。

  1. デフォルトの場所は C:\Program Files です。 インストール場所を変更したい場合は変更できます。 設置場所を変更しないことをお勧めします。
  2. インストール場所を設定したら「次へ」ボタンを押してください

ダウンロードとインストール Cassandra

ステップ4) お気軽にご連絡ください Cassandra および OpsCenter。上記のステップで「次へ」ボタンを押すと、次のページが表示されます。このページでは、自動的に開始するかどうかを尋ねられます。 Cassandra そしてオプスセンター。

  1. 自動的に開始したい場合はチェックボックスをオンにしてください Cassandra そしてオプスセンター。
  2. この情報を入力したら、「次へ」ボタンを押してください。

ダウンロードとインストール Cassandra

ステップ5) インストールボタンをクリックしてください。セットアップに必要な情報がすべて収集されました。これでインストール準備が整いました。インストールボタンを押してください。

ダウンロードとインストール Cassandra

ステップ6) 「次へ」をクリックしてください。「インストール」ボタンを押すと、次のページが表示されます。

ダウンロードとインストール Cassandra

DataStaxコミュニティ版をインストールしています。インストールが完了したら、「次へ」ボタンをクリックしてください。セットアップが正常に完了したら、「完了」ボタンを押してください。

ダウンロードとインストール Cassandra

Windowsのスタートプログラムに移動し、検索 Cassandra CQL シェルを選択して実行します。 Cassandra シェル。走った後 Cassandra シェルでは、次のコマンドラインが表示されます

ダウンロードとインストール Cassandra

これで、キースペース、テーブルを作成し、クエリを作成できるようになりました。

Running: Cassandra Docker で Windows

上記の両方の方法を実行すると Cassandra 直接に Windowsこれは、プロジェクトで最もテストされていないプラットフォームです。コンテナは、 Java パス、サービス登録、ファイル権限の問題がほとんどの原因となっている Windows インストールが失敗した場合、その後ノードを正常に削除します。

Docker Desktopがインストールされていれば、コマンド1つで動作する単一ノードを起動できます。

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などのパスに移動してください。
「同僚と噂話をすることができない」 以前の起動失敗により、古いデータが残っています。ノードを停止し、インストールディレクトリ内のデータフォルダとコミットログフォルダをクリアしてください。
「アドレスはすでに使用されています」 ポート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 はサービス登録のためのインストールフラグを受け付けますが、このパスはほとんどテストされていません。実験以外の目的では、以下を実行してください。 Cassandra Linux上、またはコンテナ内で。

system.logスタックを貼り付けます tracAIアシスタントにエラーを報告すれば、起動エラーは十分に文書化されているため、通常は原因を迅速に特定できます。修正を適用する前に、cassandra.yamlファイルに対して提案された修正が正しいかどうかを確認してください。

これらはあくまで出発点として扱ってください。ヒープサイズ、同時読み取り数、および圧縮スループットは実際のハードウェアに依存するため、生成された値はすべて対象マシンでテストする必要があります。