本教程适用于以下操作系统版本

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 20.04 (Focal Fossa)
  • Ubuntu 16.04 (Xenial Xerus)

本页内容

  • 先决条件
  • 步骤 1 - 安装 Java
  • 步骤 2 - 安装 Apache Cassandra
  • 步骤 3 - 检查 Cassandra 服务
  • 步骤 4 - 配置 Cassandra 4.1 启用用户认证 4.1.1 - 添加管理员超级用户 4.2 - 编辑控制台配置文件 4.3 - 重命名集群
  • 结论
  • 4.1 启用用户认证
  • 4.1.1 - 添加管理员超级用户
  • 4.2 - 编辑控制台配置文件
  • 4.3 - 重命名集群

Apache Cassandra 是一个开源的 NoSQL 分布式数据库管理系统。Cassandra 可以通过添加更多节点实现横向扩展,数据会在这些节点之间自动复制。添加或移除节点无需任何停机时间。这些节点可以在逻辑上组织为集群或环,并部署在多个数据中心,以提升高性能应用的速度和可靠性。

在本教程中,我们将学习如何在单节点 Ubuntu 22.04 集群上安装 Apache Cassandra。

先决条件

  • 一台运行 Ubuntu 22.04、至少配备 2GB 内存的服务器。
  • 一个具有 root 权限的非 sudo 用户。
  • 所有软件均已更新。$ sudo apt update && sudo apt upgrade

一台运行 Ubuntu 22.04、至少配备 2GB 内存的服务器。

一个具有 root 权限的非 sudo 用户。

所有软件均已更新。

$ sudo apt update && sudo apt upgrade

步骤 1 - 安装 Java

Apache Cassandra 需要 Java 8 或 Java 11 才能运行。最新版本的 Cassandra 全面支持 Java 11,我们将使用 Java 11。

$ sudo apt install openjdk-11-jdk

确认 Java 安装。

$ java -version
openjdk 11.0.15 2022-04-19
OpenJDK Runtime Environment (build 11.0.15+10-Ubuntu-0ubuntu0.22.04.1)
OpenJDK 64-Bit Server VM (build 11.0.15+10-Ubuntu-0ubuntu0.22.04.1, mixed mode, sharing)

步骤 2 - 安装 Apache Cassandra

第一步是添加 Cassandra 的官方仓库。

运行以下命令,将该仓库添加到系统的仓库列表中。

$ echo "deb http://www.apache.org/dist/cassandra/debian 40x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list

在撰写本教程时,Cassandra 的最新可用版本是 4.0.5。上述命令使用 40x 来表示 Cassandra 的 4.0 系列。

将该仓库的密钥添加到系统的可信仓库列表中。

$ wget -q -O - https://www.apache.org/dist/cassandra/KEYS | sudo tee /etc/apt/trusted.gpg.d/cassandra.asc

更新系统仓库列表。

$ sudo apt update

安装 Cassandra。

$ sudo apt install cassandra

步骤 3 - 检查 Cassandra 服务

Cassandra 会自动创建并启动服务守护进程。检查该服务的状态。

$ sudo systemctl status cassandra

你应该会得到以下输出。

? cassandra.service - LSB: distributed storage system for structured data
     Loaded: loaded (/etc/init.d/cassandra; generated)
     Active: active (running) since Mon 2022-07-25 11:40:42 UTC; 12min ago
       Docs: man:systemd-sysv-generator(8)
      Tasks: 48 (limit: 2241)
     Memory: 1.3G
        CPU: 38.219s
     CGroup: /system.slice/cassandra.service
             ??4602 /usr/bin/java -ea -da:net.openhft... -XX:+UseThreadPriorities -XX:+HeapDumpOnOutOfMemoryError -Xss256k -XX:+AlwaysPreTouch -XX:-UseBiasedLocking -XX:+UseTLAB -XX:+ResizeTLAB -XX:+UseNUMA ->
Jul 25 11:40:42 cassandra systemd[1]: Starting LSB: distributed storage system for structured data...
Jul 25 11:40:42 cassandra systemd[1]: Started LSB: distributed storage system for structured data.

你也可以使用 nodetool 命令验证状态。

$ nodetool status
Datacenter: datacenter1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address    Load       Tokens  Owns (effective)  Host ID                               Rack
UN  127.0.0.1  69.08 KiB  16      100.0%            6690243a-950d-4d64-9463-aa722f8064d4  rack1

步骤 4 - 配置 Cassandra

Cassandra 配置文件的默认位置是 /etc/cassandra。日志和数据目录的默认位置分别是 /var/log/cassandra 和 /var/lib/cassandra。

JVM 级别的设置(如堆大小)可以通过 /etc/cassandra/cassandra-env.sh 文件进行设置。你可以向 JVM_OPTS 变量传递额外的 JVM 命令行参数。这些参数会在 Cassandra 启动时传递给它。

4.1 启用用户认证

要启用用户认证,第一步是备份 /etc/cassandra/cassandra.yaml 文件。

$ sudo cp /etc/cassandra/cassandra.yaml /etc/cassandra/cassandra.yaml.backup

打开 cassandra.yaml 文件进行编辑。

$ sudo nano /etc/cassandra/cassandra.yaml

在该文件中找到以下参数。

...
authenticator: AllowAllAuthenticator
...
authorizer: AllowAllAuthorizer
...
roles_validity_in_ms: 2000
...
permissions_validity_in_ms: 2000
...

按如下所示更改这些参数的值。

...
authenticator: org.apache.cassandra.auth.PasswordAuthenticator
...
authorizer: org.apache.cassandra.auth.CassandraAuthorizer
...
roles_validity_in_ms: 0
...
permissions_validity_in_ms: 0
. . .

你可以根据自己的需求配置其他设置。如果它们被注释掉了,请取消注释。

完成后,按 Ctrl + X 并在提示时输入 Y 保存文件。

重启 Cassandra 以使更改后的设置生效。

$ sudo systemctl restart cassandra

4.1.1 - 添加管理员超级用户

现在我们已经启用了认证,需要创建一个用户。为此,我们将使用 Cassandra Command shell 工具。使用默认用户 cassandra 的凭据登录。

$ cqlsh -u cassandra -p cassandra

你将看到以下 shell。

Connected to Test Cluster at 127.0.0.1:9042
[cqlsh 6.0.0 | Cassandra 4.0.5 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
cassandra@cqlsh>

创建一个新的超级用户。将 [username] 和 [yourpassword] 替换为你自己的凭据。

cassandra@cqlsh> CREATE ROLE [username] WITH PASSWORD = '[yourpassword]' AND SUPERUSER = true AND LOGIN = true;

退出该 shell。

cassandra@cqlsh> exit

使用新的超级用户账户重新登录。

$ cqlsh -u username -p yourpassword

移除默认 cassandra 账户的提升权限。

username@cqlsh> ALTER ROLE cassandra WITH PASSWORD = 'cassandra' AND SUPERUSER = false AND LOGIN = false;
username@cqlsh> REVOKE ALL PERMISSIONS ON ALL KEYSPACES FROM cassandra;

将所有权限授予该超级用户账户。

username@cqlsh> GRANT ALL PERMISSIONS ON ALL KEYSPACES TO '[username]';

退出该 shell。

username@cqlsh> exit

4.2 - 编辑控制台配置文件

如果你想自定义 Cassandra Shell,可以通过编辑 cqlshrc 文件来实现。该文件的默认位置在 ~/.cassandra 目录中。如果你想从其他目录加载它,可以在运行时向 cqlsh 工具传递参数 --cqlshrc /customdirectory。Cassandra 的默认安装不包含该文件,因此我们需要创建它。

在 ~/.cassandra 目录中创建 cqlshrc 文件。在 ~/.cassandra 目录中执行任何操作都不需要使用 sudo。Cassandra 要求该目录中的文件归本地账户所有,且不应被其他账户或用户组访问。

$ touch ~/.cassandra/cqlshrc

如果 ~/.cassandra 目录不存在,则使用以下命令创建它。

$ mkdir ~/.cassandra

打开该文件进行编辑。

$ nano ~/.cassandra/cqlshrc

Cassandra 的 Github 仓库提供了一个 cqlshrc 示例文件。你可以根据需要复制其中的任意或全部配置段。所有设置都用 ;; 注释。通过移除双分号取消注释,然后根据你的需求进行修改。

我们将配置该 shell 使用超级用户凭据自动登录。将 [username] 和 [password] 替换为上一步创建的凭据。

....
[authentication]
;; If Cassandra has auth enabled, fill out these options
username = [username]
password = [password]
....

编辑你想要更改的其他设置。完成后,按 Ctrl + X 并在提示时输入 Y 保存文件。

更新 cqlshrc 文件的权限。这会阻止任何其他用户组访问该文件。

$ chmod 600 ~/.cassandra/cqlshrc

使用新更改登录 Cassandra shell。

$ cqlsh
Connected to Test Cluster at 127.0.0.1:9042
[cqlsh 6.0.0 | Cassandra 4.0.5 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
navjot@cqlsh>

注意:从 Cassandra 4.1 版本开始,在 cqlshrc 文件中存储用户名和密码的方式将被弃用。要了解更多信息,可以阅读 Cassandra 官网上的相关条目。

4.3 - 重命名集群

最后,我们将把集群名称从 Test Cluster 重命名为你选定的名称。

登录 cqlsh 终端。

$ cqlsh

在下面的命令中将 [clustername] 替换为你的新集群名称。

username@cqlsh> UPDATE system.local SET cluster_name = '[new_name]' WHERE KEY = 'local';

退出该 shell。

username@cqlsh> exit

打开 /etc/cassandra/cassandra.yaml 文件进行编辑。

$ sudo nano /etc/cassandra/cassandra.yaml

将变量 cluster_name 的值替换为你选定的名称。

...
# The name of the cluster. This is mainly used to prevent machines in
# one logical cluster from joining another.
cluster_name: '[new_name]'
...

完成后,按 Ctrl + X 并在提示时输入 Y 保存文件。

清除 Cassandra 系统缓存。

$ nodetool flush system

重启 Cassandra。

$ sudo systemctl restart cassandra

登录该 shell 查看新名称。

$ cqlsh
Connected to howtoforge at 127.0.0.1:9042
[cqlsh 6.0.0 | Cassandra 4.0.5 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
navjot@cqlsh>

结论

在本教程中,你学习了如何在 AlmaLinux 或 Rocky Linux 服务器上安装 Apache Cassandra。你还学习了如何添加用户认证并执行一些基本配置。要了解更多信息,请访问 Cassandra 官方文档。如果你有任何问题,请在下方评论中发布。