136 lines
5.0 KiB
Markdown
136 lines
5.0 KiB
Markdown
|
|
|||
|
|
# yunkong2.js-controller
|
|||
|
|
==================
|
|||
|
|
|
|||
|
|
[](https://www.npmjs.com/package/yunkong2.js-controller)
|
|||
|
|
[](https://www.npmjs.com/package/yunkong2.js-controller)
|
|||
|
|
[](https://travis-ci.org/yunkong2/yunkong2.js-controller)
|
|||
|
|
|
|||
|
|
[](https://nodei.co/npm/yunkong2.js-controller/)
|
|||
|
|
|
|||
|
|
Here you can find change [log](CHANGELOG.md).
|
|||
|
|
|
|||
|
|
This is a main controller, that starts all other yunkong2 adapters.
|
|||
|
|
|
|||
|
|
Official Web-Site: http://yunkong2.net
|
|||
|
|
|
|||
|
|
Forum: http://forum.yunkong2.net
|
|||
|
|
|
|||
|
|
Trello: https://trello.com/b/q0SZKdfW/yunkong2-whiteboard
|
|||
|
|
|
|||
|
|
yunkong2 wiki: https://github.com/yunkong2/yunkong2/wiki/Home-(English)
|
|||
|
|
|
|||
|
|
Explanation of the concept: https://github.com/yunkong2/yunkong2
|
|||
|
|
|
|||
|
|
----------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
This is a Javascript/Node.js implementation of an yunkong2 controller.
|
|||
|
|
|
|||
|
|
## Manual installation of yunkong2.js-controller on Debian based Linux (Raspbian, Ubuntu, ...)
|
|||
|
|
|
|||
|
|
### Install Node.js
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
sudo apt-get update
|
|||
|
|
sudo apt-get upgrade
|
|||
|
|
sudo apt-get install curl build-essential
|
|||
|
|
sudo curl -sL https://deb.nodesource.com/setup_6.x | sudo bash -
|
|||
|
|
sudo apt-get install -y nodejs
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Install yunkong2 on linux
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
sudo mkdir /opt/yunkong2
|
|||
|
|
sudo cd /opt/yunkong2
|
|||
|
|
sudo chmod 777 /opt/yunkong2
|
|||
|
|
sudo npm install yunkong2 --unsafe-perm
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
After that the yunkong2 should run and be available in browser under ```http://<ip>:8081/```
|
|||
|
|
|
|||
|
|
### Start yunkong2 controller on linux
|
|||
|
|
|
|||
|
|
* run ```./yunkong2 start``` in the yunkong2 directory to start the yunkong2 controller in the background
|
|||
|
|
* watch the logfile ```tail -f log/yunkong2.log```
|
|||
|
|
|
|||
|
|
or
|
|||
|
|
|
|||
|
|
* run ```node node_modules/yunkong2.js-controller/controller.js``` to start the yunkong2 controller in foreground and watch the log on console
|
|||
|
|
|
|||
|
|
### Install js-controller on windows
|
|||
|
|
|
|||
|
|
* Create and change to the directory under which you want to install yunkong2.
|
|||
|
|
|
|||
|
|
```mkdir C:/yunkong2```
|
|||
|
|
```cd C:/yunkong2```
|
|||
|
|
|
|||
|
|
* install npm packet from created directory
|
|||
|
|
|
|||
|
|
```npm install yunkong2```
|
|||
|
|
|
|||
|
|
### Start yunkong2 controller on windows
|
|||
|
|
|
|||
|
|
* run ```yunkong2 start``` in the yunkong2 directory to start the yunkong2 controller in the background console
|
|||
|
|
* check the logfile ```node_modules/yunkong2.js-controller/log/yunkong2.log```
|
|||
|
|
|
|||
|
|
or
|
|||
|
|
|
|||
|
|
* run ```node node_modules/yunkong2.js-controller/controller.js``` to start the yunkong2 controller in foreground and watch the log on console
|
|||
|
|
|
|||
|
|
### Admin UI
|
|||
|
|
|
|||
|
|
The admin adapter starts a web-server that hosts the Admin UI. Default port is 8081, so just open http://<yunkong2>:8081/
|
|||
|
|
If port 8081 is occupied, you can install second Admin UI on alternate port and change port for first admin UI:
|
|||
|
|
|
|||
|
|
* run ```./yunkong2 add admin --enabled --port 8090``` and go to the http://<yunkong2>:8090/. Of course you can change port 8090 to other one.
|
|||
|
|
|
|||
|
|
## Using REDIS as States-DB
|
|||
|
|
There is a possibility to use REDIS as states database. It is reasonable to do that for big installations or for systems with performance problems.
|
|||
|
|
It is possible to switch anytime between REDIS and In-Memory Javascript DB. The only problem, that all states must be updated by adapters again (values will be lost).
|
|||
|
|
Objects and configuration are not affected.
|
|||
|
|
|
|||
|
|
To install REDIS on linux/debuan just write: ```apt-get install redis-server``` .
|
|||
|
|
|
|||
|
|
If you plan to use mulithost installation you must allow connections to redis from any address (default only 127.0.0.1).
|
|||
|
|
To do that edit file */etc/redis/redis.conf* (```sudo nano /etc/redis/redis.conf```) and replace ```bind 127.0.0.1``` with ```bind 0.0.0.0``` .
|
|||
|
|
Don't forget to restart redis after that. (```sudo /etc/init.d/redis-server restart```)
|
|||
|
|
|
|||
|
|
To install on windows download latest release here [https://github.com/MSOpenTech/redis/releases](https://github.com/MSOpenTech/redis/releases).
|
|||
|
|
|
|||
|
|
To switch to REDIS write in the console following:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
>yunkong2 stop
|
|||
|
|
>yunkong2 setup custom
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
And then:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Type of objects DB [file, couch, redis], default [file]:
|
|||
|
|
Host of objects DB(file), default[127.0.0.1]:
|
|||
|
|
Port of objects DB(file), default[9001]:
|
|||
|
|
Type of states DB [file, redis], default [file]: redis
|
|||
|
|
Host of states DB (redis), default[127.0.0.1]:
|
|||
|
|
Port of states DB (redis), default[6379]:
|
|||
|
|
Data directory (file), default[../../../yunkong2-data/]:
|
|||
|
|
Host name of this machine [FastPC]:
|
|||
|
|
creating conf/yunkong2.json
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Note that in fourth line it was entered **redis**.
|
|||
|
|
|
|||
|
|
Now yunkong2 can be started.
|
|||
|
|
Of course redis must be first installed and firewall rules must be checked.
|
|||
|
|
|
|||
|
|
To switch back to JS States write the same commands again, just instead of **redis** in fourth line write nothing and press ENTER.
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
The MIT License (MIT)
|
|||
|
|
|
|||
|
|
Copyright (c) 2014-2018 bluefox <dogafox@gmail.com>,
|
|||
|
|
|
|||
|
|
Copyright (c) 2014 hobbyquaker
|