跳到主要内容
版本:2.3.2

Ubuntu & Debian

Ubuntu 和 Debian 用户可以使用包管理器 apt-get 安装最新稳定版本的 CnosDB。

下载

对于 Ubuntu 或 Debian 用户,使用以下命令添加 CnosDB 存储库:

curl -fsSL https://repo.cnosdb.com/repo/cnosdb.gpg-key.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/cnosdb.gpg > /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/cnosdb.gpg] https://repo.cnosdb.com/repo/deb stable main" | sudo tee /etc/apt/sources.list.d/cnosdb.list > /dev/null

更新并下载软件:

sudo apt-get update & apt-get -y install cnosdb cnosdb-meta

启动单机实例

1. 修改配置

修改 [deployment].modesingleton

[deployment]
mode = "singleton"

2. 启动

systemctl start cnosdb

如果是 Ubuntu 14.04 以及之前的版本 和 Debina 9 之前的版本,使用以下命令启动:

service cnosdb start

启动集群

备注

请将以下记录添加到您的 DNS 解析服务器中,以便于 CnosDB 集群中的实例之间进行通信。必要时需要联系您的网络管理员。

记录类型主机名主机IP
Ameta1.cnosdb.com<meta1_ip>
Ameta2.cnosdb.com<meta2_ip>
Ameta3.cnosdb.com<meta3_ip>
Aquery_tskv1.cnosdb.com<query_tskv1_ip>
Aquery_tskv2.cnosdb.com<query_tskv2_ip>

启动 meta 服务

1. 修改配置

默认配置文件位置:/etc/cnosdb/cnosdb-meta.conf

将添加在 DNS 服务器中的记录添加到配置文件中,将不同记录分配个不同的 meta 服务。

host = meta<n>.cnosdb.com

分配 node_id 给每个 meta 服务,id 不能重复。

id = n

配置完成后的配置文件示例如下:

id = n
host = "meta<n>.cnosdb.com"
port = 8901
... ...

启动服务

systemctl start cnosdb-meta

如果是 Ubuntu 14.04 以及之前的版本 和 Debina 9 之前的版本,使用以下命令启动:

service cnosdb-meta start

初始化 meta 服务

如果您的集群中有多个 meta 服务,只需要在其中一个 meta 服务上执行初始化命令即可。

curl http://meta1.cnosdb.com:8901/init -d '{}'

添加其他 meta 服务实例

curl http://meta1.cnosdb.com:8901/add-learner -H "Content-Type: application/json" -d '[2, "meta2.cnosdb.com:8901"]' | jq
curl http://meta1.cnosdb.com:8901/add-learner -H "Content-Type: application/json" -d '[3, "meta3.cnosdb.com:8901"]' | jq

重置集群成员以使集群生效

执行以下命令可以修改集群成员,如果您的集群中有多个 meta 服务,使用最初执行初始化的节点执行此命令。

curl http://meta1.cnosdb.com:8901/change-membership -H "Content-Type: application/json" -d '[1,2,3]' | jq

查看集群状态

分别指定不同的节点,执行以下命令,查看集群状态。

替换命令中的 <n> 以指定不通的 meta 服务实例。

curl http://meta<n>.cnosdb.com:8901/metrics | jq

如果集群安装成功,则应该返回以下内容:

state 还有可能是 Follower

{
"Ok": {
"running_state": {
"Ok": null
},
"id": 1,
... ...
"state": "Leader",
... ...
}

启动 cnosdb 服务

修改配置文件

cnosdb 服务的配置文件位于 /etc/cnosdb/cnosdb.conf

将添加在 DNS 服务器中的记录添加到配置文件中,将不同记录分配个不同的 cnosdb 服务。

host = "query_tskv<n>.cnosdb.com"

修改 [deployment].modequery_tskv

[deployment]
mode = "query_tskv"

修改 node_idnode_id 不能重复。

[node_basic]
node_id = <n>

修改 meta 服务地址。 [cluster].name 需要与 cnosdb-meta 配置中的[meta_init].cluster_name 相同。

 [cluster]
name = "cluster_xxx"
meta_service_addr = ['meta1.cnosdb.com:8901', 'meta2.cnosdb.com:8901', 'meta3.cnosdb.com:8901']

配置完成后的配置文件示例如下:

 ... ...
host = "query_tskv<n>.cnosdb.com"
[deployment]
mode = 'query_tskv'
... ...
[cluster]
name = 'cluster_xxx'
meta_service_addr = ['meta1.cnosdb.com:8901', 'meta2.cnosdb.com:8901', 'meta3.cnosdb.com:8901']
[node_basic]
node_id = <n>
... ...

启动服务

systemctl start cnosdb

如果是 Ubuntu 14.04 以及之前的版本 和 Debina 9 之前的版本,使用以下命令启动。

service cnosdb start