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. 修改配置

社区版

企业版

修改 license_file 指定正确的文件位置

获取 License 文件，请联系我们

license_file = '/etc/cnosdb/license.json'

修改 [deployment].mode 为 singleton

[deployment]
mode = "singleton"

2. 启动

systemctl start cnosdb

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

service cnosdb start

启动集群

备注

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

记录类型	主机名	主机IP
A	meta1.cnosdb.com	meta1_ip
A	meta2.cnosdb.com	meta2_ip
A	meta3.cnosdb.com	meta3_ip
A	query_tskv1.cnosdb.com	query_tskv1_ip
A	query_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"

社区版

企业版

修改 license_file 指定正确的文件位置

获取 License 文件，请联系我们

license_file = '/etc/cnosdb/license.json'

修改 [deployment].mode 为 query_tskv 。

[deployment]
mode = "query_tskv"

修改 node_id，node_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