2. Installation#

Sie installieren den Apple School Manager Connector wie jede andere App aus dem App Center. Dieses Kapitel beschreibt, wo Sie ihn installieren können, wie Sie ihn installieren und wie Sie die Zugangsdaten erhalten, die der Connector benötigt.

2.1. Unterstützte Systemrollen#

Sie können den Connector auf den folgenden Systemrollen installieren:

  • Primary Directory Node

  • Backup Directory Node

  • Replica Directory Node

Vorsicht

Installieren Sie den Connector auf genau einem System in der Domäne.

Jede Installation lädt einen vollständigen Datensatz hoch und überschreibt, was der vorherige Upload übertragen hat. Zwei Installationen überschreiben daher gegenseitig ihre Daten. Wenn Sie weitere Schulen synchronisieren möchten, fügen Sie diese der bestehenden Installation hinzu, wie in Schulen beschrieben, oder fügen Sie ein weiteres Konto in Apple School Manager hinzu, wie in Konten in Apple School Manager beschrieben.

Auf dem Replica Directory Node einer Schule sieht der Connector nur die Schule dieses Nodes. Auf einem zentralen Replica Directory Node, einem Primary Directory Node oder einem Backup Directory Node sieht er alle Schulen der Domäne.

2.2. App installieren#

  1. Öffnen Sie das App Center in UMC.

  2. Wählen Sie Apple School Manager Connector.

  3. Klicken Sie auf Installieren.

Beschaffen Sie nach der Installation die Zugangsdaten, wie im nächsten Abschnitt beschrieben, und tragen Sie sie ein, wie in Zugangsdaten eingeben beschrieben.

Bemerkung

Der Connector erfordert UCS@school in Version 5.2v5 oder höher. Auf einem System mit einer älteren Version verweigert die App das Update.

2.3. SFTP-Zugangsdaten ermitteln#

Apple School Manager erzeugt den SFTP-Benutzernamen und das Passwort für Sie. Um diese zu finden, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Apple School Manager an.

  2. Klicken Sie unten links auf Ihren Namen und wählen Sie Preferences.

  3. Wählen Sie Managed Apple Accounts.

  4. Öffnen Sie das Menü für Apple formatted CSV.

  5. Klicken Sie auf Upload CSV.

Ein neuer Bereich öffnet sich und zeigt die Daten des SFTP-Kontos. Hintergrundinformationen finden Sie in Apple Inc. [3].

2.4. Zugangsdaten eingeben#

  1. Speichern Sie das Passwort in /etc/asm.secret, mit Leserechten nur für den Benutzer root.

    Quellcode 2.1 Passwort speichern#
    $ install -m 600 /dev/null /etc/asm.secret
    $ editor /etc/asm.secret
    
  2. Tragen Sie den Benutzernamen, den Pfad der Passwortdatei und die Schulen in die Einstellungsdatei /etc/asm-connections.json ein, die die Installation ohne Konto anlegt.

    Quellcode 2.2 Ein Konto in Apple School Manager in /etc/asm-connections.json#
    {
        "accounts": {
            "main": {
                "username": "sftp-user",
                "password_file": "/etc/asm.secret"
            }
        },
        "schools": {
            "*": {"account": "main"}
        }
    }
    

    Der Eintrag * in schools synchronisiert jede Schule in das Konto.

Einstellungsdatei beschreibt die Datei im Detail, einschließlich der Beschränkung des Kontos auf einzelne Schulen, des Hinzufügens weiterer Konten und aller Einstellungen für Benutzer und Klassen. Fahren Sie danach mit Konfiguration fort.