Überblick über On-Premise Connector Hosts

Zweck

Lernen Sie, wie Sie On-Premise Connector Hosts für Ihre Integrationen nutzen können.

Voraussetzungen

Um mehr über Connector Hosts in Tulip zu erfahren, lesen Sie zuerst diesen Artikel

Übersicht

Dieser Artikel soll als Bezugspunkt für On-Premise Connector Hosts (OPCH) in Tulip dienen. Der Connector Host ist ein Dienst, der verwendet wird, um Verbindungen von Tulip zu externen Webservices, Datenbanken und OPC UA-Servern zu ermöglichen. Alle Tulip-Instanzen haben standardmäßig einen Cloud Connector Host.

Bei der Entscheidung, ob ein On-Premise Connector Host die richtige Architektur ist, sind mehrere Überlegungen anzustellen.

Wichtige Überlegungen für On-Premise Connector Host

Die Überlegungen für einen On-Premise Connector Host können in einige Kategorien eingeteilt werden:

1. Netzwerkarbeit2. Verwaltung der Infrastruktur3. Leistung

Vernetzung

Der häufigste Grund für den Einsatz eines On-Premise Connector Hosts sind die Vorteile, die er bei der Verbindung mit Systemen bietet, die innerhalb eines lokalen Netzwerks gehostet werden. Mit dem On-Premise-Angebot beginnen alle Verbindungen von Tulip zu externen Systemen in Ihrem lokalen Netzwerk. Alle Verbindungen aus Ihrem Netzwerk gehen über einen sicheren WebSocket zu Tulip.

Dies steht im Gegensatz zu Cloud Connector Hosts, die einen eingehenden Zugang zu den Diensten erfordern. Dies ist in der Regel eine IT-Entscheidung, um eingehende sichere WebSocket-Verbindungen von der Tulip-Cloud zum Dienst zuzulassen, oft unter Verwendung von Port-Weiterleitungsregeln auf dem WAN-Router/Firewall.

Verwaltung der Infrastruktur

Für den Einsatz eines On-Premise Connector Host gibt es mehrere Infrastrukturkomponenten, für die der Kunde verantwortlich ist. Nachfolgend finden Sie eine grundlegende Rollen- und Verantwortungsmatrix:

Der Kunde sollte idealerweise mit den Technologien vertraut sein, die er für die Bereitstellung des Connector Hosts verwendet, sowie mit Technologien wie Docker für das Container-Management.

Leistung

Als Empfehlung für Best Practices empfiehlt Tulip, auch einen On-Premise Connector Host zu verwenden, wenn ein OPC UA Server angeschlossen wird. Es ist zwar möglich, die Cloud-Lösung zu verwenden, aber die Bandbreitenanforderung an das Netzwerk kann sehr hoch sein, wenn die Anzahl der abonnierten OPC UA-Tags steigt.

Einsatz eines On-Premise Connector Hosts

Technische Standards

Wenn die Entscheidung für eine On-Premise-Lösung getroffen wird, empfiehlt Tulip eine Self-Service-Route mit einem verteilten Docker-Image. Am einfachsten ist es, eine virtuelle Maschine mit einer Linux-Distribution zu verwenden (Ubuntu wird bevorzugt).

Tulip empfiehlt außerdem, nur einen On-Premise Connector Host pro virtuelle Maschine zu hosten, um einen Single Point of Failure für Standorte zu vermeiden.

Anforderungen an die virtuelle Maschine:

• RAM - 4 GB
• ROM - 8-16 GB Festplattengröße
• CPU - 2 Kerne
• Docker-Version - 20.10+

Was die Netzwerkanforderungen betrifft, so muss der On-Premise Connector Host Folgendes aufweisen:

• eine IP-Adresse
• DNS-Auflösung zu
• Ausgehender Zugang auf Port 443 zu Tulip (IPs hier aufgelistet)
• Ausgehender Zugriff auf das Docker Repository hier
• Ausgehender Zugang zu allen relevanten externen Systemen mit Ports

Sehen Sie sich die vollständige Liste der Netzwerkanforderungen hier an

Anmeldeinformationen beantragen

Wenden Sie sich an den Tulip Support(support@tulip.co), um die Anmeldedaten für den On-Premise Connector Host anzufordern. Verwenden Sie dazu die folgende Vorlage und geben Sie alle in Klammern gesetzten Details ein..:

Dies ist eine Anfrage zur Erstellung eines neuen On-Premise Connector Hosts. 


Tulip-Instanz:   
OPCH Name: ---CH```


Tulip wird die Anmeldedaten über eine sichere, temporäre Passwortverbindung erstellen und weitergeben. Die Details sollten in einen intern verwalteten Anmeldungsspeicher übertragen werden und Folgendes beinhalten:


* Werk
* UUID
* Maschinengeheimnis


:::(Info) (HINWEIS**)On-Premise Connector Host Anmeldedaten sollten nicht verwendet werden, um mehr als einen Connector Host zu erstellen - dies würde zu Verbindungsproblemen für alle Hosts führen, die Anmeldedaten teilen:**


### Verfügbare On-Premise Connector Host-Versionen (Tags)


Tulip verwendet Docker-Image-Tags zur Versionierung von Connector Host-Images. Nachstehend finden Sie eine Liste der aktiv unterstützten On-Premise Connector Host Tags, die in Verbindung mit Docker `run` und `pull` Befehlen verwendet werden können. 


:::(Warning) (WARNUNG)Für eine optimale Leistung sollten die Version Ihrer Tulip-Instanz und die Version des On-Premise Connector Hosts übereinstimmen. Es ist nicht garantiert, dass der Connector Host vorwärtskompatibel mit Instanzversionen ist (z.B. eine LTS8 Connector Host Version auf einer LTS7 Instanz).:::




| Tag | LTS-Version | Zweiwöchentliche Version |
| --- | --- | --- |
| `LTS7` | LTS7 | r222 - r232 |
| `lts8` | LTS8 | r233 - r237 |
| `lts9` | LTS9 | r238 - r248 |
| `lts10` | LTS10 | r249 - r261 |
| `lts11` | LTS11 | r262 - r274 |
| `lts12` | LTS12 | r275-r287 |
| `lts13` | LTS13 | r288+ |


:::(Warning) (Prod Tag Deprecation)In der Vergangenheit konnte das `prod` Tag verwendet werden, um auf die neueste Version von OPCH zu verweisen. Dies ist nun veraltet. In Zukunft wird das `prod-Tag` auf LTS11.3 OPCH verweisen. :::


### Bereitstellung


Im folgenden Abschnitt wird beschrieben, wie ein On-Premise Connector Host in verschiedenen Umgebungen eingesetzt werden kann. AWS und Azure bieten beide Container-Dienste an, auf denen das Docker-Image ausgeführt werden kann. 


* AWS:


	+ Verwenden Sie die Web-UI und diesen Befehlssatz: <https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/>


:::(Warning) (Vor LTS12 OPCH)Vor LTS12 müssen die Umgebungsvariablen CONNECTORS\_HTTPS\_PROXY und CONNECTORS\_HTTP\_PROXY durch HTTPS\_PROXY bzw. HTTP\_PROXY ersetzt werden:::


* Azure:

`az container create \ -g <NAME DER RESOURCE GROUP IN AZURE> \ --name <NAME FÜR DEN CONTAINER> \ --cpu 2 \ --memory 3 \ --restart-policy Always \ --image bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG> \ -e TULIP_UUID='<UUID>' \ TULIP_FACTORY='https://<YOUR SITE>.tulip.co' \ TULIP_MACHINE_SECRET='<SECRET>' \ TULIP_DEVICE_TYPE='onprem' \ CONNECTORS_HTTP_PROXY='' \ CONNECTORS_HTTPS_PROXY=''`
* Linux VM: :::(Warning) (Pre-LTS12 OPCH)Vor LTS12 müssen die Umgebungsvariablen CONNECTORS\_HTTPS\_PROXY und CONNECTORS\_HTTP\_PROXY durch HTTPS\_PROXY bzw. HTTP\_PROXY ersetzt werden:::

`docker run -d \ --name tulip-connector-host \ -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ -e TULIP_UUID='<UUID>' \ -e TULIP_MACHINE_SECRET='<SECRET>' \ -e TULIP_DEVICE_TYPE='onprem' \ -e CONNECTORS_HTTP_PROXY='' \ -e CONNECTORS_HTTPS_PROXY='' \ -e EXIT_ON_DISCONNECT=true \ --restart=always \ --net=host \ --mount type=volume,source=tuliplog,target=/log \ bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>`


## Aktualisieren eines On-Premise Connector Hosts


Tulip veröffentlicht Updates für den On-Premise Connector Host in Übereinstimmung mit unserem Long Term Support (LTS) Release-Plan. Um den Dienst zu aktualisieren, folgen Sie den unten stehenden Anweisungen:


:::(Info) (HINWEIS**)Der Upgrade-Prozess für einen OPCH führt zu einer Ausfallzeit, während der Pod gestoppt und neu erstellt wird:**::


1. Besorgen Sie sich die neueste Version des On-Premise Connector Host Docker-Images.

`docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2`. Führen Sie den folgenden Befehl aus, um die Docker-Container-ID zu erhalten.

`docker ps3`. Wenn Sie Zugriff auf `TULIP_FACTORY`, `TULIP_UUID` und `TULIP_MACHINE_SECRET` haben, fahren Sie mit Schritt 4 fort. Wenn nicht, führen Sie den folgenden Befehl aus und speichern Sie die Ausgabe dieses Befehls an einem sicheren Ort.

`docker exec <container-id> env4`. Stoppen Sie den vorhandenen Docker-Container.

`docker stop <container-id>5`. Entfernen Sie den vorhandenen Docker-Container.

`docker rm <container-id>6`. Führen Sie den Standardbefehl `"Docker run"` aus und nutzen Sie dabei die gespeicherten Anmeldeinformationen.


:::(Warning) (Vor LTS12 OPCH)Vor LTS12 müssen die Umgebungsvariablen CONNECTORS\_HTTPS\_PROXY und CONNECTORS\_HTTP\_PROXY durch HTTPS\_PROXY bzw. HTTP\_PROXY ersetzt werden::: `docker run -d \ --name tulip-connector-host \ -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ -e TULIP_UUID='<UUID>' \ -e TULIP_MACHINE_SECRET='<SECRET>' \ -e TULIP_DEVICE_TYPE='onprem' \ -e CONNECTORS_HTTP_PROXY='' \ -e CONNECTORS_HTTPS_PROXY=''`\ `-e EXIT_ON_DISCONNECT=true \ --restart=always \ --net=host \ --mount type=volume,source=tuliplog,target=/log \ bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>7`. Bestätigen Sie, dass der neue Docker-Container aktiv ist.

````docker ps``

## Zusätzliche Referenzen


### Aktivieren von Log-Rotationen für Docker


Für bestehende On-Premise Connector Hosts, die keine Docker Log-Rotationen verwenden, befolgen Sie die [hier](https://support.tulip.co/docs/enabling-log-rotations-for-existing-on-premise-connector-host-container) dokumentierten Anweisungen, um sicherzustellen, dass der Speicherplatz ordnungsgemäß verwaltet wird.




---

Haben Sie gefunden, wonach Sie gesucht haben?


Sie können auch zu [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) gehen, um Ihre Frage zu stellen oder zu sehen, ob andere mit einer ähnlichen Frage konfrontiert wurden!