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

Geräteregistrierung

Auf der Seite Geräteregistrierung werden alle Geräte angezeigt, die sich aktuell im Registrierungsprozess befinden.

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.
• Blockiert - Die Geräteregistrierung wurde blockiert, weil die Höchstzahl an fehlgeschlagenen Versuchen überschritten wurde.

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:

• Einzel-Geräteregistrierung - zum manuellen Verbinden eines Gerätes oder mehrerer Geräte nacheinander.
• Bulk-Geräteregistrierung - zum Registrieren größerer Gerätemengen in einem Schritt.

Microservice-Entwickler können auch die Erweiterte Geräteregistrierung verwenden und ein benutzerdefiniertes Registrierungsformular implementieren, das sich nahtlos in die Benutzeroberfläche einfügt.

Einzel-Geräteregistrierung

Cumulocity IoT ermöglicht eine einzelne Geräteregistrierung, um manuell mehrere Geräte nacheinander zu verbinden.

So verbinden Sie ein Gerät manuell

1. Klicken Sie auf Registrierung im Menü Geräte des Navigators.
2. Klicken Sie auf der Seite Geräteregistrierung rechts in der oberen Leiste auf Gerät registrieren und wählen Sie aus dem Auswahlmenü die Option Einzelregistrierung > Generell. Der Dialog Geräte registrieren wird angezeigt.
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 auf 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 auf Weiter, um Ihr(e) Gerät(e) zu registrieren.

Info

In einem Enterprise Tenant kann der Management Tenant auch direkt einen Mandanten auswählen, dem das Gerät von hier aus hinzugefügt werden soll. Bitte beachten Sie: Da der Management Tenant 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 “Wartet 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 auf Akzeptieren, um die Verbindung zu bestätigen. Der Status des Geräts wechselt auf “Akzeptiert”.

Sicherheitstokenregel für die Geräteregistrierung

Konfigurieren Sie die Sicherheitstokenregel, um das Risiko zu mindern, dass noch nicht registrierte Geräte durch Bedrohungsakteure übernommen werden, z. B. durch Erraten ihrer Seriennummer.

Cumulocity IoT unterstützt die folgenden Werte für die Sicherheitstokenregel:

• IGNORIEREN - Selbst wenn ein Gerät eine sichere Registrierung erfordert, ignoriert Cumulocity IoT dieses Erfordernis.
• OPTIONAL - Wenn ein Gerät eine sichere Registrierung erfordert, fordert Cumulocity IoT ein zusätzliches Sicherheitstoken vom Benutzer an.
• ERFORDERLICH - Alle mit Cumulocity IoT verbundenen Geräte müssen während der Registrierung ein Sicherheitstoken verwenden.

Die Regel kann durch Festlegen der folgenden Mandantenoption mit einem der oben genannten Werte konfiguriert werden, z. B.:

{
  "category": "device-registration",
  "key": "security-token.policy",
  "value": "IGNORED"
}

Ignorierte Sicherheitstokenregel

Mit dem Wert “IGNORED” für die Sicherheitstokenregel kann ein mit Cumulocity IoT verbundenes Gerät ohne jede Token-Validierung akzeptiert werden:

Optionale Sicherheitstokenregel

Die Liste der Geräteregistrierungen wird im Bild unten präsentiert. Beachten Sie, dass die Eingabe für Sicherheitstokens für alle Geräte angezeigt wird.

Registrierung ohne Verwendung eines Sicherheitstokens

Wenn ein mit Cumulocity IoT verbundenes Gerät kein Sicherheitstoken verwendet, kann die Registrierung erfolgen, ohne dass in der Sicherheitstoken-Eingabe ein Wert bereitgestellt wird.

Wenn ein Sicherheitstoken für ein Gerät bereitgestellt wird, das unsicher verbunden ist, wird dieses akzeptiert und das Token wird ignoriert.

Registrierung mithilfe eines Sicherheitstokens

Wenn ein mit Cumulocity IoT verbundenes Gerät ein Sicherheitstoken verwendet, kann die Registrierung nur abgeschlossen werden, wenn der Benutzer ein Token bereitstellt, das mit demjenigen übereinstimmt, das vom Gerät beim Herstellen der Verbindung übereinstimmt.

Bei Bereitstellung eines falschen Tokens wird eine Fehlermeldung angezeigt, die über eine Nichtübereinstimmung zwischen dem vom Gerät verwendeten Wert und dem über die Benutzeroberfläche bereitgestellten Wert informiert.

Nach einer bestimmten Anzahl fehlgeschlagener Versuche erreicht die Registrierung den blockierten Zustand, was durch eine entsprechende Fehlermeldung angezeigt wird. Die blockierte Registrierung muss vor dem nächsten Versuch, das Gerät zu verbinden, beseitigt werden.

Eingeschränkte Verwendung der Funktion “Alle akzeptieren”

Die Funktion Alle akzeptieren wird bei Geräten unterstützt, die ohne Verwendung eines Sicherheitstokens mit Cumulocity IoT verbunden werden.

Bei jedem Gerät, das ein Sicherheitstoken verwendet, ist die Funktion Alle akzeptieren nicht verfügbar und es wird eine Warnmeldung angezeigt. In den Details der Warnmeldung werden die Geräte aufgelistet, die nicht automatisch akzeptiert werden konnten.

Um solche Geräte zu akzeptieren, muss der richtige Sicherheitstoken-Wert manuell bereitgestellt und auf Akzeptieren geklickt werden.

Erforderliche Sicherheitstokenregel

In diesem Modus muss jedes mit Cumulocity IoT verbundene Gerät beim Herstellen der Verbindung ein Sicherheitstoken verwenden und der Benutzer muss beim Akzeptieren des Geräts dasselbe Token eingeben.

Zum Akzeptieren von Geräten ist genauso vorzugehen, wie unter Optionale Sicherheitstokenregel beschrieben.

In diesem Modus werden alle Geräte, die sich ohne ein Sicherheitstoken mit Cumulocity IoT verbinden, blockiert, und ihre Registrierung kann nicht abgeschlossen werden.

Bulk-Geräteregistrierung

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.

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

1. Klicken Sie auf Registrierung im Menü Geräte des Navigators.

2. Klicken Sie auf der Seite Geräteregistrierung rechts in der oberen Leiste auf Gerät registrieren und wählen Sie aus dem Auswahlmenü die Option Bulk-Registrierung > Generell. Der Dialog Bulk-Geräteregistrierung wird angezeigt.

3. Klicken Sie auf die Plus-Schaltfläche, um die hochzuladende CSV-Datei auszuwählen, oder wählen Sie sie durch Ziehen und Ablegen aus.

Je nach Format der hochgeladenen CSV-Datei wird einer der folgenden Registrierungstypen verarbeitet:

• Einfache Registrierung
• Vollständige Registrierung

Ein Trennzeichen wird automatisch aus der CSV-Datei übernommen. Gültige Trennzeichenwerte sind: \t (Tabulatorzeichen), ; (Semikolon) und , (Komma).

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 im folgenden Beispiel gezeigt:

ID;CREDENTIALS;TYPE;NAME;ICCID;IDTYPE;PATH;SHELL;AUTH_TYPE
006064ce800a;LF2PWJoLG1Fz;c8y_Device;Sample_Device1;+491555555;c8y_Serial;bulk group/subgroup1;1;BASIC
006064ce8077;OowoGKAbiNJs;c8y_Device;Sample_Device2;+491555555;c8y_Serial;bulk group/subgroup2;1;BASIC

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 eindeutige Passwort für jedes Gerät 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 aus dem Registrierungsassistenten 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 auf Weiter.
5. Wählen Sie in Schritt 2 des Textimport-Assistenten die Option Semikolon und klicken Sie auf Fertig stellen.

Weitere Informationen zum Dateiformat und akzeptierten CSV-Varianten finden Sie auch unter Create a bulk device credentials request in der Cumulocity IoT OpenAPI Specification.

Anzeigen von Geräten

Klicken Sie auf 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:

Für Benutzer mit globalen Rollen werden die Elemente in der Geräteliste in Seiten unterteilt angezeigt. Sie können die Anzahl der Elemente pro Seite wählen und direkt zu einer beliebigen Seite springen. Benutzer mit Stammdatenrollen sehen anfangs bis zu 50 Elemente. Wenn mehr als 50 Geräte vorhanden sind, werden diese geladen, wenn Sie in der Liste nach unten scrollen.

Konfigurieren von Spalten

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

So blenden Sie Spalten ein/aus

1. Klicken Sie in der Tabellenkopfzeile auf Spalten konfigurieren.
2. Aktivieren/deaktivieren Sie in der darauf folgenden Auswahlliste die Checkboxen für die gewünschten/unerwünschten Spalten.

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 in der Auswahlliste 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. Stellen Sie den Umschalter Diese Spalte speichern, um eine weitere hinzuzufügen auf aktiv, um direkt nach dem Speichern der aktuellen benutzerdefinierten Spalte eine weitere zu erstellen, ohne den Dialog zu verlassen.
5. Klicken Sie auf Speichern.

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

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.
3. Bestätigen Sie das Entfernen des Geräts. Wählen Sie optional, ob Kindgeräte des Geräts oder der zugehörige Gerätebesitzer gelöscht werden sollen. Beachten Sie, dass nicht beide Optionen gewählt werden können.

Das Objekt wird dauerhaft aus der Plattform gelöscht.

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 in der Auswahlliste 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 auf + Nächsten hinzufügen, 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).
• Wählen Sie für benutzerdefinierte Spalten die Option Nur Zeilen, in denen der Wert definiert ist, um anhand dessen zu filtern, ob das Fragment existiert, oder legen Sie einen oder mehrere Filterbegriffe fest, denen der Eintrag entsprechen muss.

Klicken Sie auf Anwenden, um die Filterbedingungen anzuwenden.

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

Die Sortierfunktion steht bei jeder Spalte zur Verfügung. Klicken Sie auf das Sortieren-Symbol in der jeweiligen Spaltenüberschrift einmal, um die Einträge in aufsteigender Reihenfolge zu sortieren, oder zweimal, um sie in absteigender Reihenfolge zu sortieren. Klicken Sie erneut auf das Sortieren-Symbol, um die Sortierung bei dieser Spalte aufzuheben.

Klicken Sie auf Filter zurücksetzen in der Tabellenkopfzeile, wenn Sie alle Filter zurücksetzen und wieder alle Geräte anzeigen möchten.

Gruppieren von Geräten

Sie können Geräte 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 können zur weiteren Unterteilung von Top-Level-Gruppen verwendet werden.

Anzeigen von Gruppen

Klicken Sie im Navigator auf Gruppen, um alle Gruppen in einem Listenformat anzuzeigen.

Zu jeder Gruppe werden verschiedene Informationen wie Typ und Name bereitgestellt. Klicken Sie rechts auf Spalten konfigurieren, um Spalten hinzuzufügen oder zu entfernen und die Ansicht nach Ihren Wünschen anzupassen. Siehe auch Anzeigen von Geräten > Konfigurieren von Spalten.

Um die Gruppen nach bestimmten Kriterien zu filtern, bewegen Sie den Mauszeiger über die Spaltenüberschriften und klicken Sie auf das entsprechende Filtersymbol.

Siehe auch Anzeigen von Geräten > So filtern Sie Geräte.

Beachten Sie, dass diese Funktion nur einen temporären Filter erzeugt. Für permanente Filter können Sie die Funktion Dynamische Gruppe verwenden.

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

Seite “Kind-Assets”

Oben auf der Seite Kind-Assets werden Name und Beschreibung der Gruppe angezeigt (bearbeitbar), gefolgt von der Information, wann die Gruppe erstellt und zuletzt aktualisiert wurde.

Darunter werden alle der Gruppe zugewiesenen Assets aufgelistet. Zu jedem Asset werden verschiedene Informationen wie Typ und Name angezeigt. Wie bei der Liste der Top-Level-Gruppen können Sie auch hier Spalten hinzufügen oder entfernen und die Liste individuell anpassen oder Filter anwenden, um die Liste nach bestimmten Kriterien zu filtern.

Darüber hinaus können Sie Geräte zuordnen, siehe So weisen Sie einer Gruppe Geräte zu.

So fügen Sie eine Gruppe hinzu

1. Klicken Sie auf Gruppe hinzufügen rechts in der oberen Menüleiste.
2. Geben Sie im darauf folgenden Dialog einen eindeutigen Gruppennamen und eine optionale Beschreibung ein und klicken Sie auf Weiter.
3. Wählen Sie in der Liste die hinzuzufügenden Geräte aus. Sie können Filter anwenden, um die Anzahl der angezeigten Geräte zu reduzieren.
4. Klicken Sie auf Erstellen, um die neue Gruppe zu erstellen.

Die neue Gruppe wird der Gruppenliste hinzugefügt.

Um eine neue Gruppe als Kind einer existierenden Gruppe hinzuzufügen, navigieren Sie zur entsprechenden Kind-Assets-Seite und klicken Sie auf Gruppe hinzufügen in der oberen Menüleiste.

So bearbeiten Sie eine Gruppe

1. Wählen Sie im Navigator eine Gruppe aus.
2. Auf der Seite Kind-Assets können Sie den Namen und die Beschreibung der Gruppe bearbeiten.

Weitere Informationen zu den Berechtigungen finden Sie unter Verwalten von Berechtigungen im Abschnitt “Administration”.

So löschen Sie eine Gruppe

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

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ü Gruppe und öffnen Sie dann die Seite Kind-Assets.
2. Klicken Sie auf Geräte zuweisen rechts in der oberen Menüleiste.
3. Wählen Sie in der Liste die hinzuzufügenden Geräte aus. Sie können Filter anwenden, um die Anzahl der angezeigten Geräte zu reduzieren.
4. Klicken Sie auf Zuweisen, um die ausgewählten Geräte zuzuweisen.

Die Geräte werden der ausgewählten Gruppe zugewiesen und als Kind-Assets auf der Seite Kind-Assets angezeigt.

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

So heben Sie die Zuweisung eines Geräts auf

Bewegen Sie den Mauszeiger über das Gerät, dessen Zuweisung Sie aufheben möchten, und klicken Sie rechts auf das Symbol “Zuweisung aufheben”.

Wenn Sie die Zuordnung eines Geräts aufheben, werden das Gerät, seine Kindgeräte sowie zugehörige Daten nicht gelöscht. Das Gerät wird nur aus dieser Gruppe entfernt.

So löschen Sie ein Gerät

Bewegen Sie den Mauszeiger über das Gerät, das Sie löschen möchten, und klicken Sie rechts auf das Löschen-Symbol.

Das Gerät wird dauerhaft gelöscht.

So zeigen Sie die Gerätedetails an

Um die Details eines bestimmten Geräts anzuzeigen, klicken Sie auf dessen Namen.

Die entsprechenden Gerätedetails werden angezeigt.

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 die Operation 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.

Dynamische Gruppen werden in der Geräteliste erstellt.

So erstellen Sie eine dynamische Gruppe

1. Klicken Sie auf 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 Anzeigen von Geräten > So filtern Sie Geräte.
3. Klicken Sie auf Dynamische Gruppe erstellen rechts in der oberen Menüleiste.
4. Geben Sie einen Namen für die Gruppe ein und klicken Sie auf Erstellen.

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

Unterhalb des Namens und der Beschreibung der dynamischen Gruppe sehen Sie die Filterkriterien, die beim Erstellen der dynamischen Gruppe angewendet wurden. Sie können die Filtereinstellungen hier ändern und Ihre Auswahl anpassen.

So löschen Sie eine dynamische Gruppe

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

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. Eine detaillierte Beschreibung der Operationen und Fragmente für die jeweilige Gerätedetail-Registerkarte finden Sie in der Device Management Library im Reference Guide.

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, Verfügbarkeit, 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:

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.

Alarme

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

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.

Firmware

Weitere Informationen zum Verwalten und Aktualisieren von Firmware auf einem Gerät finden Sie unter Verwalten von Firmware auf einem Gerät.

Geräteprofil

Weitere Informationen zum Anwenden von Geräteprofilen auf ein Gerät finden Sie unter Geräteprofile auf Geräte anwenden.

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 z. B. 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.

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.

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. Wählen Sie eine der geräteunterstützten Konfigurationen aus der Liste.
3. 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.

Logdaten

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

So fragen Sie Loginformationen ab

1. Klicken Sie auf 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 auf 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 Logdateien 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.

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.

So ist etwa im Screenshot unten ein Diagramm für Temperaturmesswerte mit zwei verschiedenen Series zu sehen.

Wenn ein Diagramm Messwerte mit verschiedenen Series enthält, wird pro Series eine Y-Achse dargestellt. Im Beispiel oben werden die Temperaturdaten zweier Sensoren aufgezeichnet, nämlich “sensors-1” und “sensor-2” mit der gleichen Einheit wie °C. Hier werden Messwerte verschiedener Sensoren als separate “Series”-Daten kategorisiert. Die Messwerte der jeweiligen Sensoren werden unter verschiedenen Series-Namen gespeichert (identisch mit den Sensornamen), und somit werden hier zwei Achsen dargestellt. Gehören die Messwerte derselben Series an, wird hingegen nur eine Y-Achse 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 auf 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" : {
	"series_name" : {
		"value" : ...
		"unit" : ...
	}
}

Beispiel:

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

"Fragment_name" und "series_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.

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.

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 auf Speichern, um Ihre Einstellungen zu speichern.

So konfigurieren Sie LAN-Parameter

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

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 auf Speichern, um Ihre Einstellungen zu speichern.

Services

Die Registerkarte Services enthält eine Liste aller auf einem Gerät ausgeführten Services mit deren Status, Namen, Typ und letztem Aktualisierungsdatum. In jeder Spalte können die Services anhand des jeweils angezeigten Wertes gefiltert und/oder sortiert werden.

Die Plattform gibt drei Statusoptionen für Services vor: In Betrieb, Außer Betrieb und Unbekannt. Diese vordefinierten Status haben jeweils eine eigene grafische Darstellung und können direkt im Filter Status ausgewählt werden. Andere Statusoptionen sind ebenfalls zulässig und können frei definiert werden, siehe Service module in der Web SDK-Dokumentation. Sie verwenden alle das gleiche Symbol und müssen im Filter Status manuell eingegeben werden. Ein Tooltip am Statussymbol zeigt ihren tatsächlichen Wert an.

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 auf Ausführen, um das Kommando an das Gerät zu senden. Diese Schaltfläche wird erst aktiviert, wenn das Kommando in den Textbereich geschrieben wird.

Cumulocity IoT stellt für manche Gerätetypen einige häufig verwendete Kommandos bereit. Klicken Sie über dem Kommandozeilenbereich auf Vordefinierte Kommandos, um ein Fenster zu öffnen, das eine Liste von verfügbaren vordefinierten Kommandos enthält. Wählen Sie das gewünschte Kommando aus und klicken Sie auf Verwenden, um das ausgewählte Kommando in der Kommandozeile einzufügen. Sie können auch selbst neue Kommandos zur Wiederverwendung hinzufügen.

Software

Weitere Informationen zum Verwalten und Aktualisieren der auf einem Gerät installierten Software finden Sie unter Verwalten von Software auf einem Gerät.

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.

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.

Tracking

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

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.

Verfügbarkeit

Die Registerkarte “Verfügbarkeit” ermöglicht die Verfügbarkeitsüberwachung von Maschinen. Näheres dazu finden Sie unter Überwachen und Steuern von Geräten > Verfügbarkeit.

Ü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 auf 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.”

Sendeverbindungen werden aktualisiert, wenn etwas an das Gerät gesendet wird, z. B. Alarme, Ereignisse, Messwerte oder aktualisierte Stammdaten.

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

Eine Push-Verbindung ist eine aktive HTTPS-Long-Poll-Verbindung zum API-Endpunkt /notification/operations oder eine aktive MQTT-Verbindung zum MQTT-Endpunkt von Cumulocity IoT. Sie ist immer grün dargestellt, wenn das Gerät verbunden ist, auch wenn kein Datenverkehr stattfindet.

Wartungsmodus

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.

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.

Verfügbarkeit

Cumulocity IoT unterscheidet zwischen Verbindungsüberwachung und Verfügbarkeit. 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.

Verfügbarkeit zeigt hingegen 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 Verfügbarkeit eines bestimmten Geräts an

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

So zeigen Sie die Verfügbarkeit für alle Geräte an

Klicken Sie auf Verfügbarkeit im Menü Geräte des Navigators, um den Gesamtservice aller Geräte anzuzeigen.

Die Seite Verfügbarkeit zeigt die Verfügbarkeit aller Geräte während der letzten 24 Stunden, der letzten 7 Tage und der letzten 30 Tage in Prozent 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 auf 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 auf 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.

In der oberen Menüleiste sind Schaltflächen zum Filtern nach Schweregrad verfügbar. Wenn Sie auf eine Schaltfläche klicken, wird der entsprechende Bereich ausgeblendet. Klicken Sie erneut darauf, um ihn wieder sichtbar zu machen.

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 dient zum Duplizieren von Alarmen und zum Konfigurieren der Priorität von Alarmen in Administration > Verwalten von Geschäftsregeln > Alarmregeln.
• Ä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 auf 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 auf 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

Sie finden die Liste der Einzel-Operationen auf der Registerkarte Einzel-Operationen.

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

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

Durch Klicken auf eine Zeile wird diese aufgeklappt und es werden weitere Details zur Operation angezeigt.

• Details: Nähere Beschreibung und Status der Operationen. 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 Einzel-Operationen nach dem Status zu filtern, klicken Sie auf eine der Status-Schaltflächen in der oberen Menüleiste. Klicken Sie auf Alle, um den Filter wieder zurückzusetzen.

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

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 und mehr.

Wenn Sie eine Bulk-Operation erstellen, werden die Einzel-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.

So brechen Sie ausstehende Einzel-Operationen ab

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

Um eine bestimmte ausstehende Einzel-Operation abzubrechen, klicken Sie auf das Menüsymbol rechts neben dem Eintrag der betreffenden Einzel-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

Sie finden die Liste der Bulk-Operationen in der Registerkarte Bulk-Operationen.

Bulk-Operationen besitzen einen Operationstyp und einen Status.

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 Einzel-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. Handelt es sich bei der Bulk-Operation um einen Wiederholungsversuch für fehlgeschlagene Operationen, wird eine zusätzliche Zeile mit dem Index der Bulk-Operation angezeigt, die erneut ausgeführt werden soll. Klicken Sie auf den Index, um zu dieser Bulk-Operation zu scrollen. Wenn beim Erstellen der Bulk-Operation eine Beschreibung hinzugefügt wurde, wird eine zusätzliche Zeile mit dieser Beschreibung angezeigt.
• 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 Einzel-Operationen, die in der Bulk-Operation abgearbeitet werden. Kann nach Status gefiltert werden. Darüber hinaus können Sie entweder alle fehlgeschlagenen Operationen erneut ausführen, indem Sie rechts oben im Abschnitt Operationen auf Fehlgeschlagene Operationen erneut ausführen klicken, oder einzelne Operationen erneut ausführen, indem Sie den Mauszeiger darüber bewegen und dann auf die Schaltfläche Operation erneut ausführen klicken, die direkt daneben erscheint. Siehe auch So führen Sie fehlgeschlagene Operationen erneut aus.
• Änderungshistorie: In einer zweiten Registerkarte werden Informationen zu den letzten Änderungen der Operation angezeigt.

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 auf Alle, um den Filter wieder zurückzusetzen.

Um die Liste der Bulk-Operationen nach Datum zu filtern, wählen Sie ein Datum in den beiden Datumsauswahlfeldern Von Datum und Bis Datum aus und klicken Sie direkt daneben auf Anwenden. Um den Filter zurückzusetzen, klicken Sie direkt daneben auf Löschen.

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

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

Führen Sie folgende Schritte aus:

1. Klicken Sie in der Registerkarte Bulk-Operationen rechts in der oberen Menüleiste auf Neue Bulk-Operation.
2. Wählen Sie im nächsten Dialog einen Operationstyp.
3. Im darauf folgenden Assistenten gibt es vier Schritte. Je nach Operationstyp unterscheiden sich die ersten beiden Schritte:

• Konfigurationsaktualisierung
  • Wählen Sie eine Konfiguration aus der Liste aus. Die Liste kann nach Konfigurationstyp oder Konfigurationsnamen gefiltert werden. Klicken Sie auf Weiter.
  • Überprüfen Sie die Vorschau der gewählten Konfiguration. Klicken Sie auf Weiter.
• Firmware-Aktualisierung
  • Wählen Sie eine Firmware aus der Liste aus. Die Liste kann nach Firmware-Namen gefiltert werden. Klicken Sie auf Weiter.
  • Erweitern Sie einen Versionseintrag und wählen Sie einen Patch. Klicken Sie auf Weiter.
• Software Update
  • Erweitern Sie einen Softwareeintrag aus der Liste und wählen Sie eine Version, anschließend wählen Sie aus der Auswahlliste aus, ob Sie die Software installieren, aktualisieren oder entfernen möchten. Die Liste der verfügbaren Software kann nach Gerätetyp, nach Software-Typ oder nach Softwarename gefiltert werden. Klicken Sie auf Weiter. Wenn Sie Software für mehrere Gerätetypen gewählt haben, informiert Sie ein Warndialog darüber, dass einige Operationen wegen nicht unterstützter Software fehlschlagen könnten, und fordert Sie zur Bestätigung auf.
  • Bestätigen Sie die Auswahl und klicken Sie auf Weiter.
• Geräteprofil anwenden
  • Wählen Sie ein Geräteprofil aus der Liste aus. Die Liste kann nach Gerätetyp oder Profilnamen gefiltert werden. Klicken Sie auf Weiter.
  • Bestätigen Sie die Auswahl und klicken Sie auf Weiter.

4. Wählen Sie Zielgeräte, indem Sie Filter auf die in Seiten aufgeteilte Liste aller Geräte anwenden. Sie können nach Status, Name, Typ, Modell, Gruppe, Registrierungsdatum und Alarmen filtern. Sie können mehrere Filter anwenden. Um einen Filter anzuwenden, klicken Sie auf die Spaltenüberschrift, wählen Sie Ihre Filteroptionen im Kontextmenü und klicken Sie auf Anwenden. Der Gruppenfilter ermöglicht auch das Filtern nach Untergruppen. Zum Auswählen einer ggf. vorhandenen Untergruppe klicken Sie auf die Pfeilschaltfläche rechts neben einer Gruppe und wählen Sie die gewünschten Untergruppen aus der Auswahlliste. Sie können alle Filter zurücksetzen, indem Sie oberhalb der Liste auf Filter zurücksetzen klicken. Für die Operationstypen “Konfigurationsaktualisierung”, “Software Update” und “Geräteprofil anwenden” ist die Liste bereits nach dem entsprechenden Gerätetyp gefiltert. Klicken Sie auf Weiter.
5. Geben Sie einen neuen Titel ein oder verwenden Sie den vorgegebenen Titel. Geben Sie bei Bedarf eine Beschreibung ein. Wählen Sie eine Startzeit und eine Verzögerung. Die Verzögerung ist die Zeitspanne zwischen den Einzel-Operationen der Bulk-Operation und kann in Sekunden oder Millisekunden angegeben werden. Klicken Sie auf Bulk-Operation planen, um die Bulk-Operation anzulegen.

So planen Sie eine Einzel-Operation als Bulk-Operation

Es gibt zwei Möglichkeiten, eine Einzel-Operation als Bulk-Operation zu planen: entweder auf der Registerkarte Einzel-Operationen oder auf der Registerkarte Steuerung eines bestimmten Geräts. Führen Sie folgende Schritte aus:

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

So setzen Sie fehlgeschlagene Bulk-Operation manuell auf “erfolgreich”

Sie können eine fehlgeschlagene Bulk-Operation manuell auf den Status ERFOLGREICH setzen.

Klicken Sie dazu auf das Menüsymbol rechts neben der Bulk-Operation und anschließend auf Operation auf ERFOLGREICH setzen.

Dies kann hilfreich sein, wenn die Operation allgemein erfolgreich war, aber Operationsfehler bei Geräten aufweist, die nicht allzu wichtig sind. Diese Fehler würden andernfalls dazu führen, dass die Bulk-Operation im Status FEHLGESCHLAGEN verbleibt.

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 auf 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 auf 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 auf Anwenden, um den Filter anzuwenden. Klicken Sie auf Aufheben, um den Filter wieder zurückzusetzen.

Überwachen von Geräteservices

Mit der Anwendung Device Management können Sie die Daten überwachen, die Ihre Geräte über die auf ihnen ausgeführten Services senden.

Die Registerkarte Services in der Geräte-Detailansicht bietet eine Übersicht über die Services, die auf dem jeweiligen Gerät ausgeführt werden, und dient als Einstiegspunkt zur Service-Detailansicht. Dort finden Sie ausführliche Informationen über Messungen, Ereignisse und Alarme, die für den betreffenden Service gesendet wurden.

Die Service-Detailansicht umfasst die folgenden Registerkarten, die in den nachstehenden Abschnitten detailliert beschrieben werden:

Alarme

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

Ereignisse

Die Registerkarte Ereignisse zeigt die mit einem Service verbundenen Ereignisse an. Weitere Informationen finden Sie unter Fehlerbehebung von Geräten.

Messwerte

Die Registerkarte Messwerte zeigt eine Standardvisualisierung der numerischen Daten für den Service in Form von Diagrammen an.

Weitere Informationen zur Verwendung der Registerkarte Messungen finden Sie unter Messwerte.

Verwalten von Gerätetypen

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

Klicken Sie auf 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äteprotokolltyp (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 auf 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 auf 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 auf 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 auf 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 auf 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. Links in der oberen Menüleiste können Sie die Repository-Einträge nach Name, Beschreibung und Gerätetyp filtern. Weitere Informationen zur Filterfunktionalität finden Sie unter Erste Schritte > Eigenschaften und Funktionen der Benutzeroberfläche > Filtern.

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 darauffolgenden 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. Optional können Sie den Gerätetypfilter definieren, wenn Sie eine neue Firmware hinzufügen.
4. Laden Sie entweder eine Binärdatei aus Ihrem Dateisystem hoch oder geben Sie eine URL an, unter der die Firmware heruntergeladen werden kann.
5. Klicken Sie auf 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. Geben Sie die neue Versionsnummer ein und laden Sie eine Binärdatei hoch oder geben Sie einen Dateipfad an.

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

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 der letzten Operation an (ERFOLGREICH, AUSSTEHEND, WIRD AUSGEFÜHRT, oder FEHLGESCHLAGEN). Durch Klicken auf die Operation werden die Operationsdetails angezeigt.

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.

Klicken Sie auf die Operation, um Details dazu anzuzeigen. 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 auf 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.

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ätetyp, auf den sie anwendbar ist (falls angegeben), den Software-Typ (falls angegeben) sowie einen Sticker, der angibt, ob und wie viele Versionen für eine bestimmte Software verfügbar sind. Die Werte in jeder Spalte außer in der Spalte Versionen können durch Klicken auf das Filter- oder Sortiersymbol in der Spaltenüberschrift gefiltert bzw. sortiert werden.

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, ein oder mehrere Gerätetypfilter (optional) und ein Software-Typ. Wenn ein Gerätetypfilter 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. Der Software-Typ bewirkt, dass die Software nur auf Geräten installierbar ist, die den jeweiligen Software-Typ explizit unterstützen.

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 darauffolgenden 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. Optional können Sie den Gerätetypfilter definieren, wenn Sie eine neue Software hinzufügen.
4. Definieren Sie den Software-Typ. Dies bewirkt, dass die Software nur auf Geräten installierbar ist, die den jeweiligen Software-Typ erklärtermaßen unterstützen.
5. Laden Sie entweder eine Binärdatei aus Ihrem Dateisystem hoch oder geben Sie eine URL an, unter der die Software heruntergeladen werden kann.
6. Klicken Sie auf Software hinzufügen.

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. Geben Sie die neue Versionsnummer ein und laden Sie eine Binärdatei hoch oder geben Sie einen Dateipfad an.

So bearbeiten Sie eine Software

1. Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Software-Element und anschließend im Kontextmenü auf Bearbeiten.
2. Bearbeiten Sie den Namen, die Beschreibung, den Gerätetypfilter oder den Software-Typ, 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-Elementen oder Software-Versionen

So löschen Sie eine Software

Klicken Sie auf das Menüsymbol rechts neben einem bestimmten Software-Element 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.

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. Wenn eine bestimmte Software einen Typ hat, wird dieser neben ihrem Namen angezeigt. Sie können nach einer bestimmten Software anhand ihres Namens suchen oder die Liste anhand des Software-Typs filtern.

Darüber hinaus zeigt sie den Operationsstatus der letzten Operation an (ERFOLGREICH, AUSSTEHEND, WIRD AUSGEFÜHRT, oder FEHLGESCHLAGEN). Durch Klicken auf die Operation werden die Operationsdetails angezeigt.

So installieren Sie Software auf einem Gerät

1. Klicken Sie auf der Registerkarte Software auf Software installieren.

   Info

   Im Dialog Software installieren werden nur Software-Elemente angezeigt, die dem Gerätetyp entsprechen. Zudem gilt: Wenn für das Gerät c8y_SupportedSoftwareTypes deklariert wurden, werden in dem Dialog nur die Software-Elemente angezeigt, die den unterstützten Software-Typen entsprechen.

2. Wählen Sie einen oder mehrere Software-Einträge, indem Sie die entsprechende Version in der Liste auswählen. Diese enthält alle Software-Elemente, die für diesen Gerätetyp im Software-Repository bereitstehen.
   Bei Geräten, die erweiterte Software-Management-Funktionen unterstützen, können bereits installierte Software-Elemente nicht in der Liste der verfügbaren Software-Elemente vorab gefiltert werden. Daher wird nach Auswahl der jeweiligen Software-Version überprüft, ob die ausgewählte Software bereits auf dem Gerät installiert ist. Ist dies der Fall, wird durch eine Warnung neben der ausgewählten Version darauf hingewiesen, dass die Software-Version bereits auf dem Gerät vorhanden ist.
   Sie können das bereits installierte Software-Element unter Software-Änderungen entfernen oder aber beibehalten und im Rahmen der Änderungen anwenden. Wie mit einer solchen Aktualisierung umgegangen werden soll, bleibt dem Geräte-Agenten überlassen.

3. Klicken Sie auf Installieren.

4. Überprüfen Sie Ihre geplanten Änderungen unter 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.

Klicken Sie auf die Operation, um Details dazu anzuzeigen. 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 das Software-Element, das 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 das Software-Element, das 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 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 auf 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.

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 auf 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 auf 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ätetypen ein. Den Gerätetypen 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

Das Verwalten von Konfigurationen, also das Anfordern einer Konfiguration von einem Gerät und das Senden einer Konfiguration an ein Gerät, kann auf mehrere Arten erfolgen. Je nach Benutzerberechtigungen und Geräteeinstellungen können Sie mit textbasierter, typenbasierter oder dateibasierter Konfiguration arbeiten. Detailliertere und technische Informationen finden Sie unter Device management library > Configuration im Reference Guide.

So laden Sie einen Konfigurationssnapshot und wenden ihn auf ein Gerät an, das die typenbasierte Konfiguration unterstützt

Wir empfehlen ihnen, die typenbasierte Konfiguration zu verwenden. Bei typenbasierter Konfiguration können Geräte mehrere Konfigurationen gleichzeitig verwalten. Sie können verschiedene Konfigurationen für verschiedene Typen hochladen oder abrufen. Dieser Ansatz ist flexibler, da die Konfigurationen nicht als Dateien, sondern als Ereignisse behandelt werden, was effizienter ist.

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.

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.

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

Geräte, die Konfigurationen als Dateien verwalten, können dies in grundlegender Form mithilfe einer dateibasierten Konfiguration tun. Bei dateibasierter Konfiguration kann pro Gerät nur eine einzige Konfiguration festgelegt werden.

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

Die grundlegendste Form der Konfiguration ist die textbasierte Konfiguration. Ein Textbefehl kann von einem Gerät gesendet oder empfangen werden. Wir empfehlen Ihnen, die textbasierte Konfiguration nur für kurze, menschenlesbare Konfigurationsdateien zu verwenden.

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 auf 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 auf 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-Operationen 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-Pakete 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 Konfigurationen.

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.

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.

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ätetypen 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.

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.

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

Alle Zertifikate des Mandanten werden angezeigt.

Die Spalte Status zeigt an, ob das Zertifikat aktiviert oder deaktiviert ist. Ein Mandant kann jederzeit über eine beliebige Anzahl von aktivierten oder deaktivierten 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 im nächsten Dialog die folgenden Informationen ein:

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

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.

SmartREST-Templates

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 jedes Mal manuell eine Anfrage zu schreiben.

Um ein neues Template hinzuzufügen, importieren Sie entweder ein vorhandenes Template oder erstellen Sie ein neues. Um ein Template zu importieren, klicken Sie rechts in der oberen Menüleiste auf Template importieren, wählen Sie eine hochzuladende Datei aus und geben Sie einen Namen und eine eindeutige ID ein. Um ein neues Template zu erstellen, klicken Sie rechts in der oberen Menüleiste auf Template erstellen, geben Sie einen Namen und eine eindeutige ID ein und fügen Sie die erforderlichen Nachrichten oder Antworten hinzu, wie im weiteren Verlauf beschrieben.

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 jedes Mal 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 Reference 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 rechts in der oberen Menüleiste auf Template importieren.
2. Wählen Sie im darauf folgenden Dialog eine Datei zum Hochladen aus Ihrem Dateisystem.
3. Geben Sie einen Namen und eine eindeutige ID für das Template ein (beide Eingaben sind erforderlich).
4. Klicken Sie auf Importieren, um das Template zu importieren.

So erstellen Sie ein neues SmartREST-Template

1. Klicken Sie rechts in der oberen Menüleiste auf Template erstellen.
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 auf 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 auf 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, OPERATION, 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 auf 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 auf 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 auf Antwort hinzufügen.

2. Füllen Sie die folgenden Felder aus:

3. Klicken Sie auf Speichern.

Die Antwort wird dem SmartREST-Template hinzugefügt.

Weitere Informationen finden Sie unter SmartREST 1.0 > Templates > Response templates im Reference Guide.

So löschen Sie eine Antwort

Um eine Antwort zu löschen, öffnen Sie diese und klicken Sie unten auf 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 auf 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.

Arbeiten mit 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 Operationen, 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 Geräte erstellen, die den gleichen Grad an Funktionalität simulieren 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, z. B. 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 auf 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 auf 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 auf 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 auf 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 auf 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 auf 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 auf 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 auf Speichern.

Die neue Anweisung wird dem Simulator hinzugefügt.

So fügen Sie eine Wartezeit hinzu

1. Klicken Sie auf Wartezeit hinzufügen, um dem Simulator eine neue Warteanweisung hinzuzufügen.
2. Legen Sie im darauf folgenden Dialog die Dauer fest.
3. Klicken Sie auf 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 Operationen

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

Klicken Sie auf den Umschalter, um die jeweilige Operation ein- oder auszuschalten.

So fügen Sie eine benutzerdefinierte Operation hinzu

1. Klicken Sie auf Eigene Operation hinzufügen, um eine eigene Operation festzulegen.
2. Geben Sie im darauf folgenden Dialog den Typ des benutzerdefinierten Operationen an, der vom Simulator unterstützt werden soll.
3. Klicken Sie auf Hinzufügen.

Die benutzerdefinierte Operation wird der Operationsliste 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.

Connectivity

Der Connectivity-Agent, der von der Anwendung Cumulocity IoT Device Management aus arbeitet, liefert grundlegende Informationen zu Mobilgeräten sowie zusätzliche Details zur Konnektivität.

Die Cumulocity IoT-Plattform lässt sich mit den SIM-Connectivity-Plattformen Comarch, Ericsson, Jasper und Kite integrieren.

Die folgenden Funktionen werden von diesen Anbietern bereitgestellt:

Wie Sie sehen, bietet Jasper derzeit den größten Funktionsumfang.

Für jeden Anbieter muss entweder ICCID oder MSISDN im Fragment c8y_Mobile des Objekts eingestellt werden. Dies ist erforderlich, um das Objekt in Cumulocity IoT korrekt der zugehörigen SIM auf der Plattform des entsprechenden Anbieters zuordnen zu können.

Die folgende Beschreibung basiert vornehmlich auf Jasper, doch dieselbe Konfiguration und Nutzung gilt auch für die anderen Anbieter. Etwaige Unterschiede werden explizit angegeben.

In den nachstehenden Abschnitten wird Folgendes beschrieben:

• Einrichten Ihres Jasper Control Center-Kontos (beispielhaft).
• Konfigurieren der Konnektivität zum SIM-Anbieter in Ihrem Cumulocity IoT-Mandanten
• Verknüpfen von SIMs und Mobilgeräten.
• In der Registerkarte “Connectivity” angezeigte Informationen.
• Verwalten der Konnektivität über Device Management.

Einrichten Ihres Jasper Control Center-Kontos

In den folgenden Schritten wird beschrieben, wie Sie im Jasper Control Center einen dedizierten Benutzer einrichten können. Dieser Benutzer wird für jeglichen Zugriff von Cumulocity IoT auf das Jasper Control Center verwendet. Die Berechtigungen des Benutzers haben also Einfluss auf die in Cumulocity IoT verfügbaren Funktionalitäten.

Neben dem Benutzer benötigen Sie auch einen sogenannten API License Key (nur für Jasper erforderlich) und eine API-Server-URL. Zur Ermittlung Ihres API License Key und der API-Server-URL melden Sie sich über einen Control Center-Administratorbenutzer bei Ihrem Control Center-Konto an und klicken Sie auf der Control Center-Startseite auf API Integration. Ihr API License Key und die API-Server-URL werden links oben anzeigt.

Zum Erstellen eines Benutzers im Jasper Control Center führen Sie die folgenden Schritte aus:

1. Navigieren Sie als Admin-Benutzer zu Admin und Users.
2. Klicken Sie auf Create New.
3. Geben Sie den Benutzernamen und weitere Details des Benutzers ein.
4. Wenn Sie SIM-Karten über Cumulocity IoT aktivieren und deaktivieren oder SMS von Cumulocity IoT aus senden möchten, verwenden Sie die Rolle ACCOUNTUSER. Andernfalls verwenden Sie die Rolle ACCOUNTREADONLY.
5. Klicken Sie auf OK, um den Benutzer zu erstellen, geben Sie dann Ihr Admin-Passwort ein und klicken Sie erneut auf OK.

Der Benutzer ist nun erstellt, aber hat noch kein Passwort. Folgen Sie den Anweisungen, die Ihnen das Control Center per E-Mail gesendet hat, um das Passwort festzulegen.

Konfigurieren der Konnektivität für den SIM-Anbieter

Führen Sie den folgenden Schritt aus, um die Konnektivität in Cumulocity IoT zu konfigurieren:

1. Melden Sie sich über einen Cumulocity IoT-Administratorbenutzer bei der Cumulocity IoT-Plattform an.
2. Wechseln Sie zur Anwendung Administration.
3. Klicken Sie auf Connectivity im Menü Einstellungen des Navigators. Falls das Menüelement nicht angezeigt wird, vergewissern Sie sich, dass Ihr Benutzer über die READ- und ADMIN-Berechtigung für Connectivity verfügt. Ist das Menüelement noch immer nicht verfügbar, wenden Sie sich bitte an den Produkt-Support, um den Connectivity-Agenten in Ihrem Mandanten bereitzustellen.
4. Wechseln Sie zur Registerkarte Mobilfunkanbieter-Einstellungen.
5. Wählen Sie einen Anbieter aus der Auswahlliste aus.
6. Geben Sie die Zugangsdaten für das entsprechende SIM-Anbieter-Konto ein. Wenn Ihnen keine Zugangsdaten vorliegen, fragen Sie Ihren Administrator.
7. Legen Sie eine Cache duration (Cache-Dauer) in Sekunden fest um zu bestimmen, wie lange die vom Anbieter stammenden Informationen zwischengespeichert werden sollen. Dadurch werden Timeout-Probleme vermieden.
8. Klicken Sie auf Speichern, um Ihre Einstellungen zu speichern.

Je nach gewähltem Konnektivitätsanbieter müssen Sie anbieterspezifische Parameter festlegen. Der Parameter Cache duration bestimmt, wie viele Sekunden lang die vom Anbieter zurückgegebenen SIM-Daten zwischengespeichert werden, bevor wieder frische Daten angefordert werden. Dies verringert den Datenverkehr und die Anzahl der Anfragen an die SIM-Anbieter im Hinblick auf Inrechnungstellung und Zuverlässigkeit. Eine längere Cache-Dauer bedeutet weniger Datenverkehr an Ihren SIM-Anbieter, eine kürzere Dauer bedeutet, dass aktuellere Daten angezeigt werden.

Verknüpfen von SIMs und Mobilgeräten

Wechseln Sie zur Anwendung Device Management und navigieren zu dem Gerät, das über eine SIM-Karte verbunden ist, die vom SIM-Anbieter Ihrer Wahl verwaltet wird. Das Gerät sollte eine Registerkarte namens Connectivity aufweisen. Wird diese Registerkarte nicht angezeigt, hat dies einen der folgenden Gründe:

• Ihr Benutzer hat keine Berechtigungen für Connectivity.
• Das Gerät ist mit keiner SIM-Karte verknüpft.
• Das Gerät ist zwar mit einer SIM-Karte verknüpft, doch die Karte wird nicht durch das entsprechende SIM-Anbieter-Konto verwaltet.

Um Berechtigungen zuzuweisen, navigieren Sie zur Anwendung Administration und vergewissern Sie sich, dass Ihrem Benutzer eine Rolle mit LESEN- oder ADMIN-Berechtigung für Connectivity zugewiesen ist.

Jasper und Comarch identifizieren SIM-Karten über ihre ICCID (Integrated Circuit Card Identifier). Ericsson verwendet stattdessen eine MSISDN (Mobile Station International Subscriber Directory Number). In den meisten Fällen melden die Geräte die ICCID und die MSISDN Ihrer SIM-Karte automatisch an Cumulocity IoT.

Falls die ICCID nicht automatisch angezeigt wird, überprüfen Sie Folgendes:

• Ermitteln Sie die ICCID der SIM-Karte. Sie ist auf die SIM-Karte aufgedruckt und wird im Control Center angezeigt.
• Geben Sie die ICCID in der Registerkarte Info ein und klicken Sie dann auf Speichern.
• Klicken Sie in der oberen Menüleiste auf Neu laden, damit die Registerkarte Connectivity erscheint.

Der Anbieter Kite erfordert die folgende Gerätekonfiguration: ICCID (Integrated Circuit Card Identifier) und MSISDN (Mobile Station International Subscriber Directory Number).

Registerkarte “Connectivity”

In der Registerkarte Connectivity finden Sie folgende Abschnitte:

• Status
• SMS
• Sitzungen
• Audit-Logs

Im Abschnitt Status werden zusammenfassende Informationen zur SIM-Karte aufgeführt.

Die erste Zeile gibt Auskunft darüber, ob das Gerät momentan eine Datensitzung durchführt. Ist dies der Fall, werden der Beginn der Sitzung und die aktuelle WAN-IP-Adresse des Geräts angezeigt.

Die zweite Zeile zeigt weitere Statusinformationen an: die ICCID der SIM-Karte, den Aktivierungszustand der SIM-Karte und, sofern eingestellt, die festgelegte IP-Adresse der SIM-Karte. Sofern Sie über eine ADMIN-Berechtigung für Connectivity verfügen, können Sie den Aktivierungszustand über das Auswahlmenü ändern.

Am unteren Ende finden Sie Nutzungsinformationen für den aktuellen Monat, d. h. vom ersten Tag des Monats bis heute. Durch Bewegen der Maus über den Tooltip wird der abgedeckte Zeitraum angezeigt, einschließlich der Nutzung im Vormonat.

Der Abschnitt SMS zeigt die Textnachrichten an, die an das Gerät gesendet und von diesem empfangen wurden, einschließlich der folgenden Informationen:

• Sende- bzw. Empfangszeitpunkt der Nachricht
• Absender und Empfänger der Nachricht
• Zustellungsstatus der Nachricht:
  • Für Nachrichten an das Gerät: “Ausstehend”, wenn die Nachricht vom Gerät nicht empfangen wurde, oder “Übergeben”, wenn sie vom Gerät empfangen wurde.
  • Für Nachrichten vom Gerät: “Empfangen”, wenn die Nachricht vom SIM-Anbieter empfangen wurde, oder “Abgebrochen”, wenn sie noch nicht vom SIM-Anbieter empfangen wurde.
• Senderichtung der Nachricht: MT (“Mobile terminated”), wenn sie an das Gerät gesendet wurde, oder MO (“Mobile originated”), wenn sie vom Gerät kam.

Sofern Sie über eine ADMIN-Berechtigung für Connectivity verfügen, können Sie auch Textnachrichten an das Gerät senden, indem Sie den Text eingeben und auf SMS senden klicken.

Im Abschnitt Sitzungen werden die Logdaten der vom Gerät durchgeführten Datensitzungen angezeigt. Hier wird aufgeführt, wann die Sitzung begann, wie lange sie dauerte und wie viel Datenverkehr verbraucht wurde.

Im Abschnitt Audit-Logs werden alle Änderungen an der SIM-Karte und ihrem Tarif aufgeführt. Angezeigt werden die Art der Änderung, alter und neuer Wert, wann die Änderung durch wen erfolgte und ob die Änderung erfolgreich war.

Die Registerkarte Connectivity wird nicht in Echtzeit aktualisiert. Um aktuelle Daten anzuzeigen, klicken Sie in der oberen Menüleiste auf Neu laden.

Überprüfen der Konnektivität

Wenn Sie den Verdacht haben, dass ein Gerät nicht die korrekten Daten an Cumulocity IoT meldet oder keine Kommandos empfängt, können Sie den Konnektivitätsstatus des Geräts überprüfen.

Prüfen Sie in der Registerkarte Connectivity, ob:

• die SIM aktiviert ist. Ist die SIM-Karte nicht aktiviert, können Sie sie aktivieren, indem Sie “AKTIV” aus dem Auswahlmenü “SIM-Status” wählen. Es kann eine Weile dauern, bis die SIM-Karte im Netzwerk aktiviert ist. Unter Umständen ist ein Reset des Geräts notwendig, damit es sich wieder in das Netzwerk einwählt.

• das Gerät mit dem Netzwerk verbunden ist. Falls sich das Gerät nicht mit dem Netzwerk verbindet, kann dies mehrere Ursachen haben:

  • Das Gerät befindet sich an einem Ort ohne Mobilfunkabdeckung. Falls das Gerät Netzwerk-Qualitätsparameter meldet, können Sie zur Registerkarte Messwerte des Geräts navigieren und die zuletzt gemeldeten Signalstärke- und Fehlerraten-Parameter überprüfen.
  • Es liegt ein Netzwerk- oder Hardwareproblem (Antenne, Modem) vor. Klicken Sie zum Beispiel für das Jasper Control Center rechts oben auf das Zahnrad-Symbol, wählen Sie SIM-Details und öffnen Sie dann das Diagnose-Tool des Jasper Control Center. Sollte das Gerät nicht versuchen, sich mit dem Netzwerk zu verbinden, ist es möglicherweise defekt.
  • Das Gerät befindet sich in einer Datensitzung. Befindet es sich nicht in einer Datensitzung, kann dies wiederum mehrere Ursachen haben:
  • Die APN-Einstellungen sind im Gerät falsch konfiguriert.
  • Die SIM-Karte hat den verfügbaren Datenverkehr überschritten.
  • Daten-Roaming ist am Gerät deaktiviert und das Gerät befindet sich nicht im Heimatnetzwerk der SIM-Karte.
  • Daten-Roaming für das jeweilige Netzwerk ist nicht im Funktionsumfang der SIM-Karte enthalten.
  • Die SIM-Konfiguration wurde geändert.

Die Datenkonnektivität kann an verschiedenen Stellen analysiert werden:

• Wenn das Gerät seine Netzwerkkonfiguration meldet, navigieren Sie zur Registerkarte Netzwerk. Überprüfen Sie die APN-Einstellungen und bearbeiten Sie sie gegebenenfalls.
• Wenn das Gerät die Shell-Funktion unterstützt, navigieren Sie zur Registerkarte Shell. Überprüfen Sie die APN-Einstellungen und die Roaming-Konfiguration und bearbeiten Sie sie gegebenenfalls.
• Überprüfen Sie im Abschnitt Sitzungen der Registerkarte Connectivity, ob das Gerät früher kommuniziert hat und wie viel Datenverkehr verbraucht wurde.
• Überprüfen Sie im Abschnitt Audit-Logs der Registerkarte Connectivity, ob in letzter Zeit Änderungen an der SIM-Karte vorgenommen wurden.
• Klicken Sie zum Schluss rechts oben auf das Zahnrad und wählen Sie SIM-Details, um zur SIM-Konfiguration im Jasper Control Center zu gelangen.

Wenn das Gerät noch immer nichts an Cumulocity IoT meldet, liegt möglicherweise ein Konfigurations- oder Softwareproblem am Gerät vor.

• Das Gerät hat möglicherweise seine Zugangsdaten verloren, beispielsweise durch ein Reset auf die Werkseinstellungen oder durch einen kompletten Stromausfall. In diesem Fall können Sie das Gerät neu registrieren.
• Es könnte ein Konfigurations- oder Softwareproblem am Gerät vorliegen, das gerätespezifisch analysiert werden muss.