本页内容
- 先决条件
- 第 1 步 - 安装 Java
- 第 2 步 - 安装 Apache Cassandra
- 第 3 步 - 安装 Cqlsh
- 第 4 步 - 为 Cassandra 创建 Systemd 单元文件
- 第 5 步 - 配置 Cassandra 5.1 启用用户认证 5.1.1 - 添加管理员超级用户 5.2 - 编辑控制台配置文件 5.3 - 重命名集群
- 结论
- 5.1 启用用户认证
- 5.1.1 - 添加管理员超级用户
- 5.2 - 编辑控制台配置文件
- 5.3 - 重命名集群
Apache Cassandra 是一个开源的 NoSQL 分布式数据库管理系统。可以通过增加更多节点来横向扩展 Cassandra,数据会在这些节点之间自动复制。节点的添加或移除无需任何停机时间。这些节点可以在逻辑上组织为一个集群或一个环,并跨多个数据中心进行设置,以提高高性能应用的速度和可靠性。
在本教程中,我们将学习如何在 AlmaLinux 和 Rocky Linux 8 操作系统上安装 Apache Cassandra。除非另有说明,这两个操作系统的命令都是相同的。
先决条件
- 一台运行 AlmaLinux 或 Rocky Linux 且内存至少为 2GB 的服务器。
- 一个具有 root 权限的非 sudo 用户。
- 所有内容均已更新。$ sudo dnf update
一台运行 AlmaLinux 或 Rocky Linux 且内存至少为 2GB 的服务器。
一个具有 root 权限的非 sudo 用户。
所有内容均已更新。
$ sudo dnf update
第 1 步 - 安装 Java
Apache Cassandra 需要 Java 8 才能运行。最新版本的 Cassandra 包含对 Java 11 的实验性支持,但在本教程中,我们将坚持使用 Java 8。
$ sudo dnf install java-1.8.0-openjdk java-1.8.0-openjdk-devel
确认 Java 安装。
$ java -version
openjdk version "1.8.0_312"
OpenJDK Runtime Environment (build 1.8.0_312-b07)
OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)
第 2 步 - 安装 Apache Cassandra
第一步是添加 Cassandra 的官方仓库。
运行以下命令以创建仓库文件 /etc/yum.repos.d/cassandra.repo 并输入详细信息。
$ sudo tee /etc/yum.repos.d/cassandra.repo <<EOF
> [cassandra]
> name=Apache Cassandra
> baseurl=https://www.apache.org/dist/cassandra/redhat/40x/
> gpgcheck=1
> repo_gpgcheck=1
> gpgkey=https://www.apache.org/dist/cassandra/KEYS
> EOF
现在仓库文件已创建,安装 Cassandra。
$ sudo dnf install cassandra -y
第 3 步 - 安装 Cqlsh
我们将使用 CQL Shell(cqlsh)工具与 Cassandra 交互。该工具兼容 Python 2.7 或 Python 3.6+。在本教程中,我们将使用 Python 3.8。安装 Python 3.8。
$ sudo dnf install python38
将 Python 3.8 设置为默认的 Python 版本。
$ sudo update-alternatives --config python
There are 3 programs which provide 'python'.
Selection Command
-----------------------------------------------
*+ 1 /usr/libexec/no-python
2 /usr/bin/python3
3 /usr/bin/python3.8
Enter to keep the current selection[+], or type selection number: 3
你将看到多个选项。在本例中,我们将选择数字 3 以将 Python 3.8 设置为默认版本。
确认 Python 安装。
$ python --version
Python 3.8.8
使用 update-alternatives 工具后,你无需再使用 python3 命令。
使用 pip Python 包管理器安装 cqlsh。
$ pip3 install --user cqlsh
确认 cqlsh 安装。
$ cqlsh --version
cqlsh 6.0.0
第 4 步 - 为 Cassandra 创建 Systemd 单元文件
创建并打开 /etc/systemd/system/cassandra.service 进行编辑。
$ sudo nano /etc/systemd/system/cassandra.service
将以下代码粘贴到其中。
[Unit]
Description=Apache Cassandra
After=network.target
[Service]
PIDFile=/var/run/cassandra/cassandra.pid
User=cassandra
Group=cassandra
ExecStart=/usr/sbin/cassandra -f -p /var/run/cassandra/cassandra.pid
Restart=always
[Install]
WantedBy=multi-user.target
按 Ctrl + X 并在出现提示时输入 Y 来保存文件。
重新加载服务守护进程。
$ sudo systemctl daemon-reload
启用并启动 Cassandra 服务。
$ sudo systemctl enable cassandra --now
检查服务状态。
$ sudo systemctl status cassandra
? cassandra.service - Apache Cassandra
Loaded: loaded (/etc/systemd/system/cassandra.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2021-12-30 11:07:43 UTC; 12s ago
Main PID: 4679 (java)
Tasks: 48 (limit: 23696)
Memory: 1.3G
CGroup: /system.slice/cassandra.service
??4679 /usr/bin/java -ea -da:net.openhft... -XX:+UseThreadPriorities -XX:+HeapDumpOnOutOfMemoryError -Xss256>
你还可以使用 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.09 KiB 16 100.0% 2fe7ccae-2af9-4841-9bff-bffa29f10dc5 rack1
第 5 步 - 配置 Cassandra
Cassandra 配置文件的默认位置是 /etc/cassandra。日志和数据目录的默认位置是 /var/log/cassandra 和 /var/lib/cassandra。
JVM 级别的设置(例如堆大小)可以通过 /etc/cassandra/conf/cassandra-env.sh 文件进行设置。你可以向 JVM_OPTS 变量传递额外的 JVM 命令行参数。这些参数会在 Cassandra 启动时传递给它。
5.1 启用用户认证
要启用用户认证,首先对 /etc/cassandra/conf/cassandra.yaml 文件进行备份。
$ sudo cp /etc/cassandra/conf/cassandra.yaml /etc/cassandra/conf/cassandra.yaml.backup
打开 cassandra.yaml 文件进行编辑。
$ sudo nano /etc/cassandra/conf/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
5.1.1 - 添加管理员超级用户
现在我们已经启用了认证,需要创建一个用户。为此,我们将使用 Cassandra 命令行 shell 工具。使用默认用户 cassandra 的凭据登录。
$ cqlsh -u cassandra -p cassandra
创建一个新的超级用户。用你的凭据替换 [username] 和 [yourpassword]。
cassandra@cqlsh> CREATE ROLE [username] WITH PASSWORD = '[yourpassword]' AND SUPERUSER = true AND LOGIN = true;
退出登录。
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]';
退出登录。
username@cqlsh> exit
5.2 - 编辑控制台配置文件
如果你想自定义 Cassandra Shell,可以通过编辑 cqlshrc 文件来实现。该文件的默认位置在 ~/.cassandra 目录中。如果你想从其他目录加载它,可以在运行时向 cqlsh 工具传递参数 --cqlshrc /customdirectory。
你可以在 /etc/cassandra/conf/cqlshrc.sample 找到一个示例文件,其中包含有关 Cassandra Shell 的所有可配置设置。
将示例文件复制并重命名到 ~/.cassandra 目录。
$ sudo cp /etc/cassandra/conf/cqlshrc.sample ~/.cassandra/cqlshrc
使用所需权限更新 cqlshrc 文件。
$ sudo chmod 600 ~/.cassandra/cqlshrc
$ sudo chown $USER:$USER ~/.cassandra/cqlshrc
打开文件进行编辑。
$ nano ~/.cassandra/cqlshrc
我们将配置 shell 以使用超级用户凭据自动登录。找到以下部分并填入你的用户名和密码。
....
[authentication]
;; If Cassandra has auth enabled, fill out these options
username = [superuser]
password = [password]
....
编辑你想要更改的其他设置。其中一些设置使用 ;; 进行了注释。移除双分号以取消注释,然后进行修改。
完成后,按 Ctrl + X 并在出现提示时输入 Y 来保存文件。
使用你新的更改登录 Cassandra shell。
$ cqlsh
Connected to Test Cluster at 127.0.0.1:9042
[cqlsh 6.0.0 | Cassandra 4.0.1 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
username@cqlsh>
5.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/conf/cassandra.yaml 进行编辑。
$ sudo nano /etc/cassandra/conf/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 example Cluster at 127.0.0.1:9042
[cqlsh 6.0.0 | Cassandra 4.0.1 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
username@cqlsh>
结论
在本教程中,你学习了如何在 AlmaLinux 或 Rocky Linux 服务器上安装 Apache Cassandra。你还学习了如何添加用户认证并执行一些基本配置。要了解更多信息,请访问 Cassandra 官方文档。如果你有任何问题,请在下面的评论中发布。