User Manual
awaBerry | Bestehendes Gerät hinzufügen - WINDOWS
Ein vorhandenes Windows-Gerät zu awaBerry hinzufügen. Installationsanleitung für Windows 10 und 11 — verbinden Sie Ihren PC in wenigen Minuten mit Ihrem...
Vorhandenes Gerät hinzufügen - WINDOWS
Zusammenfassung
Diese umfassende Anleitung hilft Ihnen, Ihr vorhandenes Windows-Gerät mit awaBerry zu verbinden. Der Prozess umfasst mehrere wichtige Schritte: Zuerst stellen Sie sicher, dass Ihr Windows Subsystem für Linux (WSL) ordnungsgemäß installiert und konfiguriert ist. Als Nächstes weisen Sie Ihrem Gerät innerhalb der awaBerry-Plattform einen eindeutigen Namen zu. Nach erfolgreicher Registrierung des Gerätenamens stellt Ihnen das System eine eindeutige Geräte-ID und Installationsbefehle zur Verfügung, die auf Ihrem Windows-Gerät (innerhalb von WSL) ausgeführt werden müssen. Schließlich überwacht das System, bis Ihr Gerät online geht und die Einrichtung abschließt, was eine erfolgreiche Verbindung bestätigt und Ihr Gerät für die Verwendung mit awaBerry vorbereitet.
Seitenaufruf
Sie können diese Seite aufrufen, indem Sie zu Folgendem navigieren: /connect_steps_existing?os=windows
Seitenfunktionen
Schritt 1: Gerätenamen festlegen (Windows-Einrichtung)
Dies ist der Ausgangspunkt für die Verbindung Ihres Windows-Geräts. Er bietet wichtige Einrichtungsanweisungen und ermöglicht es Ihnen, Ihr Gerät zu benennen.
- Fehlermeldungsbereich: Oben erscheint ein rotes Feld, wenn während des Benennungs- oder Registrierungsprozesses des Geräts Fehler auftreten.
- Anforderungsfeld für Windows-Einrichtung: Dieser Abschnitt enthält spezifische Anweisungen für Windows-Geräte und führt Sie durch die Installation des Windows Subsystem für Linux (WSL).
- 1. Sicherstellen, dass WSL installiert ist: Ein Link zur offiziellen Microsoft-Dokumentation hilft Ihnen bei der Installation von WSL.
- 2. WSL Autostart-Skript herunterladen: Ein Download-Link für ein Skript (`setup_wsl_autostart_for_awaberry.ps1`), das den automatischen Start von WSL und awaBerry automatisiert.
- 3. Installationsskript ausführen: Detaillierte Schritte zur Ausführung des heruntergeladenen Skripts in der Windows PowerShell (Admin), einschließlich eines Befehls zur Aktivierung der Skriptausführung, falls erforderlich, und des Befehls zum Ausführen des Skripts selbst. Beide Befehle können direkt kopiert werden.
- Eingabefeld für Gerätenamen: Hier geben Sie einen gewünschten Namen für Ihr Gerät ein. Der Name muss mindestens 3 Zeichen lang sein.
- Windows Linux Subsystem starten: Eine Erinnerung, sicherzustellen, dass Ihr WSL-Terminal geöffnet und bereit ist.
- Option zum Kopieren der Installer-URL: Dies stellt einen Befehl zum Herunterladen des awaBerry-Installationsskripts bereit. Klicken Sie auf den Text, um ihn zu kopieren, und fügen Sie ihn in das Terminal Ihres Geräts (innerhalb von WSL) ein, um den Download zu starten.
- Option zum Kopieren des Installer-Startbefehls: Nach dem Herunterladen des Skripts stellt dies den Befehl bereit, um es ausführbar zu machen und auszuführen. Kopieren und fügen Sie dies in Ihr Terminal (innerhalb von WSL) ein, um die Installation zu starten.
- Weiter-Schaltfläche: Nachdem Sie einen Gerätenamen eingegeben und die Installationsschritte verstanden haben, klicken Sie auf diese Schaltfläche, um zum nächsten Schritt zu gelangen.
Schritt 2: Geräte-ID anzeigen
Nachdem Sie erfolgreich einen Gerätenamen angegeben haben, zeigt diese Seite eine eindeutige ID für Ihr Gerät an.
- Zurück-Schaltfläche: Ermöglicht Ihnen, zum vorherigen Schritt zurückzukehren, falls Sie den Gerätenamen ändern müssen.
- Anzeige der Geräte-ID: Ihre eindeutige Geräte-ID wird angezeigt. Klicken Sie auf die ID, um sie automatisch in Ihre Zwischenablage zu kopieren.
- Anweisung: Eine Nachricht weist Sie an, diese Geräte-ID in das Terminal Ihres Geräts einzufügen, wenn Sie vom awaBerry-Installer dazu aufgefordert werden.
- Weiter-Schaltfläche: Sobald Sie die Geräte-ID kopiert und in Ihrem Terminal verwendet haben, klicken Sie auf diese Schaltfläche, um fortzufahren.
Schritt 3: Auf Gerät warten
Diese Seite überwacht den Verbindungsstatus und wartet darauf, dass Ihr Gerät online geht, nachdem Sie den Installer ausgeführt haben.
- Warte-Nachricht: Zeigt 'Warte auf Gerät, das online geht...'.
- Fortschrittsanzeige: Ein Balken zeigt den Fortschritt der Wartezeit an. Das System wartet bis zu 2 Minuten, bis Ihr Gerät seinen Online-Status meldet.
- Fehlermeldung (bei Zeitüberschreitung): Wenn das Gerät nicht innerhalb der angegebenen Zeit online geht, erscheint eine Fehlermeldung: 'Gerät hat nach 4 Minuten keinen Online-Status gesendet.' begleitet von dem Vorschlag, Ihre Installation zu überprüfen, und einer Schaltfläche 'Erneut versuchen'.
- Erneut versuchen-Schaltfläche: Wenn die Verbindung abläuft, bringt Sie das Klicken auf diese Schaltfläche zurück zum Schritt 'Gerätenamen festlegen', um den Prozess neu zu starten.
Schritt 4: Geräteverbindung erfolgreich
Diese letzte Seite bestätigt, dass Ihr Gerät erfolgreich mit awaBerry verbunden wurde und sich in der Endkonfiguration befindet.
- Erfolgsbanner: Eine prominente Nachricht bestätigt 'Geräteverbindung erfolgreich' und gibt den Namen Ihres verbundenen Geräts an.
- Geräteinformationen: Zeigt wichtige Details zu Ihrem neu verbundenen Gerät an, wie z. B. seine lokale IP-Adresse und den Arbeitsspeicher in MB.
- Konfigurationsfortschritt: Eine Fortschrittsanzeige und Meldungen wie 'Warte auf Gerätekonfiguration und Installation' und 'Dauert normalerweise 1-2 Minuten.' informieren Sie darüber, dass die endgültige Einrichtung im Gange ist.
Szenario-Ausführungen
Mögliche Nutzungsschritte innerhalb dieser Seite
Hier sind gängige Szenarien, die zeigen, wie ein Benutzer ein Windows-Gerät erfolgreich mit awaBerry verbinden würde.
Szenario: Erfolgreiche Verbindung eines neuen Geräts unter Windows
Dieses Szenario deckt den vollständigen, erfolgreichen Prozess der Verbindung eines neuen Windows-Geräts ab.
- Erster Zugriff: Sie navigieren zur Seite 'Vorhandenes Gerät hinzufügen - WINDOWS'.
- WSL-Einrichtung: Sie folgen den Anweisungen im Feld 'Anforderungen für Windows-Einrichtung', um WSL zu installieren, das Autostart-Skript herunterzuladen und das Installationsskript in PowerShell (Admin) auf Ihrem Windows-Computer auszuführen.
- Gerät benennen: Sie geben einen eindeutigen und beschreibenden Namen (z. B. "MeinHeimserver") in das Feld 'Gerätename' ein.
- Zum Geräte-ID fortfahren: Sie klicken auf die Schaltfläche 'Weiter'. Die Seite wechselt zur Anzeige Ihrer eindeutigen 'Geräte-ID'.
- Installer-Ausführung: Sie kopieren den bereitgestellten Befehl 'Installer-URL', öffnen Ihr WSL-Terminal (stellen Sie sicher, dass Linux läuft), fügen den Befehl ein und führen ihn aus, um den Installer herunterzuladen.
- Installer starten: Sie kopieren dann den 'Installer-Startbefehl' (`sudo chmod +x install.sh && sudo ./install.sh`), fügen ihn in Ihr WSL-Terminal ein und führen ihn aus. Wenn Sie vom Installer dazu aufgefordert werden, fügen Sie die kopierte 'Geräte-ID' ein.
- Verwendung der Geräte-ID bestätigen: Zurück im Browser klicken Sie auf der Seite 'Geräte-ID anzeigen' auf die Schaltfläche 'Weiter'.
- Auf Online-Status warten: Die Seite wechselt zu 'Warte auf Gerät, das online geht...', und zeigt einen Fortschrittsbalken an. Sie warten, bis dieser Vorgang abgeschlossen ist, was bedeutet, dass Ihr Gerät mit dem awaBerry-Backend verbunden ist.
- Endgültige Konfiguration: Die Seite aktualisiert sich dann zu 'Geräteverbindung erfolgreich' und zeigt einen abschließenden Fortschrittsbalken für 'Warte auf Gerätekonfiguration und Installation'. Nach kurzer Wartezeit werden Sie automatisch zur Gerätekostenseite weitergeleitet.
Mögliche Fehler, die auf dieser Seite auftreten können
Diese Szenarien beschreiben potenzielle Probleme und wie das System darauf reagiert.
Fehler: Gerätename zu kurz
Wenn Sie einen Gerätenamen eingeben, der kürzer als 3 Zeichen ist (z. B. "ab") und auf 'Weiter' klicken, wird das System Sie daran hindern, fortzufahren. Direkt unter dem Eingabefeld erscheint eine Fehlermeldung: "Mindestens 3 Zeichen". Sie müssen einen längeren Namen angeben, um fortzufahren.
Fehler: Gerätename bereits in Verwendung
Wenn Sie versuchen, einen Gerätenamen zu registrieren, der bereits von einem Ihrer anderen Geräte verwendet wird (z. B. "VorhandenerServerName") und auf 'Weiter' klicken, erscheint eine vollständige Fehlermeldung am oberen Rand der Seite. Sie informiert Sie: "Gerätename existiert in Geräten: VorhandenerServerName. Wählen Sie einen anderen Gerätenamen." Sie müssen einen anderen, eindeutigen Namen eingeben, um fortzufahren.
Fehler: Gerät geht nicht online
Nachdem Sie einen Gerätenamen angegeben und zum Schritt 'Auf Gerät warten' fortgefahren sind, wenn Ihr physisches Windows-Gerät (mit laufendem WSL und dem awaBerry-Installer) nicht innerhalb von etwa 2 Minuten (120 Sekunden) erfolgreich eine Verbindung zu den awaBerry-Servern herstellt, läuft der Wartevorgang ab. Die Seite zeigt dann eine vollständige Fehlermeldung an: "Gerät hat nach 4 Minuten keinen Online-Status gesendet." Sie werden auch aufgefordert, "Bitte überprüfen Sie Ihre Installation." und erhalten eine Schaltfläche 'Erneut versuchen', um den Verbindungsprozess vom Schritt 'Gerätenamen festlegen' neu zu starten.
