Installation und Voraussetzungen

Welche Voraussetzungen braucht SourceAnalytix (Node.js, js-controller, Admin)?

Kurz: Ab v0.7.0 braucht SourceAnalytix Node.js 22, js-controller 6.0.11 und Admin 8.0.0 oder neuer. Admin 8 ist nötig, weil die Instanz-Einstellungsseite mit den Tabs „Übersicht" und „Probleme" aus Bausteinen von Admin 8 besteht.

	ab v0.7.0	v0.6.0 bis v0.6.x
Node.js	22 oder neuer	22 oder neuer
js-controller	6.0.11 oder neuer	6.0.11 oder neuer
Admin	8.0.0 oder neuer	7.8.23 oder neuer

Die Versionen prüfst du in der Konsole mit iobroker -v (js-controller) und node -v (Node.js). Erfüllt dein System eine Voraussetzung nicht, aktualisiere zuerst diese Komponente und danach SourceAnalytix. v0.6.0 bis v0.6.x laufen mit Admin 7.8 und mit Admin 8. Ältere Angaben aus dem Forum wie „läuft mit Admin 6" gelten nicht mehr.

Wenn SourceAnalytix nach einem Update von Node.js nicht startet

Steht im Log nach einem Update von Node.js TypeError: Class extends value … is not a constructor or null, ist meist der js-controller zu alt. Aktualisiere den js-controller, führe in der Konsole iob fix aus und starte die Instanz neu. Läuft ioBroker in Docker, aktualisierst du stattdessen das Container-Image und spielst bei Bedarf dein Backup zurück.

Siehe auch: Wie aktualisiere ich SourceAnalytix? · Probleme bei Installation und Admin-Anzeige

Wie installiere ich SourceAnalytix und lege eine Instanz an?

Kurz: Stelle in den ioBroker-Systemeinstellungen das Repository „latest" (Beta) ein und installiere SourceAnalytix im Reiter „Adapter". Dabei legt Admin die Instanz sourceanalytix.0 an. Danach öffnest du die Einstellungen der Instanz und richtest im Tab „Übersicht" deine erste Quelle ein.

SourceAnalytix steht derzeit nur im Repository „latest", nicht in „stable". In „stable" kommt es erst nach einer Testphase. Mit „stable" findest du es deshalb in der Adapterliste nicht.

So gehst du vor (ab v0.7.0)

1. Prüfe die Voraussetzungen, vor allem Admin 8.
2. Öffne in Admin die Systemeinstellungen und wähle unter „Repositories" das Repository „latest" (Beta) als aktives Repository.
3. Öffne den Reiter „Adapter", aktualisiere die Adapterliste und suche nach „SourceAnalytix".
4. Installiere den Adapter. Admin legt dabei die Instanz sourceanalytix.0 an und startet sie.
5. Öffne im Reiter „Instanzen" die Einstellungen von sourceanalytix.0. Im Tab „Übersicht" steht die Karte „SourceAnalytix einrichten" mit den Schritten „Preis anlegen", „Quelle hinzufügen" und „Werte ansehen".
6. Lege im Tab „Preisdefinitionen" mindestens eine Preisdefinition an, zum Beispiel für Strom in kWh, und speichere. Speichern startet den Adapter neu.
7. Klicke im Tab „Übersicht" auf „Erste Quelle hinzufügen". Wie es weitergeht, steht unter Wo konfiguriere ich SourceAnalytix für einen Datenpunkt?.

Die Tabs „Übersicht" und „Probleme" brauchen eine laufende Instanz. Ist sie gestoppt, steht oben „Instanz läuft nicht" mit dem Knopf „Starten". Alle Aktionen mit ⚡ sind dann gesperrt.

Es gibt keine Instanz

Hast du SourceAnalytix über die Konsole mit npm oder über eine GitHub-Adresse installiert, legt ioBroker keine Instanz an. Lege sie dann selbst mit dem Plus-Symbol an, das in Admin eine Instanz hinzufügt. Eine Instanz reicht für alle Quellen.

NOTE

Eine Installation über die GitHub-Adresse ist nur zum Testen gedacht, wenn der Entwickler dazu aufruft. Admin zeigt für eine solche Installation keine Updates an. Wie du zurück zum Repository „latest" kommst, steht unter Wie aktualisiere ich SourceAnalytix?.

Bis v0.6.x: Die Instanz-Einstellungen enthalten nur „Haupteinstellungen" und „Preisdefinitionen". Quellen aktivierst du dort am Datenpunkt im Reiter „Objekte" über das Schraubenschlüssel-Symbol.

Siehe auch: Brauche ich mehrere Instanzen? · Mein erster Zähler

Brauche ich mehrere Instanzen oder Versionen nebeneinander?

Kurz: Nein. Eine Instanz verarbeitet beliebig viele Quellen, jede mit eigenen Einstellungen. Zwei Versionen von SourceAnalytix nebeneinander gibt es nicht, ioBroker installiert von jedem Adapter genau eine Version.

Eine Instanz für alles

Die Einstellungen einer Quelle gelten je Instanz. Sie stehen am Datenpunkt unter common.custom.sourceanalytix.<Instanz>, und jede Instanz rechnet nur mit den Quellen, die für sie aktiviert sind. Auch die Tabs „Übersicht" und „Probleme" zeigen nur die Quellen dieser Instanz. Eine zweite Instanz bringt also nichts, außer du willst bewusst getrennte Ordner sourceanalytix.0 und sourceanalytix.1.

Mehrere Instanzen laufen immer mit derselben installierten Version. Eine neue Version testest du deshalb nicht neben der alten, sondern nach einem Backup als Update. Wie du bei Problemen zurückgehst, steht unter Downgrade.

Eine überzählige Instanz entfernen

Eine zweite Instanz entsteht oft unbemerkt, etwa wenn du nach einer GitHub-Installation SourceAnalytix noch einmal aus dem Repository installierst. So räumst du auf:

1. Prüfe im Reiter „Objekte", unter welcher Instanz deine Werte liegen, also ob deine Ordner unter sourceanalytix.0 oder unter sourceanalytix.1 stehen.
2. Lösche im Reiter „Instanzen" die überzählige Instanz mit dem Papierkorb-Symbol.

CAUTION

Beim Löschen einer Instanz verschwinden auch ihre Ordner mit allen Werten. Lösche nie die Instanz, unter der deine Daten liegen. Willst du nur eine einzelne Quelle stilllegen, nimm bei der Quelle die Aktion „Deaktivieren".

Siehe auch: Datenpunkt deaktivieren oder Quelle entfernen