Device Management

Übersicht

Die folgenden Abschnitte beschreiben detailliert alle Funktionalitäten der Device Management-Anwendung. Zur besseren Orientierung folgt eine Übersicht über den Inhalt dieses Dokuments.

Verbinden von Geräten

Auf der Seite Geräteregistrierung werden alle Geräte, die sich aktuell im Registrierungsprozess befinden, entweder als Liste oder als Raster angezeigt.

Die folgenden Informationen werden für jedes Gerät angezeigt:

• Bei der Registrierung angegebener Gerätename
• Status des Geräts (siehe unten)
• Erstellungsdatum
• Mandant, von dem aus das Gerät registriert wurde

Die Geräte können einen der folgenden Status haben:

• Wartet auf Verbindung - Das Gerät wurde registriert, aber kein Gerät mit der angegebenen ID hat versucht, eine Verbindung herzustellen.
• Bitte akzeptieren - Es liegt eine Kommunikation von einem Gerät mit der angegebenen ID vor, doch der Benutzer, der die Registrierung vornimmt, muss noch explizit zustimmen, damit die Zugangsdaten an das Gerät gesendet werden.
• Akzeptiert - Der Benutzer hat erlaubt, dass die Zugangsdaten an das Gerät gesendet werden.

Geräte können auf verschiedene Weise mit Ihrem Cumulocity IoT-Konto verbunden werden.

So registrieren Sie Geräte

Um Geräte zu registrieren, können Sie eine der folgenden Optionen wählen:

• Manuelle Geräteregistrierung - zum manuellen Herstellen einer Verbindung mit einem oder mehreren Geräten
• Bulk-Geräteregistrierungg - zum Registrieren größerer Gerätemengen in einem Schritt

Sofern Sie die erforderlichen Anwendungen abonniert haben, wird Ihnen eine dritte Option angezeigt: Benutzerdefinierte Geräteregistrierung - zum Registrieren von Geräten spezifischer Typen, z. B. LoRa oder Sigfox, siehe die Dokumentation zu diesen Services im Protocol Integration Guide.

So verbinden Sie ein Gerät manuell

Info: Je nach Gerätetyp sind möglicherweise nicht alle beschriebenen Schritte relevant.

1. Klicken Sie Geräteregistrierung im Menü Geräte des Navigators und klicken Sie dann Gerät registrieren.

2. Wählen Sie im darauf folgenden Dialog Geräte registrieren die Option Manuelle Geräteregistrierung.

   

3. Geben Sie im Feld Geräte-ID die eindeutige ID des Geräts ein. Diese finden Sie in der Gerätedokumentation. Bei mobilen Geräten handelt es sich dabei meistens um die IMEI (International Mobile Equipment Identity), die häufig auf der Rückseite des Geräts zu finden ist.

4. Wählen Sie optional eine Gruppe aus, der Sie das Gerät nach der Registrierung zuweisen möchten, siehe auch Gruppieren von Geräten.

5. Klicken Sie Weiteres Gerät hinzufügen, um ein weiteres Gerät zu registrieren. Geben Sie auch hier die Geräte-ID ein und weisen Sie optional das Gerät einer Gruppe zu. Auf diese Weise können Sie mehrere Geräte in einem Schritt registrieren.

6. Klicken Sie Weiter, um Ihr(e) Gerät(e) zu registrieren.

Info: In einem Enterprise Tenant kann der Management-Mandant auch direkt einen Mandanten auswählen, dem das Gerät von hier aus hinzugefügt werden soll. Bitte beachten Sie: Da der Management-Mandant keinen Zugriff auf die Stammdaten des Untermandanten hat, können Sie Geräte entweder für einen Mandanten ODER für eine Gruppe registrieren, nicht jedoch für beides.

Nach erfolgreicher Registrierung werden die Geräte auf der Seite Geräteregistrierung mit dem Status “Warten auf Verbindung” angezeigt.

Schalten Sie das Gerät bzw. die Geräte ein und warten Sie, bis die Verbindung hergestellt wird. Wenn ein Gerät verbunden ist, wechselt der Status auf “Bitte akzeptieren”. Klicken Sie Akzeptieren, um die Verbindung zu bestätigen. Der Status des Geräts wechselt auf “Akzeptiert”.

Info: Im Falle von Problemen lesen Sie die Dokumentation zu Ihrem Gerätetyp im Cumulocity IoT Device Partner Portal oder schlagen Sie im Handbuch zu Ihrem Gerät nach.

So führen Sie eine Bulk-Registrierung von Geräten durch

Um eine größere Anzahl von Geräten zu registrieren, bietet Cumulocity IoT die Möglichkeit der Bulk-Registrierung, d. h. einer Registrierung mehrerer Geräte durch Hochladen einer CSV-Datei.

1. Klicken Sie Geräteregistrierung im Menü Geräte des Navigators und klicken Sie dann Gerät registrieren.

2. Wählen Sie im darauf folgenden Dialog Geräte registrieren die Option Bulk-Geräteregistrierung.

   

3. Klicken Sie Datei zum Hochladen auswählen und wählen Sie die hochzuladende CSV-Datei aus, indem Sie auf Ihrem Computer zu der Datei navigieren.

Info: Durch Mehrfachregistrierung wird eine elementare Darstellung des Geräts erstellt. Danach muss das Gerät sie auf eine volle Darstellung mit eigenem Status aktualisieren.

Einfache Registrierung

Die CSV-Datei enthält zwei Spalten: ID;PATH, wobei ID die Gerätebezeichnung, z. B. die Seriennummer, und PATH eine durch Schrägstriche getrennte Liste von Gruppennamen (Pfad zu der Gruppe, der das Gerät nach der Registrierung zugewiesen werden soll) ist.

		ID;PATH
		Device1;Group A
		Device2;Group A/Group B			

Nachdem die Datei hochgeladen wurde, werden alle erforderlichen neuen Gruppen erstellt und neue Registrierungen mit dem Status “Wartet auf Verbindung” angelegt und der normale Registrierungsprozess muss fortgesetzt werden (siehe oben).

Vollständige Registrierung

Die CSV-Dateien müssen mindestens die IDs als Gerätebezeichnung und die Zugangsdaten der Geräte enthalten.

Neben diesen Spalten kann die Datei auch andere Spalten wie ICCID, NAME oder TYPE enthalten, wie in diesem Beispiel gezeigt.

		ID;Credentials;PATH;ICCID;NAME;TYPE
		006064ce800a;LF2PWJoLG1Fz;Sample_Düsseldorf;+491555555;Sample_Device1;c8y_Device
		006064ce8077;OowoGKAbiNJs;Sample_Düsseldorf;+491555555;Sample_Device2;c8y_Device		

Um die Geräte zu verbinden, werden diese mit den relevanten Informationen vorregistriert. Genauer gesagt wird jedes Gerät folgendermaßen konfiguriert:

• Benutzername - der Benutzername für das Cumulocity IoT-Konto im Format <tenant>/device_<id>, wobei sich <tenant> auf den Mandanten bezieht, von welchem die CSV-Datei importiert wird, und <id> auf den entsprechenden Wert in der CSV-Datei.
• Passwort - das Passwort für den Zugang zu Cumulocity IoT; entspricht dem Wert “Credentials” in der CSV-Datei.
• Gerätedaten - Felder TYPE, NAME, ICCID, IDTYPE, PATH, SHELL in der CSV-Datei.

Nachdem die Daten importiert wurden, erhalten Sie eine Rückmeldung zur Anzahl der Geräte, die vorregistriert wurden, sowie zu gegebenenfalls aufgetretenen Fehlern.

Für beide Bulk-Registrierungstypen (einfach/vollständig) stellen wir praktische CSV-Vorlagendateien bereit, die Sie herunterladen können, um die Struktur anzuzeigen oder zu kopieren.

So importieren Sie CSV-Daten in Microsoft Excel

1. Wechseln Sie in Microsoft Excel zur Registerkarte Daten.
2. Wählen Sie in der Registerkarte Daten in der oberen Menüleiste die Option Aus Text.
3. Wählen Sie die zu importierende CSV-Datei aus, indem Sie zu ihr navigieren (in diesem Fall zu der Vorlagendatei, die Sie von der Cumulocity IoT-Plattform heruntergeladen haben).
4. Behalten Sie in Schritt 1 des Textimport-Assistenten die Standardeinstellungen bei und klicken Sie Weiter.
5. Wählen Sie in Schritt 2 des Textimport-Assistenten die Option Semikolon und klicken Sie Fertig stellen.

Weitere Informationen zum Dateiformat und akzeptierten CSV-Varianten finden Sie auch unter Bulk device credentials in the Reference guide.

Info: Wenn Sie mit dem Enterprise Tenant arbeiten, können Sie auch Geräte über mehrere Mandanten registrieren, indem Sie eine Spalte Mandant hinzufügen und die CSV-Datei vom Management-Mandanten aus importieren.

Anzeigen von Geräten

Klicken Sie Alle Geräte im Menü Geräte des Navigators, um alle mit Ihrem Konto verbundenen Geräte anzuzeigen.

Eine detaillierte Geräteliste wird angezeigt.

Geräteinformationen

Die Liste enthält eine Zeile für jedes Gerät mit den folgenden Informationen, dargestellt in Spalten:

Konfigurieren von Spalten

Die Spalten der Geräteliste können nach Bedarf angepasst werden.

So blenden Sie Spalten ein/aus

1. Klicken Sie Spalten konfigurieren in der oberen Menüleiste.
2. Aktivieren/deaktivieren Sie im darauf folgenden Dialog die Checkboxen für die gewünschten/unerwünschten Spalten.
   
   
3. Klicken Sie Speichern.

Die Geräteliste wird entsprechend angepasst und zeigt nur die gewählten Spalten.

So fügen Sie benutzerdefinierte Spalten hinzu

Darüber hinaus können Sie benutzerdefinierte Spalten hinzufügen, in denen zusätzliche Geräteattribute angezeigt werden.

1. Klicken Sie im Dialog Spalten konfigurieren auf Eigene Spalte hinzufügen.
   
   
2. Geben Sie im Feld Kopfzeile eine Kopfzeile für die neue benutzerdefinierte Spalte ein.
3. Geben Sie im Feld Fragmentpfad das anzuzeigende Attribut des Geräts ein. Verschachtelte Attribute sind zulässig. Für verschachtelte Attribute können jedoch nur Cumulocity IoT-Standardfragmente wie c8y_Mobile.mcc ausgewählt werden.
4. Wählen Sie einen Filtermodus für die neue Spalte aus.
   Wenn Sie Fragment entspricht Wert wählen, erfolgt die Filterung durch Anwenden der Kriterien, die ein Benutzer in dem Dialogfeld festlegen kann, das beim Klicken auf das Spaltenfilter-Symbol angezeigt wird.
   
   Im Fall von Fragment existiert wird nach vorhandenen Fragmenten gefiltert, also danach, ob das Attribut vorhanden ist oder nicht.
5. Klicken Sie Hinzufügen.

Die neue Spalte wird hinzugefügt und in der Geräteliste angezeigt.

Info: Während Standardspalten lediglich nach Bedarf ein- oder ausgeblendet werden können, lassen sich benutzerdefinierte Spalten auch dauerhaft löschen.

So löschen Sie ein Gerät aus der Liste

1. Bewegen Sie den Mauszeiger über die Zeile des zu löschenden Geräts.
2. Klicken Sie auf das Löschen-Symbol rechts neben der Zeile.

Das Objekt wird dauerhaft aus der Plattform gelöscht.

Wichtig: Wenn Sie ein Gerät löschen, wird dieses aus der Cumulocity IoT-Datenbank gelöscht, einschließlich aller erzeugter Daten. Alternativ können Sie alle nicht mehr benötigten Geräte in einer Gruppe zusammenfassen (siehe Gruppieren von Geräten). So stellen Sie sicher, dass alle Berichte korrekt erhalten bleiben. Damit für stillgelegten Geräte keine Alarme mehr ausgelöst werden, deaktivieren Sie die Verbindungsüberwachung für das entsprechende Gerät. Löschen Sie ein Gerät, werden dadurch nicht die Daten der Kindgeräte gelöscht.

So suchen Sie nach Geräten

Cumulocity IoT umfasst eine Volltextsuche nach Geräten.

Klicken Sie auf das Lupensymbol rechts oben und geben Sie einen Suchbegriff in das Textfeld ein.

Weitere Informationen zur Suchfunktionalität finden Sie unter Erste Schritte > Eigenschaften und Funktionen der Benutzeroberfläche.

Unser Beispiel zeigt eine Suche nach “Ublox C027”.

So filtern Sie Geräte

Die Geräteliste bietet eine Filterfunktion, um Geräte in der Liste nach bestimmten Kriterien zu Filtern.

Die Filterfunktion steht für jede Spalte zur Verfügung. Klicken Sie auf das Filtersymbol neben dem Namen der Spalte, nach der Sie filtern möchten.

Legen Sie im Dialog Filteroptionen Ihre Filteroptionen fest.

Die meisten Spalten enthalten Text. Hier können Sie filtern, indem Sie wie im Suchfeld einen beliebigen Text in das Textfeld eingeben. Klicken Sie + Oder, um ein weiteres Textfeld hinzuzufügen, falls Sie nach mehr als einem Begriff filtern möchten.

Abgesehen vom Filtern nach Text gibt es folgende weitere Optionen:

• Bei Datumsfeldern (z. B. Registrierungsdatum) geben Sie ein Zeitintervall als Filter ein.
• In der Spalte Status können Sie nach verschiedenen Kriterien filtern, die jeweils den Sende-, Push- oder Wartungsstatus des Geräts repräsentieren.
• In der Spalte Alarm entsprechen die Filterkriterien den Alarmtypen (kritisch, wichtig, weniger wichtig, Warnung, keine Alarme).
• Wenn für benutzerdefinierte Spalten bei der Konfiguration das Kriterium Fragment entspricht Wert festgelegt wurde, muss ein Wert bereitgestellt werden.
• Wenn bei der Konfiguration das Kriterium Fragment existiert festgelegt wurde, hängt die Filterung davon ab, ob das Fragment existiert oder nicht.

Klicken Sie im Dialog Filteroptionen die Option Aufsteigend oder Absteigend, wenn Sie die Geräte in einer bestimmten Reihenfolge sortieren möchten. Klicken Sie Anwenden, um die Filterbedingungen anzuwenden.

Die Geräteliste zeigt nun nur noch die Geräte an, auf die die Filterbedingungen zutreffen.

Klicken Sie Filter zurücksetzen links in der oberen Menüleiste, wenn Sie alle Filter zurücksetzen und wieder alle Geräte anzeigen möchten.

Info: Wenn Sie die Liste anhand eines Textfelds, z.B. Gerätename, in aufsteigender oder absteigender Reihenfolge sortieren lassen, beachten Sie, dass die daraus resultierende alphabetische Sortierung auf ASCII/UTF basiert: A < B < … < Z < … < a < b … < z. Namen, die mit Kleinbuchstaben beginnen, werden unter allen Namen mit Großbuchstaben aufgelistet bzw. umgekehrt.

Gruppieren von Geräten

Sie können Geräte beliebig nach Ihren Bedürfnissen gruppieren. Ein Gerät kann sich in mehreren Gruppen befinden und Gruppen selbst können wiederum Teil von mehreren anderen Gruppen sein.

Cumulocity IoT unterscheidet zwischen Top-Level-Gruppen und untergeordneten Gruppen:

Top-Level-Gruppen werden im Menü Gruppen des Navigators auf oberster Ebene angezeigt.
Untergeordnete Gruppen dienen zur weiteren Unterteilung von Top-Level-Gruppen.

Anzeigen von Gruppen

Um eine Liste aller Gruppen in Ihrem Konto anzuzeigen, klicken Sie Gruppen im Navigator.

Für jede Gruppe wird der Name und die Anzahl der Kinder angezeigt.

Klicken Sie auf eine Gruppe, um Details dieser Gruppe anzuzeigen.

Registerkarte Info

In der Registerkarte Info werden folgende Informationen angezeigt:

Kind-Assets

In der Registerkarte Kind-Assets werden alle Geräte angezeigt, die der Gruppe zugewiesen wurden. Für jedes Kind-Asset wird der Name und im Fall einer Gruppe die Anzahl der Kinder angezeigt.

Siehe auch So fügen Sie eine Gruppe hinzu und So weisen Sie einer Gruppe ein Gerät zu.

Bulk-Operationen

In der Registerkarte Bulk-Operationen können Bulk-Operationen, die für die Gruppe erstellt wurden, verwaltet werden. Mit Bulk-Operationen können Sie eine Operation in einem Schritt für jedes Gerät in einer Gruppe ausführen. Weitere Informationen finden Sie unter Bulk-Operationen in “Überwachen und Steuern von Geräten”.

Info: Bulk-Operationen werden nach Datum geordnet, wobei die letzte Operation an erster Stelle erscheint.

So erstellen Sie eine neue Gruppe

1. Klicken Sie auf die Schaltfläche Plus rechts in der oberen Leiste und anschließend auf Gruppe hinzufügen.
   
2. Geben Sie im darauf folgenden Dialog einen eindeutigen Namen für die Gruppe an.
3. Geben Sie im Suchfeld die Suchkriterien für die Geräte ein, die Sie zur Gruppe hinzufügen möchten (z. B. “ublox”). Eine Liste mit passenden Geräten wird angezeigt.
4. Wählen Sie die Geräte aus, die Sie hinzufügen möchten.
5. Klicken Sie Gruppe mit # Gerät(en) erstellen, um die neue Gruppe zu erstellen.

Die neue Gruppe wird der Gruppenliste hinzugefügt.

Info: Eine Gruppe kann mit “0” Geräten erstellt werden.

Auf der Seite Gruppen können Sie auch eine neue Gruppe erstellen, in dem Sie in der oberen Menüleiste auf Gruppe hinzufügen klicken. Geben Sie im darauf folgenden Dialog einen Namen für die Gruppe an und klicken Sie Gruppe hinzufügen.

So bearbeiten Sie eine Gruppe

1. Wählen Sie im Navigator eine Gruppe aus.
2. Klicken Sie Bearbeiten in der Registerkarte Info. Sie können den Namen der Gruppe bearbeiten sowie Benutzerberechtigungen für die Gruppe zuweisen. Weitere Informationen zu den Berechtigungen finden Sie unter Verwalten von Berechtigungen im Abschnitt “Administration”.

So löschen Sie eine Gruppe

Klicken Sie bei einem Geräteeintrag auf das Menüsymbol und anschließend auf Löschen.

Verwalten von Geräten in Gruppen

So weisen Sie einer Gruppe Geräte zu

Geräte können Gruppen auf mehrere Arten zugewiesen werden.

Aus der Gruppenperspektive

Durch Ziehen und Ablegen können Sie im Navigator auf schnelle Weise Geräte zu Gruppen zuweisen, siehe Umsortieren von Gruppen und Geräten.

Darüber hinaus können Sie Geräte auch durch folgende Schritte zuweisen:

1. Wählen Sie im Navigator eine Gruppe aus dem Menü Gruppen und wechseln Sie zur Registerkarte Kind-Assets.
2. Klicken Sie Geräte zuweisen rechts in der oberen Menüleiste. Im darauf folgenden Dialog können Sie Suchkriterien für die Geräte eingeben, die Sie zu der Gruppe hinzufügen möchten (z. B. “ublox”). Eine Liste mit passenden Geräten wird angezeigt.
3. Wählen Sie die Geräte aus, die Sie hinzufügen möchten.
4. Klicken Sie Gruppe mit # Gerät(en) erstellen, um die Geräte der Gruppe zuzuweisen.

Die Geräte werden der ausgewählten Gruppe zugewiesen.

Aus der Geräteperspektive

1. Wählen Sie ein Gerät aus der Geräteliste und öffnen Sie es.
2. Scrollen Sie in der Registerkarte Info zur Karte Gruppenzuweisung. Wählen Sie im Auswahlfeld die Gruppe aus, der Sie das Gerät zuweisen möchten. Sie können hier auch direkt einen Gruppennamen eingeben oder nur Teile eines Namens eingeben, um die Liste danach zu filtern und nur die passenden Gruppennamen anzuzeigen.
3. Klicken Sie Zuweisen.

Das Geräte wird der ausgewählten Gruppe zugewiesen.

Wenn Sie nach einer Gruppe anhand eines Namens suchen, der noch nicht existiert, wird die Schaltfläche Neu angezeigt, so dass Sie von hier aus eine neue Gruppe mit diesem Namen erstellen und ihr das Gerät zuweisen können.

Info: Zum Erstellen einer neuen Gruppe muss der Benutzer über folgende Berechtigungen verfügen: ROLE_INVENTORY_CREATE und ROLE_INVENTORY_ADMIN.

So heben Sie die Zuweisung eines Geräts auf

Klicken Sie bei einem Geräteeintrag auf das Menüsymbol und anschließend auf Zuweisung aufheben.

So löschen Sie ein Gerät

Klicken Sie bei einem Geräteeintrag auf das Menüsymbol und anschließend auf Löschen.

Das Gerät wird dauerhaft gelöscht.

So zeigen Sie die Gerätedetails an

Klicken Sie bei einem Geräteeintrag auf das Menüsymbol und anschließend auf Device Management.

Die Gerätedetails für das jeweilige Gerät, die unter Alle Geräte in der Anwendung Device Management gespeichert sind, werden geöffnet.

Umsortieren von Gruppen und Geräten

Durch Ziehen und Ablegen können Sie Gruppen, Untergruppen und Geräte auf einfache Weise neu strukturieren.

So verschieben Sie eine Gruppe

1. Wählen Sie im Navigator eine Gruppe aus, die Sie zu einer andere Gruppe verschieben möchten.
2. Ziehen Sie sie zur gewünschten Gruppe und legen Sie sie dort ab.
3. Bestätigen Sie das Kommando im darauf folgenden Dialog.

So können Sie ein Gerät verschieben oder hinzufügen

1. Wählen Sie im Navigator die Gruppe oder das Gerät aus, die/das Sie zu einer anderen Gruppe verschieben oder dieser hinzufügen möchten.
2. Ziehen Sie sie zur gewünschten Gruppe und legen Sie sie dort ab.
3. Wählen Sie im darauf folgenden Dialog, ob das Gerät verschoben oder hinzugefügt werden soll.

Verwenden von dynamischen Gruppen

Dynamische Gruppen werden basierend auf Filterkriterien erstellt. Dieser Gruppentyp kann beispielsweise eingesetzt werden, um Bulk-Upgrades von Geräten eines bestimmten Typs auf eine neue Software- oder Firmware-Version durchzuführen.

Beachten Sie, dass dynamische Gruppen nur in der Device Management-Anwendung verfügbar und in der Cockpit-Anwendung nicht sichtbar sind.

Dynamische Gruppen werden in der Geräteliste erstellt.

So erstellen Sie eine dynamische Gruppe

1. Klicken Sie Alle Geräte im Navigator, um die Geräteliste anzuzeigen.
2. Filtern Sie die Geräte in der Liste nach den gewünschten Kriterien. Nähere Information zum Filtern finden Sie unter Filtern von Geräten.
3. Klicken Sie Dynamische Gruppe erstellen rechts in der oberen Menüleiste.
4. Geben Sie einen Namen für die Gruppe ein und klicken Sie Erstellen.

Die neue Gruppe erscheint als Top-Level-Gruppe im Menü Gruppe im Navigator. Dynamische Gruppen werden durch ein kleines Zahnrad im Ordnersymbol gekennzeichnet.

In der Registerkarte Kind-Assets können Sie Ihre Auswahl anpassen und die Filtereinstellungen ändern.

So löschen Sie eine dynamische Gruppe

Um eine dynamische Gruppe zu löschen, klicken Sie auf das Menüsymbol und anschließend auf Löschen.

Wichtig: Das Löschen einer dynamischen Gruppe ist irreversibel.

Gerätedetails

Zu jedem Gerät werden im Device Management detaillierte Informationen angezeigt. Welche Informationen jeweils angezeigt werden, ist abhängig vom Gerätetypen, der Gerätenutzung und der Konfiguration der Plattform.

Klicken Sie auf ein Gerät in der Geräteliste, um die Gerätedetails anzuzeigen.

Die Gerätedetails sind in verschiedene Registerkarten aufgeteilt. Die Anzahl der Registerkarten ist dynamisch und abhängig von den jeweils verfügbaren Informationen, d.h. Registerkarten werden nur angezeigt, wenn entsprechende Informationen für das jeweilige Gerät vorhanden sind.

Eingangs wird die Registerkarte Info angezeigt, die allgemeine Informationen zu einem Gerät enthält und bei allen Geräte vorhanden ist.

Jedes Gerät enthält mindestens die folgenden Registerkarten: Info, Alarme, Steuerung, Ereignisse, Serviceüberwachung, Identifikator (siehe auch die folgende Liste der Registerkarten).

Die folgenden Registerkarten sind die am häufigsten vorhandenen und werden in den folgenden Abschnitten detailliert beschrieben:

Info: Mögliche weitere spezielle Registerkarten, die nicht hier aufgeführt sind, werden in dem entsprechenden Kontext an anderer Stelle in der Cumulocity IoT-Dokumentation beschrieben. Nutzen Sie die Suchfunktion, um zu den betreffenden Abschnitten zu gelangen. Eine detaillierte Beschreibung der Registerkarte Modbus ist beispielsweise unter Cloud Fieldbus im Protocol Integration Guide zu finden.

Unter dem Namen wird eine Liste von Breadcrumbs angezeigt. Ist das Gerät Teil einer Asset-Hierarchie (z. B. einer Gruppe), können Sie mit Hilfe der Breadcrumbs einfach in der Hierarchie nach oben navigieren. Da Geräte zu mehreren Hierarchien gehören können, werden möglicherweise mehrere Breadcrumb-Zeilen angezeigt.

Abhängig vom Gerätetypen und seiner Nutzung sind weitere Aktionen möglich, die in einem Aktionsmenü angezeigt werden, wenn Sie Mehr… rechts in der oberen Menüleiste klicken.

Details zu den einzelnen Menüpunkten sind dort beschrieben, wo diese relevant sind.

Info

Die Registerkarte Info fasst die Geräteinformationen, die aus Managementsicht relevant sind, in einem Dashboard zusammen.

Die Information wird auf den folgenden Karten bereitgestellt:

Kindgeräte

Die Registerkarte Kindgeräte zeigt eine Liste von Geräten, die mit dem aktuellen Gerät verbunden sind. Wenn es sich bei dem aktuellen Gerät beispielsweise um ein Gateway handelt, werden alle Maschinen, die mit dem Gateway verbunden sind, aufgelistet.

Weitere Informationen zur Kindgeräte-Liste finden Sie unter Anzeigen von Geräten.

Messwerte

Die Registerkarte Messwerte zeigt eine Standardvisualisierung der vom Gerät bereitgestellten numerischen Daten in Form von Diagrammen. Die Diagramme sind in Messwert-Typen aufgeteilt, die jeweils mehrere Graphen und “Series” enthalten können.

Die Abbildung unten zeigt beispielsweise ein Diagramm mit Bewegungsmesswerten, einschließlich Graphen für Beschleunigung in drei Dimensionen sowie ein Diagramm mit Modemstatistiken im Form von Signalstärken und Bit-Fehlerraten.

Wenn ein Diagramm Graphen mit verschiedenen Einheiten enthält, wird pro Einheit eine Y-Achse dargestellt. In der Beispielabbildung bestehen die Bewegungsmesswerte aus drei Parametern mit der Einheit “Meter je Sekundequadrat”, daher wird nur eine Achse dargestellt. Die Modemstatistiken bestehen aus einer Signalstärke in Dezibel Milliwatt und der Bit-Fehlerrate in Prozent, daher wird eine Achse pro Graph dargestellt.

Bewegen Sie den Mauszeiger über den Graphen, um detaillierte Informationen zu den Messwerten anzuzeigen. Neben dem Mauszeiger wird ein Tooltip mit Details zum jeweiligen Messwert angezeigt (der Tooltip rastet bei dem am nächsten liegenden Messwert ein).

Zeitintervall und Aggregation

Standardmäßig zeigen Diagramme die Ausgangsdaten der letzten Stunde. Um das Zeitintervall der X-Achse zu ändern, öffnen Sie das entsprechende Auswahlmenü rechts oben und wählen Sie ein anderes Zeitintervall.

Wenn Sie das Zeitintervall vergrößern, wechselt der Wert im Feld Aggregation automatisch auf “stündlich” oder “täglich”. Das Diagramm zeigt nun Bereiche anstelle von einzelnen Datenpunkten. Für “stündlich” zeigt das Diagramm den Bereich des minimalen und maximalen Werts gemessen in der letzten Stunde. Für “täglich” zeigt das Diagramm den Bereich des minimalen und maximalen Werts gemessen über einen Tag. Entsprechend zeigen die Tooltips nun Wertebereiche anstelle von Einzelwerten.

Dies ermöglicht einen effizienten Überblick über größere Zeitintervalle. Es werden maximal 5.000 Datenpunkte pro Graph angezeigt, um eine Überlastung Ihres Desktop-Browsers zu vermeiden. Wenn Sie einen genaueren Fokus wählen, der mehr als 5.000 Datenpunkte ergibt, wird eine entsprechende Warnung angezeigt: “Abgeschnittene Daten. Ändern Sie die Aggregation oder wählen sie einen kürzeren Zeitraum.”

Klicken Sie Echtzeit, um Echtzeitaktualisierungen der Graphen zu erhalten, sobald neue Daten von den Geräten empfangen werden.

Sie können die graphische Darstellung und Achsenbegrenzung durch sogenannte “KPIs” modifizieren, siehe Administration.

Messwerteformate

Um Messwertgraphen anzuzeigen, muss das Gerät Messwerte in einem bestimmten Fragmentformat senden.

"fragment_name" : {
	"serie_name" : {
		"value" : ...
		"unit" : ...
	}
}

Beispiel:

"c8y_SpeedMeasurement": {
      "Speed": { "value": 1234, "unit": "km/h" }
}

"Fragment_name" und "serie_name" können durch verschiedene gültige JSON-Attributnamen ersetzt werden, aber es sind keine Leerzeichen oder Sonderzeichen wie [ ],* zulässig. Die Struktur muss genau wie oben ein JSON-Objekt mit zwei Ebenen sein.

Alarme

Die Registerkarte Alarme enthält Informationen zu den Alarmen für ein Gerät. Weitere Informationen finden Sie unter Verwenden von Alarmen.

Konfiguration

Die Registerkarte Konfiguration ermöglicht das Konfigurieren der Parameter und Grundeinstellungen Ihres Geräts. Abhängig vom Gerät sind folgende Konfigurationen möglich:

• Textbasierte Konfigurationen
• Binärbasierte Konfigurationssnapshots

Weitere Informationen zum Verwalten von binärbasierten Konfigurationssnapshots finden Sie unter Verwalten von Gerätedaten > Verwalten von Konfigurationen.

So fordern Sie den aktuellen textbasierten Konfigurationssnapshot an.

1. Navigieren Sie zur Registerkarte Konfiguration.
2. Klicken Sie auf Snapshot vom Gerät abrufen.

So können Sie einen textbasierten Konfigurationssnapshot hinzufügen oder bearbeiten

1. In der Registerkarte Konfiguration können Sie manuell die Gerätekonfiguration im Textfeld hinzufügen oder bearbeiten.
2. Klicken Sie auf Konfiguration an Gerät senden, um Ihre Eingaben zu speichern.

Info: Wenn ein Gerät sowohl die textbasierte als auch die binärbasierte Konfiguration unterstützt, zeigt die Registerkarte Konfiguration für jeden Konfigurationstyp eine untergeordnete Registerkarte an.

Steuerung

Die Registerkarte Steuerung enthält eine Liste der an das Gerät gesendeten Operationen. Weitere Informationen zu Operationen finden Sie unter Verwenden von Operationen.

Netzwerk

In der Registerkarte Netzwerk können Parameter für das mobile Netzwerk (WAN) und das lokale Netzwerk (LAN) angezeigt und konfiguriert werden.

Die WAN-Parameter auf der Benutzeroberfläche entsprechen dem ersten im Router gespeicherten Profil. Diese Parameter können remote oder per SMS konfiguriert werden.

Info: Für die SMS-Konfiguration muss der Router so konfiguriert werden, dass er SMS-Kommandos akzeptiert.

So konfigurieren Sie WAN-Parameter

1. Geben Sie den Access Point Name (APN) ein.
2. Geben Sie den Benutzernamen und das Passwort Ihres Kontos in der Plattform ein, mit der Sie eine Verbindung herstellen möchten.
3. Wählen Sie den Authentifizierungstyp aus.
4. Klicken Sie Änderungen speichern, um Ihre Eingaben zu speichern.

So konfigurieren Sie LAN-Parameter

Zum Konfigurieren von LAN-Parametern geben Sie einfach IP-Adresse und Subnetzmaske ein.

Info: Die Felder Name und MAC-Adresse sind nicht konfigurierbar.

So konfigurieren Sie DHCP-Parameter

1. Geben Sie den Adressbereich ein, in dem die Verbindung hergestellt werden kann.
2. Geben Sie den DNS ein.
3. Geben Sie den DNS 2 ein.
4. Geben Sie den Domain-Namen ein.
5. Klicken Sie Änderungen speichern, um Ihre Eingaben zu speichern.

Info: Wenn die LAN-Konfiguration deaktiviert ist, ist automatisch auch die DHCP-Konfiguration deaktiviert.

Software

Die Registerkarte Software ermöglicht es, die Firmware eines Geräts sowie die auf dem Gerät installierte Software zu verwalten und zu aktualisieren.

So installieren Sie Firmware/Software

Wählen Sie eine Firmware aus der Auswahlliste, die sämtliche im Firmware Repository verfügbare Firmware enthält, und klicken Sie Installieren.

Ähnliches gilt für das Installieren einer Software auf dem Gerät: Wählen Sie ein Software-Paket aus der Auswahlliste, die sämtliche im Software Repository verfügbare Software enthält, und klicken Sie Installieren.

Das Installieren von Software oder Firmware beinhaltet normalerweise einen Geräteneustart. Um den Fortschritt einer Installation zu überwachen, wechseln Sie zur Registerkarte Steuerung.

So entfernen Sie Firmware/Software

Um ein Firmware-/Software-Objekt von einem Gerät zu löschen, fahren Sie mit dem Mauszeiger über den entsprechenden Eintrag und klicken Sie auf das Löschen-Symbol.

Ereignisse

Die Registerkarte Ereignisse zeigt die mit dem Gerät verbundenen Ereignisse an. Dies ermöglicht unter anderem eine Fehlersuche. Weitere Informationen finden Sie unter Fehlerbehebung von Geräten.

Standort

Die Registerkarte Standort zeigt standardmäßig den Standort eines Geräts auf einer Karte und als Koordinaten, wie vom Gerät gesendet, an. Für Geräte, die keinen Standort senden, können Sie manuell einen Standort eingeben. Platzieren Sie einfach den “Pin” an die entsprechende Stelle in der Karte.

Die Registerkarte Standort zeigt außerdem, wenn ein Gerät das Attribut “c8y_Position” enthält. Wenn Sie ein neues c8y-Position-Ereignis senden, können Sie das gleiche c8y-Position-Fragment auf dem Gerät setzen, so dass das Gerät automatisch seine Position in der Karte markiert.

Logdateien

Die Registerkarte Logdateien ermöglicht es, Loginformationen von Geräten zu verwalten.

So fragen Sie Loginformationen ab

1. Klicken Sie Logdatei anfordern rechts in der oberen Menüleiste der Registerkarte Logdateien.
2. Geben Sie im darauf folgenden Dialog einen Datum- und Uhrzeitbereich für die Loginformationen ein.
3. Wählen Sie den Logdateityp aus der Auswahlliste. Die unterstützten Logs sind üblicherweise geräteabhängig.
4. Legen Sie optional einen Textfilter fest. Wenn Sie etwa “Users” eingeben, werden nur Zeilen ausgegeben, die den Begriff “Users” enthalten.
5. Legen Sie die maximale Anzahl der auszugebenden Zeilen fest (von hinten gezählt). Der Standardwert ist 1000.
6. Klicken Sie Logdatei anfordern.

Die Loginformationen des Geräts werden abgefragt.

Das Abfragen der Logdaten von einem Gerät kann einige Zeit in Anspruch nehmen.

Sobald die Logdaten vom Gerät auf die Cumulocity IoT-Plattform übertragen wurden, werden Sie in der Registerkarte Logdaten gelistet. Die Zeile in der Liste zeigt das jeweils angeforderte Zeitintervall.

Klicken Sie auf den Eintrag in der Liste, um die gesamten Loginformationen anzuzeigen.

So laden Sie Logdaten herunter

Bewegen Sie den Mauszeiger über eine Zeile und klicken Sie auf das Herunterladen-Symbol, um den Logauszug in Ihr Dateisystem herunterzuladen.

So löschen Sie Logdaten

Bewegen Sie den Mauszeiger über eine Zeile und klicken Sie auf das Löschen-Symbol, um die Loginformationen zu löschen.

Serviceüberwachung

Zusätzlich zur Verbindungsüberwachung bietet Cumulocity IoT eine Serviceüberwachung von Maschinen, siehe Serviceüberwachung.

Shell

Die Registerkarte Shell ermöglicht es, interaktiv mit entfernten Geräten zu arbeiten. Viele industrielle Geräte unterstützen Kommandosprachen wie etwa AT-Kommandos für Modems, CSV-artige Kommandos für viele Tracking-Systeme oder aufwendigere Scripting-Mechanismen wie Tixi TiXML. In der Shell können Kommandos in der entsprechenden Sprache an das Gerät gesendet und die Ergebnisse angezeigt werden.

Die Registerkarte Shell enthält eine Kommandozeile zur Eingabe der Kommandos.

In der Kommandozeile kann beliebiger Kommandotext eingegeben werden. Klicken Sie Ausführen, um das Kommando an das Gerät zu senden. Diese Schaltfläche ist nur aktiviert, wenn das Gerät online ist.

Wichtig: Wenn Sie Cumulocity IoT zum Fernsteuern von Maschinen verwenden, vergewissern Sie sich, dass alle Remotevorgänge den Sicherheitsstandards entsprechen und keine Gefahr darstellen.

Klicken Sie Historie ansehen rechts in der oberen Menüleiste, um zur Registerkarte Steuerung zu wechseln, in der eine Liste der zuvor ausgeführten Operationen angezeigt wird. Weitere Informationen finden Sie unter Überwachen und Steuern von Geräten > Verwenden von Operationen.

Cumulocity IoT stellt für manche Gerätetypen einige häufig verwendete Kommandos bereit. Klicken Sie <_Beispielkommando auswählen rechts in der oberen Menüleiste, um eine Liste der verfügbaren vordefinierten Kommandos anzuzeigen. Wählen Sie das gewünschte Kommando aus und klicken Sie Verwenden, um das ausgewählte Kommando in der Kommandozeile einzufügen oder klicken Sie Ausführen, um das Kommando unmittelbar auszuführen. Sie können auch selbst neue Kommandos zur Wiederverwendung hinzufügen.

Tracking

In Cumulocity IoT können Geräte die Historie ihrer Bewegungen festhalten. Diese Bewegungen können in der Registerkarte Tracking angezeigt werden.

Info: Die Registerkarte Tracking wird nur angezeigt, wenn ein Gerät das Attribut “c8y_Position” enthält.

In der Auswahlliste oben rechts können Sie ein Zeitintervall auswählen (oder eines eingeben, indem Sie “Benutzerdefiniert” auswählen). Die Bewegungen des Geräts während des ausgewählten Zeitintervalls werden als rote Linien in der Karte visualisiert.

Neben der Karte werden die einzelnen Einträge mit Zeitangabe aufgelistet (“Standortaktualisierungsereignisse”). Wenn Sie auf einen Eintrag klicken, zeigt ein “Pin” auf der Karte den Standort zu diesem Zeitpunkt an.

Abhängig vom Gerätetypen und der Integration in Cumulocity IoT können Sie geräteseitiges Geofencing und Bewegungserfassung konfigurieren.

Info: Wenn diese Funktion aktiviert und das Gerät kompatibel ist, kann die Zellen-ID-Information genutzt werden, um die Position des Geräts zu bestimmen. Aktuell werden die Services von Combain und Google unterstützt. Der Benutzer kann die Ortungen basierend auf beiden Datentypen ansehen oder nach GPS-basierten Daten oder Zellen-ID-basierten Daten filtern.

Identifikator

Cumulocity IoT kann Geräte und Assets mit mehreren externen Identifikatoren verknüpfen. Geräte werden beispielsweise oft durch die IMEI ihres Modems, eine Microcontroller-Seriennummer oder ein Asset-Tag identifiziert. Die Registerkarte Identifikator listet alle gespeicherten Identifikatoren für ein Gerät auf.

Dies ist etwa hilfreich, wenn Hardware nicht mehr funktioniert und ausgetauscht werden muss, ohne bereits aufgezeichnete Daten zu verlieren. Verbinden Sie die neue Hardware mit Ihrem Konto und modifizieren Sie den Identifikatoren-Eintrag der alten Hardware, so dass er die Identität der neuen Hardware enthält.

Überwachen und Steuern von Geräten

Lokalisieren von Geräten

Cumulocity IoT bietet die Möglichkeit, den Standort aller Geräte in Ihrem Konto auf einer Karte anzuzeigen.

Klicken Sie Karte im Menü Geräte im Navigator, um eine Karte zu öffnen, die alle Geräte in Echtzeit anzeigt.

Die Geräte sind als “Pins” dargestellt. Klicken Sie auf einen Pin, um den Namen des entsprechenden Geräts anzuzeigen. Klicken Sie auf den Gerätenamen, um zur Ansicht der Gerätedetails zu wechseln.

Verbindungsüberwachung

Im Device Management können Sie die Verbindungen zu Ihren Geräten überwachen.

Dies kann auf der Ebene einzelner Geräte erfolgen (siehe unten) oder für mehrere Geräte in einer Liste.

So überwachen Sie die Verbindung für mehrere Geräte

Öffnen Sie eine Geräteliste, um die Verbindungen für mehrere Geräte zu überwachen.

Der Verbindungsstatus wird durch Pfeile in der Spalte Status in der Geräteliste angezeigt.

Sendeverbindungen

Der obere Pfeil symbolisiert die Sendeverbindungen (Verkehr vom Gerät zu Cumulocity IoT). Der Status der Sendeverbindungen kann einer der folgenden sein:

• Grüner Pfeil - online (Daten wurden im erwarteten Intervall gesendet)
• Roter Pfeil - offline (Daten wurden nicht im erwarteten Intervall gesendet)
• Grauer Pfeil - unbekannt oder nicht überwacht (kein Intervall konfiguriert)

Wenn Sie den Mauszeiger über einen Pfeil bewegen, wird der Zeitstempel der letzten Anfrage vom Gerät an den Server angezeigt.

Wenn ein Gerät als offline erkannt wird (sendet keine Daten im erwarteten Intervall und der obere Pfeil wechselt auf rot), wird ein “UnavailabilityAlarm” für das Gerät mit der folgenden Nachricht erzeugt: “Im erforderlichen Zeitraum wurden keine Daten vom Gerät empfangen.”

Push-Verbindungen

Der untere Pfeil symbolisiert die Push-Verbindungen (von Cumulocity IoT zum Gerät). Der Status der Push-Verbindungen kann einer der folgenden sein:

• Grüner Pfeil - online (Verbindung hergestellt)
• Roter Pfeil - offline (Verbindung nicht hergestellt)
• Grauer Pfeil - nicht überwacht

Push-Verbindung bedeutet Verbindung von Cumulocity IoT zu /device/control/notifications API, nicht zu /device/control/realtime API.

Info: Die Verbindungsüberwachung erfolgt nicht in Echtzeit. Dies bedeutet, dass sich der angezeigte Verbindungsstatus nach dem Ausschalten eines Geräts nicht sofort ändert. Je nach verwendetem Protokoll für die Push-Verbindungsüberwachung kann dies einige Minuten dauern.

Maintenance mode

Außerdem kann sich ein Gerät im Wartungsmodus befinden. Dies wird durch ein Werkzeug-Symbol in der Spalte Status gekennzeichnet. Dieser spezielle Verbindungsstatus zeigt an, dass das Gerät gerade gewartet wird und nicht überwacht werden kann. Während ein Gerät gewartet wird, werden keine Alarme für dieses Gerät ausgelöst.

In der Karte Verbindungsüberwachung in der Registerkarte Info eines Geräts können Sie den Wartungsmodus für dieses Gerät durch einen Umschalter ein- oder ausschalten, siehe unten.

So überwachen Sie die Verbindung eines bestimmten Geräts

Navigieren Sie zur Registerkarte Info eines bestimmten Geräts, um dessen Verbindungen zu überwachen. Unter Gerätestatus wird der Verbindungsstatus für das Gerät angezeigt.

Unter dem Status für die Sende- und Push-Verbindungen wird der Zeitpunkt der letzten Kommunikation angezeigt.

Info: “Letzte Kommunikation” und “Letzte Aktualisierung” sind zwei vollkommen verschiedene Zeitstempel. “Letzte Kommunikation” zeigt an, wann ein Gerät das letzte mal Daten gesendet hat. “Letzte Aktualisierung” zeigt an, wann der Stammdateneintrag des Geräts das letzte mal aktualisiert wurde. Diese Aktualisierung kann durch das Gerät selbst, über die Web-Benutzerschnittstelle oder durch eine andere Anwendung erfolgt sein.

Im Feld Erwartetes Sendeintervall können Sie ein Intervall angeben. Dieser Parameter legt fest, wie häufig Sie erwarten, von dem Gerät zu hören. Wenn Sie dieses Intervall etwa auf 60 setzen, erwarten Sie, dass das Gerät mindestens einmal pro Stunde mit Cumulocity IoT kommuniziert. Das Intervall wird entweder vom Gerät selbst festgelegt, basierend auf den Kenntnissen des Geräts darüber, wie oft es versuchen wird, Daten zu senden, oder es wird manuell von Ihnen festgelegt.

Wenn ein Intervall angegeben ist, befindet sich darunter der Umschalter Wartung.

Mit dem Umschalter Wartung können Sie den Wartungsmodus für das Gerät ein- oder ausschalten. Dies wird unmittelbar im Verbindungsstatus angezeigt.

Serviceüberwachung

Cumulocity IoT unterscheidet zwischen Verbindungsüberwachung und Serviceüberwachung. Verbindungsüberwachung, wie im vergangenen Abschnitt beschrieben, zeigt nur an, ob ein Gerät mit Cumulocity IoT kommuniziert, was nicht automatisch auch bedeutet, dass das Gerät betriebsbereit ist.

Serviceüberwachung dagegen zeigt an, ob ein Gerät in Betrieb ist. Ein Verkaufsautomat ist beispielsweise in Betrieb, wenn er bereit ist, Waren zu verkaufen. Ein Verkaufsautomat kann ohne eine Verbindung zu Cumulocity IoT gegen Bargeld Waren verkaufen. Aus kaufmännischer Sicht ist der Automat also betriebsbereit. Ähnlich können Geräte hinter einem Gateway weiterarbeiten, auch wenn das Gateway ausgeschaltet wurde.

Cumulocity IoT betrachtet ein Gerät als betriebsbereit, wenn es für das Gerät keine kritischen aktiven Alarme gibt. Dies wird entsprechend des Zeitanteils, den Alarme aktiv waren, dargestellt. Hat ein Gerät innerhalb eines bestimmten Zeitraums keinerlei kritische Alarme, war es zu 100% in Betrieb. Gab es während der Hälfte der Zeit kritische aktive Alarme, war es zu 50% in Betrieb.

Ist ein Gerät offline, nimmt Cumulocity IoT standardmäßig an,

• dass das Gerät während des Verbindungsabbruchs weiterhin in Betrieb bleibt, wenn dies zuvor der Fall war.
• dass das Gerät während des Verbindungsabbruchs weiterhin nicht in Betrieb ist, wenn dies zuvor der Fall war.

Es gibt möglicherweise Ausnahmen zu dieser Regel. Wenn Ihr Verkaufsautomat beispielsweise nur mit bargeldloser Bezahlung funktioniert, bedeutet ein Verbindungsabbruch, dass der Automat nichts mehr verkaufen kann und damit nicht mehr betriebsbereit ist. In diesem Fall müssen Nichtverfügbarkeits-Alarme in der “Administration”-Anwendung eingestellt werden, die den Schweregrad KRITISCH statt des Schweregrads WICHTIG haben.

Cumulocity IoT zeigt die Serviceverfügbarkeit für einzelne Geräte sowie für alle Geräte an.

So zeigen Sie die Serviceüberwachung eines bestimmten Geräts an

Klicken Sie auf die Registerkarte Serviceüberwachung in den Details eines bestimmten Geräts, um die Serviceüberwachung dieses Geräts zu überprüfen.

So zeigen Sie die Serviceüberwachung für alle Geräte an

Klicken Sie Serviceüberwachung im Menü Geräte des Navigators, um den Gesamtservice aller Geräte anzuzeigen.

Die Seite Serviceüberwachung zeigt die prozentuale Verfügbarkeit aller Geräte während der letzten 24 Stunden, der letzten 7 Tage und der letzten 30 Tage an.

Verwenden von Alarmen

Geräte können Alarme auslösen, um anzuzeigen, dass ein Problem besteht, das einer Handlung bedarf.

So zeigen Sie Alarme an

Cumulocity IoT zeigt Alarme für einzelne Geräte sowie für alle Geräte an:

• Um die Alarme für alle Geräte zu überprüfen, klicken Sie Alarme im Menü Übersichten des Navigators.
• Um die Alarme eines bestimmten Geräts zu überprüfen, wechseln Sie zur Registerkarte Alarm in den Details dieses Geräts.

Standardmäßig

• werden nur ungelöste Alarme gezeigt. Wenn Sie rechts in der oberen Menüleiste Aufgehobene Alarme anzeigen aktivieren, sehen Sie die gesamte Alarmhistorie.
• werden Alarme in Echtzeit angezeigt, sobald sie vom Gerät gemeldet werden. Klicken Sie Echtzeit in der oberen Menüleiste, um Echtzeitaktualisierungen zu deaktivieren.

Alarme werden nach Schweregraden klassifiziert. Cumulocity IoT enthält vier verschiedene Alarmtypen:

Die Registerkarte Alarm ist entsprechend dieser Alarmtypen in vier Bereiche unterteilt.

Klicken Sie in der oberen Leiste auf eine der Schaltflächen für die Alarmtypen, um den entsprechenden Bereich auszublenden. Nochmaliges Klicken zeigt den Bereich wieder an.

In jedem Bereich sind die Alarme nach ihrem Auftreten sortiert, wobei der aktuellste zuerst angezeigt wird.

In jeder Zeile werden die folgenden Informationen für einen Alarm angezeigt:

Klicken Sie auf den Pfeil rechts in einem Eintrag, um die Zeile auszuklappen und weitere Details zum Alarm anzuzeigen.

• Status: Enthält weitere Informationen zum Alarmstatus und zeigt den Alarmtypen an. Die Typ-Information wird verwendet, um die Priorität von Alarmen zu konfigurieren, siehe Administration“ > Priorisieren von Alarmen.
• Änderungsprotokoll: Gibt die Serverzeit an, zu der der Alarm erstellt wurde. Diese kann von der Gerätezeit abweichen.

So ändern Sie den Status eines Alarms

Um den Status eines Alarms zu ändern, bewegen Sie den Mauszeiger über die Zeile und klicken Sie auf die entsprechende Schaltfläche oder klicken Sie auf das Menüsymbol und wählen Sie den gewünschten Status.

Außerdem ist es möglich, den Status aller Alarme auf einmal auf “aufgehoben” zu setzen. Klicken Sie Alle aufheben in der oberen Menüleiste, um alle Alarme der gewählten Schweregrade zu löschen.

Verwenden von Operationen

Operationen werden verwendet, um Geräte aus der Ferne zu steuern.

Sie können Operationen für einzelne Geräte oder für alle Geräte anzeigen:

• Um die Operationen für alle Geräte anzuzeigen, klicken Sie Gerätesteuerung im Menü Übersichten im Navigator.
• Um die Operationen eines bestimmten Geräts anzuzeigen, wechseln Sie zur Registerkarte Steuerung in den Details dieses Geräts.

In der Gerätesteuerung gibt es zwei Arten von Operationen, die jeweils auf einer eigenen Registerkarte angezeigt werden:

• Einzel-Operationen werden auf einzelnen Geräten ausgeführt, siehe So zeigen Sie Einzel-Operationen an.
• Bulk-Operationen bestehen aus einer Einzel-Operation, die auf einer Reihe von Geräten ausgeführt wird, siehe So zeigen Sie Bulk-Operationen an.

So zeigen Sie Einzel-Operationen an

• Details: Informationen zu Namen und Status der Operation. Lautet der Status = FEHLGESCHLAGEN, wird die Ursache für das Fehlschlagen angegeben. Ist die Einzel-Operation Teil einer Bulk-Operation, können Sie die Details der Bulk-Operation anzeigen.
• Änderungshistorie: Informationen zu den letzten Änderungen der Operation.

Um die Liste der einzelnen Operationen nach dem Status zu filtern, klicken Sie auf eine der Status-Schaltflächen in der oberen Menüleiste. Klicken Sie Alle, um den Filter wieder zurückzusetzen.

Klicken Sie Echtzeit rechts in der oberen Menüleiste, um die vom Gerät empfangenen Operationen in Echtzeit anzuzeigen. Klicken Sie Neu laden, um die Liste einmal manuell zu aktualisieren.

Info: Einzel-Operationen werden in absteigender Zeitfolge aufgelistet. Operationen werden streng nach dieser Reihenfolge ausgeführt.

So können Sie eine Einzel-Operation hinzufügen und ausführen

Einzel-Operationen können entweder aus Bulk-Operationen erstellt werden oder aus den verschiedenen Operationstypen, die das Gerät unterstützt: Verwalten von Firmware, Software, Konfigurationen etc.

Wenn Sie eine Bulk-Operation erstellen, werden die einzelnen Operationen, die in der Bulk-Operation abgearbeitet werden, ebenfalls zur Liste der Einzel-Operationen hinzugefügt.

Operationen für ein bestimmtes Gerät können auch in der Registerkarte Shell des Geräts erstellt und ausgeführt werden, siehe Gerätedetails > Shell.

Wichtig: Wenn Sie Cumulocity IoT zum Fernsteuern von Maschinen verwenden, vergewissern Sie sich, dass alle Remotevorgänge den Sicherheitsstandards entsprechen und keine Gefahr darstellen.

So brechen Sie ausstehende Operationen ab

Sie können bestimmte ausstehende Operationen oder alle ausstehenden Einzel-Operationen gleichzeitig abbrechen.

Um eine bestimmte ausstehende Operation abzubrechen, klicken Sie auf das Menüsymbol rechts neben dem Eintrag der betreffenden einzelnen Operation und wählen Sie Operation abbrechen.

Um alle ausstehenden Operationen gleichzeitig abzubrechen, klicken Sie auf Mehr… rechts in der oberen Menüleiste und wählen Sie Alle ausstehenden Operationen abbrechen. Alternativ können Sie die Liste der Einzel-Operationen nach dem Status AUSSTEHEND filtern, und anschließend auf Alle abbrechen klicken.

So erstellen Sie eine Regel für eine Einzel-Operation

Klicken Sie auf das Menüsymbol rechts neben der Einzel-Operation, für die Sie eine Smart Rule erstellen möchten, und wählen Sie Smart Rule erstellen.

Weitere Schritte werden unter Cockpit > Smart Rules > So erstellen Sie eine Smart Rule beschrieben.

So zeigen Sie Bulk-Operationen an

Mit Hilfe des Bulk-Operations-Assistenten können Sie Bulk-Operationen der folgenden Operationstypen hinzufügen:

Bulk-Operationen können auch andere Operationstypen besitzen, beispielsweise wenn Sie eine Einzel-Operation als Bulk-Operation planen und der Typ der einzelnen Operation sich von dem der Bulk-Operation unterscheidet.

Bulk-Operationen können sich in einem der folgenden Status befinden:

In jeder Zeile werden die folgenden Informationen für eine Bulk-Operation angezeigt:

Durch Klicken auf die Pfeil-Schaltfläche auf der rechten Seite können Sie die Zeile aufklappen und weitere Details zur Bulk-Operation anzeigen.

• Details: Informationen zu Startdatum, Verzögerung, Status und Ergebnis der Bulk-Operation. Das Ergebnis listet die Anzahl der erfolgreich abgeschlossenen, fehlgeschlagenen und ausstehenden Operationen auf.
• Operation: Informationen zur Operation in Form eines JSON-Objekts.
• Operationen: Nur verfügbar für Bulk-Operationen, die ausgeführt werden oder abgeschlossen sind. Informationen zu Status und Geräten von einzelnen Operationen, die in der Bulk-Operation abgearbeitet werden. Kann nach Status gefiltert werden.

Um die Liste der Bulk-Operationen nach Operationstyp zu filtern, klicken Sie auf die Auswahlliste in der Menüleiste, wählen Sie eine Reihe von Operationstypen und klicken Sie auf Anwenden. Um den Filter wieder zurückzusetzen, wählen Sie Alle in der Auswahlliste und klicken Sie erneut auf Anwenden.

Um die Liste der Bulk-Operationen nach dem Status zu filtern, klicken Sie auf eine der Status-Schaltflächen in der oberen Menüleiste. Klicken Sie Alle, um den Filter wieder zurückzusetzen.

Um beide Filter zurücksetzen, klicken Sie Filter zurücksetzen am Ende der Liste (nur sichtbar, wenn Filter angewendet wurden).

Info: Bulk-Operationen, die vor der Version 10.7.0 erstellt wurden, sind von einer Gruppe abhängig und können immer noch angezeigt werden. Wählen Sie dazu die gewünschte Gruppe und klicken Sie auf die Registerkarte Bulk-Operationen.

So fügen Sie eine Bulk-Operation hinzu

Es gibt zwei Möglichkeiten, eine Bulk-Operation anzulegen:

• Verwenden Sie den Bulk-Operations-Assistenten
• Planen Sie eine Einzel-Operation als Bulk-Operation

So fügen Sie eine Bulk-Operation mit Hilfe des Assistenten hinzu

So planen Sie eine Einzel-Operation als Bulk-Operation

1. Klicken Sie auf das Menüsymbol rechts neben der Einzel-Operation, die sie als Bulk-Operation planen möchten, und klicken Sie anschließend auf Als Bulk-Operation planen.
2. Der darauf folgende Assistent ähnelt dem neuen Bulk-Operations-Assistenten, der unter So fügen Sie eine Bulk-Operation mit Hilfe des Assistenten hinzu beschrieben wird. Allerdings gibt es nur zwei Schritte, da der Operationstyp von der als Bulk-Operation geplanten Operation abgeleitet wird. Lesen Sie die Beschreibung des vollständigen Assistenten und folgen Sie den Anweisungen.

So bearbeiten Sie den Zeitplan von Bulk-Operationen

Sie können nur den Zeitplan von Bulk-Operationen mit dem Status GEPLANT bearbeiten.

1. Klicken Sie auf das Menüsymbol rechts neben der Bulk-Operation, die Sie bearbeiten möchten, und anschließend auf Zeitplan bearbeiten.
2. Im darauf folgenden Dialog können Sie die Werte für Startzeit und Verzögerung ändern.
3. Klicken Sie Neu planen, um Ihre Einstellungen zu speichern.

Die Änderungen werden entsprechend auf die Bulk-Operation angewendet.

So brechen Sie Bulk-Operationen ab

Sie können nur Bulk-Operationen mit dem Status GEPLANT oder WIRD AUSGEFÜHRT abbrechen. Wenn eine Bulk-Operation gerade ausgeführt wird, können Sie sie nur solange abbrechen, bis alle Einzel-Operationen angelegt wurden. Auf diese Weise können Sie die Erstellung der verbleibenden Einzel-Operationen abbrechen.

Klicken Sie auf das Menüsymbol rechts neben der Bulk-Operation, die Sie abbrechen möchten, und anschließend auf Bulk-Operation abbrechen.

So führen Sie fehlgeschlagene Operationen erneut aus

Sie können die fehlgeschlagenen Operationen einer Bulk-Operation, die ausgeführt wird oder mit Fehlern abgeschlossen wurde, erneut ausführen.

Erweitern Sie dazu die gewünschte Bulk-Operation und klicken Sie unter Operationen auf Fehlgeschlagene Operationen erneut ausführen, um mit allen fehlgeschlagenen Operationen eine neue Bulk-Operation zu erstellen. Um eine Einzel-Operation erneut auszuführen, bewegen sie den Mauszeiger über die Operation und klicken Sie auf Operation erneut ausführen. Dadurch wird eine neue Einzel-Operation angelegt.

Bei einer Bulk-Operation, die mit Fehlern abgeschlossen wurde, können Sie auch auf das Menüsymbol rechts neben der Operation und anschließend auf Fehlgeschlagene Operationen erneut ausführen klicken.

Fehlerbehebung von Geräten

Eine Fehlerbehebung auf detaillierterer Ebene kann bei Geräten mit Hilfe von Ereignissen durchgeführt werden. Ereignisse sind von Geräten gesendete Low-Level-Nachrichten, die üblicherweise für die anwendungsspezifische Verarbeitung verwendet werden. So sendet zum Beispiel ein Verkaufsautomat seine Echtzeitverkäufe in Form von Ereignissen.

So zeigen Sie Ereignisse an

Cumulocity IoT zeigt Ereignisse für einzelne Geräte sowie für alle Geräte an:

• Um die Ereignisse für alle Geräte anzuzeigen, klicken Sie Ereignisse im Menü Übersichten des Navigators.
• Um die Ereignisse eines bestimmten Geräts anzuzeigen, wechseln Sie zur Registerkarte Ereignisse in den Details dieses Geräts.

Standardmäßig werden die Ereignisse in Echtzeit angezeigt, sobald sie vom Gerät empfangen werden. Um die Echtzeitaktualisierung zu deaktivieren, klicken Sie Echtzeit rechts in der oberen Menüleiste.

Für jedes Ereignis werden die folgenden Informationen bereitgestellt:

In der Ereignisliste wird der letzte Eintrag ganz oben angezeigt.

Durch Klicken einer Zeile wird diese aufgeklappt und weitere Details zum Ereignis angezeigt (wie der Typ und die Position des Geräts).

Da Geräte möglicherweise große Datenmengen senden, können Sie die angezeigten Daten nach Datum filtern.

Wählen Sie in den Feldern in der oberen Menüleiste ein Startdatum und ein Enddatum und klicken Sie Anwenden, um den Filter anzuwenden. Klicken Sie Aufheben, um den Filter wieder zurückzusetzen.

Verwalten von Gerätetypen

Um Daten aus verschiedenen Gerätetypen zu verarbeiten, verwendet Cumulocity IoT sogenannte Geräteprotokolle, die in einer Datenbank gespeichert sind.

Klicken Sie Geräteprotokolle im Menü Gerätetypen des Navigators.

Die Seite Geräteprotokolle zeigt eine Liste aller in Ihrem Konto verfügbaren Geräteprotokolle an.

Die Geräteprotokoll-Liste zeigt die folgenden Informationen an:

• den Geräteprotokolltypen (z. B. Modbus, CANOpen, LoRa)
• den Gerätetypnamen
• die Anzahl der Ressourcen für das Gerät (auf der rechten Seite)

So fügen Sie ein Geräteprotokoll hinzu

1. Klicken Sie Geräteprotokoll hinzufügen in der oberen Menüleiste.
   
2. Wählen Sie einen der verfügbaren Geräteprotokolltypen aus der Liste.
3. Geben Sie im darauf folgenden Dialog einen Namen und eine optionale Beschreibung für das Geräteprotokoll ein und klicken Sie Erstellen.
4. Geben Sie die Konfiguration für das Geräteprotokoll ein. Die Konfiguration des Geräteprotokolls hängt vom Protokolltypen ab.
   Weitere Informationen zum Konfigurieren von Geräteprotokollen finden Sie in der Dokumentation des jeweiligen Gerätetyps, den Sie anlegen möchten, siehe Protocol Integration Guide.
5. Klicken Sie Speichern.

Das Geräteprotokoll wird der Gerätedatenbank hinzugefügt.

So importieren Sie ein Geräteprotokoll

Um ein Geräteprotokoll aus einem bestehenden Protokoll hinzuzufügen, gehen Sie folgendermaßen vor:

1. Klicken Sie Importieren in der oberen Menüleiste.
   
2. Wählen Sie das zu importierende Geräteprotokoll entweder aus einer Liste der vordefinierten Protokolle aus oder laden Sie es aus einer Datei, indem Sie zu dieser navigieren.
3. Geben Sie einen Namen für das neue Protokoll ein und klicken Sie Speichern.

Das Geräteprotokoll wird der Gerätedatenbank hinzugefügt.

So bearbeiten Sie ein Geräteprotokoll

Zum Bearbeiten eines Geräteprotokolls klicken Sie einfach auf das Protokoll oder auf das Menüsymbol rechts neben der jeweiligen Zeile und anschließend auf Bearbeiten.

Weitere Informationen zu den Feldern finden Sie in der Dokumentation des jeweiligen Gerätetyps, siehe Protocol Integration Guide.

So löschen Sie ein Geräteprotokoll

Zum Löschen eines Geräteprotokolls klicken Sie auf das Menüsymbol rechts neben der jeweiligen Zeile und anschließend auf Löschen.

Das Geräteprotokoll wird aus der Gerätedatenbank gelöscht.

So exportieren Sie ein Geräteprotokoll

Zum Exportieren eines Geräteprotokolls klicken Sie auf das Menüsymbol rechts neben der jeweiligen Zeile und anschließend auf Exportieren.

Das Geräteprotokoll wird in Ihr Dateisystem exportiert.

Verwalten von Gerätedaten

Übersicht

Die Device Management-Anwendung bietet verschiedene Funktionen, die Sie bei der effizienten Verwaltung Ihrer Geräte unterstützen:

Sämtliche Funktionen können über das Menü Verwaltung im Navigator aufgerufen werden:

Verwalten von Geräte-Firmware

Mit dem Firmware-Repository bietet Cumulocity IoT die Möglichkeit, Referenz-Firmware für Geräte zu verwalten.

Pro Gerät kann nur eine Firmware-Paketversion angewendet werden.

Anzeigen von Firmware

Klicken Sie im Menü Verwaltung des Navigators auf Firmware Repository.

Die verfügbaren Firmware-Objekte werden in Form einer Liste angezeigt.

Jeder Eintrag enthält den Namen der Firmware, den Gerätetypen, auf den sie anwendbar ist (falls angegeben) und eine Bezeichnung, die angibt, ob und wie viele Versionen für eine bestimmte Firmware verfügbar sind.

Wenn sie auf einen Eintrag klicken, werden die Details dieser Firmware sowie alle verfügbaren Versionen und Patches angezeigt.

Am Anfang der Liste stehen der Name der Firmware, eine Beschreibung und ein oder mehrere Gerätetypfilter (optional). Wenn ein Filter gesetzt ist, wird die Firmware nur für die entsprechenden Geräte zur Installation angeboten. Ist kein Filter gesetzt, wird sie für alle Geräte angeboten.

Die Liste der Versionen und Patches enthält den Versionsnamen und den Namen der Firmware-Binärdatei. Darüber hinaus gibt sie an, ob für eine Firmware Patches bereitstehen. Durch Aufklappen des Versionseintrages können diese angezeigt werden. Die Versionen und Patches sind nach ihrem Erstellungszeitpunkt (absteigend) sortiert.

Hinzufügen von Firmware, Firmware-Versionen oder Firmware-Patches

So fügen Sie eine neue Firmware oder Firmware-Version hinzu

1. Klicken Sie auf der Seite Firmware Repository rechts in der oberen Menüleiste auf Firmware hinzufügen.
2. Im darauffolgenden Dialog können Sie
   • eine neue Firmware hinzufügen, indem Sie einen Namen für die Firmware eingeben (im nächsten Fenster durch Klicken auf Hinzufügen bestätigen) und eine Beschreibung sowie die Version hinzufügen (alle Angaben erforderlich).
   • eine neue Version hinzufügen, indem Sie die Firmware, für die Sie die Version hinzufügen möchten, in der Auswahlliste im Feld Firmware auswählen und eine Version eingeben.
3. Laden Sie entweder eine Binärdatei aus Ihrem Dateisystem hoch oder geben Sie eine URL an, unter der die Firmware heruntergeladen werden kann.
4. Klicken Sie Speichern.

Das Firmware-Objekt wird der Firmware-Liste bzw. die Firmware-Version den Firmware-Details hinzugefügt und die Versionsbezeichnung wird entsprechend aktualisiert.

Wenn Sie in den Details einer bestimmten Firmware auf Firmware hinzufügen klicken, sieht der Dialog etwas anders aus, da die Firmware bereits ausgewählt ist.

So fügen Sie einen neuen Firmware-Patch hinzu

1. Klicken Sie auf der Seite Firmware Repository rechts in der oberen Menüleiste auf Firmware-Patch hinzufügen.
2. Wählen Sie im darauffolgenden Dialog im Feld Firmware der Auswahlliste die Firmware, für die Sie den Patch hinzufügen möchten.
3. Wählen Sie im Feld Version die Version, für die Sie einen Patch hinzufügen möchten.
4. Geben Sie im Feld Patch einen Namen für den Patch ein.
5. Laden Sie entweder eine Binärdatei aus Ihrem Dateisystem hoch oder geben Sie eine URL an, unter der die Firmware heruntergeladen werden kann.
6. Klicken Sie Speichern.

Wie beim Hinzufügen von Versionen sieht der Dialog etwas anders aus, wenn Sie in den Details einer bestimmten Firmware auf Firmware-Patch hinzufügen klicken. Dies liegt daran, dass die Firmware bereits ausgewählt ist.

Der Firmware-Patch wird den Versionsdetails innerhalb der Firmware-Details hinzugefügt.

So bearbeiten Sie eine Firmware

1. Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Firmware-Eintrag und anschließend im Kontextmenü auf Bearbeiten.
2. Bearbeiten Sie den Namen, die Beschreibung oder den Gerätetypfilter, indem Sie auf das daneben angezeigte Bleistiftsymbol klicken. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern.

Die Firmware wird entsprechend aktualisiert.

Löschen von Firmware, Firmware-Versionen oder Firmware-Patches

So löschen Sie eine Firmware

Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Firmware-Eintrag und anschließend im Kontextmenü auf Löschen.

Das Objekt wird aus dem Firmware-Repository gelöscht.

So löschen sie eine Firmware-Version oder ein Firmware-Patch

Bewegen Sie den Mauszeiger in den Details einer bestimmten Firmware über den Eintrag der zu löschenden Version oder des zu löschenden Patches und klicken Sie auf das Löschen-Symbol. Die Firmware-Version oder der Firmware-Patch wird aus den Firmware-Details gelöscht.

Verwalten von Firmware auf einem Gerät

Sie können die für ein Gerät installierte Firmware auf der Registerkarte Firmware dieses Geräts verwalten.

Info: Die Registerkarte Firmware wird für Geräte angezeigt, die Operationen vom Typ c8y_Firmware unterstützen.

Klicken Sie im Menü Geräte des Navigators auf Alle Geräte, wählen Sie das gewünschte Gerät aus der Geräteliste und öffnen Sie die dazugehörige Registerkarte Firmware.

Die Registerkarte Firmware zeigt die aktuell auf dem Gerät installierte Firmware.

Darüber hinaus zeigt sie den Operationsstatus des letzten Operationen an (ERFOLGREICH, AUSSTEHEND, WIRD AUSGEFÜHRT, oder FEHLGESCHLAGEN). Wenn Sie auf die Operation klicken, gelangen Sie zur Registerkarte Steuerung, die weitere Details zur Operation enthält, siehe auch Gerätedetails > Steuerung.

So installieren/ersetzen Sie Firmware auf einem Gerät

1. Klicken Sie auf der Registerkarte Firmware auf Firmware installieren (oder Firmware ersetzen wenn bereits Firmware auf dem Gerät installiert ist).
2. Wählen Sie eine Firmware und die gewünschte Version aus der Liste. Diese enthält die gesamte Firmware, die für diesen Gerätetyp im Firmware-Repository bereitsteht.
3. Klicken Sie auf Installieren.

Die von dem Gerät auszuführende Installationsoperation wird erzeugt. Die Installation der Firmware ist abgeschlossen, sobald das Gerät die Operation ausgeführt hat.

Die Operationsdetails werden auf der Registerkarte Steuerung des Geräts angezeigt. Der Status der letzten Operation wird ebenfalls auf der Registerkarte Firmware angezeigt.

So installieren/aktualisieren Sie Firmware auf mehreren Geräten

Cumulocity IoT bietet die Möglichkeit, Firmware-Updates für mehrere Geräte gleichzeitig durchzuführen.

1. Führen Sie die Firmware-Operation (installieren oder ersetzen) zunächst für ein Gerät aus, um zu testen, ob die neue Version funktioniert.
2. Navigieren Sie in der Registerkarte Steuerung zu der Operation und wählen Sie im Kontextmenü Als Bulk-Operation planen.
3. Geben Sie einen Zeitpunkt an, zu dem die Bulk-Operation ausgeführt werden soll, und klicken Sie Erstellen. Weitere Informationen zu Bulk-Operationen finden Sie unter Überwachen und Steuern von Geräten.

Der Status der Bulk-Operation wird auf der Registerkarte Bulk-Operationen unter Gerätesteuerung angezeigt.

Außerdem werden die Operationsdetails auf der Registerkarte Steuerung der ausgewählten Geräte angezeigt.

Info: Bulk-Operationen, die mit einer Version vor 10.7.0 erzeugt wurden, können auf der Registerkarte Bulk-Operationen der ausgewählten Gruppe angezeigt werden, siehe auch Bulk-Operationen.

Verwalten von Geräte-Software

Mit dem Software-Repository bietet Cumulocity IoT die Möglichkeit, Referenz-Software für Geräte zu verwalten. Auf einem Gerät können mehrere Software-Pakete installiert werden.

Anzeigen von Software

Klicken Sie im Menü Verwaltung des Navigators auf Software Repository.

Die verfügbaren Software-Objekte werden in Form einer Liste angezeigt.

Jeder Eintrag enthält den Namen der Software, den Gerätetypen auf den sie anwendbar ist (falls angegeben) und eine Bezeichnung, die angibt, ob und wie viele Versionen für eine bestimmte Software verfügbar sind.

Wenn sie auf einen Eintrag klicken, werden die Details dieser Software sowie alle verfügbaren Versionen angezeigt.

Am Anfang der Liste stehen der Name der Software, eine Beschreibung und ein oder mehrere Gerätetypfilter (optional). Wenn ein Filter gesetzt ist, wird die Software nur für die entsprechenden Geräte zur Installation angeboten. Ist kein Filter gesetzt, wird sie für alle Geräte angeboten.

Die Liste der Versionen und Patches enthält den Versionsnamen und den Namen der Software-Binärdatei. Die Versionen sind nach ihrem Erstellungszeitpunkt (absteigend) sortiert.

So fügen Sie eine neue Software oder Software-Version hinzu

1. Klicken Sie auf der Seite Software Repository rechts in der oberen Menüleiste auf Software hinzufügen.
2. Im darauffolgenden Dialog können Sie
   • eine neue Software hinzufügen, indem Sie einen Namen für die Software eingeben (im nächsten Fenster durch Klicken auf Hinzufügen bestätigen) und eine Beschreibung sowie die Version hinzufügen (alle Angaben erforderlich).
   • eine neue Version hinzufügen, indem Sie die Software, für die Sie die Version hinzufügen möchten, in der Auswahlliste im Feld Software auswählen und eine Version eingeben.
3. Laden Sie entweder eine Binärdatei aus Ihrem Dateisystem hoch oder geben Sie eine URL an, unter der die Software heruntergeladen werden kann.
4. Klicken Sie Speichern.

Das Software-Objekt wird der Software-Liste bzw. die Software-Version den Software-Details hinzugefügt und die Versionsnummer wird entsprechend aktualisiert.

Wenn Sie in den Details einer bestimmten Software auf Software hinzufügen klicken, sieht der Dialog etwas anders aus, da die Software bereits ausgewählt ist.

So bearbeiten Sie eine Software

1. Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Software-Eintrag und anschließend im Kontextmenü auf Bearbeiten.
2. Bearbeiten Sie den Namen, die Beschreibung oder den Gerätetypfilter, indem Sie auf das daneben angezeigte Bleistiftsymbol klicken. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern.

Die Software wird entsprechend aktualisiert.

Löschen von Software oder Software-Versionen

So löschen Sie eine Software

Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Software-Eintrag und anschließend im Kontextmenü auf Löschen.

Die Software wird mit sämtlichen Versionen aus dem Software-Repository gelöscht.

So löschen Sie eine Software-Version

Bewegen Sie den Mauszeiger in den Details einer bestimmten Software über den Eintrag der zu löschenden Version und klicken Sie auf das Löschen-Symbol. Die Software-Version wird aus den Software-Details gelöscht.

Verwalten von Software auf einem Gerät

Sie können die Software eines Geräts auf der Registerkarte Software dieses Geräts verwalten.

Info: Die Registerkarte Software wird für Gerate angezeigt, die eine der folgenden Operationen unterstützen: c8y_SoftwareUpdate, c8y_SoftwareList, c8y_Software.

Klicken Sie im Menü Geräte des Navigators auf Alle Geräte, wählen Sie das gewünschte Gerät aus der Geräteliste und öffnen Sie die dazugehörige Registerkarte Software.

Die Registerkarte Software listet die gesamte auf dem Gerät installierte Software auf.

Darüber hinaus zeigt sie den Operationsstatus der letzten Operation an (ERFOLGREICH, AUSSTEHEND, WIRD AUSGEFÜHRT, oder FEHLGESCHLAGEN). Wenn Sie auf die Operation klicken, gelangen Sie zur Registerkarte Steuerung, die weitere Details zur Operation enthält, siehe auch Gerätedetails > Steuerung.

So installieren Sie Software auf einem Gerät

1. Klicken Sie auf der Registerkarte Software auf Software installieren.
   
   
2. Wählen Sie einen oder mehrere Software-Einträge, indem Sie die entsprechende Version in der Liste auswählen. Diese enthält die gesamte Software, die für diesen Gerätetyp im Software-Repository bereitsteht.
3. Klicken Sie auf Installieren.
4. Überprüfen Sie Ihre geplanten Änderungen im Bereich Software-Änderungen auf der rechten Seite und bestätigen Sie die Software-Update-Operation durch Klicken auf Änderungen übernehmen.
   
   

Die von dem Gerät auszuführende Installationsoperation wird erzeugt. Die Installation der Software ist abgeschlossen, sobald das Gerät die Operation ausgeführt hat.

Die Operationsdetails werden auf der Registerkarte Steuerung des Geräts angezeigt. Der Status der letzten Operation wird ebenfalls auf der Registerkarte Software angezeigt.

So aktualisieren Sie Software auf einem Gerät

Bewegen Sie den Mauszeiger über den Eintrag der Software, die Sie aktualisieren möchten und klicken Sie auf Aktualisieren. Wählen Sie eine Version aus der Liste und klicken Sie erneut auf Aktualisieren.

Die Software wird mit der ausgewählten Version aktualisiert.

So löschen Sie Software von einem Gerät

Bewegen Sie den Mauszeiger über den Eintrag der Software, die sie löschen möchten und klicken Sie auf das Löschen-Symbol.

So installieren Sie Software auf mehreren Geräten

Cumulocity IoT bietet die Möglichkeit, Software-Updates für mehrere Geräte gleichzeitig durchzuführen.

1. Führen Sie die Software-Operation (installieren oder ersetzen) zunächst für ein Gerät aus, um zu testen, ob die neue Version funktioniert.
2. Navigieren Sie in der Registerkarte Steuerung zu dieser Operation und wählen Sie im Kontextmenü Als Bulk-Operation planen.
3. Geben Sie einen Zeitpunkt an, zu dem die Bulk-Operation ausgeführt werden soll, und klicken Sie Erstellen. Weitere Informationen zu Bulk-Operationen finden Sie unter Überwachen und Steuern von Geräten.

Der Status und die Details der Bulk-Operation werden auf der Registerkarte Bulk-Operationen unter Gerätesteuerung angezeigt.

Außerdem werden die Operationsdetails auf der Registerkarte Steuerung der ausgewählten Geräte angezeigt.

Info: Bulk-Operationen, die mit einer Version vor 10.7.0 erzeugt wurden, können auf der Registerkarte Bulk-Operationen der ausgewählten Gruppe angezeigt werden, siehe auch Bulk-Operationen.

Verwalten von Konfigurationen

In Cumulocity IoT können Sie Konfigurationsdaten von einem Gerät abrufen oder aus einer Datei laden und diese in einem Konfigurations-Repository speichern und verwalten. Konfigurationsdaten enthalten die Grundeinstellungen und Parameter eines Geräts.

Solche Konfigurationssnapshots sind beispielsweise nützlich, um die gleiche Konfiguration auf mehrere Geräte anzuwenden, wie im Folgenden beschrieben.

Klicken Sie Konfigurations-Repository im Menü Verwaltung des Navigators. Auf der Seite Konfigurations-Repository werden alle verfügbaren Konfigurationssnapshots aufgelistet. Jeder Eintrag zeigt den Namen und die Beschreibung der Konfiguration sowie den Geräte- und Konfigurationstyp.

So fügen Sie einen Konfigurationssnapshot hinzu

1. Klicken Sie Konfigurationssnapshot hinzufügen rechts in der oberen Menüleiste.
2. Geben Sie im darauffolgenden Dialog einen eindeutigen Namen ein.
3. Geben Sie im Feld Gerätetyp einen Gerätetyp ein. Den Gerätetyp finden Sie in der Registerkarte Info des Zielgeräts.
4. Sie können optional eine Beschreibung für die Konfiguration eingeben.
5. Geben Sie den Konfigurationstyp, zum Beispiel “ssh”, ein.
6. Geben Sie die Datei mit dem Konfigurationssnapshot an, indem Sie sie aus dem Dateisystem hochladen, indem Sie eine URL angeben, über die der Konfigurationssnapshot abgerufen werden kann, oder indem Sie eine Datei auswählen.
7. Klicken Sie auf Konfiguration hinzufügen.

Der Konfigurationssnapshot wird dem Konfigurations-Repository hinzugefügt.

So bearbeiten Sie einen Konfigurationssnapshot

Zum Bearbeiten eines Konfigurationssnapshots klicken Sie auf das Menüsymbol rechts neben der jeweiligen Zeile und anschließend auf Bearbeiten.

Weitere Informationen zu den Feldern finden Sie unter So fügen Sie einen Konfigurationssnapshot hinzu.

Klicken Sie auf Konfiguration aktualisieren, um Ihre Änderungen zu speichern.

So löschen Sie einen Konfigurationssnapshot

Zum Löschen eines Konfigurationssnapshots klicken Sie auf das Menüsymbol rechts neben der jeweiligen Zeile und anschließend auf Löschen.

Der Konfigurationssnapshot wird aus dem Konfigurationssnapshot-Repository gelöscht.

So laden und wenden Sie einen Konfigurationssnapshot an

Info: Die folgenden Schritte gelten für Geräte, die nur einen Konfigurationstyp unterstützen. Informationen zu Geräten, die mehrere Konfigurationstypen unterstützen, finden Sie im nächsten Abschnitt.

1. Navigieren Sie unter Geräte > Alle Geräte zu dem entsprechenden Gerät und wechseln Sie zur Registerkarte Konfiguration.
2. Klicken Sie Neuen Snapshot vom Gerät laden rechts oben unter Konfigurationssnapshot.

Der geladene Snapshot wird im Konfigurations-Repository im Menü Verwaltung des Navigators angezeigt.

So wenden Sie einen Konfigurationssnapshot auf ein Gerät an

1. Navigieren Sie zu dem entsprechenden Gerät und wechseln Sie zur Registerkarte Konfiguration.
2. Wählen Sie unter Konfigurationssnapshot eine Konfiguration aus der Auswahlliste.
3. Klicken Sie Snapshot an Gerät senden, um den ausgewählten Snapshot an das Gerät zu senden.

So laden Sie einen Konfigurationssnapshot und wenden ihn auf ein Gerät an, das mehrere Konfigurationstypen unterstützt

1. Navigieren Sie unter Geräte > Alle Geräte zu dem entsprechenden Gerät und wechseln Sie zur Registerkarte Konfiguration.
2. Wählen Sie den gewünschten Konfigurationstyp unter Geräteunterstützte Konfigurationen und klicken Sie auf Snapshot vom Gerät abrufen auf der rechten Seite.

Sobald Sie den Snapshot geladen haben, können Sie ihn im Abschnitt Vorschau speichern oder herunterladen. Der Snapshot wird zum Konfigurations-Repository hinzugefügt, auf das Sie über das Menü Verwaltung im Navigator zugreifen können.

Info: Wenn Sie auf Snapshot vom Gerät abrufen klicken, wird eine neue Operation erstellt. Wenn sich die Operation im Status AUSSTEHEND oder WIRD AUSGEFÜHRT befindet, ist es nicht möglich, eine weitere Konfigurationsanforderung für den Konfigurationstyp zu stellen. Navigieren Sie zur Registerkarte Steuerung eines Geräts, um die Operation abzubrechen oder die Änderungshistorie der Operation anzuzeigen.

So wenden Sie einen Konfigurationssnapshot auf ein Gerät an, das mehrere Konfigurationstypen unterstützt

1. Navigieren Sie zu dem entsprechenden Gerät und wechseln Sie zur Registerkarte Konfiguration.
2. Wählen Sie den gewünschten Konfigurationstyp unter Geräteunterstützte Konfigurationen.
3. Wählen Sie eine Konfigurationsdatei unter Verfügbare unterstützte Konfigurationen.
4. Klicken Sie auf der rechten Seite auf Konfiguration an Gerät senden, um den ausgewählten Snapshot an das Gerät zu senden.

Info: Unter Verfügbare unterstützte Konfigurationen werden nur die Konfigurationsdateien angezeigt, die über ein passendes Konfigurationstyp-Attribut verfügen oder für die kein Konfigurationstyp definiert wurde. Zudem werden Konfigurationsdateien basierend auf dem Gerätetyp gefiltert.

Verwalten von Gerätezugangsdaten

Die Registerkarte Gerätezugangsdaten listet alle Zugangsdaten auf, die für Ihre verbundenen Geräte erstellt wurden. Jedes Gerät, das registriert wurde, wird hier mit der Namenskonvention “device_<id>” angezeigt.

So verwalten Sie Berechtigungen für ein Gerät

1. Klicken Sie auf den Pfeil in der Spalte Globale Rollen, um eine Liste mit globalen Rollen anzuzeigen.
2. Zum Zuweisen oder Entfernen von Berechtigungen für ein einzelnes Gerät aktivieren bzw. deaktivieren Sie die jeweiligen Rollen.
3. Klicken Sie Anwenden.

Die Rollen für die Geräte werden entsprechend aktualisiert.

So bearbeiten Sie Gerätezugangsdaten

1. Klicken Sie auf das Menüsymbol rechts neben einem Gerätezugangsdaten-Eintrag und anschließend auf Bearbeiten, um die Gerätedetails zu öffnen.

2. In der Detail-Seite können Sie ein Gerät deaktivieren/aktivieren, indem Sie auf den Umschalter Aktiv klicken, das Passwort für ein Gerät ändern oder in der Liste Globale Rollen Berechtigungen zuweisen oder entfernen.

   

3. Klicken Sie Speichern.

Die Gerätezugangsdaten werden entsprechend aktualisiert.

So deaktivieren Sie Gerätezugangsdaten

Klicken Sie auf das Menüsymbol rechts neben dem Gerätezugangsdaten-Eintrag und anschließend auf Abschalten.

Die Gerätezugangsdaten werden vorübergehend deaktiviert.

So löschen Sie Gerätezugangsdaten

Klicken Sie auf das Menüsymbol rechts neben dem Gerätezugangsdaten-Eintrag und anschließend auf Löschen.

Die Gerätezugangsdaten werden dauerhaft gelöscht.

Das Löschen von Gerätezugangsdaten kann erforderlich sein, wenn Sie ein Gerät auf die Werkseinstellungen zurückgesetzt haben. In diesem Fall verliert das Gerät häufig seine zugewiesenen Zugangsdaten. Löschen Sie diese und fahren Sie mit dem normalen Registrierungsprozess fort, um das Gerät erneut zu registrieren.

Verwalten von Geräteprofilen

Geräteprofile stellen eine Kombination aus einer Firmware-Version, einem oder mehreren Software-Paketen und einer oder mehreren Konfigurationsdateien, die auf einem Gerät bereitgestellt werden können, dar. Basierend auf den Geräteprofilen können Benutzer mit Hilfe von Bulk-Operation eine bestimmte Zielkonfiguration auf Geräten bereitstellen.

So zeigen Sie Geräteprofile an

Zum Anzeigen der Seite Geräteprofile, die sämtliche verfügbaren Geräteprofile auflistet, klicken Sie im Menü Verwaltung des Navigators auf Geräteprofile.

Jeder Geräteprofil-Eintrag zeigt den Profilnamen und die gewählten Gerätetypen, falls vorhanden.

Klicken Sie auf einen Geräteprofilnamen, um die Details dieses Geräteprofils anzuzeigen.

Der Abschnitt Name und Gerätetyp zeigt den Namen des Profils und die optional gewählten Gerätetypen an.

Die darauffolgenden Abschnitte listen die Firmware-Version, die Software-Pakete und die Konfigurationsdateien für dieses bestimmte Geräteprofil auf.

So fügen Sie ein Geräteprofil hinzu

Um ein neues Geräteprofil hinzuzufügen, klicken Sie rechts in der oberen Menüleiste auf Geräteprofil hinzufügen.

Geben Sie im Fenster Geräteprofil hinzufügen einen Namen für das Profil an und tragen Sie optional einen oder mehrere Gerätetypen ein. Wenn ein Gerätetyp angegeben wird, kann das Geräteprofil nur Geräten dieses bestimmten Typs zugewiesen werden. Wird kein Gerätetyp angegeben, ist das Profil für alle Gerätetypen verfügbar.

So fügen Sie Elemente zu einem Geräteprofil hinzu

In den Details eines Geräteprofils können sie Firmware-Versionen, Software-Pakets und Konfigurationsdateien hinzufügen.

Klicken Sie auf Firmware hinzufügen, um dem Profil eine Firmware-Version hinzuzufügen. Wählen Sie eine Firmware und eine Version aus der Liste und klicken Sie auf Speichern, um die Auswahl zu dem Profil hinzuzufügen. Wenn ein Gerätetyp für das Profil definiert wurde, können nur Firmware-Versionen mit dem entsprechenden Gerätetyp gewählt werden. Sie können nur eine Firmware-Version zu einem Profil hinzufügen.

Nähere Informationen zu Firmware finden Sie unter Verwalten von Geräte-Firmware.

Klicken Sie auf Software hinzufügen, um dem Profil eine Software hinzuzufügen. Wählen Sie eine Software und eine Software-Version aus der Liste und klicken Sie auf Speichern, um die Auswahl zu dem Profil hinzuzufügen. Wenn ein Gerätetyp für das Profil definiert wurde, können nur Software-Versionen mit dem entsprechenden Gerätetyp gewählt werden. Sie können mehrere Software-Pakete zu einem Profil hinzufügen.

Nähere Informationen zu Software finden Sie unter Verwalten von Geräte-Software.

Klicken Sie auf Konfiguration hinzufügen, um dem Profil eine Software hinzuzufügen. Wählen Sie eine Konfigurationsdatei aus der Liste und klicken Sie auf Speichern, um die Auswahl zu dem Profil hinzuzufügen. Sie können mehrere Konfigurationsdateien zu einem Profil hinzufügen.

Nähere Informationen zu Konfigurationssnapshots finden Sie unter Verwalten von Konfigurationssnapshots.

So aktualisieren Sie Geräteprofile

Zum Aktualisieren eines Geräteprofils klicken Sie auf das Menüsymbol rechts neben dem jeweiligen Eintrag und anschließend auf Bearbeiten.

Bearbeiten Sie den Namen und die Gerätetypen, indem Sie auf das Bleistiftsymbol neben den entsprechenden Feldern klicken. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern um Ihre Bearbeitungen zu speichern.

Sie können außerdem Firmware, Software oder Konfigurationselemente löschen oder neue hinzufügen.

Zum Löschen eines Elements bewegen Sie den Mauszeiger darüber und klicken Sie auf das Löschen-Symbol.

Nähere Informationen zum Hinzufügen von Firmware, Software oder Konfigurationselementen finden Sie unter So fügen Sie Elemente zu einem Geräteprofil hinzu.

Beachten Sie, dass bei Firmware immer nur ein Element im Profil erlaubt ist.

So duplizieren Sie Geräteprofile

Zum Duplizieren eines Geräteprofils klicken Sie auf das Menüsymbol rechts neben dem jeweiligen Eintrag und anschließend auf Duplizieren.

Wenn Sie ein Profil duplizieren, wird eine weitere Instanz des Profils mit demselben Inhalt angelegt. Standardmäßig erhält der Name des Originalprofils den Zusatz “Copy of”. Sie können dem Profil einen anderen Namen geben, indem Sie auf das Bleistiftsymbol neben dem Namen klicken und den Namen bearbeiten.

So löschen Sie Geräteprofile

Zum Löschen eines Geräteprofils klicken Sie auf das Menüsymbol rechts neben dem jeweiligen Eintrag und anschließend auf Löschen.

Info: Wenn Sie ein Profil löschen, wird der Eintrag aus dem Geräteprofil-Repository gelöscht. Dies hat keine Auswirkungen auf die Geräte, die das Profil aktuell nutzen.

Geräteprofile auf Geräte anwenden

Geräteprofile können angewendet werden auf:

• einzelne Geräte
• mehrere Geräte mit Hilfe von Bulk-Operationen

Die Registerkarte Geräteprofil eines bestimmten Geräts zeigt die Details des aktuell auf dem Gerät installierten Profils.

Info: Die Registerkarte Geräteprofil wird für Geräte angezeigt, die Operationen vom Typ c8y_DeviceProfile unterstützen.

Zudem kann in der Geräteliste ausgehend von dem Namen des angewendeten Profils und davon, ob das Profil in der Vergangenheit angewendet wurde, nach Geräten gefiltert werden.

So wenden Sie Geräteprofile auf ein einzelnes Gerät an

Auf der Registerkarte Geräteprofil eines Geräts können Sie Geräteprofile auf einzelne Geräte anwenden.

1. Wählen Sie auf der Registerkarte Geräteprofil ein Geräteprofil aus der Auswahlliste. Es werden nur die Profile angezeigt, die zu dem Gerätetyp passen (falls angegeben), oder für die kein Gerätetyp angegeben wurde.

   

2. Klicken Sie auf Geräteprofil zuweisen, um die Aktualisierungsoperation zu starten.

So wenden Sie Geräteprofile auf mehrere Geräte an

Geräteprofile können mittels Bulk-Operationen auf mehrere Geräte angewendet werden.

1. Klicken Sie im Menü Übersicht auf Gerätesteuerung, um zur Seite Gerätesteuerung zu gelangen. Auf der Seite Gerätesteuerung können Sie eine neue Bulk-Operation zum Anwenden eines Geräteprofils erstellen.
2. Klicken Sie auf der Registerkarte Bulk-Operationen rechts in der oberen Menüleiste auf Neue Bulk-Operation und wählen Sie im darauffolgenden Dialog Geräteprofil anwenden.
3. Um eine Bulk-Operation zum Anwenden eines Geräteprofils zu planen, befolgen Sie die Schritte unter Überwachen und Steuern von Geräten > Verwenden von Operationen > So fügen Sie eine Bulk-Operation hinzu.

Die Geräte installieren die Firmware, Software und Konfigurationselemente des Profils und senden einen Bericht über den Status der Operation. Nachdem das Profil angewendet wurde, werden die Geräteobjekte in der Plattform mit der neuen Profilinformation aktualisiert.

Info: Beim Anlegen von Bulk-Operationen können Filter verwendet werden, die es Ihnen ermöglichen, Bulk-Operationen nur für die Geräte anzulegen, auf die noch kein Profil angewendet wurde.

Verwalten von vertrauenswürdigen Zertifikaten

In Cumulocity IoT können sich Geräte via MQTT-Protokoll und unter Verwendung eines X.509-Zertifikats zur Authentifizierung miteinander verbinden. Das Zertifikat muss dazu von Cumulocity IoT als vertrauenswürdig eingestuft werden. Ein Zertifikat ist vertrauenswürdig, wenn es zu den vertrauenswürdigen Zertifikaten hinzugefügt wurde und aktiviert ist.

Info: Dieser Abschnitt beschreibt, wie Sie vertrauenswürdige Zertifikate verwalten. Informationen zum Verbinden von Geräten mit Zertifikaten finden Sie unter Geräteintegration mit MQTT > Gerätezertifikate im Device SDK Guide.

Klicken Sie im Menü Verwaltung des Navigators auf Vertrauenswürdige Zertifikate.

Alle Zertifikate des Mandanten werden angezeigt.

Das Symbol links neben dem jeweiligen Eintrag zeigt, ob das Zertifikat aktiv (grün) oder inaktiv (rot) ist. Ein Mandant kann jederzeit über eine beliebige Anzahl von aktiven oder inaktiven Zertifikaten verfügen.

Durch Klicken auf das Pfeilsymbol rechts neben einem Zertifikat können Sie weitere Details zu dem betreffenden Zertifikat aufklappen.

Die Information in der Tabelle rechts stammt von dem bereitgestellten Zertifikat. Der Inhalt ist schreibgeschützt und kann nicht geändert werden.

So fügen Sie ein Zertifikat hinzu

Bevor Sie ein neues vertrauenswürdiges Zertifikat hinzufügen, stellen Sie folgende Punkte sicher:

• Es handelt sich um ein X.509-Zertifikat im PEM-Format.
• Das Zertifikat liegt in Version 3 vor.
• Das Zertifikat enthält BasicConstraints:[CA:true].
• Das Zertifikat wurde noch nicht in Cumulocity IoT hochgeladen.
• Das Zertifikat ist noch gültig (nicht abgelaufen).

Um ein Zertifikat hinzuzufügen, gehen Sie folgendermaßen vor:

1. Klicken Sie auf Vertrauenswürdiges Zertifikat hinzufügen rechts in der oberen Menüleiste.

   

2. Geben Sie Sie im nächsten Dialog die folgenden Informationen ein:

3. Klicken Sie auf Zertifikat hinzufügen, um das Zertifikat zu validieren und zu speichern.

Info: Aus Leistungsgründen sollten Sie nicht die Zertifikate von jedem Gerät, das Sie verbinden möchten, hinzufügen, sondern nur das Stammzertifikat oder eines der Zwischenzertifikate aus der Kette, die zum Signieren der von Geräten verwendeten Zertifikate genutzt wurde.

So bearbeiten Sie ein vertrauenswürdiges Zertifikat

In der Detailansicht eines Zertifikats können Sie die Parameter auf der linken Seite, d.h. den Zertifikatsnamen und die Einstellungen für die Auto-Registrierung sowie die Eingeschaltet/Ausgeschaltet-Option ändern.

Weitere Informationen zu den Feldern finden Sie in der vorstehenden Beschreibung zum Hinzufügen von Zertifikaten.

So löschen Sie ein vertrauenswürdiges Zertifikat

Um ein Zertifikat dauerhaft aus der Liste der vertrauenswürdigen Zertifikate zu löschen, klicken Sie auf das Menüsymbol rechts neben dem betreffenden Eintrag und anschließend im Kontextmenu auf Löschen.

Das Zertifikat wird dauerhaft gelöscht.

Verwenden von SmartREST-Templates

Einführung

Bei den SmartREST-Templates handelt es sich um eine Sammlung von Anfrage- und Antwort-Templates, die verwendet werden, um CSV-Daten und Cumulocity IoT Rest API-Aufrufe zu konvertieren. Sie können SmartREST-Templates etwa verwenden, um einfach Geräte zur Plattform hinzuzufügen anstatt jedesmal manuell eine Anfrage zu schreiben.

Um die Geräteintegration zu vereinfachen, stellt Cumulocity IoT auch statische Templates bereit, so dass Sie keine eigenen Templates erstellen müssen. Diese Templates konzentrieren sich jedoch nur auf häufig verwendete Nachrichten für die Geräteverwaltung. Weitere Informationen zu statischen Templates finden Sie im Device SDK Guide.

Öffnen Sie die Seite SmartREST-Template im Menü Gerätetypen des Navigators.

Für jedes Template werden folgende Informationen bereitgestellt:

• Template-Name
• Template-ID
• Anzahl gesendeter Nachrichten
• Anzahl der Antworten

SmartREST-Templates können auf zweierlei Weise hinzugefügt werden:

• Importieren eines bereits vorhandenen Templates
• Erstellen eines neuen Templates

So importieren Sie ein vorhandenes SmartREST-Template

1. Klicken Sie Import rechts in der oberen Menüleiste.
2. Wählen Sie im darauf folgenden Dialog eine Datei zum Hochladen von Ihrem Computer.
3. Geben Sie einen Namen und eine eindeutige ID für das Template ein (beide Eingaben sind erforderlich).
4. Klicken Sie Importieren, um das Template zu importieren.

So erstellen Sie ein neues SmartREST-Template

1. Klicken Sie Neues Template rechts in der oberen Menüleiste.
2. Geben Sie im darauf folgenden Dialog einen Namen und eine eindeutige ID für das Template ein (beide Eingaben sind erforderlich).
3. Klicken Sie Weiter, um Nachrichten oder Antworten hinzuzufügen.

So fügen Sie eine Nachricht hinzu

Das Nachrichten-Template enthält alle erforderlichen Informationen, um eine SmartREST-Anfrage in einen entsprechenden Rest API-Aufruf zu konvertieren, der dann zur Plattform gesendet wird.

1. Um eine neue Nachricht zu einem Template hinzuzufügen, navigieren Sie zur Registerkarte Nachrichten im entsprechenden Template und klicken Sie Nachricht hinzufügen.

2. Füllen Sie die folgenden Felder aus:

   Feld	Beschreibung
   Message-ID	Integer-Wert, der zur Identifizierung der Nachricht verwendet wird. Dieser Wert muss eindeutig für alle Nachricht- und Antwort-Templates sein.
   Name	Name für die Nachricht. Erforderlich.
   Ziel-REST API	REST API für das Ziel. Auswahlliste. Verfügbare Werte: ALARM, EREIGNIS, KOMMANDO, MESSWERT, STAMMDATEN.
   Methode	Anfragemethode. Verfügbare Werte POST, PUT, GET, abhängig von der ausgewählten Ziel-REST API.
   Erwartet Antwortnachricht	Aktivieren Sie diese Checkbox, wenn Sie die Ergebnisse der Anfrage mit Antwort-Templates verarbeiten möchten.
   Integrierte REST API-Felder	Diese Felder sind optional und variieren je nach ausgewählter Ziel-REST API. Wenn kein Wert bereitgestellt wird, kann das Gerät diesen setzen, sobald die eigentliche Nachricht gesendet wird.
   Benutzerdefinierte REST API-Felder	Durch Klicken von Feld hinzufügen, können zusätzliche eigene Felder hinzugefügt werden. Geben Sie den API-Schlüssel ein und wählen Sie den gewünschten Datentypen.

   

   Unter Vorschau können Sie eine Vorschau Ihrer Anfragenachricht sehen.

3. Klicken Sie Speichern.

Die Nachricht wird dem SmartREST-Template hinzugefügt.

So löschen Sie eine Nachricht

Um eine Nachricht zu löschen, öffnen Sie diese und klicken Sie unten Löschen.

Die Nachricht wird aus dem SmartREST-Template gelöscht.

So fügen Sie eine Antwort hinzu

Ein Antwort-Template enthält alle erforderlichen Informationen, um Datenwerte aus einer Antwort der Plattform auf eine REST API-Anfrage zu extrahieren, die dann an den Client im CSV-Datenformat gesendet werden.

1. Um eine neue Antwort hinzuzufügen, navigieren Sie zur Registerkarte Antworten im entsprechenden Template und klicken Sie Antwort hinzufügen.

2. Füllen Sie die folgenden Felder aus:

   Feld	Beschreibung
   Antwort-ID	Eindeutiger Integer-Wert zur Identifizierung der Antwort.
   Name	Name für die Antwort. Erforderlich.
   Basis-Pattern	Basis-Pattern für die Antwort.
   Bedingung	Bedingungswert der Antwort.
   Pattern	Mindestens ein Pattern ist erforderlich. Klicken Sie Pattern hinzufügen und geben Sie einen Pattern-Wert an.

   

3. Klicken Sie Speichern.

Die Antwort wird dem SmartREST-Template hinzugefügt.

So löschen Sie eine Antwort

Um eine Antwort zu löschen, öffnen Sie diese und klicken Sie unten Löschen.

So bearbeiten Sie ein SmartREST-Template

Klicken Sie entweder auf das gewünschte Template oder klicken Sie auf das Menüsymbol rechts oben neben der entsprechenden Template-Karte und anschließend auf Bearbeiten.

Klicken Sie nach der Bearbeitung des Templates auf Speichern, um Ihre Einstellungen zu speichern.

So löschen Sie ein SmartREST-Template

Klicken Sie auf das Menüsymbol rechts oben in der entsprechenden Template-Karte und anschließend auf Löschen.

So exportieren Sie ein SmartREST-Template

Klicken Sie auf das Menüsymbol rechts oben in der entsprechenden Template-Karte und anschließend auf Exportieren.

Das Template wird automatisch in Ihr Dateisystem heruntergeladen.

Um ein SmartREST-Template als CSV-Datei herunterzuladen, führen Sie folgende Schritte aus:

1. Öffnen Sie das Template, das Sie exportieren möchten, und wählen Sie die Registerkarte CSV-Vorschau.
2. Wählen Sie im darauf folgenden Dialog die bevorzugten Optionen für Feldtrennzeichen, Dezimaltrennzeichen und Zeichensatz.
3. Klicken Sie in der Registerkarte CSV-Vorschau, die zusätzliche Informationen zu Nachrichten und Antworten enthält, In die Zwischenablage kopieren.

Das SmartREST-Template wird in die CSV-Datei exportiert.

Verwenden von Simulatoren

Mit dem Simulator in Cumulocity IoT können alle Aspekte von IoT-Geräten simuliert werden, wie:

• Einrichten eines simulierten Geräts oder eines Netzwerks von simulierten Geräten
• Bestimmen der Kommandos, die ein Gerät verarbeiten kann
• Erstellen von Anweisungen basierend auf voreingestellten oder benutzerdefinierten Templates und Planen von Schritten
• Erstellen von bis zu zehn Geräten eines bestimmten Typs
• Erstellen von Nachrichten für Messwerte, Alarme, Ereignisse und Stammdaten
• Anzeigen von Simulationsproblemen als Alarme

Allgemeines zu Simulatoren

Mit dem Simulator können Sie “künstliche” Geräte erstellen, die den gleichen Grad an Funktionalität aufweisen, wie verbundene Hardwaregeräte.

Ein Simulator verwendet eine Play-Liste, um Nachrichten zu simulieren, die das Gerät an die Cumulocity IoT-Plattform sendet. Eine Play-Liste ist eine Reihe von Anweisungen, die der Simulator nacheinander ausführt. Wenn die letzte Anweisung erreicht ist, beginnt der Simulator wieder von vorne.

Eine Anweisung kann entweder eine Nachricht senden (Messwerte, Alarme, Ereignisse und Stammdaten) oder eine bestimmte Zeit warten.

Eine Nachricht wird durch Auswählen eines Nachricht-Templates (z. B. Senden einer Temperatur) und Bereitstellen des entsprechenden Werts (z. B. 23,0 Grad) definiert. Es gibt viele vordefinierte Nachricht-Templates, etwa für das Senden eines Messwerts oder das Erstellen oder Aufheben eines Alarms. Diese Templates basieren auf statischen MQTT-Templates. Darüber hinaus können mit dem SmartREST-Template-Editor eigene Nachricht-Templates erstellt werden.

So zeigen Sie Simulatoren an

Klicken Sie Simulatoren im Menü Geräte des Navigators, um die Seite Simulatoren zu öffnen.

Alle Simulatoren, auf die Sie zugreifen können, werden hier angezeigt.

So erstellen Sie einen Simulator

1. Klicken Sie Simulator hinzufügen rechts in der oberen Menüleiste.
2. Wählen Sie im darauf folgenden Dialog aus der Auswahlliste im Feld Voreinstellungen einen Simulatortypen. Wählen Sie “Leerer Simulator”, um einen eigenen Simulator zu erstellen.
3. Geben Sie einen Namen für den Simulator ein.
4. Wählen Sie die Anzahl der Instanzen für diesen Simulator (bis zu zehn).
5. Klicken Sie Erstellen.

Der Simulator wird erstellt und der Liste hinzugefügt.

So bearbeiten Sie einen Simulator

1. Klicken Sie auf das Menüsymbol rechts oben in einer Simulatorkarte und anschließend auf Bearbeiten oder klicken Sie einfach auf die Simulatorkarte.
2. Nehmen Sie im darauf folgenden Dialog die gewünschten Änderungen vor.
3. Klicken Sie Speichern, um Ihre Änderungen anzuwenden.

So duplizieren Sie einen Simulator

1. Klicken Sie auf das Menüsymbol rechts oben in der Simulatorkarte und anschließend auf Duplizieren.
2. Geben Sie im darauf folgenden Dialog einen Namen für den neuen Simulator ein.
3. Klicken Sie Duplizieren.

Der neue Simulator wird der Liste hinzugefügt.

So löschen Sie einen Simulator

1. Klicken Sie auf das Menüsymbol rechts oben in der Simulatorkarte und anschließend auf Löschen.
2. Bestätigen Sie das Löschen des Simulators im darauf folgenden Dialog.
3. Klicken Sie Speichern.

Der Simulator wird aus der Liste gelöscht.

Anweisungen

Für jeden Simulator können Sie Anweisungen erstellen, die angeben, was der Simulator tun soll. Anweisungen sind einzelne Aufgaben, die einer Play-Liste hinzugefügt und vom Simulator nacheinander ausführt werden.

Anweisungen können auf der Registerkarte Anweisungen eines Simulators angezeigt und bearbeitet werden.

Beispiele

Die Simulator-Voreinstellungen enthalten bereits Beispielanweisungen. Beispielsweise enthält der Simulator “Temperaturmesswerte” Anweisungen für die Schritte “Messwert erstellen” und “Warten”, siehe Abbildung oben.

Der Bereich auf der rechten Seite ändert sich entsprechend des ausgewählten Anweisungstyps.

Die Messwertanweisungen beziehen sich auf ein Fragment. Fragmente werden verwendet, um die Kapazitäten von Objekten zu bestimmen. Nähere Informationen zu Fragmenten finden Sie in der Sensor Library im Reference Guide.

Die Anweisung “Warten” erfordert einen einzelnen Wert für die Dauer des Wartens in Sekunden.

So fügen Sie eine Anweisung hinzu

1. Klicken Sie Anweisung hinzufügen, um dem Simulator eine neue Anweisung hinzuzufügen.
2. Wählen Sie im darauf folgenden Dialog eine Nachricht aus der Auswahlliste.
3. Legen Sie je nach Typ der Nachricht die erforderlichen Parameter fest.
4. Klicken Sie Speichern.

Die neue Anweisung wird dem Simulator hinzugefügt.

So fügen Sie eine Wartezeit hinzu

1. Klicken Sie Wartezeit hinzufügen, um dem Simulator eine neue Warteanweisung hinzuzufügen.
2. Legen Sie im darauf folgenden Dialog die Dauer fest.
3. Klicken Sie Speichern.

Die neue Warteanweisung wird dem Simulator hinzugefügt.

So löschen Sie eine Anweisung

Bewegen Sie den Mauszeiger über die Anweisung oder die Wartezeit, die Sie entfernen möchten, und klicken Sie auf das Löschen-Symbol.

Die Anweisung wird aus dem Simulator entfernt.

Unterstützte Kommandos

In der Registerkarte Unterstützte Kommandos eines Simulators finden Sie spezielle Kommandos, etwa für Konfigurationen oder für Software-/Firmware-Updates.

Klicken Sie auf den Umschalter, um das jeweilige Kommando ein- oder auszuschalten.

So fügen Sie ein benutzerdefiniertes Kommando hinzu

1. Klicken Sie Eigenes Kommando hinzufügen, um ein eigenes Kommando festzulegen.
2. Geben Sie im darauf folgenden Dialog den Typ des benutzerdefinierten Kommandos an, der vom Simulator unterstützt werden soll.
3. Klicken Sie Hinzufügen.

Das benutzerdefinierte Kommando wird der Kommandoliste hinzugefügt.

Alarme für den Simulator

Die Registerkarte Alarme eines Simulators zeigt Alarme an, die den Simulator selbst und nicht das simulierte Gerät betreffen, d. h. Alarme für den Fall, dass der Simulator nicht korrekt arbeitet. Informationen zu Alarmen finden Sie unter Verwenden von Alarmen.