#+SETUPFILE: "doc/basho-doc-style.iorg"
Welcome to Riak.
* Overview
综述
Riak is a distributed, decentralized data storage system.
Riak 是一个分布式的 分散数据的存储系统。
Below, you will find the "quick start" directions for setting up and
接下来，你将发现设置和使用Riak“快速开始”的说明
using Riak. For more information, browse the following files:
对于更多的信息，浏览下面的文件：
- README: this file
README：本文件
- LICENSE: the license under which Riak is released
许可：Riak遵循这个协议
- doc/
- admin.org: Riak Administration Guide
- admin.org:Riak 管理指南
- architecture.txt: details about the underlying design of Riak
- architecture.txt: 详细的介绍了Riak底层设计
- basic-client.txt: slightly more detail on using Riak
- basic-client.txt：客户简单使用Riak的介绍
- basic-setup.txt: slightly more detail on setting up Riak
- basic-setup.txt: 配置Riak的简单介绍
- man/riak.1.gz: manual page for the riak(1) command
- man/riak.1.gz:riak(1)命令的使用手册页面
- man/riak-admin.1.gz manual page for the riak-admin(1) command
- man/riak-admin.1.gz riak-admin(1) 命令使用手册
- raw-http-howto.txt: using the Riak HTTP interface
- raw-http-howto.txt: 使用Riak的http接口
* Where to find more
去哪发现更多
Below, you'll find a basic introduction to starting and using Riak as
接下来，你将发现开始和何用Riak作为键/值存储的入门介绍
a key/value store. For more information about Riak's extended feature
想要获取关于Riak的拓展特性包括 MapReduce，查找，次要索引，多样存储策略，等等
set, including MapReduce, Search, Secondary Indexes, various storage
strategies, and more, please visit our docs at http://docs.basho.com/.
请浏览我们在http://docs.basho.com/ 上的文档
* Quick Start
This section assumes that you have copy of the Riak source tree. To get
这部分假设你已经有了Riak原树的备份。想要开始，你需要
started, you need to:
1. Build Riak
建设 Riak
2. Start the Riak server
启动Riak服务
3. Connect a client and store/fetch data
连接一个客户端 和存储和取数据
** Building Riak
建设Riak
Assuming you have a working Erlang (R14B02 or later) installation,
假设你有一个Erlang(R14B02或更高版本)的安装工作,
building Riak should be as simple as:
#+BEGIN_EXAMPLE
$ cd $RIAK
$ make rel
#+END_EXAMPLE
** Starting Riak
Once you have successfully built Riak, you can start the server with the
following commands:
#+BEGIN_EXAMPLE
$ cd $RIAK/rel/riak
$ bin/riak start
#+END_EXAMPLE
Now, verify that the server started up cleanly and is working:
现在，验证服务已经成功启动并正在运行
: $ bin/riak-admin test
Note that the $RIAK/rel/riak directory is a complete, self-contained instance
注意：$RIAK/rel/riak目录 是一个 完成的自主独立的Riak and Erlang实例
of Riak and Erlang. It is strongly suggested that you move this directory
如果你计划运行一个生产实例,强烈建议将这个目录移动到源代码目录之外.
outside the source tree if you plan to run a production instance.
** Connecting a client to Riak
为Riak连接一个客户端
Now that you have a functional server, let's try storing some data in
现在你已经有了一个可以提供功能的服务，让我们试着在它里面存储一些数据。
it. First, start up a erlang node using our embedded version of erlang:
首先，用我们嵌入式版本erlang启动一个erlang节点
#+BEGIN_EXAMPLE
$ erts-<vsn>/bin/erl -name [email protected] -setcookie riak
Eshell V5.7.4 (abort with ^G)
([email protected])1>
#+END_EXAMPLE
Now construct the node name of Riak server and make sure we can talk to it:
现在构造一个Riak server节点 并确保我们能够跟它进行会话。
#+BEGIN_EXAMPLE
([email protected])4> RiakNode = '[email protected]'.
([email protected])2> net_adm:ping(RiakNode).
pong
([email protected])2>
#+END_EXAMPLE
We are now ready to start the Riak client:
现在我们已经启动了一个Riak客户端
#+BEGIN_EXAMPLE
([email protected])2> {ok, C} = riak:client_connect(RiakNode).
{ok,{riak_client,'[email protected]',<<4,136,81,151>>}}
#+END_EXAMPLE
Let's create a shopping list for bread at /groceries/mine:
让我们创建一个面包的购物列表在/groceries/mine:
#+BEGIN_EXAMPLE
([email protected])6> O0 = riak_object:new(<<"groceries">>, <<"mine">>, ["bread"]).
O0 = riak_object:new(<<"groceries">>, <<"mine">>, ["bread"]).
{r_object,<<"groceries">>,<<"mine">>,
[{r_content,{dict,0,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],[],[],[],[],[],[],...}}},
["bread"]}],
[],
{dict,1,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],[],[],[],[],[],[],[],...}}},
undefined}
([email protected])3> C:put(O0, 1).
#+END_EXAMPLE
Now, read the list back from the Riak server and extract the value
现在，从Riak服务上这个列表，并提取这些值
#+BEGIN_EXAMPLE
([email protected])4> {ok, O1} = C:get(<<"groceries">>, <<"mine">>, 1).
{ok,{r_object,<<"groceries">>,<<"mine">>,
[{r_content,{dict,2,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],
[["X-Riak-Last-Modified",87|...]],
[],[],[],...}}},
["bread"]}],
[{"[email protected]@127.0.0.1-266664",
{1,63415509105}}],
{dict,0,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],[],[],[],[],[],...}}},
undefined}}
([email protected])5> %% extract the value
([email protected])5> V = riak_object:get_value(O1).
["bread"]
#+END_EXAMPLE
Add milk to our list of groceries and write the new value to Riak:
添加牛奶到我们的食品列表并向Riak写入新值：
#+BEGIN_EXAMPLE
([email protected])6> %% add milk to the list
([email protected])6> O2 = riak_object:update_value(O1, ["milk" | V]).
{r_object,<<"groceries">>,<<"mine">>,
[{r_content,{dict,2,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],
[["X-Riak-Last-Modified",87,101,100|...]],
[],[],[],[],[],...}}},
["bread"]}],
[{"[email protected]@127.0.0.1-266664",
{1,63415509105}}],
{dict,0,16,16,8,80,48,
{[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],...},
{{[],[],[],[],[],[],[],[],[],[],[],[],[],...}}},
["milk","bread"]}
([email protected])7> %% store the new list
([email protected])7> C:put(O2, 1).
ok
#+END_EXAMPLE
Finally, see what other keys are available in groceries bucket:
最后，看在食品桶中什么键值是可用的
#+BEGIN_EXAMPLE
([email protected])8> C:list_keys(<<"groceries">>).
{ok,[<<"mine">>]}
#+END_EXAMPLE
** Clients for Other Languages
其他语言的客户端
Client libraries are available for many languages. Rather than
客户端库对于很多语言都是可用的。
bundle them with the Riak server source code, we have given them
而不是受它服务端的源代码所限制，我们给了他们自己的源库。
each their own source repository. Currently, official Riak
目前官方的Riak客户端语言库包含
client language libraries include:
+ Javascript
https://github.com/basho/riak-javascript-client
+ Python
https://github.com/basho/riak-python-client
+ Ruby
https://github.com/basho/riak-ruby-client
+ Java
https://github.com/basho/riak-java-client
+ PHP
https://github.com/basho/riak-php-client
+ Erlang
https://github.com/basho/riak-erlang-client
(using protocol buffers instead of distributed Erlang)
* Server Management
服务管理
** Configuration
配置
Configuration for the Riak server is stored in $RIAK/rel/riak/etc
Riak服务的配置存放在$RIAK/rel/riak/etc目录
directory. There are two files:
是两个文件
- vm.args
This file contains the arguments that are passed to the Erlang VM
这个文件包含参数被传到运行Riak服务的Erlang虚拟机
in which Riak runs. The default settings in this file shouldn't need to be
在大多数环境中这个文件配置的默认参数不应该被修改
changed for most environments.
- app.config
This file contains the configuration for the Erlang applications
that run on the Riak server.
这个文件包含的配置是为了运行Riak服务上的Erlang应用
More information about this files is available in doc/basic-setup.txt.
关于这些配置文件的更多信息在doc/basic-setup.txt中
** Server Control
服务控制
*** bin/riak
This script is the primary interface for starting and stopping the Riak
这些脚本是启动和停止Riak服务的初级接口
server.
To start a daemonized (background) instance of Riak:
想要后台启动Riak实例
: $ bin/riak start
Once a server is running in the background you can attach to the Erlang
console via:
Riak服务一旦后台运行后，你可以通过
: $ bin/riak attach
Alternatively, if you want to run a foreground instance of Riak, start it
或者，如果你想前台运行Riak实例，这样启动：
with:
: $ bin/riak console
Stopping a foreground or background instance of Riak can be done from a
停止一个前台或者后台的Riak实例，可以通过一个这个shell命令
shell prompt via:
: $ bin/riak stop
Or if you are attached/on the Erlang console:
或者，你是通过attached执行
: ([email protected])1> q().
You can determine if the server is running by:
你可以通过这样判断服务是否启动
: $ bin/riak ping
*** bin/riak-admin
This script provides access to general administration of the Riak server.
提供访问Riak服务的管理总处的脚本
The below commands assume you are running a default configuration for
下面的命令假定你运行了一个默认配置的（Riak服务）
parameters such as cookie.
To join a new Riak node to an existing cluster:
想向一个已经存在簇中添加一个新的Riak节点
#+BEGIN_EXAMPLE
$ bin/riak start # If a local server is not already running
$ bin/riak-admin join <node in cluster>
#+END_EXAMPLE
(Note that you must have a local node already running for this to work)
（注意:确保本地节点已经已经运行）
To verify that the local Riak node is able to read/write data:
想要确保你本地的Riak节点可以被读/写
: $ bin/riak-admin test
To backup a node or cluster run the following:
想备份一个节点或者一个簇
: $ bin/riak-admin backup [email protected] riak <directory/backup_file> node
: $ bin/riak-admin backup [email protected] riak <directory/backup_file> all
Restores can function in two ways, if the backup file was of a node the
可以通过两种方法恢复数据，如果备份文件是一个节点，这个节点想要恢复。
node will be restored and if the backup file contains the data for a
和如果这个备份文件包含整个簇的数据，并且想要恢复整个簇的数据
cluster all nodes in the cluster will be restored.
To restore from a backup file:
通过备份文件恢复数据
: $ riak-admin restore [email protected] riak <directory/backup_file>
To view the status of a node:
浏览节点状态
: $ bin/riak-admin status
If you change the IP or node name you will need to use the reip command:
如果你向改变IP或者是节点名称，你需要用reip命令
: $ bin/riak-admin reip <old_nodename> <new_nodename>
* Contributing to Riak and Reporting Bugs
向Riak做贡献，这个提交一个bug（这部分就翻译了）
Basho encourages contributions to Riak from the community. Here's how to get started.
- Fork the appropriate sub-projects that are affected by your
change. Fork this repository if your changes are for release
generation or packaging.
- Make your changes and run the test suite. (see below)
- Commit your changes and push them to your fork.
- Open pull-requests for the appropriate projects.
- Basho engineers will review your pull-request, suggest changes,
and merge it when it's ready and/or offer feedback.
To report a bug or issue, please open a [[https://github.com/basho/riak/issues][new issue]] against this repository.
You can read the [[http://docs.basho.com/riak/latest/references/appendices/community/How-to-Report-a-Bug/][full guidelines for bug reporting and code contributions]] on the Riak Docs.
** Testing
To make sure your patch works, be sure to run the test suite in each
modified sub-project, and dialyzer from the top-level project to
detect static code errors.
To run the QuickCheck properties included in Riak sub-projects,
download QuickCheck Mini: http://quviq.com/downloads.htm NOTE: Some
properties that require features in the Full version will fail.
*** Running unit tests
The unit tests for each subproject can be run with =make= or
=rebar= like so:
#+BEGIN_SRC shell
make eunit
#+END_SRC
#+BEGIN_SRC shell
./rebar skip_deps=true eunit
#+END_SRC
*** Running dialyzer
Dialyzer performs static analysis of the code to discover defects,
edge-cases and discrepancies between type specifications and the
actual implementation.
Dialyzer requires a pre-built code analysis table called a PLT.
Building a PLT is expensive and can take up to 30 minutes on some
machines. Once built, you generally want to avoid clearing or
rebuilding the PLT unless you have had significant changes in your
build (a new version of Erlang, for example).
**** Build the PLT
Run the command below to build the PLT.
#+BEGIN_SRC shell
make build_plt
#+END_SRC
**** Check the PLT
If you have built the PLT before, check it before you run
Dialyzer again. This will take much less time than building the
PLT from scratch.
#+BEGIN_SRC shell
make check_plt
#+END_SRC
**** Run Dialyzer
#+BEGIN_SRC shell
make dialyzer
#+END_SRC
RIAK1.4.2 ReadMe文档翻译
猜你喜欢
转载自l810102251.iteye.com/blog/2166213
今日推荐
周排行