[译]How to Setup Sync Gateway on Ubuntu如何在ubuntu上安装sync-gateway

参考文章https://hidekiitakura.com/2015/03/21/how-to-setup-sync-gateway-on-ubuntudigitalocean/
在此对作者表示感谢

最近常在ubuntu上安装couchbase，以及配置couchbase sync gateway于是写下此文，作为安装过程的笔记。

第一步 安装couchbase server3.0.2

1、下载couchbase server

• couchbase server可以从couchbase的官方下载页进行下载（截止2015-3-21）
• 选择couchbase3.0.1企业版，根据系统情况选择相应的版本32位/64位，通过下载按钮获取下载链接，通过执行以下命令将安装文件下载下来。

$ wget http://packages.couchbase.com/releases/3.0.1/couchbase-server-community_3.0.1-ubuntu12.04_amd64.deb

2、安装couchbase server

• 使用root权限通过dpkg命令安装下载软件安装包

$ sudo dpkg -i couchbase-server-community_3.0.1-ubuntu12.04_amd64.deb

3、验证安装结果

在浏览器打开链接地址http://:8091/，可以看到couchbase的欢迎页面

4、配置couchbase

作为一个开放使用的服务器，我才用系统默认设置。对于Per Server RAM Quota:的值，我选择为服务器内存的一半。在本文中，我的服务器内存为256M。尽管这比系统推荐的内存值小很多，但是我认为对于一个开发服务器来说够用了。

5、为sync gateway配置数据采集器

选择顶部菜单栏的Data Bucket选项。因为对默认的Bucket没有使用计划，我删除了default bucket。点击Create New Data Bucket按钮创建新的bucket，名字为sync_gateway，Per Node RAM Quota的值为256MB。

第二步 安装couchbase sync Gateway

1、下载couchbase sync Gateway 软件安装包

同样，我们在couchbase 的官方下载页面下载sync Gateway。你可以在couchbase mobile标签页中找到sync Gateway的下载链接。目前的最新版本是1.0.3，你可以根据系统的配置选择32位/64位。根据我的测试，如果我通过wget命令将安装包直接下载至ubuntu服务器，安装会失败。我选择将安装包通过浏览器下载至本地，然后在拷贝至Ununtu服务器中。

2、安装sync Gateway

同安装couchbase一样，使用root权限通过dpkg命令来安装

$ sudo dpkg -i couchbase-sync-gateway-community_1.0.3_x86_64.deb

3、配置sync Gateway

此处是一个默认的配置文件，如果需要请查看。默认配置不允许gust用户进行连接，于是我使用以下配置文件，与默认配置不同的是，我修改了用户授权的设置。关于用户授权的说明，可以查看官方文档。以下代码保存在config.json中，存放在sync-gateway的安装路径下，通常为/opt/couchbase-sync-gateway/bin/sync_gateway

{
   "interface":":4984",
   "adminInterface":":4985",
   "log":["REST"],
   "databases":{
      "sync_gateway":{
         "users": {"GUEST": {"disabled": false, "all_channels": ["*"], "admin_channels": ["*"]}},
         "server":"http://localhost:8091",
         "bucket":"sync_gateway",
         "sync":`function(doc) {channel(doc.channels);}`
      }
   }
}

4、启动sync-gateway

使用以下命令来启用sync-gateway

/opt/couchbase-sync-gateway/bin/sync_gateway ./config.j

启动后，屏幕上会输出以下内容：

$ /opt/couchbase-sync-gateway/bin/sync_gateway ./config.json 
20:03:14.925870 Enabling logging: [REST]
20:03:14.926411 ==== Couchbase Sync Gateway/1.0.3(81;fa9a6e7) ====
20:03:14.926520 Opening db /sync_gateway as bucket "sync_gateway", pool "default", server <http://localhost:8091>
20:03:14.926674 Opening Couchbase database sync_gateway on <http://localhost:8091>
20:03:15.182813     Reset guest user to config
20:03:15.182843 Starting admin server on :4985
20:03:15.192678 Starting server on :4984 ...

5、确认sync-Gateway运行正常

我们可以在浏览器中访问连接：http://<IP address of Ubuntu server>:4984/来确保同步端口正常工作。顺利的话，你会在打开的页面看到Couchbase Sync Gateway的欢迎页面。

{
   "couchdb":"Welcome",
   "vendor":{"name":"Couchbase Sync Gateway","version":1},
   "version":"Couchbase Sync Gateway/1.0.3(81;fa9a6e7)"
}

如果需要配置和管理端口，可以在浏览器中访问链接http://<IP address of Ubuntu server>:4985/_admin/可进入sync-Gateway的管理界面。