Ü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 beim Anschluss an Systeme bietet, die in einem lokalen Netzwerk 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 (Ubuntu wird bevorzugt) zu verwenden.

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 Zugangsdaten 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) (NOTE)
**On-Premise Connector Host credentials should not be used to create more than one Connector Host - this would result in connectivity problems for all hosts sharing credentials.**  
:::


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


Tulip verwendet Docker Image Tags, um Connector Host Images zu versionieren. 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) (WARNING)
For best performance, your Tulip Instance version and the On-Premise Connector Host version should match. The Connector Host is not guaranteed to be forward-compatible with instance versions (i.e. an LTS8 connector host version on an LTS7 instance).  
:::




| 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)
Historically, the `prod` tag could be used to point at the most recent version of OPCH. This has been deprecated. Going forward, the `prod` tag will point at LTS11.3 OPCH.   
:::


### Bereitstellung


Im folgenden Abschnitt wird beschrieben, wie ein On-Premise Connector Host in verschiedenen Umgebungen bereitgestellt werden kann. AWS und Azure bieten beide Containerdienste an, die das Docker-Image ausführen können. 


* AWS:


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


:::(Warning) (Pre-LTS12 OPCH)
Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively  
:::


* 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)
Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively  
:::

`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) (NOTE)
**The upgrade process for an OPCH will result in downtime while the pod is stopped and recreated.**  
:::


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) (Pre-LTS12 OPCH)
Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively  
::: `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!