1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 11:42:08 +00:00
iiab/roles/nodered/README.rst

38 lines
2.3 KiB
ReStructuredText
Raw Normal View History

2019-01-16 06:53:11 +00:00
===============
Node-RED README
===============
2019-01-16 18:08:15 +00:00
Adds `Node-RED <https://nodered.org/>`_ and `Node-RED Dashboard <https://flows.nodered.org/node/node-red-dashboard>`_ to Internet-in-a-Box (IIAB) for electronics projects and educational experiments with `IoT <https://en.wikipedia.org/wiki/Internet_of_things>`_.
2019-01-15 17:58:23 +00:00
2019-01-15 21:24:46 +00:00
Node-RED is a flow-based development tool for visual programming developed originally by IBM for wiring together hardware devices, APIs and online services as part of the Internet of Things. Node-RED provides a web browser-based flow editor, which can be used to create JavaScript functions.
2019-01-16 06:53:11 +00:00
Using It
--------
Prior to installing IIAB, make sure your `/etc/iiab/local_vars.yml <http://wiki.laptop.org/go/IIAB/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F>`_ contains::
2019-01-16 06:41:29 +00:00
nodered_install: True
nodered_enabled: True
2019-02-24 20:57:17 +00:00
After installing Node-RED as part IIAB, please log in to http://box/nodered or http://box:1880/nodered with:
2019-01-16 06:41:29 +00:00
2019-01-16 06:53:11 +00:00
Username: ``Admin``
Password: ``changeme``
2019-10-07 01:59:31 +00:00
To change this password, please see: `roles/nodered/defaults/main.yml <defaults/main.yml#L12-L27>`_
2019-02-13 08:43:23 +00:00
2019-01-16 07:22:54 +00:00
You can monitor the Node-RED service with command::
2019-02-13 08:43:23 +00:00
systemctl status nodered
2019-01-16 07:22:54 +00:00
2019-02-13 03:06:34 +00:00
Raspberry Pi Zero W Warning
---------------------------
2020-06-07 04:21:26 +00:00
Node.js applications like Asterisk/FreePBX, Node-RED and Sugarizer won't work on Raspberry Pi Zero W (ARMv6) if you installed Node.js while on RPi 3, 3 B+ (ARMv7) or RPi 4 (ARMv8). If necessary, run ``apt remove nodejs`` or ``apt purge nodejs`` then ``rm /etc/apt/sources.list.d/nodesource.list; apt update`` then (`attempt! <https://nodered.org/docs/hardware/raspberrypi#swapping-sd-cards>`_) to `install Node.js <https://github.com/iiab/iiab/blob/master/roles/nodejs/tasks/main.yml>`_ *on the Raspberry Pi Zero W itself* (a better approach than "cd /opt/iiab/iiab; ./runrole nodejs" is to try ``apt install nodejs`` or try installing the tar file mentioned at `#2082 <https://github.com/iiab/iiab/issues/2082#issuecomment-569344617>`_). You might also need ``apt install npm``. Whatever versions of Node.js and npm you install, make sure ``/etc/iiab/iiab_state.yml`` contains the line ``nodejs_installed: True`` (add it if nec!) Finally, proceed to install Asterisk/FreePBX, Node-RED and/or Sugarizer. `#1799 <https://github.com/iiab/iiab/issues/1799>`_
2019-02-13 03:06:34 +00:00
2019-01-16 06:53:11 +00:00
See Also
--------
2019-01-16 06:41:29 +00:00
2019-02-13 09:54:03 +00:00
`Mosquitto (MQTT) <../mosquitto#mosquitto-readme>`_