本教程适用于以下操作系统版本
- 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 官方文档。如果你有任何问题,请在下方评论中发布。