riak资料汇编

[size=x-large]一、上手[/size]

各个操作系统平台上的安装说明：[url=http://wiki.basho.com/Installation.html]Installation[/url]

新手可以先看[url=http://wiki.basho.com/The-Riak-Fast-Track.html]riak快速教程[/url]上手。


[size=x-large]二、探索[/size]

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

0. 基本架构说明：[url=https://github.com/basho/riak/blob/master/doc/architecture.txt]architecture[/url]

1. 系统配置指导： [url=https://github.com/basho/riak/blob/master/doc/basic-setup.txt]basic-setup[/url]
riak系统的配置包括对erlang虚拟机运行参数的配置和对riak系统运行时的配置，分别对应着etc目录下的vm.args和app.config两个配置文件，关于这两个配置文件更详细的说明见[url=http://wiki.basho.com/Configuration-Files.html]Configuration Files[/url]

理解riak系统的这些参数需要对riak的一些基本概念有所了解：从这里开始了解[url=http://wiki.basho.com/Concepts.html]riak基本概念[/url]

2. 客户端使用指导： [url=https://github.com/basho/riak/blob/master/doc/basic-client.txt]riak client[/url]

3. 系统的运行管理指导：[url=https://github.com/basho/riak/blob/master/doc/admin.org]riak admin[/url]

4. riak HTTP接口使用说明： [url=https://github.com/basho/riak/blob/master/doc/raw-http-howto.txt]riak HTTP[/url]


[size=x-large]三、常用API[/size]
[list]
[*]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
[*]
[/list]
[size=x-large]四、FAQ[/size]

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


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


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

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

在 Unix 中，对不清楚的bash命令，可通过 man 指令即时查询这些 Manpages 以获取帮助。这里有个设置彩色版本的 Manpages的方法，读起来令人感觉更加醒目。不过对复杂的命令更有效：
[url=http://linuxtoy.org/archives/colored-manpages.html]color man[/url]