Skip to main content

Web proxy configuration and activation fails if the EnterpriseWorkloadsAgent service port 8082 is used by another application

Web proxy configuration and activation fails if the EnterpriseWorkloadsAgent service port 8082 is used by another application

Problem Description

When attempting to configure a network web proxy or activate the EnterpriseWorkloadsAgent, the operation fails. You may notice one of the following indications:

  • Desktop Graphical Application: The EnterpriseWorkloadsAgent desktop shortcut layout opens to a completely blank window, rendering no parameters to configure the web proxy or complete registration.

  • Command Line (Proxy Config): Executing the configuration parameters through an elevated command prompt falls back onto the following error payload:

    Failed to set proxy configuration: Put "https://localhost:8082/falcon/v1/webProxy": http: server gave HTTP response to HTTPS client
  • Command Line (Activation): Standard manual activation runs via the command prompt (even following an offline alteration of the configuration template) return:

    Plaintext

    "https://localhost:8082/falcon/v1/webProxy": http: server gave HTTP response to HTTPS client

Cause

This condition is triggered because the default port reserved for local microservice hooks within the EnterpriseWorkloadsAgent daemon (Port 8082) is already actively bound to a separate, non-Druva process on the target server environment.

Resolution

To remediate this conflict, you must pinpoint a free local TCP port on the host operating system and redirect the agent service configuration tracker to utilize that path.

Step 1: Confirm the Port Block

  1. Open an elevated Command Prompt (Run as Administrator).

  2. Execute the following sequence to isolate active processes binding port 8082:

    netstat -ano | findstr 8082
  3. If this strings back alphanumeric rows showing listening PIDs, the default port is contested.

Step 2: Identify an Alternate Open Port

Scan an alternative unassigned port target (for example, 8083) to ensure it is completely free:

netstat -ano | findstr 8083

(If no output or rows return, this port is open and safe to adapt.)

Step 3: Update the Agent Configuration Mapping

  1. Open the Windows Services Management Console (services.msc).

  2. Locate and Stop the Druva-EnterpriseWorkloads service wrapper.

  3. Access the file system tracking paths using File Explorer or a terminal interface:

    C:\ProgramData\Druva\EnterpriseWorkloads\
  4. Open the Config.yaml core definition manifest in an text editor (e.g., Notepad) leveraging elevated Administrator permissions.

  5. Locate the variable string attribute labeled service_port and modify its value to match the open port determined during Step 2.

    service_port: 8083
  6. Save your edits and close out of the text editor workspace.

  7. Return back to the Windows Services applet (services.msc) and Start the Druva-EnterpriseWorkloads service.

Step 4: Re-Run Agent Activation

Relaunch the registration process through the administrator shell framework using your designated organizational token string:

EnterpriseWorkloadsAgent.exe fs activate --token <your_activation_token>

The activation wrapper will successfully initialize, bind correctly to the altered local port endpoint, and the server instance will cleanly surface within your Druva Management Console interface.

Did this answer your question?