Konkrete Version: 2.0.0.3 RELEASE

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

Deutsch	English	Numbers
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 Sprachen	LoxBerry is available in these languages	English, Czech, Dutch, German, Spanish
Unterschiedliche Plugins verfügbar und in Verwendung	Plugins available and in use	72 different plugins in use (not counted are plugins with less then 4 installations), from 25 plugin developers
Releases seit LoxBerry 1.0	Releases since LoxBerry 1.0	21 releases, all updatable by LoxBerry Update, and without reoccuring, daily enforcement popups
Entwicklungs- und Testzeit für LoxBerry 2.0	Development and testing time for LoxBerry 2.0	More 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.0	Number of changes since LoxBerry 1.0	1.665commits, 857 files changed, 64.224 lines added and 24.058 lines deleted
Anzahl der Code-Änderungen seit LoxBerry 1.4.2	Number of changes since LoxBerry 1.4.2	325 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.

• 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 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
• Plugin 1-Wire

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

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.

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).

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.

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.

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.

LB 2.0.0.4 enthält noch eine kleine Korrektur, da Wifi-Adapter nicht immer als solche erkannt wurden.

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.

LB 2.0.0.4 adds a small fix as not all wifi adapters were recocnized as wifi.

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.

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.

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.

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.

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.

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.

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.

Im Log Viewer funktionieren nun einige wichtige Tastenfunktionen:

• Die Cursortasten (rauf, runter, links, rechts)
• Bild-Auf und Bild-Ab, sowie Pos1 und Ende
• Mit der Leertaste kannst du zeilenweise nach unten scrollen
• Mit der Eingabetaste kannst du Auto-Scroll ein- und ausschalten
• Mit Q (Quit) kannst du den Viewer schließen

LoxBerry's Log Viewer now has keyboard navigation support:

• The cursor keys (up, down, left, right)
• Page-Up and Page-Down, as well as Home and End key
• With the space bar you can scroll down line by line
• With the Enter key, you can toggle Auto-Scroll
• Finally, with the Q (quit) key, you can close the log window/tab

• 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
• Wenn ein Logfile der LoxBerry-Logging Bibliothek gelöscht wurde, welches von einem Daemon/Service noch in Verwendung war, wurde die Log-Session nicht mehr im Log Manager angezeigt (LB 2.0.0.4).

• 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
• If a logfile created by the LoxBerry Logging library was deleted, that was in use by a daemon/service, the log session in Log Manager was not displayed anymore. (LB 2.0.0.4)

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.

• 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 … : 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

• 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. 
• Plugin 1-Wire: A package installed by the plugin currently is broken in Debian Buster. Please do not update to LoxBerry 2.0.
• 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.

The 26th September is the European Day of Languages, proclaimed in 2001 by the Council of Europe.

We are proud to have such a variaty of culture, rites and languages all over the continent, unified in the European Union.

Starting with LoxBerry 1.0 - BEYOND THE LIMITS, LoxBerry has a fully integrated language engine, supporting the system widgets as well as every plugin. With the Translate widget, it is possible to easily translate the system and plugins to your native language, directly in the web interface.

For 26th of September 2019, on the European Day of Languages, and directly in the week of the LoxBerry 2.0 Pre-Release, we ask you for your support to provide Loxberry's system language and plugin languages in every users native language.

Of course, you may be the only user that speaks that language - this should be as much more the motivation to translate LoxBerry 2.0 and your used plugins to your language.

We do not like "robot" translations. LoxBerry in your language should also feel like a "native-speaking" LoxBerry, with all the variations of style and expression.

If you like to arrange with other users, please use this article's comments to arrange with others, to avoid doing translations twice. Feel free to use your native language in this article!

Submit LoxBerry translations to the LoxBerry-Core team (here, in the LoxForum, or on GitHub).

Submit Plugin translations to the Plugin authors (if you don't know the contact, drop it at our GitHub as well, with remark of the plugin name).

We will publish your new LoxBerry 2.0 languages with LoxBerry Update with all the new languages our community has submitted. Please give us some infomation (how you wanna be called in public) to honor you in our What's New and in the version list. 

Thanks! Merci! D?kuji! Hvala! Danke! Dank u! ευχαριστ?! Köszönöm! Grazie! Takk!  Dzi?kuj?! Obrigado! Mul?umesc! ?akujem! Gracias! Kiitos!