post

SSDB 安装部署及注意事项大全

SSDB 是一个 C/C++ 语言开发的高性能 NoSQL 数据库, 支支持 Key-value, Key-hashmap, Key-zset(sorted set) 等数据结构, 十分适合存储数亿条级别的列表, 排序表等集合数据, 是 Redis 的替代和增强方案。

SSDB 具有和 Redis 相似的 API, 支支持的客户端包括: PHP, C++, Python, Java, Lua, Ruby,Nodejs, etc。

SSDB 是稳定的, 生产环境使用的, 已经在许多互联网公司得到广泛使用, 如 360、TOPGAME。

前言:

本文是将我安装和测试的步骤记录下来,总结了 ideawu 的文档,便于日后使用。

SSDB 的配置文件使用一个 TAB 表示缩进,不可用空格,一个都不行!默认配置参考:ssdb.conf。

SSDB 支持主主、主从的部署,启动后台线程后,从库会毫秒级的同步主库的数据。

我的 SSDB 安装包路径为:/export/servers/ssdb-master
我的 SSDB 工作目录为:/usr/local/ssdb

下载和安装:

$ wget --no-check-certificate https://github.com/ideawu/ssdb/archive/master.zip
$ unzip master
$ cd ssdb-master
$ make
$ # 将安装在 /usr/local/ssdb 目录下 或者指定目录 make install PREFIX=/home/servers/ssdb
$ sudo make install

#以默认环境配置为例:
$ cd /usr/local/ssdb

# 启动主库,也可以自定义配置文件,启动多实例
$ ./ssdb-server ssdb.conf

# 启动、停止、重新启动
# $ ./ssdb-ins.sh start/stop/restart ssdb.conf 

# 启动为后台进程
$ ./ssdb-server -d ssdb.conf

# 启动 ssdb 命令行,在安装包路径下,8889 为主库的端口
$ /export/servers/ssdb-master/tools/ssdb-cli -p 8889
# 连接远程 SSDB 服务的命令行
# $ /export/servers/ssdb-master/tools/ssdb-cli -h 192.168.1.1 -p 8889 

# 停止 ssdb-server,默认都需要手动停止 SSDB 服务
$ kill `cat ./var/ssdb.pid`
# 或者先找到当前 SSDB 进程的 pid,然后绝杀
# $ ps -ef|grep 'ssdb'
# $ kill -9 6912
SSDB 安装

SSDB 安装示例图

安装包介绍:

SSDB 工作默认目录:/usr/local/ssdb
配置文件:/usr/local/ssdb/ssdb.conf
数据及实例配置:/usr/local/ssdb/var/
开机启动命令:/etc/init.d/ssdb.sh
开机自启动权限:chmod ugo+x /etc/init.d/ssdb.sh
默认端口:8888

SSDB 启动脚本(随操作系统自启动):

到目前为止, 你需要手动管理 ssdb-server 进程, 如果你希望在操作系统启动和停止时自动地管理, 请按下面的说明进行。

假设你已经安装 SSDB 在默认的 /usr/local/ssdb 目录, 把安装包下的 tools/ssdb.sh 脚本放到 /etc/init.d 目录下。

/etc/init.d/ssdb.sh 中的 /data/ssdb_data/test/ssdb.conf 修改为你的 SSDB 配置文件的路径,如果你有多个 SSDB 实例, 那么把它们写在一行, 用空格来分隔:

# each config file for one instance
configs=/data/ssdb_data/test/ssdb.conf /data/ssdb_data/demo/ssdb.conf

主主、主从配置:

当前实例的服务端口配置

server:
	#ip: 127.0.0.1
	port: 8888
	# bind to public ip
	ip: 0.0.0.0
	# format: allow|deny: all|ip_prefix
	# multiple allows or denys is supported
	#deny: all
	#allow: 127.0.0.1
	#allow: 192.168

主从
下面以主库 ip :192.168.1.1 为例介绍
#server 1(主)

replication:
	slaveof:

#server 2(从)

replication:
	slaveof:
		id: svc_1
		# sync|mirror, default is sync
		type: sync
		ip: 192.168.1.1
		port: 8888

主-主(双主)
下面以主库 ip :192.168.1.1/192.168.1.2 为例介绍
#server 1

replication:
	slaveof:
		id: svc_2
		# sync|mirror, default is sync
		type: mirror
		ip: 192.168.1.1
		port: 8889

#server 2

replication:
	slaveof:
		id: svc_1
		# sync|mirror, default is sync
		type: mirror
		ip: 192.168.1.2
		port: 8888

注意:

1、如果出现宕机、掉电、kernel panic 等系统故障,需要手动删除 SSDB 的PID文件,如果将 tools/ssdb.sh 放到 /etc/init.d/ 重启后自动删除pid;
2、默认配置的日志文件按体积分隔,需要编写自己的 crontab 进行日志压缩和定期清理;
3、配置的 ip 最好是 0.0.0.0,外部可以访问,如果是 127.0.0.1 只能本机访问。

使用 SSDB 命令行客户端(ssdb-cli)

SSDB 的命令行行客户端 ssdb-cli 可用用于日日常管理, 包括查看 SSDB 的运行行状态(info), 还能做一些 API 没有的操作, 如清空整个数据库。

1、运行行 ssdb-cli

# 连接到 127.0.0.1:8888,
$ /usr/local/ssdb/ssdb-cli -h 127.0.0.1 -p 8888

你可以输入入字母母 h, 然后按回⻋车查看帮助信息。

2、进行行 KV 操作

ssdb 127.0.0.1:8888>get key
ssdb 127.0.0.1:8888>set key 1
ssdb 127.0.0.1:8888>del key

3、进行行 hashmap 操作

ssdb 127.0.0.1:8888> hsize h
ssdb 127.0.0.1:8888> hset h k1 vb
ssdb 127.0.0.1:8888> hset h k2 va
ssdb 127.0.0.1:8888> hset h k3 vc
ssdb 127.0.0.1:8888> hscan h "" "" 10
ssdb 127.0.0.1:8888> hclear h

4、进行行 zset 操作

ssdb 127.0.0.1:8888> zsize z
ssdb 127.0.0.1:8888> zset z k1 2
ssdb 127.0.0.1:8888> zset z k2 0
ssdb 127.0.0.1:8888> zset z k3 1
ssdb 127.0.0.1:8888> zscan z "" "" "" 10
ssdb 127.0.0.1:8888> zclear z

相关链接:

SSDB 项目主页和源码下载:https://github.com/ideawu/ssdb
SSDB 作者的网站:http://www.ideawu.net/blog/
SSDB API 文档:http://www.ideawu.com/ssdb/docs/zh_cn/php/
Redis:http://redis.io/
LevelDB 项目主页:https://code.google.com/p/leveldb/

· 3,150 次浏览