Control Center Runner einrichten (Mac)

In diesem Artikel wird erklärt, wie Sie einen Mac als GoodSync Control Center Runner installieren und registrieren.

Wichtig: Für die Registrierung eines neuen Runners ist eine Company PIN erforderlich. Alle folgenden Installationsbeispiele enthalten den erforderlichen Parameter /cc-copin.

Bereits registrierte Runner müssen weder neu installiert noch erneut registriert werden.

Schritt 1: Den Mac-Runner herunterladen

Laden Sie das Installationsprogramm des GoodSync Control Center Runners für Mac herunter: GoodSync CC Runner für Mac

Schritt 2: Company ID und Company PIN ermitteln

Öffnen Sie https://jobs.goodsync.com/ und melden Sie sich bei Ihrem Unternehmenskonto an.

Ihre Company ID finden Sie im GoodSync Control Center im Tab Settings.

Die Company ID kennzeichnet das Unternehmen im Control Center, bei dem sich der Runner registriert.

Seite „Settings“ im GoodSync Control Center

Company PIN: Wenn für Ihr Unternehmen bereits eine PIN eingerichtet ist, verwenden Sie diese PIN bei der Installation neuer Runner.

Ist noch keine Company PIN eingerichtet, muss ein Control-Center-Administrator eine anlegen:

  1. Öffnen Sie Settings.
  2. Wählen Sie Company Settings.
  3. Klicken Sie auf Edit Company Settings.
  4. Geben Sie eine Company PIN ein und speichern Sie die Änderungen.

Neue Company PINs müssen aus 8–20 Buchstaben oder Ziffern bestehen.

Hinweis: Die Company PIN ist nicht identisch mit dem Passwort Ihres GoodSync-Kontos. Bei Installationen mit Kontosynchronisation werden beide benötigt.

Schritt 3: Terminal öffnen

Öffnen Sie auf Ihrem Mac das Terminal und wechseln Sie in den Ordner, in den das Installationsprogramm heruntergeladen wurde.

Standardmäßig ist das in der Regel der Ordner Downloads.

Mit dem Befehl cd wechseln Sie zwischen Verzeichnissen, mit dem Befehl ls zeigen Sie die Dateien am aktuellen Ort an.

Mac-Terminal mit dem Verzeichnis des Installationsprogramms

Schritt 4: Dem Installationsprogramm Ausführungsrechte erteilen

Sobald Sie sich im Ordner mit dem Installationsprogramm befinden, erteilen Sie ihm mit folgendem Befehl Ausführungsrechte:

chmod +x ./goodsync-vsub-cc-runner-mac.sh

Wenn der Befehl erfolgreich ausgeführt wird, erscheint normalerweise keine Bestätigungsmeldung.

Sie können das Installationsprogramm nun mit einer der folgenden Einrichtungsmethoden ausführen.

Schritt 5: Den Mac-Runner installieren

Der GoodSync Control Center Runner lässt sich unter macOS auf zwei Arten installieren:

1) User: Der Runner startet, nachdem sich der Mac-Benutzer angemeldet hat.

2) Service: Der Runner startet nach dem Systemstart und läuft unter dem angegebenen Mac-Benutzerkonto.

Wichtig: Ersetzen Sie YOUR_COMPANY_ID, YOUR_COMPANY_PIN und die Angaben zum GoodSync-Konto durch Ihre tatsächlichen Werte, bevor Sie das Installationsprogramm ausführen.

Installation im User-Modus

Mit folgendem Befehl installieren Sie den Runner im User-Modus:

./goodsync-vsub-cc-runner-mac.sh /cc-runner=user /cc-coid=YOUR_COMPANY_ID /cc-copin=YOUR_COMPANY_PIN /gs-userid=YOUR_GOODSYNC_USER_ID /gs-pwd=YOUR_GOODSYNC_PASSWORD

Beispiel:

./goodsync-vsub-cc-runner-mac.sh /cc-runner=user /cc-coid=12345 /cc-copin=12345678 /gs-userid=yourcompany-companydomain-com /gs-pwd=YOUR_GOODSYNC_PASSWORD

Die GoodSync-Benutzer-ID finden Sie im Control Center im Tab Administrators oder in Ihrem GoodSync-Konto.

Ein GoodSync-Konto mit der Adresse yourcompany@companydomain.com hat beispielsweise eine Benutzer-ID ähnlich wie yourcompany-companydomain-com.

Hinweis: Das Wort user in /cc-runner=user darf nicht durch einen tatsächlichen Mac-Benutzernamen ersetzt werden.

So ist zum Beispiel /cc-runner=john falsch.

Kombinierter Installationsbefehl

Sie können die Ausführungsrechte auch mit einem einzigen Befehl erteilen und das Installationsprogramm direkt ausführen:

chmod +x ./goodsync-vsub-cc-runner-mac.sh && ./goodsync-vsub-cc-runner-mac.sh /cc-runner=user /cc-coid=YOUR_COMPANY_ID /cc-copin=YOUR_COMPANY_PIN /gs-userid=YOUR_GOODSYNC_USER_ID /gs-pwd=YOUR_GOODSYNC_PASSWORD

Dieser Befehl erteilt zuerst die Ausführungsrechte und startet anschließend die Installation des Runners.

Installation als Dienst (Service)

Mit folgendem Befehl installieren Sie den Runner als Dienst, der nach dem Start des Macs ausgeführt wird:

sudo ./goodsync-vsub-cc-runner-mac.sh /cc-runner=service /cc-coid=YOUR_COMPANY_ID /cc-copin=YOUR_COMPANY_PIN /sys-userid=YOUR_MAC_USER /gs-userid=YOUR_GOODSYNC_USER_ID /gs-pwd=YOUR_GOODSYNC_PASSWORD

Beispiel:

sudo ./goodsync-vsub-cc-runner-mac.sh /cc-runner=service /cc-coid=12345 /cc-copin=12345678 /sys-userid=macuser /gs-userid=yourcompany-companydomain-com /gs-pwd=YOUR_GOODSYNC_PASSWORD

Wenn Sie /cc-runner=service verwenden, geben Sie /sys-userid an, damit der Runner unter dem gewünschten Mac-Benutzerkonto läuft.

Der Befehl sudo fragt unter Umständen nach Ihrem Mac-Administratorpasswort.

Installationsbefehl für den Mac-Runner

Wichtig: Die Company PIN ist sowohl für die Installation im User-Modus als auch für die Installation als Dienst erforderlich.

Selbst gehostetes Control Center

Wenn Sie ein bestehendes selbst gehostetes Control Center verwenden, geben Sie mit dem Parameter /cc-url die Adresse Ihres Control-Center-Servers an.

./goodsync-vsub-cc-runner-mac.sh /cc-runner=user /cc-coid=YOUR_COMPANY_ID /cc-copin=YOUR_COMPANY_PIN /gs-userid=YOUR_GOODSYNC_USER_ID /gs-pwd=YOUR_GOODSYNC_PASSWORD /cc-url=http://YOUR_SERVER_IP

Ersetzen Sie die Beispieladresse durch die Adresse Ihres selbst gehosteten Control Centers.

Hinweis: Das selbst gehostete Control Center wird für Neukäufe nicht mehr angeboten.

Parameter und Optionen

Bei der Installation des GoodSync Control Center Runners auf dem Mac stehen die folgenden Parameter zur Verfügung.

Erforderliche Parameter

  • /cc-coid=CompanyID – Gibt die Company ID an, mit der der Runner beim Control Center registriert wird.
  • /cc-copin=YourCompanyPIN – Gibt die Company PIN an, die für die Registrierung eines neuen Runners erforderlich ist.
  • /cc-runner=user|service – Legt fest, wie der Runner gestartet wird.
    • user – Startet den Runner, nachdem sich der Mac-Benutzer angemeldet hat.
    • service – Startet den Runner nach dem Systemstart unter dem angegebenen Mac-Benutzerkonto.
  • /gs-userid=GoodSyncUserID – Gibt die GoodSync-Benutzer-ID für die Kontosynchronisation an.
  • /gs-pwd=GoodSyncPassword – Gibt das Passwort des GoodSync-Kontos für die Kontosynchronisation an.

Hinweis: Ab Control Center 3.2 sind für neue Installationen mit Kontosynchronisation sowohl /gs-userid als auch /gs-pwd erforderlich.

Verwenden Sie die GoodSync-Benutzer-ID, die mit Ihrem Unternehmen im Control Center verknüpft ist.

Weitere Parameter

  • /sys-userid=MacUser – Gibt das Mac-Benutzerkonto an, unter dem der Runner im Service-Modus läuft.
  • /cc-url=ServerURL – Gibt eine benutzerdefinierte Control-Center-Server-URL an.
    Standard: https://jobs.goodsync.com/
  • /cc-allow-bad-certs – Erlaubt Verbindungen mit SSL-Zertifikaten, die die Validierung sonst nicht bestehen würden. Nur bei Bedarf und nur in einer vertrauenswürdigen Umgebung verwenden.
  • /cc-proxy=Host – Gibt einen Proxyserver an. Unterstützt host oder host:port.
  • /cc-proxy-auth=Login:Password – Gibt die Anmeldedaten für den konfigurierten Proxy an.
  • /cc-server-license – Zwingt den Runner, eine Server-Lizenz zu verwenden.
  • /? – Zeigt die Hilfe des Installationsprogramms und die verfügbaren Parameter an.

Sicherheitshinweis: Installationsbefehle, die Company PINs oder Kontopasswörter enthalten, sollten nur autorisierten Administratoren zugänglich sein.

Schritt 6: Die Installation des Runners überprüfen

Öffnen Sie nach Abschluss der Installation das GoodSync Control Center.

Wechseln Sie zum Tab Runners. Ihr Mac sollte in der Liste der registrierten Runner erscheinen.

Mac-Runner in der Liste des GoodSync Control Center

Schritt 7: Den neuen Runner autorisieren

Bevor der Runner zugewiesene Aufträge empfangen und ausführen kann, muss er im GoodSync Control Center autorisiert werden.

  1. Öffnen Sie den Tab Runners.
  2. Suchen Sie den neu registrierten Mac-Runner.
  3. Aktivieren Sie das Kontrollkästchen neben dem Runner.
  4. Klicken Sie auf Actions > Authorize.
  5. Speichern Sie die Änderungen.

Nach der Autorisierung sollte beim Runner Authorized: True angezeigt werden.

Sobald der Runner erfolgreich verbunden ist, sollte sein Status Online lauten.

Ihr Mac ist jetzt mit dem GoodSync Control Center verbunden und bereit, zugewiesene Aufträge zu empfangen.

Fehlerbehebung

Der Runner wird im Control Center nicht angezeigt

Wenn die Installation erfolgreich abgeschlossen wurde, der Runner aber nicht im Control Center erscheint, prüfen Sie Folgendes:

  • Vergewissern Sie sich, dass bei der Installation die richtige Company ID verwendet wurde.
  • Vergewissern Sie sich, dass die richtige Company PIN angegeben wurde.
  • Prüfen Sie, ob die GoodSync-Benutzer-ID mit dem richtigen Unternehmen im Control Center verknüpft ist.
  • Vergewissern Sie sich, dass der Mac eine Verbindung zum Control-Center-Server herstellen kann.
  • Prüfen Sie, ob der Runner bereits im Control Center registriert ist.

Wenn der Runner bereits früher registriert war und seine lokale Konfiguration fehlt oder beschädigt ist, muss ein Administrator unter Umständen die alte Runner-Registrierung aus dem Control Center entfernen, bevor der Runner erneut registriert werden kann.

Zur lokalen Runner-Konfiguration gehört die Datei enterprise-runner.tix im versteckten Ordner /Users/YourUserAccount/.goodsync.

Wichtig: Löschen Sie die Konfigurationsdatei eines bereits registrierten Runners nicht, ohne vorher seinen Registrierungsstatus im Control Center zu prüfen.

Der Punkt am Anfang von .goodsync zeigt an, dass es sich um einen versteckten Ordner handelt.

Wie erkenne ich, ob der Runner aktiv ist?

Die Runner-Protokolle werden in folgenden Ordner geschrieben:

/Users/useraccount/.goodsync

Ersetzen Sie useraccount durch Ihren Mac-Benutzernamen.

Ist der Runner aktiv, sollte sich in diesem Ordner ein aktuelles Runner-Protokoll befinden. Prüfen Sie das Protokoll, um die Aktivität zu bestätigen und nach Fehlern zu suchen.

Screenshot: Ordner .goodsync im Finder mit aktuellen Runner-Protokolldateien

Ob der Runner-Prozess läuft, können Sie auch im Terminal prüfen:

ps aux | grep gsync

Ist der Runner aktiv, zeigt der Befehl den laufenden GoodSync-Prozess an.

Screenshot: Terminal mit der Ausgabe von ps aux | grep gsync und dem laufenden gsync-Prozess

Wie kann ich den Runner manuell neu starten?

Wenn der Runner bereits installiert, aber nicht aktiv ist, können Sie ihn mit folgendem Befehl manuell starten:

"/Users/useraccount/Library/Application Support/GoodSync/gsync" /runner-service=main-runner &

Ersetzen Sie useraccount durch das Mac-Benutzerkonto, unter dem GoodSync installiert wurde.

Screenshot: Terminal mit dem manuellen Start des Runners und der Meldung „Runner for Enterprise Started“

Kehren Sie nach dem Start des Runners zum GoodSync Control Center zurück und prüfen Sie, ob das Gerät als Online angezeigt wird.

Nach oben ↑

Nach oben