Enapter Handbook

# Known Bugs

Warning

This documentation is out of date. For more information please check Gateway Documentation at Software part of the Handbook.

# v1.8.15

  • Experiencing issues with receiving logs in Enapter Cloud. Please don't use system -> send-syslog-logs-to-enapter option for a now.

  • Blueprinted device actions (commands) doesn't work in Rule Engine. In general, the stable version of Gateway doesn't support Blueprints therefore it is not recommend to use it together with Blueprints.

  • After firmware update configuration migration might be needed. In case the following message is shown:

    [a6b84e] conf # show
Unhandled error happened: GatewayShellApi::ConfigurationTree::ReferenceTreeMismatchError
Stacktrace: ["/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/configuration_tree.rb:124:in `match_to_reference_tree'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/configuration_tree.rb:27:in `curly_tree_view'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:143:in `block in tree_view'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:139:in `map'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:139:in `tree_view'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:348:in `show_path'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:170:in `process_line'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:95:in `block in run!'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:86:in `loop'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:86:in `run!'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/lib/gateway_shell/shell.rb:35:in `run!'", "/usr/lib/ruby/gems/2.7.0/gems/gateway-shell-0.0.1/bin/gateway-shell:32:in `<top (required)>'", "/usr/bin/gateway-shell:23:in `load'", "/usr/bin/gateway-shell:23:in `<main>'"]
[a6b84e] conf

    Following fix must be applied.

    Switch to superuser mode:

    [bd0745] $ bash
enapter@gateway:~$ sudo su -
# KEEP LOGS FOR ALL CHANGES ALL THE TIME IN /user/maintenance-log
# USE log <text> COMMAND TO ADD UPDATE
# USE shlog COMMAND TO VIEW LOG
# LATEST CHANGES ARE ON THE BOTTOM

root@gateway:~$

    Create the migration file

    # in bash shell with root access
cat <<-EOF > /user/migrate-shell-state
#!/usr/bin/ruby
require 'gateway_shell_api'
client = GatewayShellApi::Client.new(host: '127.0.0.1', port: 9874)
client.delete(['ntp'], '') rescue nil
client.delete(['ota'], '') rescue nil
client.save
EOF

    Make migration script executable and run it

    root@gateway:~$ chmod +x /user/migrate-shell-state
root@gateway:~$ /user/migrate-shell-state
root@gateway:~$