No categories assigned

Node.js


icon for optional
Node.js is required for the operation of the rendering service "Parsoid" for the Visual Editor. The steps listed here are optional and only required if you plan to use them in your BlueSpice installation.


Downloading Node.js

In Internet Explorer, open the official website of Node.js (1). Download the latest LTS version 10.x (2).

Node.js Download 01

Follow the further download instructions and download the installation package to your hard drive.


Hint.jpg
Please note that the download on your Windows Server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.



Hint.jpg
Tis guide uses the Node.js version 10.13.0 as an example. You can download the latest Nodee.js version tat the time of installation.


Installing Node.js

Open the downloaded file "node-v10.13.0-x64.msi".

Start the installation by clicking "Next>":


Node.js Installation 01

Confirm the license (1) and click "Next >" (2):

Node.js Installation 02

Confirm the further installation steps by clicking "Next >":


Start the installation by clicking "Install":


Node.js Installation 06

You can close the setup program after finishing the installation:


Node.js Installation 07


Adjusting the Installation path of the Node.js packages

By default, Node.js installs its packages in the profile directory of the logged-in user. Since Node.js is intended solely to operate as a user-independent server application under BlueSpice, it is strongly recommended that you change the default path for these packages:

In the Node.js installation folder, open the file node_modules\npm\npmrcin a text editor:


Node.js Standardpfad ändern 01


Edit this file and enter the new default path for your Node.js packages:


Node.js Standardpfad ändern 02

Save the file and close the editor.


{{Template:Hint|text=This documentation is based on the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure | folder structure recommended by us ]. For this reason, the default path for the Node.js packages is set to the folder C:\bluespice\bin\npm. If you have differnet requirements, you must adapt these paths accordingly.}}


Installing the Windows Build Tools

The Node.js package windows-build-tools is required for installing the relevant BlueSpice applications.

To install, first open the Windows command prompt as administrator. To do this, right-click "Start" (1) and select "Command Prompt (Administrator)" (2):

Node.js Installation Windows Build Tools 01

Execute the command "npm install --global --production windows-build-tools":

Node.js Installation Windows Build Tools 02



Hint.jpg
This command may take a long time and not show any activity for a long time. However, it is still active and must not be canceled! Additionally, Windows Server may restart during the process without warning. In this case, restart the installation as described above.


After successful installation, you can close the command prompt:

Node.js Installation Windows Build Tools 03


Next step

If you have completed all steps successfully, you can delete the previously downloaded file "node-v10.13.0-x64.msi" from your hard disk and continue to the next step " Parsoid".

Attachments

Discussions