Logo

oncloud.js-controller

==================

Here you can find change log.

This is a main controller, that starts all other oncloud adapters.

Official Web-Site: http://oncloud.net

Forum: http://forum.oncloud.net

Trello: https://trello.com/b/q0SZKdfW/oncloud-whiteboard

oncloud wiki: https://github.com/oncloud/oncloud/wiki/Home-(English)

Explanation of the concept: https://github.com/oncloud/oncloud

This is a Javascript/Node.js implementation of an oncloud controller.

Manual installation of oncloud.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 oncloud on linux

sudo mkdir /opt/oncloud
sudo cd /opt/oncloud
sudo chmod 777 /opt/oncloud
sudo npm install oncloud --unsafe-perm

After that the oncloud should run and be available in browser under http://<ip>:8081/

Start oncloud controller on linux

run ./oncloud start in the oncloud directory to start the oncloud controller in the background
watch the logfile tail -f log/oncloud.log

run node node_modules/oncloud.js-controller/controller.js to start the oncloud 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 oncloud.

mkdir C:/oncloud cd C:/oncloud
install npm packet from created directory

npm install oncloud

Start oncloud controller on windows

run oncloud start in the oncloud directory to start the oncloud controller in the background console
check the logfile node_modules/oncloud.js-controller/log/oncloud.log

run node node_modules/oncloud.js-controller/controller.js to start the oncloud 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://<oncloud>:8081/ If port 8081 is occupied, you can install second Admin UI on alternate port and change port for first admin UI:

run ./oncloud add admin --enabled --port 8090 and go to the http://<oncloud>: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.

To switch to REDIS write in the console following:

>oncloud stop
>oncloud 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[../../../oncloud-data/]:
Host name of this machine [FastPC]:
creating conf/oncloud.json

Note that in fourth line it was entered redis.

Now oncloud 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)