Update Node.js

OL Connect Workflow includes a Node.js runtime that is used by certain components and functionality. In some cases, it may be necessary to update Node.js to address security vulnerabilities or apply maintenance updates.

The following procedure describes how to manually update the Node.js runtime used by OL Connect Workflow.

Before you begin

• Ensure that the new Node.js version belongs to the same major release line as the currently installed version. For example, if Node.js 22.x.x is installed, select a newer version from the 22.x.x release line.

• Ensure you have administrator privileges on the system.

Step 1: Check the installed Node.js version

1. Open the Windows Command Prompt (CMD).

2. Navigate to the Node.js installation directory:

   cd "C:\Program Files (x86)\Objectif Lune\NodeJS"

3. Enter the following command to display the currently installed Node.js version:

   node -v

4. Note the version number displayed, for example:

   v22.23.1

Step 2: Download the updated Node.js version

1. Open a web browser and navigate to the official Node.js download page.

2. Select the latest suitable version within the same major release line as the currently installed version, for example Node.js 22.x.x.

3. Select Windows as the operating system.

4. Select x86 (32-bit) as the architecture.

5. Download the Standalone Binary (.zip) distribution.

6. Extract the downloaded ZIP archive to a temporary folder.

Step 3: Stop OL Connect Workflow

1. Open the OL Connect Workflow Configuration Tool (About Workflow Configurations).

2. Stop OL Connect Workflow and its associated services.

3. Close the OL Connect Workflow Configuration Tool.

4. Verify that the services have stopped before proceeding.

Step 4: Replace the Node.js runtime

1. Open Windows File Explorer and navigate to:

   C:\Program Files (x86)\Objectif Lune\NodeJS

2. Create a backup of the existing contents of this directory so that the previous version can be restored if necessary.

3. Delete all contents of the NodeJS directory.

4. Copy the contents of the extracted Node.js ZIP archive into the now-empty NodeJS directory.

   Note: Copy the files and folders from inside the extracted archive directly into the NodeJS directory. Do not introduce an additional nested directory.

Step 5: Verify the Node.js update

1. Open a new Windows Command Prompt (CMD).

2. Navigate to the Node.js installation directory:

   cd "C:\Program Files (x86)\Objectif Lune\NodeJS"

3. Run:

   node -v

4. Confirm that the reported version matches the newly installed Node.js version.

Step 6: Restart OL Connect Workflow

1. Open the OL Connect Workflow Configuration Tool.

2. Restart OL Connect Workflow and its associated services.

3. Verify that the services start successfully.

4. Verify that OL Connect Workflow operates as expected, particularly any processes or scripts that depend on Node.js.

5. The Node.js runtime update is now complete.