Installation

Diese Seite beschreibt die Installation von Pulse auf einer frischen Maschine — entweder als Appliance oder als Collector, der sich bei einer Appliance meldet. Der Ablauf ist derselbe, ob das Ziel ein kleiner Industrie-PC, ein Rackserver oder eine virtuelle Maschine ist — booten Sie das ISO-Abbild, wählen Sie eine Rolle, beantworten Sie einige Fragen in der Installer-TUI und warten Sie, bis die Maschine in die Bedienoberfläche neu startet.

Die Schritte unten entsprechen der Reihenfolge des Installations-Assistenten, den Sie auf der Konsole sehen, exakt.

Hardware-Anforderungen

Die Appliance ist bewusst genügsam:

• CPU: 2 Kerne (x86_64). Jede moderne Intel- oder AMD-CPU ist geeignet.
• Arbeitsspeicher: mindestens 4 GB, empfohlen 8 GB für Standorte mit mehr als wenigen hundert Monitoren.
• Festplatte: mindestens 32 GB. SSD wird ausdrücklich empfohlen — die Datenbank erzeugt genug zufällige I/O-Last, dass eine konventionelle Festplatte die Weboberfläche spürbar verlangsamt.
• Firmware: UEFI oder Legacy-BIOS — beides wird unterstützt. Das ISO-Abbild ist ein Hybrid-Image und startet in beiden Modi.
• Netzwerk: mindestens ein Ethernet-Anschluss. Ein zweiter Anschluss wird unterstützt und lohnt sich, wenn die Maschinen in einem eigenen Netz stehen. WLAN wird nicht unterstützt.

Die Zielfestplatte wird während der Installation vollständig gelöscht. Wenn die Maschine mehrere Festplatten besitzt, können Sie im Installer auswählen, welche verwendet wird — alle Daten auf der ausgewählten Festplatte gehen jedoch verloren, sobald Sie die Installation bestätigen.

ISO-Abbild auf einen USB-Stick schreiben

Sie benötigen einen USB-Stick mit mindestens 4 GB. Jedes Werkzeug, das eine rohe Blockkopie des ISO auf den Stick anlegt, ist geeignet — das Abbild ist direkt bootfähig, ein Partitionieren oder Formatieren entfällt.

• Linux / macOS: sudo dd if=pulse.iso of=/dev/sdX bs=4M status=progress conv=fsync (ersetzen Sie /dev/sdX durch das tatsächliche Gerät — lsblk bzw. diskutil list zeigen es an). Wenn Sie das falsche Gerät angeben, löschen Sie die falsche Festplatte; prüfen Sie sorgfältig, bevor Sie bestätigen.
• Windows: nutzen Sie Rufus im Modus DD-Image (nicht ISO-Modus). Wählen Sie das ISO, wählen Sie den USB-Stick, klicken Sie auf Start.
• Plattformübergreifende GUI: Balena Etcher läuft auf allen drei Betriebssystemen und versteckt die manuelle Geräteauswahl.

Der erstellte USB-Stick bootet sowohl auf UEFI- als auch auf Legacy-BIOS-Systemen, sodass Sie denselben Stick für jedes Ziel verwenden können.

Erster Start

Stecken Sie den USB-Stick in die Zielmaschine und schalten Sie sie ein. Möglicherweise müssen Sie während der Firmware-Startanzeige eine Taste drücken, um das Bootmenü zu öffnen — übliche Tasten sind F12, F11, F10, F2, Esc oder Entf, je nach Hersteller.

Wählen Sie im Bootmenü den USB-Stick aus. Das Appliance-ISO lädt und führt Sie nach wenigen Sekunden in die Installer-TUI auf tty1. Es gibt keinen grafischen Installer — die gesamte Einrichtung erfolgt tastaturgesteuert über die Konsole.

Wenn die Maschine stattdessen in das vorhandene Betriebssystem bootet, ist die Bootreihenfolge in der Firmware falsch konfiguriert. Starten Sie neu, öffnen Sie das Firmware-Setup und ändern Sie entweder die Bootpriorität oder verwenden Sie erneut das Einmal-Bootmenü.

Installations-Assistent

Der Assistent führt Sie in einer festen Abfolge von Bildschirmen durch die Einrichtung. Der erste Bildschirm legt die Rolle fest, und diese Wahl entscheidet, welche der folgenden Bildschirme Sie sehen — Festplatte, Netzwerk und NTP sind bei beiden Rollen gleich, was danach kommt nicht. Navigieren Sie mit den Pfeiltasten (oder j / k), bestätigen Sie mit Enter und gehen Sie mit Esc einen Schritt zurück. Strg+C bricht die Installation vollständig ab.

Role

Als Erstes fragt der Installer, welche Rolle Sie installieren: Appliance oder Collector. Wählen Sie mit den Pfeiltasten und bestätigen Sie mit Enter.

• Appliance ist ein eigenständiger Pulse-Server. Diese Rolle beschreibt der Rest dieser Seite, sofern ein Schritt nichts anderes sagt.
• Collector meldet sich bei einer Appliance, statt selbst die Weboberfläche zu betreiben. Er überspringt den Basis-URL-Schritt und fragt stattdessen nach der Appliance, bei der er sich meldet, und einem Pairing-Code — wie diese Kopplung funktioniert, beschreibt Collector-Kopplung.

Welcome

Der Startbildschirm benennt den Assistenten und fasst kurz zusammen, was für die gewählte Rolle folgt: Festplattenauswahl, Netzwerkkonfiguration, optionaler NTP-Server und danach entweder eine Basis-URL (Appliance) oder eine Appliance-Adresse und ein Pairing-Code (Collector). Er weist Sie zudem darauf hin, dass die Zielfestplatte gelöscht wird. Drücken Sie Enter, um zu beginnen, oder Strg+C, um abzubrechen.

Disk

Der Installer ermittelt alle Festplatten, auf die installiert werden kann, und listet sie auf. Jede Zeile zeigt den Gerätenamen (zum Beispiel /dev/sda), die Größe und die Modellbezeichnung, die die Firmware meldet. Markieren Sie das Ziel mit den Pfeiltasten und bestätigen Sie mit Enter.

Warnung. Die hier ausgewählte Festplatte wird vollständig gelöscht. Sobald die Installation beginnt, gibt es kein Zurück mehr. Wenn die Maschine sowohl eine Betriebssystem-Festplatte als auch eine separate leere Festplatte besitzt, vergewissern Sie sich kurz, welche welche ist — Modellbezeichnung und Größe reichen normalerweise zur Unterscheidung.

Network

Hat die Maschine mehr als einen Ethernet-Anschluss, beginnt der Bildschirm mit einer Liste dieser Anschlüsse. Wählen Sie den Anschluss, über den die Appliance erreicht werden soll — den, der im Netz der Personen steckt, die Pulse nutzen. Jeder Eintrag zeigt die Hardware-Adresse, ob ein Kabel eingesteckt ist, und eine eventuell schon bezogene Adresse. Genügt das nicht, um zwei baugleiche Anschlüsse zu unterscheiden, drücken Sie d und ziehen das Kabel des gewünschten Anschlusses ab und wieder ein — der Installer erkennt ihn und wählt ihn aus. Bei einer Maschine mit nur einem Anschluss entfällt dieser Schritt.

Während der Installation wird ausschließlich dieser eine Anschluss konfiguriert. Braucht die Appliance zusätzlich einen Anschluss in einem zweiten Netz, richten Sie diesen nach dem ersten Start über den Bildschirm Network Configuration ein — siehe Netzwerk.

Wählen Sie anschließend, wie die Appliance ihre IP-Adresse bezieht:

• DHCP — das Netz vergibt Adressen automatisch. Die meisten internen LANs und viele Anlagennetze funktionieren so. Wählen Sie diese Option, wenn Sie unsicher sind.
• Statische IP — das LAN-Team hat eine feste IP-Adresse für die Appliance reserviert. Diese Wahl blendet drei zusätzliche Felder ein: die IP-Adresse (in CIDR-Notation, z. B. 192.168.1.100/24), das Gateway und einen DNS-Server.

Die Eingaben werden vor dem nächsten Schritt validiert — Tippfehler oder unmögliche Werte erzeugen eine Fehlermeldung, und Sie bleiben auf der Seite, bis sie korrigiert sind. Siehe Netzwerk für Hinweise zur Wahl der statischen IP und zum späteren Wechsel des Modus.

NTP

Optional. Lassen Sie das Feld leer, um die standardmäßigen öffentlichen NTP-Server zu verwenden — das genügt, wenn die Appliance Internetzugang hat. Wenn der Standort einen internen Zeitserver nutzt, tragen Sie hier seinen Hostnamen oder seine IP ein, dann synchronisiert sich die Appliance gegen diesen Server. Drücken Sie Enter, um fortzufahren.

BaseURL

Dieser Schritt erscheint nur für die Rolle Appliance. Ein Collector hat keine eigene Basis-URL — siehe Appliance-Adresse weiter unten.

Die URL, unter der die Weboberfläche und die Kopplung der Mobile-App die Appliance erreichen. Das ist die Adresse, die Bediener im Browser eingeben und die die Mobile-App beim Koppeln eines Telefons speichert.

• Wenn die Appliance einen DNS-Namen im LAN hat, verwenden Sie diesen (https://pulse-system.example.local).
• Andernfalls verwenden Sie die im vorigen Schritt vergebene IP-Adresse (https://192.168.1.100).
• Geben Sie immer das Schema mit an (https://). Reine Hostnamen werden abgelehnt.

Eine fehlerhafte Basis-URL können Sie später in der TUI ändern; vorher gekoppelte Mobile-Geräte müssen jedoch neu gekoppelt werden — eine korrekte Eingabe spart also Aufwand.

Appliance-Adresse

Dieser Schritt und der Pairing-Code-Schritt danach ersetzen bei der Rolle Collector den Basis-URL-Schritt.

Geben Sie die IP-Adresse oder den Hostnamen der Appliance ein, optional gefolgt von einem Port nach einem Doppelpunkt — lassen Sie den Port weg, nimmt der Installer 443 an. Meist ist das eine IP-Adresse; alles Weitere, um die Appliance zu erreichen, ermittelt der Collector selbst.

Verbindet sich der Collector nicht mit einer Appliance, sondern mit Pulse Cloud, geben Sie auf dieselbe Weise die Domain ein, die unter Organisation > Einstellungen > Collectors angezeigt wird — zum Beispiel app.pulsehq.de.

Pairing-Code

Geben Sie den auf der Appliance angezeigten Pairing-Code im Format XXXX-XXXX-XXXX ein. Groß- und Kleinschreibung spielen keine Rolle, und die Bindestriche sind optional — ab12cd34ef56 und AB12-CD34-EF56 werden beide akzeptiert. Den Code erhalten Sie über den Dialog Organisation > Einstellungen > Collectors > Collector hinzufügen der Appliance; siehe Collector-Kopplung dafür, woher der Code kommt und was zu tun ist, wenn er bis hierhin schon abgelaufen ist.

Ein falsch eingegebener Code wird sofort abgelehnt, mit einem Hinweis, ihn zu prüfen und es erneut zu versuchen — Sie müssen dafür nicht bis zum Confirm-Bildschirm warten.

Confirm

Der Assistent zeigt alle eingegebenen Werte auf einem Bildschirm zusammengefasst, damit Sie sie prüfen können, bevor irgendetwas auf die Festplatte geschrieben wird. Der Hinweis auf das Löschen der Festplatte wird wiederholt. Drücken Sie Enter, um die eigentliche Installation zu starten, oder Esc, um eine Antwort zu ändern.

• Appliance: Festplatte, Netzwerkmodus (und gegebenenfalls die Details der statischen IP), NTP-Server und Basis-URL.
• Collector: Rolle, Festplatte, Netzwerkmodus (und gegebenenfalls die Details der statischen IP), NTP-Server, Appliance-Adresse und Pairing-Code.

Progress

Nach der Bestätigung partitioniert der Installer die Festplatte, kopiert das Systemabbild für die gewählte Rolle und schreibt die Konfiguration. Fortschrittszeilen erscheinen laufend auf dem Bildschirm. Drücken Sie jederzeit l, um das vollständige Installer-Log einzublenden — hilfreich, wenn der Assistent bei einem langwierigen Schritt zu pausieren scheint und Sie wissen wollen, was tatsächlich passiert.

Die Installation dauert auf einer SSD typischerweise wenige Minuten; konventionelle Festplatten benötigen wegen Partitionierung und Kopiervorgang deutlich länger. Schalten Sie die Maschine in dieser Phase nicht aus.

Done

Wenn der Installer fertig ist, erscheint der Done-Bildschirm. Bei Erfolg bestätigt er die abgeschlossene Installation und bietet einen Neustart an — drücken Sie Enter, um neu zu starten, und ziehen Sie den USB-Stick während des BIOS-POST ab, damit die Maschine von der frisch installierten Festplatte startet.

Schlägt die Installation fehl, zeigt der Bildschirm stattdessen die Fehlermeldung; l öffnet das Log, damit Sie nachsehen können, was schiefgegangen ist, und Esc bringt Sie zurück zum Confirm-Schritt, um eine Antwort anzupassen und es erneut zu versuchen. Strg+C beendet, ohne neu zu starten.

Nach dem Neustart erscheint eine Appliance mit der TUI als Standardkonsole und ist betriebsbereit. Ein Collector erscheint stattdessen auf seinem Collector-Status-Bildschirm und koppelt sich im Hintergrund mit der eingegebenen Adresse und dem Code an die Appliance — siehe Collector-Kopplung dafür, was danach passiert, einschließlich eines inzwischen abgelaufenen Codes.