Anleitung
Niagara N4 Cloud Suite
Inhalt
Niagara Cloud Suite Einrichten
Vertraulichkeitshinweis
Die Informationen in diesem Dokument sind vertrauliche Informationen der alvasys automation ag ("alvasys"). Solche Informationen und die hier beschriebene Software werden unter Lizenzvereinbarung bereitgestellt und dürfen nur gemäss dieser Vereinbarung verwendet werden. Die in diesem Dokument enthaltenen Informationen werden ausschliesslich für den Gebrauch durch Mitarbeiter, Lizenznehmer und Systembesitzer von ALVASYS bereitgestellt. Der Inhalt dieses Dokuments darf nicht an andere weitergegeben oder für andere vervielfältigt werden. Obwohl alle Anstrengungen unternommen wurden, um die Richtigkeit dieses Dokuments zu gewährleisten, ist ALVASYS nicht verantwortlich für Schäden jeglicher Art, einschliesslich Folgeschäden, die aus der Anwendung der hier enthaltenen Informationen resultieren. Informationen und Spezifikationen, die hier veröffentlicht werden, sind zum Zeitpunkt dieser Veröffentlichung aktuell und können ohne vorherige Ankündigung geändert werden. Dieses Dokument darf von Parteien, die autorisiert sind, ALVASYS-Produkte im Zusammenhang mit der Verteilung dieser Produkte zu verteilen, kopiert werden, unter der Bedingung, dass dies durch die Verträge autorisiert ist, die eine solche Verteilung ermöglichen. Es darf anderweitig, ganz oder teilweise, nicht kopiert, fotokopiert, reproduziert, übersetzt oder in irgendeiner elektronischen Form oder maschinenlesbaren Form reduziert werden, ohne vorherige schriftliche Zustimmung von ALVASYS.
Beschreibung
Schritt für Schritt führen wir Sie durch die grundlegenden Einstellungen, die notwendig sind, um Ihre Niagara-Instanz mit der Cloud zu verbinden und erste Funktionen wie Remotezugriff, Gerätemanagement und Cloud-Dashboards zu aktivieren.
Sie erfahren unter anderem:
- Wie Sie Ihre Instanz mit einem Cloud-Konto verknüpfen,
- Welche Voraussetzungen erfüllt sein müssen,
- Und wie Sie erste Geräte und Dienste in der Cloud sichtbar machen.
Anforderungen
- Niagara 4.14.U2 >
Niagara Cloud Suite Einrichten
1. Auf der Niagara Community Plattform unter Cloud anmelden
https://www.niagara-community.com/
2. Auf Customer reinklicken
3. Ein neues Projekt erstellen
4. In der Workbench NiagaraCloudService aus der Palette cloudLinkNcs nach Services ziehen
5. Rechts klick auf den NiacaraCloudService->Authenticator -> FederatedindentityAuthenticator und Start Registration ausführen.
6. Den Registration URL kopieren und im Browser einfügen.
7. Wenn das Gerät eine Lizenz hat. Sollte folgendes Fenster erscheinen.
Device Name, Location und den vorhin erstellten Project Name auswählen und mit Done bestätigen.
8. Wenn alles geklappt hat, erscheint nun der Kontroller auf der Cloud Übersicht:
9. Im letzten Schritt muss in der Workbench der Cloud Id Manager mit rechtsklick->Ausführen -> Execute ausgeführt werden.
10. Um sicher zu gehen, dass es funktioniert hat, sollte im Channel nun neue Reiter drin sein und last Success mit dem aktuellen Datum und Zeit gesetzt sein.
Niagara Cloud Suite Remote
die Verschlüsselte Remote Webansicht kann über die Cloud gestartet werden.
Niagara Cloud Suite Trend
1. Unter Services->NiagaraCloudService->Channels-History->Exports nach dem bestehenden Trenddaten auf dem Kontroller durchsuchen
3. Für die erste manuelle Synchronisierung, die gewünschten Trends markieren und mit Export bestätigen.
4. Auf der Cloud Plattform unter Data Services findet man nun die Trend Daten.
TrendDaten können auf der Cloud Plattform auch als PDF oder CSV exportiert werden.
Niagara Cloud Suite Backup
Unter Services->NiagaraCloudService->Channels-> Backup -> Policies -> Default Backup Policy mit Rechtsklick den Execute Manuel ausführen. Wenn Status OK, sollte das Backup nun auf der Cloud Plattform ersichtlich sein.
Niagara Cloud Suite Alarm
Beim Hineinziehen des Cloud Service, wird automatisch ein CloudLinkAlarmRecipient im AlarmService erstellt. Diese muss noch mit den gewünschten Alarmklassen verknüpft werden.
Auf der Cloud Plattform gelangt man über Alarms auf die Alarmübersicht.
Alarme können auch über die Cloud Plattform quittiert werden.Niagara Cloud Suite API
1. Erstellen sie als erstes auf der Cloud Plattform einen Service Account
2. Nach erfolgreichem erstellen erhält man einen Client ID und einen Client Secret Key.
3. Kopieren sie diese zwei Keys in einer neuen Textdatei getrennt durch einen Doppelpunkt
1a125eea-7997-4971-9b61-de23dda4a00b:BEWluudUU_qP~L~QyR16rL
7cEOOZaOczwoDOfuoGPSJwHA3gVskeGhkBCDT2J7Dn
4. Öffnen sie die Windows Eingabeaufforderung und verweisen sie in das Verzeichnis, wo die Textdatei abgelegt ist. In diesem Beispiel unter C:\Download Starten sie den CMD Befehl:
certutil -encode CloudKey.txt Base.txt.
Es wird im selben Verzeichnis eine neue Datei mit dem Namen Base.txt erstellt.
Darin ist der neue Schlüssel in Base64 Format konvertiert hinterlegt.
5. Gehen sie auf der Tridium Ressources Plattform und suchen sie den Artikel Cloud API.
6. Im Kapiel 4 von Implementing an OAuth client_credentials flow, finden sie den folgenden Eintrag:
curl -X POST https://auth.pingone.com/2bb83e4b-dd73-47d3-984b-6e601302d766/as/token -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic <base64 endcoded clientId:clientSecret>" -d "grant_type=client_credentials&scope=ncp:read"
curl -X POST https://auth.pingone.com/2bb83e4b-dd73-47d3-984b-6e601302d766/as/token -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic MWExMjVlZWEtNzk5Ny00OTcxLTliNjEtZGUyM2RkYTRhMDBi
OkJFV2x1dWRVVV9xUH5MflF5UjE2ckw3Y0VPT1phT2N6d29ET2Z1b0dQU0p3SEEzZ1Zza2VHaGtCQ0RUMko3RG4=" -d "grant_type=client_credentials&scope=ncp:read"
9. Um den Token zu testen, findet man auch auf der Ressourcen Seite von Tridium einen link https://www.niagara-cloud.com/api/v1/entitymodel/swagger-ui/index.html
10. Mit Klick auf Authorize den Access starten.
.
11. Den Access Token von der CMD einfügen.
12. Auf der Cloud Plattform die persönliche Cloud ID holen (siehe Bild).
13. In der API-Testumgebung den customer ID von der Cloud Plattform einfügen.
14. In der Workbench unter: NiacaraCloudService->Authenticators -> RpkAuthenticator den System GUID Key kopieren.
15. Den System Guid Key im Reques Body einfügen.
16. Der markierte Teil im Bild kann gelöscht werden.
17. Zu guter Letzt mit Execute bestätigen.
18. Nun sieht man alle Datenpunkte Tags der Station.
Dokumenthistorie
Name | Datum | Änderung
|
Tobias Thomann | 23.06.2025 | Dokument erstellt
|
|
|
|
|
|
|
Getestete Versionen:
4.15.1.16
Allgemein:
Links:
https://www.alvasys.ch/support
https://www.youtube.com/@alvasysautomationag3852
YouTube:
Kontakt:
Für Fragen, Wünsche oder Feedbacks.
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren