参考文章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的管理界面。