How to Fix Node.js Agent Zip Extraction Issue on Windows

How to Fix Node.js Agent Zip Extraction Issue on Windows

Overview

From Node.js Agent version 5.4.1 (APM version 181000 and later) onwards, some users may experience issues extracting the agent zip file on Windows systems using the default extractor.

To properly extract the Node.js agent zip file on Windows, use the following command.
This can be run from either Command Prompt or PowerShell (Windows 10 and later):


Extraction Command Format:

Notes
      tar -xf "<path-to-zip-file>" -C "<destination-folder>"

Example:

Notes
tar -xf "C:\Users\test\Downloads\apm_insight_agent_nodejs.zip" -C "C:\Users\test\Downloads\apm_insight_agent_nodejs"


Steps:

  1. Open Command Prompt (press Win + R, type cmd, and press Enter)
    OR
    Open PowerShell (press Win + X, choose "Windows PowerShell")
  2. Copy and paste the command above (with the correct paths for your environment).
  3. Press Enter to extract the files.

Why this is needed

Some versions of Windows’ native zip extractors may not handle the Node.js agent zip archives correctly. The tar command ensures proper extraction of all agent files.


For Versions Before 5.4.1

You can extract the Node.js agent zip file using the default Windows extractor:

Steps:

  1. Navigate to the downloaded zip file.
  2. Double-click the file to open it in Windows Explorer.
  3. Click "Extract All" and choose your desired destination folder.
  4. Complete the extraction process.

If you encounter any further issues, please reach out to support or refer to the installation documentation for additional troubleshooting steps.