Axel: Installationsanleitung für die Linux-PC-Version erstellt

2026-08-10T11:59:16Z

Installationsanleitung für die Linux-PC-Version erstellt

Neue Seite

Der '''IBH OPC UA Server/Client''' ist als 64-Bit-Linux-Version für <code>amd64</code> und <code>arm64</code> verfügbar. Die Auslieferung erfolgt als Debian-Paket (<code>.deb</code>). Das Paket installiert die Anwendung, richtet den Systemdienst ein und startet ihn automatisch.

== Kurzüberblick ==
# Passendes Paket für die Prozessorarchitektur auswählen.
# Debian-Paket mit <code>apt</code> installieren.
# Status des Dienstes <code>ibhlinkua.service</code> prüfen.
# Web-Konfigurator im Browser öffnen.
# Administratorkennwort ändern und Lizenz aktivieren.
# OPC-UA-Endpoint und Steuerungsverbindungen konfigurieren und testen.

== Voraussetzungen ==
* Empfohlenes Zielsystem: '''Ubuntu 22.04 LTS''' oder ein dafür freigegebenes, Debian-kompatibles Linux-System
* 64-Bit-Prozessorarchitektur <code>amd64</code> oder <code>arm64</code>
* <code>systemd</code> als Dienstverwaltung
* Benutzerkonto mit <code>sudo</code>-Rechten
* Statische IP-Adresse oder über DNS auflösbarer Hostname empfohlen
* Für die Online-Aktivierung: DNS-Auflösung und HTTPS-Zugriff zum Lizenzserver
* Für die Kommunikation mit Steuerungen: Netzwerkzugriff auf die projektierten SPSen

Die Architektur des Zielsystems lässt sich prüfen mit:

<pre>
dpkg --print-architecture
uname -m
</pre>

<code>x86_64</code> entspricht dem Paket für <code>amd64</code>, <code>aarch64</code> dem Paket für <code>arm64</code>.

== Installationspaket ==
Verwenden Sie ausschließlich das von IBHsoftec bereitgestellte Paket für die richtige Architektur. Der Dateiname hat beispielsweise folgende Form:

<pre>
ibhlinkua_VERSION_amd64.deb
ibhlinkua_VERSION_arm64.deb
</pre>

Kopieren Sie das Paket auf den Linux-Rechner und wechseln Sie im Terminal in das Verzeichnis, in dem die Datei liegt.

== Installation ==
Installieren Sie das Paket mit <code>apt</code>. Dabei werden die im Paket hinterlegten Abhängigkeiten berücksichtigt:

<pre>
sudo apt update
sudo apt install ./ibhlinkua_VERSION_amd64.deb
</pre>

Ersetzen Sie den Dateinamen durch den Namen des gelieferten Pakets. Für ein ARM64-System verwenden Sie entsprechend das <code>arm64</code>-Paket.

Das Paket:
* installiert das Programm nach <code>/opt/IBHLinkUA</code>,
* legt die Konfiguration unter <code>/etc/ibhlinkua</code> ab,
* installiert die Wt-Konfiguration unter <code>/etc/wt</code>,
* richtet <code>ibhlinkua.service</code> ein,
* aktiviert den automatischen Start und
* startet den Dienst nach der Installation.

== Dienst prüfen und steuern ==
Status anzeigen:

<pre>
sudo systemctl status ibhlinkua.service --no-pager
</pre>

Dienst starten, stoppen oder neu starten:

<pre>
sudo systemctl start ibhlinkua.service
sudo systemctl stop ibhlinkua.service
sudo systemctl restart ibhlinkua.service
</pre>

Automatischen Start prüfen:

<pre>
sudo systemctl is-enabled ibhlinkua.service
</pre>

Aktuelle Meldungen des Dienstes anzeigen:

<pre>
sudo journalctl -u ibhlinkua.service -n 100 --no-pager
</pre>

== Web-Konfigurator öffnen ==
Ermitteln Sie bei Bedarf die IP-Adresse des Linux-Rechners:

<pre>
hostname -I
</pre>

Öffnen Sie anschließend auf einem Rechner im selben Netzwerk:

<pre>
http://IP-ADRESSE-ODER-HOSTNAME/
</pre>

Bei einer Standardinstallation verwendet der Web-Konfigurator HTTP-Port 80. Ist HTTPS eingerichtet, wird üblicherweise Port 443 verwendet.

Die Erstanmeldung erfolgt bei einer unveränderten Installation mit:

{| class="wikitable"
! Benutzername
! Kennwort
|-
| <code>admin</code>
| <code>admin</code>
|}

'''Ändern Sie das Standardkennwort unmittelbar nach der ersten Anmeldung.''' Prüfen Sie anschließend Datum, Uhrzeit, Zeitzone und Hostname des Linux-Systems, da diese Angaben für Zertifikate und sichere OPC-UA-Verbindungen wichtig sind.

== Netzwerk und Firewall ==
Standardmäßig werden insbesondere folgende eingehende Verbindungen benötigt:

{| class="wikitable"
! Funktion
! Protokoll
! Standardport
|-
| Web-Konfigurator
| TCP
| 80
|-
| Web-Konfigurator über HTTPS, wenn aktiviert
| TCP
| 443
|-
| OPC-UA-Server
| TCP
| 48010
|}

Öffnen Sie nur die tatsächlich benötigten Ports und beschränken Sie den Zugriff nach Möglichkeit auf das Anlagen- oder Administrationsnetz. Beispiel für <code>ufw</code>:

<pre>
sudo ufw allow from NETZADRESSE/PRÄFIX to any port 80 proto tcp
sudo ufw allow from NETZADRESSE/PRÄFIX to any port 48010 proto tcp
</pre>

Wenn MQTT, der integrierte OPC-UA-Client, eine Online-Lizenzierung oder andere ausgehende Verbindungen verwendet werden, müssen zusätzlich die jeweiligen Zieladressen und Ports erreichbar sein.

== Lizenz aktivieren ==
Die Lizenz ist an das Linux-Zielsystem gebunden. Eine vorhandene Lizenzdatei darf deshalb nicht einfach auf einen anderen Rechner oder eine andere virtuelle Maschine kopiert werden.

=== Online-Aktivierung ===
# Web-Konfigurator öffnen.
# Zum Bereich '''System / Lizenzierung''' wechseln.
# Lizenzseriennummer eingeben.
# Zugehörige achtstellige Geheimzahl eingeben.
# Online-Aktivierung starten.
# Prüfen, ob der Lizenzstatus anschließend als gültig angezeigt wird.

=== Offline-Aktivierung ===
# Im Web-Konfigurator die systemgebundene Anforderungsdatei <code>ibhlinkua-license-request.json</code> erzeugen und herunterladen.
# Datei auf einem Rechner mit Internetzugang über den vorgesehenen Lizenzprozess bearbeiten lassen.
# Die erhaltene signierte JSON-Lizenzdatei im Web-Konfigurator des Zielsystems hochladen.
# Lizenzstatus kontrollieren.

Die installierte Lizenz liegt standardmäßig unter <code>/etc/ibhlinkua/license.json</code>. Sie darf nicht manuell verändert werden. Weitere Einzelheiten stehen unter [[IBH OPC UA:Lizensierung|Lizenzierung]].

== OPC-UA-Verbindung testen ==
Der Standard-Endpoint lautet:

<pre>
opc.tcp://IP-ADRESSE-ODER-HOSTNAME:48010
</pre>

# Endpoint in einem OPC-UA-Client eintragen.
# Serverzertifikat anhand von Fingerabdruck und Aussteller prüfen.
# Zertifikat vertrauen, wenn es eindeutig dem installierten Server zugeordnet wurde.
# Sicherheitsrichtlinie, Nachrichtenmodus und Benutzeranmeldung passend zur Serverkonfiguration wählen.
# Adressraum durchsuchen und eine Testvariable lesen.
# Schreibzugriffe nur an ausdrücklich dafür vorgesehenen Variablen testen.

== Konfiguration und wichtige Pfade ==
{| class="wikitable"
! Zweck
! Pfad
|-
| Programm und Web-Ressourcen
| <code>/opt/IBHLinkUA</code>
|-
| Hauptkonfiguration
| <code>/etc/ibhlinkua</code>
|-
| OPC-UA-Serverkonfiguration
| <code>/etc/ibhlinkua/ServerConfig.xml</code>
|-
| Lizenz
| <code>/etc/ibhlinkua/license.json</code>
|-
| Wt-Webserverkonfiguration
| <code>/etc/wt/wt_config.xml</code>
|-
| Systemdienst
| <code>ibhlinkua.service</code>
|}

Ändern Sie Konfigurationsdateien nur, wenn dies ausdrücklich erforderlich ist. Für die normale Einrichtung wird der Web-Konfigurator beziehungsweise der [[IBH OPC UA Editor]] verwendet.

== Aktualisierung ==
Erstellen Sie vor einer Aktualisierung eine Sicherung der Konfiguration. Installieren Sie das neue Paket anschließend mit <code>apt</code> über die vorhandene Installation:

<pre>
sudo apt install ./ibhlinkua_NEUE_VERSION_ARCHITEKTUR.deb
sudo systemctl status ibhlinkua.service --no-pager
</pre>

Prüfen Sie danach:
* Lizenzstatus,
* OPC-UA-Endpoint und Zertifikate,
* Steuerungsverbindungen,
* geladene Projekte,
* Historie, MQTT und weitere verwendete Funktionen.

Ein Downgrade sollte nur nach Rücksprache mit dem IBHsoftec-Support erfolgen.

== Deinstallation ==
Paket entfernen:

<pre>
sudo apt remove ibhlinkua
</pre>

Vor einer vollständigen Bereinigung müssen Konfiguration, Zertifikate und Lizenzinformationen gesichert werden, sofern sie noch benötigt werden. Löschen Sie Verzeichnisse unter <code>/etc/ibhlinkua</code> nicht unkontrolliert.

== Fehlerbehebung ==
; Dienst startet nicht
: Mit <code>systemctl status</code> und <code>journalctl</code> die Ursache prüfen. Außerdem Architektur, Paketabhängigkeiten und Rechte kontrollieren.

; Web-Konfigurator ist nicht erreichbar
: Dienststatus, IP-Adresse, Web-Port und Firewall prüfen. Außerdem kontrollieren, ob ein anderer Dienst Port 80 oder 443 verwendet.

; OPC-UA-Client kann nicht verbinden
: Port 48010, Endpoint, Sicherheitsrichtlinie, Systemzeit, Zertifikate und Benutzeranmeldung prüfen.

; Online-Aktivierung schlägt fehl
: Internetzugang, DNS, Proxy, Firewall, Systemzeit, Seriennummer und achtstellige Geheimzahl kontrollieren.

; Lizenz ist nach einem Systemwechsel ungültig
: Eine neue systemgebundene Lizenzanforderung erzeugen. Dies gilt insbesondere nach dem Klonen einer VM oder dem Austausch wesentlicher Systemmerkmale.

== Siehe auch ==
* [[IBH OPC UA:Inbetriebnahme|Inbetriebnahme]]
* [[IBH OPC UA:Lizensierung|Lizenzierung]]
* [[IBH OPC UA Editor]]
* [[IBH OPC UA:Handbuch|Handbuchübersicht]]

IBH OPC UA:Installation unter Linux - Versionsgeschichte

Axel: Installationsanleitung für die Linux-PC-Version erstellt