venus-os:large
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
venus-os:large [2022-09-12 21:43] – [1.1 Venus OS Large, Node-RED and Signal K server?] mvader | venus-os:large [2024-07-14 16:53] – [8.1 Disk space issues / data partition full] mvader | ||
---|---|---|---|
Line 5: | Line 5: | ||
This manual documents Venus OS Large. Venus OS is the the software running on our [[https:// | This manual documents Venus OS Large. Venus OS is the the software running on our [[https:// | ||
- | **Node-RED** offers PLC like programming for connecting hardware devices, APIs and online services.It provides a browser-based editor that makes it easy to wire together flows. With it, one can for example program a functionality such as activating a relay based on a temperature measurement. Or make far more complex algorithms, tying relays, measurements, | + | **Node-RED** offers PLC like programming for connecting hardware devices, APIs and online services. It provides a browser-based editor that makes it easy to wire together flows. With it, one can for example program a functionality such as activating a relay based on a temperature measurement |
Also Node-RED features a [[https:// | Also Node-RED features a [[https:// | ||
+ | To get a good idea of its possibilities, | ||
- | **Signal K server** | + | **Signal K server** Signal K Server is a server application |
+ | - WiFi navigation and AIS data server to charting apps such as iSailor, Navionics, iNavX, Aqua Map. | ||
+ | - The perfect Anchor alarm, for features and details see [[https:// | ||
+ | - Automatic log book | ||
+ | - Serve full featured marine instrumentation package such as the iOS [[https:// | ||
+ | |||
+ | The [[https:// | ||
+ | |||
+ | For more information on Signal K on Venus OS, see below chapter. | ||
Line 19: | Line 28: | ||
There is and will be no official support on the functionalities of Venus OS large. | There is and will be no official support on the functionalities of Venus OS large. | ||
- | For support, turn to the [[https:// | + | For support, turn to the [[https:// |
- | There, first search if someone else had a similar question already. And if you can’t find such, then create a new question. | + | There, first search if someone else had a similar question already. And if you can’t find such, then create a new question. Make sure you add Node-RED to the topic. |
For support on SignalK, there is a #victron channel in [[http:// | For support on SignalK, there is a #victron channel in [[http:// | ||
Line 30: | Line 39: | ||
The compatible GX devices are: | The compatible GX devices are: | ||
+ | * Ekrano GX | ||
* Cerbo GX | * Cerbo GX | ||
+ | * Cerbo-S GX | ||
* Venus GX | * Venus GX | ||
* Octo GX | * Octo GX | ||
Line 43: | Line 54: | ||
==== 3.2 CPU & Memory resources ==== | ==== 3.2 CPU & Memory resources ==== | ||
- | Both SignalK as well as Node-red are rather resource intensive software applications to run on the GX Device. From a CPU usage point of view as well as RAM memory. | + | Both SignalK as well as Node-RED are rather resource intensive software applications to run on the GX Device. From a CPU usage point of view as well as RAM memory. |
Ofcourse, how intensive depends on what kind of flows (node-red) or how many messages & handling of them (SignalK) happens in the system. | Ofcourse, how intensive depends on what kind of flows (node-red) or how many messages & handling of them (SignalK) happens in the system. | ||
Line 79: | Line 90: | ||
- Verify that the image was successfully installed: go to the Settings menu, and check that the Venus OS Large menu is available. | - Verify that the image was successfully installed: go to the Settings menu, and check that the Venus OS Large menu is available. | ||
- | - Enable either Signal K or Node-RED. Note that though its possible to enable both, doing that on a Venus GX is " | + | - Enable either Signal K or Node-RED. Note that though its possible to enable both, doing that on a Venus GX is " |
Visible once successfully installed, the Venus OS Large menu: | Visible once successfully installed, the Venus OS Large menu: | ||
Line 109: | Line 120: | ||
===== 5. Node-RED ===== | ===== 5. Node-RED ===== | ||
- | {{ : | + | {{: |
==== 5.1 Introduction ==== | ==== 5.1 Introduction ==== | ||
Line 116: | Line 127: | ||
Also Node-RED features a [[https:// | Also Node-RED features a [[https:// | ||
- | A good tutorial on how to work with Node-RED is here: https:// | + | A good tutorial on how to work with Node-RED is here: https:// |
+ | |||
+ | ==== 5.2 Three part introductory webinar ==== | ||
+ | |||
+ | This is a 3 part introductory webinar on Node-RED and Venus available at the Victron Tech YouTube channel: | ||
+ | |||
+ | [[https:// | ||
+ | | ||
+ | [[https:// | ||
+ | | ||
+ | [[https:// | ||
+ | | ||
+ | |||
The Node-RED editor can be accessed from your LAN at https:// | The Node-RED editor can be accessed from your LAN at https:// | ||
- | __Standard nodes + Victron nodes__ | + | ==== 5.3 Node specifications ==== |
Node-RED comes with a core set of useful nodes, and within the Venus OS large install there is a set of Victron nodes added to that: the Victron Pallet. All of the different nodes are described [[https:// | Node-RED comes with a core set of useful nodes, and within the Venus OS large install there is a set of Victron nodes added to that: the Victron Pallet. All of the different nodes are described [[https:// | ||
For developers: source code for the node-red-contrib-victron modules is [[https:// | For developers: source code for the node-red-contrib-victron modules is [[https:// | ||
+ | |||
==== 5.2 Back-up and restore ==== | ==== 5.2 Back-up and restore ==== | ||
Line 158: | Line 184: | ||
==== 5.4 Controlling relays ==== | ==== 5.4 Controlling relays ==== | ||
+ | |||
+ | For a relay to be controllable via Node-RED, it needs to be switched to manual control first. In most cases this needs to be done by using [[https:// | ||
+ | |||
+ | ;#; | ||
+ | {{: | ||
+ | ;#; | ||
=== GX Device relays === | === GX Device relays === | ||
Line 174: | Line 206: | ||
=== SolarCharger MPPT Relay === | === SolarCharger MPPT Relay === | ||
- | Currently it is not possible | + | In order to switch |
Note that only the larger model solar chargers feature a relay. | Note that only the larger model solar chargers feature a relay. | ||
Line 182: | Line 214: | ||
=== RS series (inverter, multi) relays === | === RS series (inverter, multi) relays === | ||
- | Currently not controllable. Will be controllable in the future. | + | First set the relay to //manual control// using VictronConnect. Once that has been done, the relay can be controlled using Node-RED. |
=== Charger relays === | === Charger relays === | ||
- | The only charger which has a relay that is controllable is the Phoenix | + | The only charger which has a relay that is controllable is the Smart IP43 Charger. To use that for remote control, set its mode, using the VictronConnect app, to be remote controllable. Note that its use is limited: the relay is only powered (and thus only controllable) when the charger is switched on. It doesn' |
==== 5.5 Node-RED Dashboard ==== | ==== 5.5 Node-RED Dashboard ==== | ||
Line 192: | Line 224: | ||
It is viewable in a web browser - both locally as well as remote, via the VRM Servers. See chapter 6.2 for how to see it remotely. | It is viewable in a web browser - both locally as well as remote, via the VRM Servers. See chapter 6.2 for how to see it remotely. | ||
- | The dashboard needs to be installed, just like other extra palettes, using the Manage Palette feature, on the right of the screen in the menus. | + | The [[https:// |
- | Once that is done, you can find the nodes in the palettes on the left. | + | Once that is done, you can find the nodes in the palettes on the left. Once the dashboard has been configured and deployed, an extra tile will appear in the //Venus OS Large// menu on VRM, allowing to connect to the dashboard via VRM. |
Example dashboard: | Example dashboard: | ||
Line 208: | Line 240: | ||
- ''/ | - ''/ | ||
- ''/ | - ''/ | ||
- | - ''/ | + | - ''/ |
+ | When using these files, make sure that the configuration is enclosed within a '' | ||
There are more configuration files in ''/ | There are more configuration files in ''/ | ||
Line 217: | Line 250: | ||
For more information on such Node-RED configuration customisations, | For more information on such Node-RED configuration customisations, | ||
- | ==== 5.7. Node-RED FAQ ==== | + | ==== 5.7. Ready-to-use solutions |
- | === Q: Write/read file gives " | + | Node-RED can also be used for doing more advanced tasks. Some examples of ready-to-use solutions are: |
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | ==== 5.8. Using data from VRM ==== | ||
+ | |||
+ | For some flows it can be useful to retrieve data from the VRM Portal Database. For example to retrieve de Solar irradiation or yield forecasts. | ||
+ | |||
+ | To access data from the VRM API, a VRM access token is needed. This is done by going to the [[https:// | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Thereafter, that token can be used to retrieve data from the VRM Portal API. | ||
+ | |||
+ | Full portal API documentation is here: https:// | ||
+ | |||
+ | To, for example, retrieve Solar Irradiation forecasts, see the [[https:// | ||
+ | |||
+ | 1221 vrm_pv_inverter_yield_fc 7 PV Inverter - Yield Forecast | ||
+ | 1220 vrm_pv_charger_yield_fc 4 Solar Charger - Yield Forecast | ||
+ | 1173 vrm_solar_irradiance_fc 0 Solar Irradiance Forecast | ||
+ | 1172 vrm_solar_irradiance 0 Solar Irradiance | ||
+ | |||
+ | Note that there could be more relevant attributes, see VRM documentation for that. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | The [[https:// | ||
+ | |||
+ | ==== 5.9. Node-RED FAQ ==== | ||
+ | |||
+ | === Q1: Write/read file gives " | ||
Since Venus OS 2.90 and on wards, Node-RED no longer runs as user '' | Since Venus OS 2.90 and on wards, Node-RED no longer runs as user '' | ||
- | === Q: How can I update the Victron node pallette === | + | === Q2: How can I update the Victron node pallette === |
As that pallette is part of the total Venus OS large package, it can only be updated by installing a newer Venus OS large version. | As that pallette is part of the total Venus OS large package, it can only be updated by installing a newer Venus OS large version. | ||
Line 229: | Line 293: | ||
In case you see that there is a newer version Victron pallette available online, and thats not yet shipping in a Venus OS Large version, then the only option is to wait: a new Venus OS Large version is usually made available shortly after updating that pallette. | In case you see that there is a newer version Victron pallette available online, and thats not yet shipping in a Venus OS Large version, then the only option is to wait: a new Venus OS Large version is usually made available shortly after updating that pallette. | ||
- | === Q: How can I password protect Node-RED === | + | === Q3: How can I password protect Node-RED === |
Password protection of Node-Red is linked to the remote console. If a password is set for the remote console, this password is also used for securing Node-Red. The username is '' | Password protection of Node-Red is linked to the remote console. If a password is set for the remote console, this password is also used for securing Node-Red. The username is '' | ||
- | === Q: How do I restart Node-RED from the Venus GUI? === | + | === Q4: How do I restart Node-RED from the Venus GUI? === |
In order to restart Node-RED you need to disable and enable it from the menu. You can find this under //Venus OS Large Features -> Node-RED//. | In order to restart Node-RED you need to disable and enable it from the menu. You can find this under //Venus OS Large Features -> Node-RED//. | ||
- | === Q: How does safe mode work and what is it? === | + | === Q5: How does safe mode work and what is it? === |
From the Venus GUI you can select Node-RED to be enabled in "safe mode". This means that Node-RED will start without starting the flows. This allows you to open the flows in the editor and make changes without the flows running. When you deploy your changes, the flows are then started. The safe mode can be handy if one of the flows has an error that causes high CPU loads on the Venus device or other issues. | From the Venus GUI you can select Node-RED to be enabled in "safe mode". This means that Node-RED will start without starting the flows. This allows you to open the flows in the editor and make changes without the flows running. When you deploy your changes, the flows are then started. The safe mode can be handy if one of the flows has an error that causes high CPU loads on the Venus device or other issues. | ||
- | === Q: Can I install the @signalk/ | + | === Q6: Can I install the @signalk/ |
No, at least not into the node-red instance which comes as part of Venus OS Large. To @signalk/ | No, at least not into the node-red instance which comes as part of Venus OS Large. To @signalk/ | ||
Line 249: | Line 313: | ||
- install the Victron pallette into the Node-RED thats part of SignalK server | - install the Victron pallette into the Node-RED thats part of SignalK server | ||
- | === Q: I get the error: Failed to remove, unrecognised module === | + | === Q7: I get the error: Failed to remove, unrecognised module === |
This is seen when trying to remove a module that has been previously uninstalled, | This is seen when trying to remove a module that has been previously uninstalled, | ||
Line 261: | Line 325: | ||
After following these steps Node-RED should know about the module again and you should be able to remove or upgrade it. | After following these steps Node-RED should know about the module again and you should be able to remove or upgrade it. | ||
- | === Q: The browser complains about non private connection === | + | === Q8: The browser complains about non private connection === |
Node-RED on Venus now uses SSL for its connection. As the certificate is signed by a "self signed certificate", | Node-RED on Venus now uses SSL for its connection. As the certificate is signed by a "self signed certificate", | ||
Another implication might be that you need to prepend the connection with '' | Another implication might be that you need to prepend the connection with '' | ||
+ | |||
+ | Finally, if you want to use the Node-RED command line interface for administration, | ||
+ | |||
+ | export NODE_EXTRA_CA_CERTS=/ | ||
+ | | ||
+ | === Q9: How often do the Victron input nodes send a msg? === | ||
+ | |||
+ | The input nodes send out a message on each value change. If the ‘//only changes// | ||
+ | |||
+ | === Q10: How can I get Node-RED to also listen to http port 1880 === | ||
+ | |||
+ | There are some nodes that are only able to connect to a http site. In that case you probably also want to enable http on port 1880. This can be achieved by creating (or adding to) a user configuration file ''/ | ||
+ | |||
+ | module.exports = { | ||
+ | /* Make sure that we also listen on port 1880 on all interfaces */ | ||
+ | | ||
+ | } | ||
+ | |||
+ | And restart Node-RED. | ||
+ | |||
+ | === Q11: Is there a way to have the context survive reboots? === | ||
+ | |||
+ | By default the context is stored in memory of the GX device only. If the GX device gets rebooted, the | ||
+ | content of the memory gets reset and you loose the context information. | ||
+ | |||
+ | In order to keep the context data, it is needed to [[https:// | ||
+ | |||
+ | module.exports = { | ||
+ | contextStorage: | ||
+ | default: { | ||
+ | module: " | ||
+ | config: { | ||
+ | flushInterval: | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | | ||
+ | With the above settings, context files will get created periodically in ''/ | ||
===== 6. Signal K ===== | ===== 6. Signal K ===== | ||
Line 272: | Line 375: | ||
=== 6.1.1 Why have Signal K on your GX Device? === | === 6.1.1 Why have Signal K on your GX Device? === | ||
- | By adding Signal K, the GX device becomes a data hub for all marine electronics on your yacht. For example | + | By adding Signal K, the GX device becomes a data hub for all marine electronics on your yacht. For example |
Also, there are SignalK plugins to forward the data to influxdb & Grafana. | Also, there are SignalK plugins to forward the data to influxdb & Grafana. | ||
Line 278: | Line 381: | ||
Popular Apps compatible with Signal K: | Popular Apps compatible with Signal K: | ||
+ | * Auqua Map | ||
+ | * iNavX | ||
+ | * iSailor | ||
+ | * Navionics | ||
* [[https:// | * [[https:// | ||
* ... (welcome to add more here) | * ... (welcome to add more here) | ||
Line 295: | Line 402: | ||
Signalk-server is a software application that, in the context of this manual, runs on your GX Device and interface to all Victron protocols and more. It uses plugins, and there is a large community of enthusiasts around it, making it one of the most flexible and complete pieces of software that understands the plethora of protocols of all different manufacturers that make marine electronics. | Signalk-server is a software application that, in the context of this manual, runs on your GX Device and interface to all Victron protocols and more. It uses plugins, and there is a large community of enthusiasts around it, making it one of the most flexible and complete pieces of software that understands the plethora of protocols of all different manufacturers that make marine electronics. | ||
- | For more information on Signal K, read [[http://signalk.org/overview.html|the Signal K website]]. And our blog post of a while ago. | + | For more information on Signal K, read the [[https://github.com/SignalK/ |
Note that Signal K is not a Victron project. At Victron, we are great fans of sailing, open source as well as community driven projects. And Signal K is a perfect example of such project. And when running on a GX Device its a perfect marriage. | Note that Signal K is not a Victron project. At Victron, we are great fans of sailing, open source as well as community driven projects. And Signal K is a perfect example of such project. And when running on a GX Device its a perfect marriage. | ||
- | |||
- | === 6.1.4 Signal K - the data format === | ||
- | |||
- | Strictly speaking, Signal K is not software but a data format. And Signalk-server is the name of the software. | ||
- | |||
- | This section explains the rationale behind the data format. | ||
- | |||
- | Signal K is a modern and open data format for marine use. Its goal is to | ||
- | |||
- | - create a shared data model for marine related data | ||
- | - make marine related data easy to access, handle and build applications on | ||
- | |||
- | The shared data model allows you to handle the data in a uniform way independent of how the data is produced. In practice this means that you can refer to your battery voltage with `electrical/ | ||
- | |||
- | Easy access means that you can use modern standards like HTTP, WebSockets and JSON that are in widespread. There is a wealth of knowledge and skilled people are easy to find, with no special marine related knowledge needed to get started. | ||
- | |||
- | In Venus OS it brings all the data available in the GX system, including NMEA 2000 data, to a single data model and programming interface. | ||
=== 6.1.3 Considerations on how to install Signal K === | === 6.1.3 Considerations on how to install Signal K === | ||
- | The type of install described in this document, running Venus OS including SignalK, has these advantages: | + | The type of install described in this document, running Venus OS including SignalK, has these advantages: |
- | The other common type of SignalK | + | The other common type of Signal K Server |
There is no one right way for everyone to do this; the best solution will depend on the requirement. | There is no one right way for everyone to do this; the best solution will depend on the requirement. | ||
- | For raspberrypi owners, note that its very easy to try both methods and change | + | For raspberrypi owners, note that its very easy to try both methods and switch |
- | ==== 6.2 Where to find support? ==== | + | ==== 6.2 Documentation and support |
- | As above already introduced, use [[https:// | + | * [[https:// |
+ | * [[https:// | ||
+ | * [[https://discord.gg/uuZrwz4dCS | ||
Do not contact normal Victron support for any help on SignalK. Its based on community support, not official support. | Do not contact normal Victron support for any help on SignalK. Its based on community support, not official support. | ||
- | ==== 6.4 First use & configuring ==== | + | ==== 6.3 First use & configuring ==== |
=== Step 1. Opening the dashboard === | === Step 1. Opening the dashboard === | ||
Line 351: | Line 443: | ||
=== Step 3. Configure can-bus connections === | === Step 3. Configure can-bus connections === | ||
- | For the Venus GX, SignalK comes pre-configured with a NMEA2000 listener for the VE.Can ports, its named " | + | For the Venus GX, and Cerbo GX, SignalK comes pre-configured with a NMEA2000 listener for the VE.Can ports, its named " |
;#; | ;#; | ||
{{: | {{: | ||
;#; | ;#; | ||
- | |||
Note that, to keep that operational, | Note that, to keep that operational, | ||
Line 364: | Line 455: | ||
;#; | ;#; | ||
+ | For more information on CAN-busses, see chapter 6.4. | ||
=== Step 4. Adding Signalk Plugins or Webapps === | === Step 4. Adding Signalk Plugins or Webapps === | ||
Line 369: | Line 461: | ||
TODO: explain & warn about data partition size & space (since thats where plugins are installed by signalk on Venus OS). Filling up the datapartition can corrupt Venus OS. More information about data partition on Venus OS here: https:// | TODO: explain & warn about data partition size & space (since thats where plugins are installed by signalk on Venus OS). Filling up the datapartition can corrupt Venus OS. More information about data partition on Venus OS here: https:// | ||
+ | ==== 6.4 CAN-bus ports ==== | ||
+ | |||
+ | Below lists documents the mapping from physical ports on the device to the interface within Venus OS. This information is needed when you want to deviate from the standard configuration. | ||
+ | |||
+ | === Cerbo GX === | ||
+ | |||
+ | ^ Enclosure label ^ Interface ^ Notes ^ | ||
+ | | VE.Can 1 | can0 | Non-isolated and default enabled in SignalK | | ||
+ | | BMS-Can | can1 | Non-isolated, | ||
+ | |||
+ | Within the Victron product range, CAN-bus ports that are labelled BMS-Can are limited in their functionality due to hardware constraints. Their only use is to connect to a managed battery such as BYD and Pylontech, used in landbased ESS & Off-grid systems - not in the marine market. | ||
+ | |||
+ | === Cerbo GX MK2 === | ||
+ | |||
+ | ^ Enclosure label ^ Interface ^ Notes ^ | ||
+ | | VE.Can 1 | can0 | Isolated and default enabled in SignalK | | ||
+ | | VE.Can 2 | can1 | Non-isolated | | ||
+ | |||
+ | === Ekrano GX === | ||
+ | |||
+ | ^ Enclosure label ^ Interface ^ Notes ^ | ||
+ | | VE.Can 1 | vecan0 | Isolated | | ||
+ | | VE.Can 2 | vecan1 | Non-isolated | | ||
+ | |||
+ | When using SignalK on Venus OS on an Ekrano, there is currently no port enabled for N2K traffic in the default configuration. Configure it manually instead, see here for more information: | ||
==== 6.5 Signal K FAQ ==== | ==== 6.5 Signal K FAQ ==== | ||
- | === Q1 How to best handle & install a GPS === | + | === Q1 - How to best handle & install a GPS === |
You want the data available in SignalK and in Venus OS, so that it gets to VRM. And preferably a quality GPS. | You want the data available in SignalK and in Venus OS, so that it gets to VRM. And preferably a quality GPS. | ||
Line 395: | Line 512: | ||
Tbd. Actually a NMEA0183-network is probably something that doesnt exist: you can't have NMEA0183 in a network, its point to point. | Tbd. Actually a NMEA0183-network is probably something that doesnt exist: you can't have NMEA0183 in a network, its point to point. | ||
+ | |||
+ | === Q2 - What happens when I updated a pre-installed Plugin? === | ||
+ | |||
+ | A few plugins are installed by default on Venus OS Large. These include FreeboardSK, | ||
+ | |||
+ | When a newer version of such plugin is available, it is still possible to install the update - by pressing the Update button in the Signal K Admin UI -> Appstore -> Installed page. | ||
+ | |||
+ | The newer version of the plugin gets installed onto the data partition. And Signal K server will use that, as it prioritises the version of the plugins installed there over the one included in the image. | ||
+ | |||
+ | WARNING: above also means that once Venus OS ships with a newer version of the plugin than the version installed manually, Signal K Server will keep using that older one. To get out of such situation, remove the plugin by using the Appstore -> Installed page, and then the trash icon. | ||
+ | |||
+ | Note that the same icon is also available for the pre-installed plugins. Pressing it does nothing - since they can't be removed. | ||
+ | |||
+ | === Q3 - Can I update signalk-server? | ||
+ | |||
+ | Signal K Server comes preinstalled with Venus OS. And except by " | ||
+ | |||
+ | The normal -and recommended- method to get a newer version of Signal K Server is to wait for Victron to release a newer version of Venus OS. | ||
+ | |||
+ | In case you can’t wait, and don’t mind the extra work as well as risks, here is how to update it yourself. | ||
+ | |||
+ | Be warned, this method might or might not remain working | ||
+ | |||
+ | Note that all changes made to the rootfs will be overwritten the next time you do a Venus OS update. | ||
+ | |||
+ | Step 1: Get yourself [[https:// | ||
+ | |||
+ | Step 2: Follow this procedure: | ||
+ | |||
+ | < | ||
+ | ## Change the rootfs from read-only to read/write, as well as increase file system size | ||
+ | ## to use the complete partition. | ||
+ | / | ||
+ | |||
+ | ## Backup a file you'll need to restore later | ||
+ | # dev-tip: a list of especially installed files on a Victron install is here: | ||
+ | # https:// | ||
+ | # in that folder, open the .bb file and read the do_install function | ||
+ | cp / | ||
+ | |||
+ | ## See version as well as install location for signalk-server | ||
+ | npm list -g | ||
+ | |||
+ | # output will be something like this: | ||
+ | # /usr/lib | ||
+ | # ├── @victronenergy/ | ||
+ | # ├── corepack@0.17.0 | ||
+ | # ├── node-red@3.1.0 | ||
+ | # ├── npm@9.5.1 | ||
+ | # └── signalk-server@1.46.3 | ||
+ | |||
+ | ## Stop signalk-server | ||
+ | svc -d / | ||
+ | |||
+ | ## Update to a newer version, here is how to update to last released version: | ||
+ | npm install -g signalk-server | ||
+ | |||
+ | # And to update to a more specific version, do something similar to this: | ||
+ | # npm install -g signalk-server@2.3.0-beta.2 | ||
+ | |||
+ | # Output will be something like this: | ||
+ | # added 120 packages, removed 179 packages, and changed 586 packages in 6m | ||
+ | # | ||
+ | # 57 packages are looking for funding | ||
+ | # run `npm fund` for details | ||
+ | |||
+ | ## Restore that file | ||
+ | mv / | ||
+ | |||
+ | ## Install the signalk-venus-plugin in same place where it normally is on Venus OS | ||
+ | cd / | ||
+ | npm install signalk-venus-plugin | ||
+ | |||
+ | ## If you want, see updated version: | ||
+ | npm list -g | ||
+ | |||
+ | # output will be similar as above, but then with newer version | ||
+ | |||
+ | ## start signalk-server again, and see log output: | ||
+ | svc -u / | ||
+ | |||
+ | ## press CTRL-C to stop seeing the log. signalk-server will keep running in the background. | ||
+ | </ | ||
===== 7. Remote access via VRM ===== | ===== 7. Remote access via VRM ===== | ||
Line 402: | Line 602: | ||
{{ : | {{ : | ||
+ | |||
+ | ===== 8. Troubleshooting ===== | ||
+ | |||
+ | ==== 8.1 Disk space issues / data partition full ==== | ||
+ | |||
+ | Using both Signal K Server, as well as Node-RED, it is quite easy to completely fill up the data partition. Which can cause all sorts of issues, like: | ||
+ | |||
+ | - Venus OS itself no longer working correctly, | ||
+ | - Signal K Server refuses to start / no longer works, | ||
+ | - Node-RED refuses to start, | ||
+ | - and similar. | ||
+ | |||
+ | Note that Venus OS itself does **not** show a notification or warning when the data disk is full. And know that the other disks are read-only unless remounted to read/write as per [[https:// | ||
+ | |||
+ | Depending on what the issue is, there are a few things you can do: | ||
+ | |||
+ | - Do full GX factory reset, as per the instructions in the GX user manuals. This includes downloading a file called venus-data.tgz; | ||
+ | - Remove all Signal K Server log files. In case you're using SignalK, then we recommend to try that option first. See next chapter on how to do that (requires a USB stick or SD Card), and once done make sure to double check you're Signal K log setup; Most importantly, | ||
+ | - A more detailed approach is logging into the SSH console, and checking for disk space: | ||
+ | |||
+ | **Tips and tricks to login a diagnose disk space** | ||
+ | |||
+ | Require root access: https:// | ||
+ | |||
+ | The '' | ||
+ | |||
+ | < | ||
+ | root@einstein:/ | ||
+ | Filesystem | ||
+ | / | ||
+ | devtmpfs | ||
+ | tmpfs | ||
+ | tmpfs | ||
+ | / | ||
+ | tmpfs | ||
+ | overlay | ||
+ | </ | ||
+ | |||
+ | The '' | ||
+ | |||
+ | < | ||
+ | root@Cerbo:/ | ||
+ | 1103640 / | ||
+ | 1099352 / | ||
+ | 1099276 / | ||
+ | 87048 / | ||
+ | 65732 / | ||
+ | 7188 / | ||
+ | 3920 / | ||
+ | 744 / | ||
+ | 164 / | ||
+ | 160 / | ||
+ | 116 / | ||
+ | 116 / | ||
+ | </ | ||
+ | |||
+ | This is a view of a more healthy tree: | ||
+ | < | ||
+ | root@Cerbo:/ | ||
+ | 164608 / | ||
+ | 160312 / | ||
+ | 160240 / | ||
+ | 87048 / | ||
+ | 65732 / | ||
+ | 7188 / | ||
+ | 3924 / | ||
+ | 744 / | ||
+ | </ | ||
+ | |||
+ | ==== 8.2 Backup / Reset to factory defaults | ||
+ | |||
+ | There are scenarios where you want to make a backup of your data or when you want to clear logging or even start all over and go back to factory defaults. In order to make this process easy, you can put one (or more) of the following files on an USB stick and reboot your device. The files will be unpacked and the scripts within will execute. Once the script is ready with its tasks, a notification of 3 beeps can be heard (on a Multiplus-II GX the notification will be shown in the display). After which the USB stick can be removed. | ||
+ | |||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | See [[https:// |
venus-os/large.txt · Last modified: 2024-08-04 16:01 by mvader