Skip to content

Commit

Permalink
Windows installation docu: Added troubleshooting (#477)
Browse files Browse the repository at this point in the history
* Windows installation docu: Added troubleshooting

* Update "lastChanged" date
  • Loading branch information
Gaspode69 authored Jan 14, 2024
1 parent 4a448e8 commit 6e011c1
Showing 1 changed file with 29 additions and 32 deletions.
61 changes: 29 additions & 32 deletions docs/de/install/windows.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Windows"
lastChanged: "17.12.2023"
title: "Windows"
lastChanged: "14.01.2024"
---

# Voraussetzungen prüfen
Expand All @@ -9,13 +9,8 @@ Vor der Installation prüfe bitte, ob das System alle notwendigen [Installations

Probleme zum Windows Installer können hier im Forum diskutiert werden: https://forum.iobroker.net/topic/63610/test-iobroker-unter-windows-installieren-2023-edition





# Der ioBroker Windows Installer


Mit dem ioBroker Windows Installer kann ioBroker mit wenigen Klicks auf Windows PCs installiert werden. Der Installer bringt selbst keine Softwarepakete mit. Benötigte Software wird automatisch während der Installation heruntergeladen. Eine Internetverbindung ist also zwingend erforderlich.

Ist ioBroker erst einmal installiert, kann der Installer für folgende Aktionen verwendet werden:
Expand All @@ -29,43 +24,41 @@ Dafür installiert sich der Installer selbst und ist im Windows-Startmenü unter

## ioBroker unter Windows - ist das überhaupt sinnvoll?


ioBroker läuft auf Windows Systemen in der Regel genauso gut wie auf Linux Systemen. Allerdings haben Windows Systeme für den Einsatz als 24/7 Systeme u.U. systembedingt Nachteile, die jeder für sich selbst abwägen muss.
Besonders gut eignet sich Windows dafür, ioBroker einfach mal schnell auf einem vorhandenen Windows PC auszuprobieren.

## ioBroker installieren


Zunächst muss der Installer heruntergeladen werden. Die aktuelle Version liegt immer auf der offiziellen Download Seite: https://www.iobroker.net/#de/download

Anschließend wird der Installer per Doppelklick gestartet. Zunächst wählen wir die zu verwendende Sprache aus:

![Sprachauswahl](./media/windows/InstallWin_language.png 'Sprachauswahl')
![Sprachauswahl](./media/windows/InstallWin_language.png "Sprachauswahl")

Anschließend erscheint die Begrüßungsseite:

![Begrüßungsseite](./media/windows/InstallWin_welcome.png 'Begrüßungsseite')
![Begrüßungsseite](./media/windows/InstallWin_welcome.png "Begrüßungsseite")

Nach einem Klick auf "Weiter" erscheint die Lizenzseite:

![Lizenzseite](./media/windows/InstallWin_license.png 'Lizenzseite')
![Lizenzseite](./media/windows/InstallWin_license.png "Lizenzseite")

Die Lizenz müssen wir akzeptieren und anschließend klicken wir wieder auf "Weiter". Auf der folgenden Seite können wir nun den Installationsordner für unsere ioBroker-Installation auswählen:

![Installationsordner](./media/windows/InstallWin_folder.png 'Installationsordner')
![Installationsordner](./media/windows/InstallWin_folder.png "Installationsordner")

In der Regel ist es eine gute Idee, einfach den Vorgabewert "C:\ioBroker" zu verwenden. Nach einem Klick auf "Weiter" werden einige Überprüfungen durchgeführt:

![Überprüfungen](./media/windows/InstallWin_check.png 'Überprüfungen')
![Überprüfungen](./media/windows/InstallWin_check.png "Überprüfungen")

Dies kann einen Moment dauern. Im Anschluss erscheint automatisch das Ergebnis der Überprüfung:

![Überprüfungsergebnis](./media/windows/InstallWin_checkresult.png 'Überprüfungsergebnis')
![Überprüfungsergebnis](./media/windows/InstallWin_checkresult.png "Überprüfungsergebnis")

In diesem Beispiel ist alles in Ordnung und wir können fortfahren. Sollten jetzt nicht alle erforderlichen Voraussetzungen erfüllt sein, dann muss zunächst geklärt werden, was zu tun ist. Meist sind Ports nicht verfügbar, die für die Installation und den Betrieb von ioBroker benötigt werden. Wer in dieser Situation ist und nicht weiß, was zu tun ist, findet Hilfe im ioBroker Forum unter https://forum.iobroker.net/
Nach einem Klick auf "Weiter" können wir einige Details auswählen:

![Optionen](./media/windows/InstallWin_options.png 'Optionen')
![Optionen](./media/windows/InstallWin_options.png "Optionen")

Bei der ioBroker Erstinstallation sind die ersten drei Optionen fest vorgegeben:

Expand All @@ -76,40 +69,44 @@ Bei der ioBroker Erstinstallation sind die ersten drei Optionen fest vorgegeben:
Und schließlich bietet der Installer noch die Möglichkeit, die Konfiguration einer vorhandenen Installation zu übernehmen. Dafür ist der komplette Ordner "iobroker-data" erforderlich, der bei einer vorhandenen ioBroker Installation im ioBroker Ordner zu finden ist. Dieser kann von einer ioBroker Installation unter Windows oder Linux stammen. Die Daten werden während der Installation aus diesem Ordner übernommen, der Inhalt dieses Ordners wird nicht verändert.
Nach Klick auf "Weiter" sehen wir jetzt die Zusammenfassung der geplanten Aktionen:

![Optionen](./media/windows/InstallWin_summary.png 'Optionen')
![Optionen](./media/windows/InstallWin_summary.png "Optionen")

Mit einem Klick auf "Installieren" wird jetzt die eigentliche Installation gestartet:

![Optionen](./media/windows/InstallWin_downloadnode.png 'Optionen')
![Optionen](./media/windows/InstallWin_downloadnode.png "Optionen")

![Optionen](./media/windows/InstallWin_installnode.png 'Optionen')
![Optionen](./media/windows/InstallWin_installnode.png "Optionen")

![Optionen](./media/windows/InstallWin_installiobroker.png 'Optionen')
![Optionen](./media/windows/InstallWin_installiobroker.png "Optionen")

![Optionen](./media/windows/InstallWin_finish.png 'Optionen')
![Optionen](./media/windows/InstallWin_finish.png "Optionen")

Mit einem Klick auf "Fertigstellen" öffnet sich ein Webbrowser und ioBroker leitet dich durch die ersten Schritte der Einrichtung.


## Update

!> Normalerweise verlaufen Updates völlig problemlos und sicher. Dennoch sollte vor der Durchführung vorsichtshalber eine Datensicherung durchgeführt werden.

* Mit Hilfe des Windows Installers kann automatisch die installierte Node.js Version auf den empfohlenen Stand gebracht werden.
Dafür einfach den Installer aus dem Windows Startmenü ("ioBroker Setup") starten und den Anweisungen folgen.
* Der js-controller kann leider nicht mit dem Windows Installer aktualisiert werden. Das muss mit Hilfe der ioBroker Command Line erledigt werden. Diese kann aus dem Windows Startmenü unter "ioBroker automation platform" - "ioBroker Command Line" gestartet werden.

Die Aktualisierung wird dann durch folgende Kommandos durchgeführt:
- Mit Hilfe des Windows Installers kann automatisch die installierte Node.js Version auf den empfohlenen Stand gebracht werden.
Dafür einfach den Installer aus dem Windows Startmenü ("ioBroker Setup") starten und den Anweisungen folgen.
- Der js-controller kann leider nicht mit dem Windows Installer aktualisiert werden. Das muss mit Hilfe der ioBroker Command Line erledigt werden. Diese kann aus dem Windows Startmenü unter "ioBroker automation platform" - "ioBroker Command Line" gestartet werden.

``iob stop``
Die Aktualisierung wird dann durch folgende Kommandos durchgeführt:

``iob update``
`iob stop`

``iob upgrade self``
`iob update`

``iob start``
`iob upgrade self`

`iob start`

## Fehlersuche

@@@ tbd @@@
**Problem:**
Die Installation kann nicht durchgeführt werden, da Port 9001 von einem Prozess mit dem Namen "System" belegt ist.

**Mögliche Lösung:**
Der Intel® Graphics Command Center ist bekannt dafür, Port 9001 zu blockieren.
Überprüfe, ob es einen Windows Service mit dem Namen "Graphics Command Center" o.ä. auf deinem PC gibt. Wenn ja, beende und deaktiviere diesen Dienst.
Anschließend sollte die Installation von ioBroker möglich sein.

0 comments on commit 6e011c1

Please sign in to comment.