Clients hinzufügen (Linux)

Dieses Kapitel erklärt, wie Sie Linux-Clients in die opsi-Umgebung integrieren. Als Erstes geht es um die Aufnahme vorhandener Clients, danach zeigen wir, wie Sie neue Clients hinzufügen.

Mit opsi können Sie auch Windows- und macOS-Clients verwalten. Details dazu finden Sie in den beiden Kapiteln Windows-Clients und macOS-Clients.

Vorhandene Clients integrieren

Um vorhandene Clients mit bereits installiertem Betriebssystem in opsi aufzunehmen, installieren Sie auf dem jeweiligen Rechner den Client-Agent. Danach erscheint der Client auch in der Client-Liste der Management-Oberfläche, sofern Sie ihn dort noch nicht hinzugefügt hatten.

Grundsätzlich gibt es zwei verschiedene Möglichkeiten, den Client-Agent zu installieren:

  • Installer auf dem Client verwenden: Diese Methode installiert den Client-Agent auf dem Client und eignet sich vor allem für einzelne Computer.

  • opsi-deploy-client-agent verwenden: Diese Methode installiert den Client-Agent auf dem Server und eignet sich für den Massen-Rollout, wenn die dazu nötigen Freischaltungen auf den Linux-Clients vorhanden sind.

Nachdem der Client-Agent installiert ist, können Sie opsi-Produkte auf dem Client einspielen (siehe Kapitel Rollout existierender Produkte).

Installer auf dem Client verwenden

Diese Variante eignet sich besonders für einzelne Rechner, die Sie als Client in eine opsi-Umgebung integrieren möchten. So gehen Sie vor:

  1. Loggen Sie sich auf dem Client ein.

  2. Laden Sie den Installer von Ihrem opsi-Configserver herunter. Sie finden ihn unter https://<fqdn_oder_ip_des_configservers>:4447/public/opsi-client-agent/; das Linux-Programm heißt opsi-linux-client-agent-installer.run, das macOS-Programm opsi-mac-client-agent-installer.command.

Den Installer finden Sie auf dem opsi-Configserver unter `\https://<fqdn_oder_ip_des_configservers>:4447/public/opsi-client-agent/`.
  1. Machen Sie die Datei ausführbar:
    chmod +x opsi-linux-client-agent-installer.run (Linux)
    chmod +x opsi-mac-client-agent-installer.command (macOS)

  2. Führen Sie den Installer aus; unter Linux und macOS sind dazu Root-Rechte erforderlich:
    sudo ./opsi-linux-client-agent-installer.run (Linux)
    sudo ./opsi-mac-client-agent-installer.command (macOS)

  3. Der Installer entpackt sich dann in ein temporäres lokales Verzeichnis und startet den enthaltenen oca-installation-helper.

Der Installer startet den `oca-installation-helper`.
  1. Tragen Sie im Dialogfenster die Werte für die Client-ID, die opsi-Service-URL, den Benutzernamen und das Passwort ein. Soweit möglich, sind die Felder bereits ausgefüllt; passen Sie die Werte gegebenenfalls an Ihre Umgebung an:

    • Die Client-ID entspricht in der Regel dem FQDN des Clients.

    • Die opsi-Service-URL muss das Format https://<fqdn_oder_ip_des_configservers>:4447 haben.

    • Bei einer Erstinstallation des Clients gehören Benutzername und Passwort zu einem Account, der Mitglied der Gruppe opsiadmin (siehe Kapitel Berechtigungen); bei einer erneuten Installation können Sie auch die Client-ID und den Host-Key verwenden.

  2. Der Installer nimmt per opsi-Webservice Kontakt zum Server auf, um den Client beim Server zu registrieren. Anschließend ruft er das enthaltene opsi-script auf, um das setup.opsiscript des Client-Agent auszuführen.

Beim Aufruf des Installers können Sie Parameter angeben, die unter anderem Vorgänge automatisieren. Weitere Details dazu finden Sie in den jeweiligen Client-Agent-Kapiteln.

opsi-deploy-client-agent verwenden

Das Tool opsi-deploy-client-agent verteilt den opsi-Linux-Client-Agent direkt vom opsi-Server auf den Clients. Damit steht eine komfortable Möglichkeit bereit, eine große Anzahl von Clients direkt vom Server aus in die opsi-Umgebung zu integrieren.

Voraussetzungen für Linux-Clients:

  • ein aktivierter SSH-Zugang

  • ein administrativer Account

Sie finden den opsi-deploy-client-agent auf dem opsi-Server im Verzeichnis /var/lib/opsi/depot/opsi-linux-client-agent. Das Programm erfordert root-Rechte; alternativ reicht es aus, wenn der Benutzer Mitglied der Gruppe opsifileadmins ist. Falls das Skript nicht ausführbar ist, so können Sie dieses Problem mit dem folgenden Befehl beheben:

opsi-set-rights /var/lib/opsi/depot/opsi-linux-client-agent/opsi-deploy-client-agent

Das Werkzeug führt die folgenden Schritte aus:

  1. Clients auf dem Server erzeugen

  2. Installationsdateien und Konfiguration kopieren (z. B. den Host-Key)

  3. Installation über den oca-installation-helper starten (nicht-interaktiv)

Das Tool opsi-deploy-client-agent akzeptiert IP-Adressen, Hostnamen und FQDNs. Es versucht, automatisch zu erkennen, welche Art von Adresse der Benutzer übergeben hat.

Wechseln Sie ins Hauptverzeichnis des Programms:

cd /var/lib/opsi/depot/opsi-linux-client-agent

Rufen Sie das Programm mit dem Parameter --help auf, um die Hilfeseite einzublenden:

Die Onlinehilfe von *opsi-deploy-client-agent*
Abbildung 1. Die Onlinehilfe von opsi-deploy-client-agent

Typische Aufrufe sind:

  • Für einen einzelnen Client:

./opsi-deploy-client-agent -v --user=root linux-client
  • Für eine Liste von Clients:

./opsi-deploy-client-agent -v --user=root --hosts-from-file HOSTFILE.TXT  --skip-existing-clients

In der Datei HOSTFILE.TXT steht eine Liste von Clients, ein Name (FQDN) pro Zeile. Wenn die Clients dem opsi-Server noch nicht bekannt sind, versucht opsi-deploy-client-agent den opsi-linux-client-agent auf dieser Maschine zu installieren.

Neue Clients hinzufügen

Sie können opsi auch dazu verwenden, neue Clients mit einem Betriebssystem auszustatten und dann zu integrieren. Bei dieser Variante wird der benötigte Client-Agent automatisch installiert.

Die nächsten Abschnitte beschreiben unterschiedliche Möglichkeiten, einen Client in opsi anzulegen: über die grafische Management-Oberfläche opsi-configed, auf der Kommandozeile und mit unserer Boot-CD. Anschließend können Sie mit opsi ein neues Betriebssystem auf dem Client installieren.

Grafische Management-Oberfläche

Um einen Client zum opsi-Server über die grafische Management-Oberfläche opsi-configed hinzuzufügen, wählen Sie aus dem Menü Client / Neuen opsi-Client erstellen und geben dann die folgenden Werte ein:

  • Client-Name

  • DNS-Domäne (falls abweichend von der Vorgabe)

  • Beschreibung

  • IP-Adresse (wird benötigt, falls kein DNS zur Namensauflösung für diesen Client verwendet werden kann)

  • MAC-Adresse (wird benötigt, falls der opsi-Server DHCP-Server ist oder PXE-Boot mit dem Client durchgeführt werden soll)

Nachdem Sie alles bestätigt haben, wird der Client dem opsi-Server bekanntgemacht. Falls der opsi-Server gleichzeitig DHCP-Server ist, wird der Client ebenfalls als PXE-Client in der DHCP-Konfiguration angelegt.

Die Liste der eingerichteten opsi-Clients können Sie jederzeit im Modus Client-Konfiguration auf dem Reiter Clients einsehen.

Kommandozeile

Auf der Kommandozeile können Sie opsi-cli verwenden, um einen neuen Client zu erzeugen. Die grundlegende Syntax beim Aufruf sieht so aus:

opsi-cli jsonrpc execute host_createOpsiClient <client-id> [opsiHostKey] [description] [notes] [hardwareAddress] [ipAddress] [inventoryNumber] [oneTimePassword] [created] [lastSeen]

Wenn Sie einen der optionalen Werte im Aufruf weglassen, werden dafür Standardwerte eingesetzt; die meisten Felder sind dann leer.

Beispiel: Der folgende opsi-cli-Befehl legt den Client testclient.domain.local mit einem zufälligen Host-Key, der Beschreibung Testclient, ohne Notizen, mit der MAC-Addresse 00:0c:29:12:34:56 und der IP-Adresse 192.0.2.1 an:

opsi-cli jsonrpc execute host_createOpsiClient testclient.domain.local "null" "Testclient" "" 00:0c:29:12:34:56 192.0.2.1

Boot-CD

Auf der Website opsi-Tools finden Sie ein ISO-Abbild der Boot-CD. Laden Sie das Image herunter und brennen es auf eine CD. Danach starten Sie den Rechner von der CD. Der Installer begrüßt Sie mit dem folgenden Boot-Menü:

Die Boot-CD präsentiert nach dem Start das folgende Menü.
Abbildung 2. Die Boot-CD präsentiert nach dem Start das folgende Menü.

Wählen Sie opsi starten und betätigen Sie die Taste [Eingabe]. Nach einer Weile sehen Sie ein Dialogfenster, in dem Sie die IP-Adresse des Clients, die Netzwerkmaske, den Hostnamen, die Domain, das Gateway, den DNS-Server und die IP-Adresse des opsi-Config-Servers (optional) eintragen. Falls Ihr DHCP-Server IP-Adressen an unbekannte Rechner vergibt, sind einige Felder bereits ausgefüllt.

Die Netzwerkeinstellungen für den neuen Client.
Abbildung 3. Die Netzwerkeinstellungen für den neuen Client

Springen Sie mit der [Tab]-Taste zu OK und drücken dann [Eingabe].

Wie soll sich der Client beim opsi-Server anmelden?
Abbildung 4. Wie soll sich der Client beim opsi-Server anmelden?

Wählen Sie Admin account, damit sich der Client selbst beim opsi-Server anmelden und erstellen soll. Diesen Vorgang autorisieren Sie im nächsten Schritt.

Authentifizieren Sie sich am opsi-Server.
Abbildung 5. Authentifizieren Sie sich am opsi-Server.

Der Account, zu dem Sie hier den Benutzernamen und das Passwort eingeben, muss Mitglied der Gruppe opsiadmin sein (siehe Kapitel Berechtigungen). Nach erfolgreicher Anmeldung übermittelt der Client seine Daten an den Server, und er wird auf dem Server automatisch erstellt. Als Nächstes sehen Sie eine Liste der verfügbaren Netboot-Produkte, die Sie mit der Leertaste markieren und zur Installation auswählen.

Netboot-Produkte zur Installation auswählen
Abbildung 6. Netboot-Produkte zur Installation auswählen

Sie können jetzt direkt das zu installierende Betriebssystem oder die Hardware-Inventarisierung auswählen.