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.
Recommended Solution
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:
tar -xf "<path-to-zip-file>" -C "<destination-folder>"
Example:
tar -xf "C:\Users\test\Downloads\apm_insight_agent_nodejs.zip" -C "C:\Users\test\Downloads\apm_insight_agent_nodejs"
Steps:
- Open Command Prompt (press
Win + R, typecmd, and press Enter)
OR
Open PowerShell (pressWin + X, choose "Windows PowerShell") - Copy and paste the command above (with the correct paths for your environment).
- 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:
- Navigate to the downloaded zip file.
- Double-click the file to open it in Windows Explorer.
- Click "Extract All" and choose your desired destination folder.
- 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.
New to ADSelfService Plus?
Related Articles
Method to upgrade Node Js Agent
Manual upgrade from user terminal: To upgrade the APM Insight Node.js agent, follow these instructions: Stop the Node.js application. Access the node package manager (NPM). Navigate to the application root directory of the application for which you ...How to add an APM Insight Node.js agent in Kubernetes via InitContainers?
To integrate the APM Insight Node.js agent into your Kubernetes applications using InitContainers, follow the steps given below: Step 1: Create an empty volume that will be used to copy the agent files during the initContainers process. Example: ...Folder path to view the Node.js agent logs
By default, the logs generated by the Node.js agent are stored in the apminsightdata folder, which resides in your application's current working directory. The log files can be found at: <app-path>\apminsightdata\logs If you would like to customize ...Managing Node.js applications using PM2 Process Manager
Configure PM2 Process Manager to manage Node.js applications Follow the instructions given below to configure PM2 Process Manager to manage Node.js applications: Configure the processManagerEnabled key in the already created apminsightnode.json file. ...Steps to troubleshoot when no data is available for Node.Js applications.
After adding APM Insight Node.Js agent, if you find no data available in the APM Insight Node.Js Application monitor, it could be because of probable reasons like network issues or zero traffic in your application. Kindly read through the below given ...