跳转到主要内容

KogniHome项目的接口服务器

项目描述

一个使用Web应用程序消息协议(WAMP)和机器人服务总线(RSB)构建的网络之间网关,基于crossbar。WAMP由autobahn提供。该软件是KogniHome项目KogniHome的一部分。

安装

KogniServer可以通过pip获得

$ pip install kogniserver

或从github克隆并安装

$ git clone https://github.com/aleneum/kogniserver.git
$ cd kogniserver
$ python setup.py install (--prefix=/install/path/prefix)
$ # python setup.py install --prefix=/usr/local

/install/path应该是您首选环境的根目录,并将与'lib/python2.7/site-packages'连接。确保/install/path/lib/python2.7/site-packages在您的PYTHONPATH中。

配置和启动

要配置crossbar,您需要创建一个config.json文件,并告诉crossbar在哪里可以找到它。kogniserver将在找不到文件时帮助您创建一个文件。

$ kogniserver 
config.json for crossbar does not exists. Should a default one be created? [y]/n:y
Location of proto-files? [/usr/local/share/rst0.12/proto]:/usr/local/share/rst0.12/proto/
No Crossbar.io instance is currently running from node directory /home/foobar/kogniserver.
...

这将在/install/path/etc/crossbar/config.json(例如,/usr/local/etc...)创建一个通用的config.json文件。如果您想使用现有的config.json,可以使用-c选项

$ kogniserver -c /path/to/your/crossbar/config.json
...

要覆盖/install/path/etc/crossbar/config.json中的现有config.json,使用-f选项启动kogniserver

$ kogniserver -f
Location of proto-files? [/usr/local/share/rst0.12/proto]:
...

或者您可以单独启动crossbar和kogniserver。首先启动一个crossbar实例

$ crossbar start --config=/path/to/config.json

之后,您可以初始化kogniserver

$ kogniserver -k # --keep-alive; use existing crossbar instance
kogniserver(asyncio) started...

使用 --keep-alive 标志将通知 kogniserver 使用正在运行的实例。如果未传递该标志,kogniserver 将尝试关闭此实例并启动一个新的实例。

如果您使用标准配置,文件将托管在 /install/path/var/www/kogniserver,可以通过 https://:8181 访问。

Ctrl+C 或发送 SIGTERM 信号将退出服务器。

接下来做什么?

如果您打算用 JavaScript 编写应用程序,请访问 KogniJS-Framework

致谢

本软件的开发得到了 KogniHome 项目资助的支持,该项目由德国联邦教育与研究部(BMBF)资助,项目编号为 16SV7054K,在比勒费尔德大学进行。

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面