Setup:Installationsanleitung/Systemvorbereitung/Windows/Node.js: Unterschied zwischen den Versionen
← Setup:Installationsanleitung/Systemvorbereitung/Windows/Node.js
| [freigegebene Version] | [freigegebene Version] |
Inhaltsverzeichnis
|
Node.js wird für den Betrieb des Rendering-Service "Parsoid" für den visuellen Editor benötigt. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diesen in Ihrer BlueSpice-Installation verwenden möchten. |
Download[Bearbeiten | Quelltext bearbeiten]
Im Folgenden wird die Node.js-Version 10.13.0 verwendet und dient besipielhaft für die jeweils aktuelle Node.js-Version der Reihe 10.x, die Sie zum Zeitpunkt Ihrer Installation von herunterladen können.
Bitte beachten Sie, dass BlueSpice nicht mit einer Node.js-Version > 10.x funktionsfähig ist.
Öffnen Sie im Internet Explorer die offizielle Downloadsite von Node.js. Downloaden Sie die aktuelle LTS-Version 10.x.
Folgen Sie den weiteren Download-Anweisungen und laden Sie das Installationspaket auf Ihre Festplatte.
Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.
Installation von Node.js[Bearbeiten | Quelltext bearbeiten]
Öffnen Sie die soeben heruntergeladene Datei "node-v10.13.0-x64.msi".
Starten Sie die Installation durch Klick auf "Next >":
Bestätigen Sie die Lizenz (1) und klicken Sie auf "Next >" (2):
Bestätigen Sie die weiteren Installationsschritte mit Klick auf "Next >":
Starten Sie die Installation mit Klick auf "Install":
Das Setup-Programm können Sie nach Abschluss beenden:
Installationspfad der Node.js Pakete anpassen[Bearbeiten | Quelltext bearbeiten]
Node.js installiert seine Pakete standardmäßig im Profil-Verzeichnis des jeweils eingeloggten Users. Da Node.js im Rahmen von BlueSpice ausschließlich als User-unabhängige Serveranwendung betrieben werden soll, wird dringend empfohlen, den Standardpfad für diese Pakete zu ändern:
Öffnen Sie im Installationsordner von Node.js die Datei node_modules\npm\npmrc in einem Texteditor:
Editieren Sie diese Datei und geben in dieser den neuen Standardpfad für Ihre Node.js Pakete an:
Speichern Sie die Datei und schließen Sie den Editor.
Diese Dokumentation geht von der von uns empfohlenen Ordnerstruktur aus. Aus diesem Grund wird an dieser Stelle der Standardpfad für die Node.js-Pakete auf den Ordner C:\bluespice\bin\npm festgelegt. Haben Sie individuelle Wünsche, so müssen Sie diese Pfade nach eigenem Verständnis anpassen.
Installation der Windows Build Tools[Bearbeiten | Quelltext bearbeiten]
Das Node.js-Paket windows-build-tools wird für die Installation der für BlueSpice relevanten Anwendungen benötigt.
Zur Installation öffnen Sie zunächst die Windows-Eingabeaufforderung als Administrator. Klicken Sie hierzu mit der rechten Maustaste auf "Start" (1) und wählen "Eingabeaufforderung (Administrator)" (2):
Führen Sie den Befehl "npm install --global --production --vs2015 windows-build-tools" aus:
Dieser Befehl kann u.U. sehr lange dauern und zeigt längere Zeit keine Aktivität. Er ist dennoch aktiv und darf nicht abgebrochen werden! Außerdem kann es sein, dass Windows Server während des Prozesses ohne Vorwarnung neu gestartet wird. Starten Sie in diesem Fall anschließend die Installation nochmals wie soeben beschrieben.
Nach erfolgreicher Installation können Sie die Eingabeaufforderung schließen:
Nächster Schritt[Bearbeiten | Quelltext bearbeiten]
Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladenen Datei "node-v10.13.0-x64.msi" von Ihrer Festplatte löschen und zum nächsten Schritt "Parsoid" weiter gehen.
{{DISPLAYTITLE:Installation von Node.js auf Windows}}
__TOC__
{{Vorlage:Optional|text=Node.js wird für den Betrieb des Rendering-Service "Parsoid" für den visuellen Editor benötigt. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diesen in Ihrer BlueSpice-Installation verwenden möchten.}}
==Download==
{{Vorlage:Hint|text=Im Folgenden wird die Node.js-Version 10.13.0 verwendet und dient besipielhaft für die jeweils aktuelle Node.js-Version der Reihe 10.x, die Sie zum Zeitpunkt Ihrer Installation von herunterladen können.<br /> Bitte beachten Sie, dass BlueSpice nicht mit einer Node.js-Version > 10.x funktionsfähig ist.}}
Öffnen Sie im Internet Explorer die [https://nodejs.org/en/download/releases/ offizielle Downloadsite von Node.js]. Downloaden Sie die aktuelle LTS-Version 10.x.
Folgen Sie den weiteren Download-Anweisungen und laden Sie das Installationspaket auf Ihre Festplatte.
{{Vorlage:Hint|text=Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.}}
==Installation von Node.js==
Öffnen Sie die soeben heruntergeladene Datei "node-v10.13.0-x64.msi".
Starten Sie die Installation durch Klick auf "Next >":
[[Datei
[[File:Setup:Node (2)Nodejs_Install_01.png|zentriert|400x400pxcenter|400px|Node.js Installation 01]]
Bestätigen Sie die Lizenz (1) und klicken Sie auf "Next >" (2):
[[Datei
[[File:Setup:Node (3)Nodejs_Install_02.png|zentriert|400x400pxcenter|400px|Node.js Installation 02]]
Bestätigen Sie die weiteren Installationsschritte mit Klick auf "Next >":
<gallery>
File:Setup:Nodejs_Install_03.png
File:Setup:Nodejs_Install_04.png
File:Setup:Nodejs_Install_05.png
</gallery>
Starten Sie die Installation mit Klick auf "Install":
[[Datei
[[File:Setup:Node (7)Nodejs_Install_06.png|zentriert|400x400pxcenter|400px|Node.js Installation 06]]
Das Setup-Programm können Sie nach Abschluss beenden:
[[File:Setup:Nodejs_Install_07.png|center|400px|Node.js Installation 07]]
==Installationspfad der Node.js Pakete anpassen==
Node.js installiert seine Pakete standardmäßig im Profil-Verzeichnis des jeweils eingeloggten Users. Da Node.js im Rahmen von BlueSpice ausschließlich als User-unabhängige Serveranwendung betrieben werden soll, wird dringend empfohlen, den Standardpfad für diese Pakete zu ändern:
Öffnen Sie im Installationsordner von Node.js die Datei node_modules\npm\npmrc in einem Texteditor:
[[Datei
[[File:Setup:Node (9)Nodejs_ChangePath_01.png|zentriert|400x400pxcenter|400px|Node.js Standardpfad ändern 01]]
Editieren Sie diese Datei und geben in dieser den neuen Standardpfad für Ihre Node.js Pakete an:
[[Datei
[[File:Setup:Node (10)Nodejs_ChangePath_02.png|zentriert|400x400pxcenter|400px|Node.js Standardpfad ändern 02]]
Speichern Sie die Datei und schließen Sie den Editor.
{{Vorlage:Hint|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle der Standardpfad für die Node.js-Pakete auf den Ordner C:\bluespice\bin\npm festgelegt. Haben Sie individuelle Wünsche, so müssen Sie diese Pfade nach eigenem Verständnis anpassen.}}
==Installation der Windows Build Tools==
Das Node.js-Paket windows-build-tools wird für die Installation der für BlueSpice relevanten Anwendungen benötigt.
Zur Installation öffnen Sie zunächst die Windows-Eingabeaufforderung als Administrator. Klicken Sie hierzu mit der rechten Maustaste auf "Start" (1) und wählen "Eingabeaufforderung (Administrator)" (2):
[[Datei
[[File:Setup:Node (11)Nodejs_InstallWindowsBuildTools_01.png|zentriert|364x364pxcenter|200px|Node.js Installation Windows Build Tools 01]]
Führen Sie den Befehl "npm install --global --production --vs2015 windows-build-tools" aus:
[[Datei
[[File:Setup:Node (12)Nodejs_InstallWindowsBuildTools_02.png|zentriert|400x400pxcenter|400px|Node.js Installation Windows Build Tools 02]]
{{Vorlage:Hint|text=Dieser Befehl kann u.U. sehr lange dauern und zeigt längere Zeit keine Aktivität. Er ist dennoch aktiv und darf nicht abgebrochen werden! Außerdem kann es sein, dass Windows Server während des Prozesses ohne Vorwarnung neu gestartet wird. Starten Sie in diesem Fall anschließend die Installation nochmals wie soeben beschrieben.}}
Nach erfolgreicher Installation können Sie die Eingabeaufforderung schließen:
[[Datei
[[File:Setup:Node (13)Nodejs_InstallWindowsBuildTools_03.png|zentriert|400x400pxcenter|400px|Node.js Installation Windows Build Tools 03]]
==Nächster Schritt==
Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladenen Datei "node-v10.13.0-x64.msi" von Ihrer Festplatte löschen und zum nächsten Schritt "[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Parsoid|Parsoid]]" weiter gehen.
[[en:Setup:Installation_Guide/System_Preparation/Windows/Node.js]]
[[de:{{FULLPAGENAME}}]]| Zeile 15: | Zeile 15: | ||
Starten Sie die Installation durch Klick auf "Next >": | Starten Sie die Installation durch Klick auf "Next >": | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_Install_01.png|center|400px|Node.js Installation 01]] | ||
| + | |||
Bestätigen Sie die Lizenz (1) und klicken Sie auf "Next >" (2): | Bestätigen Sie die Lizenz (1) und klicken Sie auf "Next >" (2): | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_Install_02.png|center|400px|Node.js Installation 02]] | ||
| + | |||
Bestätigen Sie die weiteren Installationsschritte mit Klick auf "Next >": | Bestätigen Sie die weiteren Installationsschritte mit Klick auf "Next >": | ||
| Zeile 27: | Zeile 31: | ||
Starten Sie die Installation mit Klick auf "Install": | Starten Sie die Installation mit Klick auf "Install": | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_Install_06.png|center|400px|Node.js Installation 06]] | ||
| + | |||
Das Setup-Programm können Sie nach Abschluss beenden: | Das Setup-Programm können Sie nach Abschluss beenden: | ||
| Zeile 36: | Zeile 42: | ||
Öffnen Sie im Installationsordner von Node.js die Datei node_modules\npm\npmrc in einem Texteditor: | Öffnen Sie im Installationsordner von Node.js die Datei node_modules\npm\npmrc in einem Texteditor: | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_ChangePath_01.png|center|400px|Node.js Standardpfad ändern 01]] | ||
| + | |||
Editieren Sie diese Datei und geben in dieser den neuen Standardpfad für Ihre Node.js Pakete an: | Editieren Sie diese Datei und geben in dieser den neuen Standardpfad für Ihre Node.js Pakete an: | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_ChangePath_02.png|center|400px|Node.js Standardpfad ändern 02]] | ||
| + | |||
Speichern Sie die Datei und schließen Sie den Editor. | Speichern Sie die Datei und schließen Sie den Editor. | ||
| Zeile 47: | Zeile 57: | ||
Zur Installation öffnen Sie zunächst die Windows-Eingabeaufforderung als Administrator. Klicken Sie hierzu mit der rechten Maustaste auf "Start" (1) und wählen "Eingabeaufforderung (Administrator)" (2): | Zur Installation öffnen Sie zunächst die Windows-Eingabeaufforderung als Administrator. Klicken Sie hierzu mit der rechten Maustaste auf "Start" (1) und wählen "Eingabeaufforderung (Administrator)" (2): | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_InstallWindowsBuildTools_01.png|center|200px|Node.js Installation Windows Build Tools 01]] | ||
| + | |||
Führen Sie den Befehl "npm install --global --production --vs2015 windows-build-tools" aus: | Führen Sie den Befehl "npm install --global --production --vs2015 windows-build-tools" aus: | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_InstallWindowsBuildTools_02.png|center|400px|Node.js Installation Windows Build Tools 02]] | ||
| Zeile 55: | Zeile 68: | ||
Nach erfolgreicher Installation können Sie die Eingabeaufforderung schließen: | Nach erfolgreicher Installation können Sie die Eingabeaufforderung schließen: | ||
| − | [[ | + | |
| + | [[File:Setup:Nodejs_InstallWindowsBuildTools_03.png|center|400px|Node.js Installation Windows Build Tools 03]] | ||