Prüfen Sie zuerst die passende Fehlerbehebung. Wenn wir Ihre Instanz, Abrechnung oder den Node prüfen sollen, melden Sie sich im Portal an und erstellen Sie ein Support-Ticket. Noch kein Kunde? Informieren Sie sich zunächst über unsere Angebote.
Support gibt es ausschließlich per Portal-Ticket oder E-Mail. Auch dringende Störungen melden Sie bitte per Ticket und markieren sie als dringend. Sie müssen keinen anderen Kontaktweg suchen.
Geeignet bei fehlender SSH-Verbindung, Instanzfehlern, Verlängerungen, Fragen zu Zahlungen oder wenn wir Protokolle auf Node-Ebene prüfen sollen. Bitte geben Sie die Instanz-ID, den Beginn, den Umfang der Auswirkungen und bereits durchgeführte Prüfungen an.
Angestrebte erste Antwort: innerhalb von 4 Stunden bei hoher Priorität, innerhalb eines Werktags bei allgemeinen Anfragen.
Sie haben noch keine Instanz oder möchten die Eignung eines Modells beziehungsweise den Einkaufsprozess für Ihr Team klären? Schreiben Sie an support@zshmac.com. Nennen Sie den Einsatzzweck, die voraussichtliche Anzahl, den gewünschten Node und die geplante Nutzungsdauer.
Angestrebte erste Antwort: an Werktagen. Bei Störungen einer bestehenden Instanz nutzen Sie bitte ein Support-Ticket und geben Sie die Instanz-ID an.
Wenn die Instanz vollständig nicht erreichbar ist, mehrere Verbindungswege gleichzeitig ausfallen oder ein Problem auf Node-Ebene vermutet wird, erstellen Sie im Portal ein Ticket mit dringender Priorität. Starten Sie keine wiederholte Neuinstallation, solange der Datenstatus unklar ist.
Angestrebte erste Antwort: innerhalb von 1 Stunde bei dringender Priorität. Geben Sie auch an, wann die Instanz zuletzt erreichbar war.
Die Antwortzeiten sind Zielwerte und bedeuten nicht, dass eine Störung innerhalb desselben Zeitraums behoben wird. Angaben zur Instanz im Ticket helfen bei der Fehlersuche mehr als mehrfach versandte E-Mails.
Alle angebotenen Nodes laufen an 365 Tagen im Jahr. Die Verfügbarkeit wird pro Kalendermonat berechnet. Dokumentieren Sie bei Verbindungsabbrüchen im Ticket den Zeitraum, die Instanz-ID und das Fehlerbild, damit wir die Protokolle auf Node-Ebene prüfen können.
Liegt die Verfügbarkeit eines Monats unter 99,9 %, wird die Ausfallzeit anteilig als Kontoguthaben gutgeschrieben. Beantragen Sie die Prüfung innerhalb von 7 Tagen nach Monatsende über ein Portal-Ticket. Höhere Gewalt und Auswirkungen durch eigene Aktionen sind von der anbieterbedingten Ausfallzeit ausgenommen.
Dies ist ein Zielwert, kein historischer Betriebsnachweis. Informationen zu tatsächlichen Ereignissen und Auswirkungen der letzten 90 Tage finden Sie in den Servicehinweisen und Support-Tickets im Portal.
Prüfen Sie die Punkte in der angegebenen Reihenfolge und notieren Sie Zeitpunkt und genaue Fehlermeldung. Wenn Sie Hilfe benötigen, fügen Sie die Ergebnisse demselben Ticket hinzu, damit die Prüfung nicht von vorn beginnen muss.
| Symptom | Empfohlene Prüfungen und Angaben für das Ticket |
|---|---|
| SSH-Verbindung läuft in einen Timeout | Prüfen Sie im Portal zunächst den Instanzstatus und die aktuelle Verbindungsadresse. Testen Sie dann von Ihrem lokalen Netzwerk aus, ob der Port erreichbar ist, und prüfen Sie VPN, Proxy und Firewall. Ist der Port erreichbar, schlägt aber die Anmeldung fehl, kontrollieren Sie Benutzernamen, Berechtigungen des Schlüssels und kürzlich geänderte Zugangsdaten. Geben Sie im Ticket den Verbindungszeitpunkt, das Ausgangsnetz und die vollständige Fehlermeldung an. |
| VNC: schwarzer Bildschirm oder falsche Auflösung | Prüfen Sie zuerst, ob SSH noch funktioniert, um ein Problem mit der Desktop-Sitzung von einem vollständigen Verbindungsausfall zu unterscheiden. Stellen Sie die Bildschirmfreigabe erneut her und prüfen Sie Auflösung und Farbeinstellungen des Clients. Bleibt der Bildschirm schwarz, notieren Sie Clienttyp und Zeitpunkt sowie, ob Sie per SSH Befehle ausführen können. Installieren Sie das System nicht vorschnell neu. |
| Fehler bei Xcode-Zertifikat oder Provisioning-Profil | Prüfen Sie die ausgewählte Xcode-Version, das Build-Ziel und die Signierungseinstellungen. Kontrollieren Sie Ablaufdatum des Zertifikats, den Entsperrstatus des Schlüsselbunds sowie App-ID und Geräteumfang des Provisioning-Profils. Bei CI muss außerdem das ausführende Konto des Runners auf den benötigten Schlüsselbund zugreifen können. Fügen Sie dem Ticket bereinigte Build-Protokolle bei und übermitteln Sie keine privaten Schlüssel. |
| Zu wenig Speicherplatz | Führen Sie zuerst df -h aus, um den verfügbaren Speicherplatz des Volumes zu prüfen. Kontrollieren Sie dann DerivedData, Simulatorgeräte, Archive und Container-Images. Prüfen Sie vor dem Löschen, ob Sie diese noch als Build-Cache oder Nachweis für eine Auslieferung benötigen. Bei dauerhaft wachsendem Speicherbedarf finden Sie passende Optionen unter Speichererweiterungen und Modelloptionen. |
| Self-hosted Runner offline | Prüfen Sie zuerst, ob die Instanz online ist und den Code-Hosting-Dienst erreicht. Kontrollieren Sie anschließend Runner-Prozess, Berechtigungen des Dienstkontos, Status des Registrierungstokens und Auftragswarteschlange. Schlägt nur der Build fehl, sichern Sie Auftragsprotokoll und Exit-Code. Ist auch die Instanz nicht erreichbar, melden Sie das Problem über den SSH-Ausfallpfad. |
Die Schritte in dieser Tabelle dienen ausschließlich der Fehlersuche und ändern die Instanz nicht automatisch. Fügen Sie keine Zugangsdaten, privaten Zertifikatsschlüssel oder vollständigen Zahlungsdaten in öffentliche Seiten ein.
Beide Aktionen starten Sie in der Detailansicht der Instanz nach der Anmeldung. Entscheiden Sie zuerst, ob der aktuelle Systemzustand erhalten bleiben muss.
Öffnen Sie die gewünschte Instanz im Portal, prüfen Sie Modell und Node und vergewissern Sie sich, dass gerade kein Build, Upload oder Schreibvorgang läuft. Starten Sie dann neu. Dabei werden bestehende SSH- und VNC-Verbindungen sowie laufende Aufgaben unterbrochen. Stellen Sie nach dem Hochfahren die Verbindung wieder her und prüfen Sie Ihre Dienste.
Die Dauer hängt davon ab, in welchem Zustand das System heruntergefahren wurde und welche Aufgaben gerade laufen. Ist die Instanz längere Zeit nicht wieder erreichbar, notieren Sie den Zeitpunkt und erstellen Sie ein Support-Ticket.
Sichern Sie zuerst Repository, Zertifikate, Konfigurationsdateien und Build-Artefakte außerhalb der Instanz. Prüfen Sie anschließend die Instanz im Portal und bestätigen Sie die Neuinstallation von macOS. Dabei werden alle Instanzdaten gelöscht. Vorhandene Umgebungen, Caches und lokale Einstellungen müssen neu eingerichtet werden.
Die Installationsdauer hängt vom Systeminstallations- und Bereitstellungsstatus ab. Maßgeblich sind der Fortschritt und die abschließenden Zugangsdaten im Portal. Lösen Sie den Vorgang nicht wiederholt aus.
Prüfen Sie vor der Verlängerung Instanz, Laufzeit und Abrechnung. Wenn Sie die Instanz freigeben möchten, sichern Sie zuerst Ihre Daten extern und stoppen Sie Pipelines, die davon abhängen. Bei der Freigabe wird der Datenträger gelöscht – nutzen Sie die Instanz daher nicht als dauerhaften Backup-Speicher. Wenn Sie den Freigabestatus oder Abrechnungsdaten prüfen lassen möchten, melden Sie sich im Portal an und erstellen Sie ein Support-Ticket.
Die folgenden Themen sind Einstiegspunkte in unsere Wissensdatenbank, keine Support-Tickets. Für persönliche Instanzprotokolle, Änderungen an der Abrechnung oder Prüfungen zu Node-Ereignissen nutzen Sie bitte das Portal.
Richten Sie SSH-Schlüssel, Kommandozeilenwerkzeuge und Bildschirmfreigabe ein und prüfen Sie anschließend, ob die grafische Oberfläche erreichbar ist.
Erste-Schritte-LeitfadenUnterscheiden Sie zwischen Toolchain-Version, DerivedData-Cache, Build-Parametern und Runner-Status. Bewahren Sie reproduzierbare Auftragsprotokolle auf.
Technische Artikel ansehenPrüfen Sie Zugriffsrechte auf den Schlüsselbund, Gültigkeitsdauer des Zertifikats und die Zuordnung zum Provisioning-Profil. Entfernen Sie sensible Angaben, bevor Sie Protokolle teilen.
Technische Artikel ansehenWenn Container und Builds gleichzeitig laufen, beobachten Sie die Auslastung von Unified Memory, Speicherplatz und Hintergrundprozessen getrennt.
Technische Artikel ansehenErmitteln Sie zunächst, wie viel Unified Memory das Modell und sein Kontextfenster benötigen. Wählen Sie dann ein passendes Modell und eine geeignete Laufzeit.
Modellkonfiguration prüfenErgänzen Sie im bestehenden Ticket die aktuellen Auswirkungen, den Zeitpunkt der ersten Meldung und neue Belege. Geben Sie deutlich an, dass Sie noch keine erste Antwort erhalten haben. Im selben Ticket bleibt der bisherige Prüfungsverlauf erhalten. Erstellen Sie nicht mehrere Anfragen für denselben Vorfall.
Bei Verdacht auf ein Ereignis auf Node-Ebene prüfen Sie nach der Anmeldung die Servicehinweise im Portal. Nutzen Sie Ticket-Updates, um zu bestätigen, ob Ihre Instanz betroffen ist. Die Hinweise informieren über gemeinsame Ereignisse; Wiederherstellung und Prüfung einer möglichen Gutschrift für Ihre Instanz erfolgen weiterhin im Ticket.
Vom Bestellen und Erhalt der Zugangsdaten bis zum ersten Build: Folgen Sie Schritt für Schritt unserem Erste-Schritte-Leitfaden. Fragen zur Auswahl vor dem Kauf können Sie direkt an unser Team richten.