riak资料汇编

一、上手

各个操作系统平台上的安装说明： Installation

新手可以先看 riak快速教程上手。


二、探索

然后，可以从riak的doc目录下的文档开始探索

0. 基本架构说明： architecture

1. 系统配置指导： basic-setup
riak系统的配置包括对erlang虚拟机运行参数的配置和对riak系统运行时的配置，分别对应着etc目录下的vm.args和app.config两个配置文件，关于这两个配置文件更详细的说明见 Configuration Files

理解riak系统的这些参数需要对riak的一些基本概念有所了解：从这里开始了解 riak基本概念

2. 客户端使用指导： riak client

3. 系统的运行管理指导： riak admin

4. riak HTTP接口使用说明： riak HTTP


三、常用API

• riak_core:vnode_modules()  查询安装的vnode模块
• riak_core_ring_manager:get_raw_ring() 获取整个ring环，包括partition及其节点
• riak_core_apl:get_apl(HashKey,  N, Service) 得到HashKey对应的Preference List
• riak_core_ring:preflist(HashKey, Ring) 得到HashKey在环Ring上的Preference List

四、FAQ

日常工作时有可能会遇到一些问题，可能别人也遇到过，比如想知道riak reboot和riak restart有什么区别、对某个配置有疑问，又或者运行中出现问题了，看 这里：Operations。边栏分类很清楚，许多问题都可以在这里找到，可以作为riak日常使用操作手册。


如果遇到不常见的问题，大部分可能会问道的问题别人可能已经问过了。当然一般是google之，不过bash也提供了一个 搜索引擎，它会搜索basho blog、wiki，以及riak邮件列表等相关资源，这样绝大多数问题都可以直接搜到。如果搜不到，那就只好直接向riak邮件列表提问了，该邮件列表非常活跃，相信会找到答案。


其它
此外，可以安装riak的常用命令手册（manual），以后可以用man察看riak，riak-admin和search-cmd三个命令了。

sudo cp <riak_home>/doc/man/man1/* /usr/share/man/man1

在 Unix 中，对不清楚的bash命令，可通过 man 指令即时查询这些 Manpages 以获取帮助。这里有个设置彩色版本的 Manpages的方法，读起来令人感觉更加醒目。不过对复杂的命令更有效：
color man