Skip to end of metadata
Go to start of metadata

Major Image Release "Bilbo" - Der achtbare Hobbit aus Hobbingen und Rückeroberer des Zwergenschatzes

Konkrete Version: 2.0.0.3 RELEASE

About LoxBerry 2.0

Einige Zahlen über LoxBerry und LoxBerry 2.0 | Some numbers about LoxBerry and LoxBerry 2.0

DeutschEnglishNumbers
Aktuelle Anzahl der Installationen (07.11.2019)Current number of installations (07.11.2019)2.932 LoxBerrys (2.718 Raspberrys, around 210 VMs and some other hardware), https://stats.loxberry.de
LoxBerry ist verfügbar in diesen SprachenLoxBerry is available in these languagesEnglish, Czech, Dutch, German, Spanish
Unterschiedliche Plugins verfügbar und in VerwendungPlugins available and in use72 different plugins in use (not counted are plugins with less then 4 installations), from 25 plugin developers
Releases seit LoxBerry 1.0Releases since LoxBerry 1.021 releases, all updatable by LoxBerry Update, and without reoccuring, daily enforcement popups
Entwicklungs- und Testzeit für LoxBerry 2.0Development and testing time for LoxBerry 2.0More than 5 month since LoxBerry 1.4.2.2, the longest period since the release of LoxBerry 1.0
Anzahl der Code-Änderungen seit LoxBerry 1.0Number of changes since LoxBerry 1.01.665commits, 857 files changed, 64.224 lines added and 24.058 lines deleted
Anzahl der Code-Änderungen seit LoxBerry 1.4.2Number of changes since LoxBerry 1.4.2325 commits, 277 files changed, 18.831 lines added and 8.042 lines deleted
Github Themen (Issues)GitHub issues

Anniversary issue #1000 was created on 30.07.2019 by Michael ("Create own ramdisk for LoxBerry") and successfully finished on 10.09.2019. And yes, this anniversary issue had it's ups and downs (more downs than ups ;-).

The oldest issue closed with LoxBerry 2.0 was #241 "IPv6", created on 12.11.2017 and implemented with LoxBerry 2.0 on 06.07.2019.

Übersetzungen / Translations

  • Updated Spanish translation for LoxBerry 2.0, thanks to Madito!
  • 26th September is the European Day of Languages - we ask users of languages, LoxBerry currently does not support, to add your language to LoxBerry. See our Goal for LoxBerry 2.0 and our Translation Guide
  • We also ask our active translators to run "Translate" for LoxBerry 2.0, as some sections got new phrases. Send the translation to us, we'll update them with the next LoxBerry Update.

Für Benutzer | For users

Plugin Known Issues

Für die folgenden Plugins beachte bitte die KNOWN ISSUES am Ende der Seite | For the following plugins, see the KNOWN ISSUES section on the bottom of the page:

  • Plugin KNXd
  • Plugin Sonos4Loxone
  • Plugin LMS4Lox
  • Plugin CamStream4Lox
  • Plugin LoxMatic
  • Plugin HA-Bridge

@Developers, if you found a known issue with your plugin, please contact us to add it to the list.

Image-Aktualisierung | Image Update

Installations-Laufzeit | Setup Duration

Das eigentliche Update des Betriebssystems wird nach dem Neustart von LoxBerry gestartet. Das Update dauert sehr lange!


The actual update of the operating system starts after a reboot. It really takes a long time!


Im Zuge des Updates wird die Linux-Distribution (Raspbian) komplett von Debian Stretch auf Debian Buster aktualisiert. Damit wird auch der neue Raspberry Pi 4 B unterstützt (siehe unten).

Die Installation dauert über 50 Minuten (Pi2/3), es werden für das Update ca. 700 MB aus dem Internet geladen.

Hinweise:

  • Nach dem Update in LoxBerry Update musst du mit dem Power-Knopf LoxBerry neu starten.
  • Es läuft dann der Reboot-Balken - von dort solltest du nach ein bis drei Minuten (auch das dauert länger als üblich!) auf die LoxBerry Update Installations-Prozess Webseite geleitet werden.
  • In dieser Installations-Seite kann man bei "Last lines of logfile" verfolgen, was gerade passiert - sollte dort bei dir nichts angezeigt werden, mach mal einen Refresh im Webbrowser.
  • Nachdem LoxBerry die Installation beendet hat und rebootet, wird die Installations-Prozessseite aktualisiert und du kommst in die normale LoxBerry-Startseite zurück.
  • Dabei wird dann automatisch im Hintergrund eine weitere Aktualisierung von LB 2.0.0 auf den aktuellen Release/Pre-Release/Commit durchgeführt. Dies dauert dann nochmals ein wenig, läuft aber im Hintergrund.

Bisher war ein derartiges Update immer ein "Blindflug" - man konnte leider den Updateprozess nicht mitverfolgen, da im Zuge des Betriebssystemupdates auch der Webserver aktualisiert wurde. Mit LoxBerry 2.0 haben wir für diesen Fall einen eigenen Webserver integriert, der Dir den update-Prozess nach einem Reboot detailliert anzeigt, bis Dein LoxBerry wieder voll zur Verfügung steht.


During the update the distribution (Raspbian) will be updated completely from Debian Stretch to Debian Buster. We now also support the brand new Raspberry Pi 4 B (see below).

The installation tooks about 50 minutes (Pi 2/3), and about 700 MB are downloaded from the web. 

Notes:

  • After the normal LoxBerry Update process, you need to reboot LoxBerry with the power button. The actual update is started during reboot.
  • After clicking "Restart" the reboot progressbar is counting down. After one to three minutes (also this takes longer than usual!), you are redirected to the LoxBerry Update Install Progress website.
  • In this Install progress website, you can monitor the "Last lines of logfile" - if nothing is shown there, you might try a browser refresh.
  • After LoxBerry finished the installation and rebooted, the installation progress website is reloaded, and you should see the normal LoxBerry main menu.
  • After you are back on your LoxBerry home screen, LoxBerry triggered a further LoxBerry Update in the background to update from 2.0.0 to the current release/pre-release/commit. This takes some more minutes, but LoxBerry is available in the webinterface.

Until now these kind of updates where more or less some kind of blind-ride - during the update LoxBerry's webserver was also updated and therefore was stopped during reboot. From LoxBerry 2.0 on we integrated an own webserver which shows the update process while the original webserver isn't available.



Approx. Update times

Pi 1 / ZeroPi 2Pi 3/3+Pi 3ADebian VM
~120 Min.~100 Min.~35 Min.~35 Min.~15 Min.

Eigene Scripte, Programme, Installationen | Own scripts, programs, installations

Wenn am LoxBerry eigene Scripte und Programme eingesetzt werden, oder Installationen von Paketen durchgeführt wurden, besteht die Gefahr, dass diese nicht mehr korrekt funktionieren. Bitte beachte die Informationen "For plugin developers" und die KNOWN ISSUES. Es wird dringend geraten, ein Backup der SD-Karte durchzuführen (z.B. mit Win32Diskimager, oder Loxberry Backup).


If you use own scripts or programs, or have installed own packages, there is the risk that these do not work (correctly) anymore. Please see the section "For plugin developers" for changes, and the KNOWN ISSUES. We urgently recommend to create an SD card backup (e.g. with Win32Diskimager, or Loxberry Backup).

Unterstützung für den Raspberry 4 B | Support for Raspberry 4 B

Der neue Raspberry Pi 4 B ist vom LoxBerry 2.0 Image unterstützt. Auf älteren LoxBerry-Images bootet der Raspberry Pi 4 nicht.


The new Raspberry Pi 4 B is supported by the new image. Images below LoxBerry 2.0 do not boot on Raspbery Pi 4.

Unterstützung von IPv6 (Beta) | Support for IPv6 (Beta)

Im Widget "Netzwerk" können jetzt (eingeschränkt) IPv6-Optionen festgelegt werden. Die "Automatische Konfiguration (SLAAC)" ist standardmäßig aktiv, d.h. wenn vom Provider IPv6-Adressen angeboten werden, wird automatisch eine Adresse bezogen. Mit der Einstellung "Automatisch beziehen (DHCPv6)" wird für die IP-Adresse SLAAC und für die Nameserver-Einstellungen DHCPv6 verwendet. Bei der manuellen Vergabe können die Einstellungen selbst vergeben werden.

Achtung: Bei falscher Konfiguration bleibt Linux beim Booten für bis zu 5 Minuten stehen, bevor das Timeout abgelaufen ist. Es sollte daher ein Monitor und Keyboard am LoxBerry angeschlossen werden zum Beobachten, was los ist.


In the "Network" widget it's now possible to configure limited IPv6 settings. By default, the "Automatic configuration (SLAAC)" is active, so if your provider provides IPv6 addresses, a global IPv6 address is assigned. The "DHCPv6" setting uses SLAAC for assigning the ip, and DHCPv6 to assign nameservers and other configuration from the DHCPv6 server. With "Enter IPv6 manually", all settings can be assigned by hand.

Attention: With wrong configuration, Linux may stall for the timeout of 5 minutes during boot. Therefore, you may attach a monitor and keyboard to watch what's happening.

Korrekte Netzwerkinterfaces | Actual network interfaces

LoxBerry zeigt und konfiguriert jetzt die tatsächlich verfügbaren Netzwerkinterfaces (statt wie bisher hardcoded eth0 und wlan0). Dies ermöglicht z.B. die Nutzung eines USB-Netzwerkadapters, oder in VMs abweichende Interface-Namen. Grundsätzlich wird von LoxBerry weiterhin immer nur ein Adapter konfiguriert. 

Dennoch weiterhin Achtung, wenn manuellen Anpassungen in network/interfaces durchgeführt wurden: Beim Speichern werden solche durch die LoxBerry-Konfiguration ersetzt.


LoxBerry now shows and configures the actual available network interfaces (instead of hardcoded eth0 and wlan0). This adds the option to use usb network adapters, or the configuration of interfaces in VMs that are named different. Basicly LoxBerry still configures only one interface. 

Attention if you have done manual configuration in network/interfaces: On saving, these are overwritten with LoxBerry settings.

Samba (SMB)

In "LoxBerry-Dienste" unter Samba (SMB) kann jetzt der Windows Arbeitsgruppenname (Workgroup) gesetzt werden. Ist der LoxBerry in der gleichen Arbeitsgruppe wie der Windows-PC, wird dieser unter Windows in der Netzwerkumgebung angezeigt.


In "LoxBerry Services", in the the Samba (SMB) area, you now can set the Windows Workgroup name. If LoxBerry is in the same workgroup as your Windows workstation, LoxBerry is shown when browsing the network environment.

Netzwerk-Freigaben: Support für SMB1 | Network shares: Support for SMB1

LoxBerry unterstützte für Windows-/Samba-Freigaben nur die Protokolle SMB2 und SMB3 (SMB1 gilt als unsicher). Da ältere Geräte/NAS usw. oftmals nur dieses alte Protokoll einsetzen, haben wir SMB1 eingebaut. Wir erkennen dabei automatisch die Protokollversion und nutzen bei alten Geräten explizit das alte Protokoll. Es ist dafür keine Einstellung erforderlich.

Im Netzwerk-Freigaben Widget wird das verwendete Protokoll zudem jetzt angezeigt. NT1 entspricht dabei dem veralteten SMB1-Protokoll.


LoxBerry only supported Windows-/Samba shares with the protocol dialect SMB2 and SMB3 (SMB1 is known to be unsecure). As older devices/NAS often only support this old protocol, we have SMB1 included. LoxBerry automatically detects the protocol dialect and falls back to SMB1 on old devices. 

In the Network Shares widget LoxBerry now also shows the SMB dialect. NT1 is the old SMB1 protocol dialect.

FTP Server

LoxBerry hat von Haus aus einen FTP Server an Bord, der standardmäßig aktiviert ist. Unter "LoxBerry-Dienste" bei Weitere Optionen kann der FTP-Server jetzt ein- und ausgeschaltet werden.


LoxBerry ships with an FTP server, that by default is enabled. Under "LoxBerry Services" in the More Options area, you now can enable and disable the FTP server.

Selbsttest: Neustart erforderlich | Healthcheck: Reboot required

Die Information "Neustart erforderlich" wurde als Fehler in den Selbsttest aufgenommen. Das bedeutet, dass dieser Fehler auch per E-Mail versandt wird, wenn E-Mail konfiguriert ist. Da LoxBerry und die Plugins sich im Hintergrund aktualisieren können (LoxBerry Update und Plugin AutoUpdate), und diese ggf. einen Neustart anfordern, wird diese Information jetzt auch über den Healthcheck und ggf. per E-Mail mitgeteilt.


The information "Reboot required" was added to the healthcheck as an error. That means, that also an email is sent, if email is configured. Because LoxBerry and the plugins may update themselfs in the background (LoxBerry Update and Plugin AutoUpdate), and these possibly require a reboot, this information is now also pushed to you as notification and - if configured - email.

Mailserver

Mit dem Update des Betriebssystem musste der Mail-Agent ersetzt werden (bisher dafür eingesetzte Software wird nicht mehr unterstützt). Im Zuge des Updates werden dabei automatisch die Maileinstellungen auf die neue Software umgestellt. Bitte prüfe, ob nach dem Update deine Mail-Einstellungen korrekt sind, und lass dir eine Test-Mail zusenden.


With the update of the operating system, we needed to switch the mail agent (the previous used software ran out of support). During the update, the mail settings are automatically migrated to the new software. After the update, please double-check the mail settings and run a test mail.

Korrektur des Plugin-AutoUpdates (schon wieder...) | Fix for automatic plugin updates (again...)

Ein Fehler im Cronjob hat die automatische Benachrichtigung und Aktualisierung von Plugins außer Kraft gesetzt. Der manuelle Update-Check im Benutzerinterface war davon nicht betroffen.


An error prevented the automatic notification and installation of new plugin versions. The manual check in the web interface was not affected.

Austausch des NTFS-Treibers für USB-Geräte | Replacement of the NTFS driver for USB devices

Wir haben den NTFS-Treiber für Linux ausgetauscht, da es mit dem Originaltreiber immer Probleme gab, dass NTFS-USB-Geräte als Read-Only gemounted wurden.


We've replaced the NTFS driver for Linux, as the original driver made problems of mounting NTFS USB devices read-only.

Andere Erweiterungen und Korrekturen (English below)

  • LoxBerry nutzt jetzt einen Server von rwth-aachen.de als Distributions-Repository.
  • Plugin-Verwaltung: Bei der Installation per URL wird während des Herunterladens jetzt "Downloading..." angezeigt. Bisher blieb das Log lange leer, bevor die Installation gestartet wurde.
  • Plugin-Verwaltung: Das Eingabefeld URL erlaubt jetzt auch Parameter in der URL (erforderlich für manche Plattformen wie gitlab).
  • Log Manager: Das automatische Aufräumen von Logfiles löscht nun auch leere Logfiles.
  • Logging: Bei einem Fehler mit der Log-Datenbank wird nun nicht mehr bei jedem Auftreten eine Benachrichtung / E-Mail versandt. Die Prüfung erfolgt täglich durch den Selbsttest.
  • Log Viewer: Beim Download eines Logfiles werden im Namen keine Anführungszeichen mehr vorgeschlagen
  • Plugin-Installation: Plugins, die automatische Updates unterstützen, werden bei der Erstinstallation bei Automatische Updates auf "Release" gesetzt (bisher: "Aus")
  • Optimierter Bootprozess (wechsel unserer eigener Init-Skripte auf systemd)
  • Die Plugin-Datenbank wurde auf JSON umgestellt
  • LoxBerry nutzt jetzt wieder seine eigene Ramdisk zum Speichern von Logfiles. Ab Raspberry 2.0 wird diese zudem on the fly komprimiert. Dadurch steht mehr Speicherplatz zur Verfügung.
  • Der Healthcheck kann die CPU-Temperatur jetzt auch ohne konfigurierten Watchdog auslesen
  • Linux Kernel-Upgrade auf 4.19.69
  • Mailserver-Widget: Besseres Fehlerhandling
  • Einzelne Healthchecks können deaktiviert werden (nur über Konfigurationsdatei einstellbar)
  • Verbesserte apt-Aufrufe während des Updateprozesses
  • Aktualisierte Linfo-Version (Mein LoxBerry → System Information)
  • Für eine SupportVPN Verbindung brauchst Du Deine Passwörter nicht mehr herauszugeben - wir nutzen nun temporär gültige Credentials

Additional enhancements and fixes

  • LoxBerry now uses a server from rwth-aachen.de for the distribution repository
  • Plugin Management: While downloading a plugin package, "Downloading..." will be shown to the user
  • Plugin Management: It is now possible to enter URL parameters (needed for some platforms like gitlab)
  • Log Manager: Empty logfiles will be cleaned now
  • Logging: If there's an error in the logdatabase, we only send one email now (not several emails for each error)
  • LogViewer: Downloadfile is now without quotes in the filename
  • Plugin installations: Plugins which offer automatic updates, will be set to "Release" during the first installation
  • Optimized booting process (changing from initd to systemd)
  • The Plugin database was migrated to JSON
  • Loxberry uses now again his own ramdisc for saving logfiles etc. From Raspberry 2.0 on this ramdisc is compressed on the fly - so more space is available
  • The Healthcheck can now read CPU temperature even if the watchdog service is not configured
  • Linux Kernel Upgrade to 4.19.69
  • Mailserver Widget: Better error handling
  • Single health checks can be disabled (only via config file)
  • Better apt calls during LoxBerry Update
  • Latest Linfo-Version (My LoxBerry → System Information)
  • You do not have to give your credentials to a Core Developer during a SupportVPN session anymore - we now use temporary credentials for that kind of sessions


For plugin developers

Buster

As we switched from Debian Stretch to Debian Buster, you absolutely should check all your plugins with the new version, since most of the system packages were updated.

List of important changes

  • PHP was updated from PHP 7.0 to PHP 7.3. If you use PHP code, please verify your plugins.
  • Node.js V12 (v12.x) is now integral part of LoxBerry 2.x. To use as package manager, besides of npm, also yarn is included. LoxBerry will stay on V12.x LTS until the end of the support period (April 2022).
  • Plugin Interface 2.0: Small and useful: With LoxBerry 2.0, additionally to the cron.hourly, cron.weeky,... jobs, you now can also use a cron.reboot to run jobs in the context of user loxberry at startup. This might save you a daemon in your plugin. See Cron section for your plugin zip.
  • Perl: LoxBerry::System: execute to call shell commands including error handling, exitcode and output fetching, and optional LoxBerry::Log integration.
  • Perl: LoxBerry::JSON: New method flatten to generate a flat key=value data structure from an json data tree (known from the MQTT Gateway, flatting json data). 
  • Perl: LoxBerry::JSON: New method param. This implicitely allows you to send a opened json file to HTML::Template with HTML::Template's associate parameter.
  • Perl: LoxBerry::JSON: New method encode. Works like JSON encode, but with the currently opened JSON file.
  • Perl: LoxBerry::JSON: New method jsblock: This returns a string to put into your JS script block, assigning the json data to a JS variable. The function also does the correct escaping for JS.
  • Perl: LoxBerry::LoxoneTemplateBuilder class let you easily create Loxone templates (xml) for Virtual HTTP and UDP Inputs, and Virtual Outputs.
  • PHP: PHP Module loxberry_loxonetemplatebuilder.php class let you easily create Loxone templates (xml) for Virtual HTTP and UDP Inputs, and Virtual Outputs in OOP style.
  • Python: pip and pip3 are now included in LoxBerry 2.x
  • Python: Python 2 and Python 3 are updated during LoxBerry Update, and also all installed shared libraries that were installed by plugins
  • Other languages: To use with Node.js, Python or whatever, we now serve the Plugin Database as plugindatabase.json file. It contains object lists of all folders and files where your plugin resists. 
    • If you create a plugin/daemon/whatever with Node.js, phython, Ruby, Go, bash :-o ... : 1. Read the plugindatabase.json. 2. Use the provided "folders" and "files" lists to access your daemon, your web directory, etc. → You don't need to do handstands to calculate or replace your plugin folders.
  • MQTT libs for Perl and PHP: LoxBerry 2.0 ships with Perl and PHP libraries to connect to an MQTT broker: Perl Modul Net::MQTT::Simple (Perl) and MQTT library phpMQTT.php (PHP)
  • Other languages: LoxBerry now provides a JsonRPC interface (beta) to use LoxBerry's SDK functions in other programming languages: LoxBerry JsonRPC
  • We've relaxed LoxBerry Update's cleanup for hidden files and folders in LoxBerry's home directory /opt/loxberry: Files and folders (and it's content) beginning with dot (/opt/loxberry/.*) are not deleted anymore during an update. Some software uses a hidden file or folder in the home directory for configuration. This simplifies the installation/configuration of such programs.


Commit Log: https://github.com/mschlenstedt/Loxberry/compare/1.4.2.2...master

KNOWN ISSUES

  • Plugin KNXd: Because of incompatibility of the plugins (older) knxd daemon and Debians knxd package, the plugin needs to be uninstalled BEFORE LoxBerry Update, and after the update, install the latest version of the KNXd plugin. Save your configuration first. Support by Wörsty, see KNXd  
  • Plugin Sonos4Loxone: You need to update to the latest Sonos4Loxone version 3.9.0 or above, before or after the update. See Sonos4Loxone
  • Plugin LMS4Lox: You need to update to the latest LMS4Lox version 0.1.4 or above, before or after the update. See LMS4Lox
  • Plugin CamStream4Lox: FFServer will not work with LoxBerry 2.0 (Debian Buster) anymore! VLC can still be used with the Plugin. We already work on an update to move completely to VLC.
  • Plugin LoxMatic: You need to upgrade the Plugin at least to Version 0.3.0. With older Versions your Homematic Modules will not work.
  • Plugin HA-Bridge: Debian Buster dropped support for Oracle Java 8. Currently it needs manual installation of openjdk-8-jre. See HA-Bridge. 
  • During the update, you may receive an email from cron / logrotate "error: /etc/logrotate.conf: duplicate log entry". You can ignore this message, as the final configfile is installed later during the update process.


  • No labels