Ü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. Vernetzung 2. Verwaltung der Infrastruktur 3. 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 typischerweise eine IT-Entscheidung, um eingehende sichere WebSocket-Verbindungen von der Tulip-Cloud zum Dienst zu ermöglichen, 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. Im Folgenden finden Sie eine grundlegende Rollen- und Verantwortungsmatrix:

| | | | | --- | | | | | | | Tulip | Kunde | | Bereitstellung technischer Ressourcen für OPCH | X | | | Hosting und Bereitstellung von virtuellen Maschinen | | X | | Überwachung und Aktualisierung von virtuellen Maschinen | | X | | Generierung von OPCH-Anmeldeinformationen | X | | | Bereitstellung von OPCH | | X | | Aktualisierung von OPCH | | X | | Überwachung von OPCH | | X | | Fehlerbehebung von OPCH | X | |

Der Kunde ist idealerweise mit den Technologien vertraut, 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 die Verwendung eines On-Premise Connector Hosts für den Anschluss eines OPC UA Servers. 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 mit Instanzversionen vorwärtskompatibel ist (d.h. 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+ | | `prod` | LTS10 | r249+ |


### 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/>
	+ 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' \ HTTP_PROXY=''`\`HTTPS_PROXY=''`\* Linux VM:


`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 HTTP_PROXY='' \ -e 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 Ausfallzeiten, 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 ermitteln.


`docker ps`3. 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> env`4. 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 `Standard-Docker-Befehl "run` " aus und nutzen Sie dabei die gespeicherten Anmeldeinformationen.`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 HTTP_PROXY='' \ -e 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!