Edge Delta on Windows

Installing the Edge Delta Pipeline on Windows.

  4 minute read  

Edge Delta uses 64-bit or 32-bit MSI installation process.

Note: not all version 3 features are available on a Windows installation. You can install v2 agents.

Install a Pipeline

Select the Windows template option in the following steps:

  1. Click Pipelines.
  2. Click New Pipeline.
  3. Select Edge.
  4. Select the appropriate environment template.
  5. Specify a name to identify the pipeline.
  6. Click Generate Deployment Command.
  7. Execute the installation commands, they include the unique ID for the pipeline.
  8. Click View Pipeline.
  9. Click View Sources Found and select the sources you want to monitor.
  10. Click Add Sources.

Permissions

Note you may need to use elevated permissions:

  1. Right click the Windows button
  2. Select Windows PowerShell (Admin). Alternatively:
  3. Click the Windows button and search for PowerShell
  4. Right-click on PowerShell.
  5. Select Run as administrator.

The windows installation command for the Edge Delta pipeline performs the following functions:

  • Uninstalls any existing Edge Delta products.
  • Downloads the latest Edge Delta pipeline MSI installer.
  • Installs the pipeline using the provided Pipeline ID with no user interaction.

Upgrade the Pipeline

To upgrade the pipeline, you run the installation steps again.

Uninstall

You can uninstall the pipeline using PowerShell:

(Get-WmiObject -Query "SELECT * FROM Win32_Product WHERE Name like 'Edge Delta%'").uninstall()

Troubleshoot Windows Installations

Check for Elevated Permissions

You require elevated permissions to install the Edge Delta pipeline. Verify Administrator Rights:

  1. Right-click on PowerShell.
  2. Select Run as administrator.
  3. Confirm elevated permissions:
[bool]([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

The command should return True if you have elevated permissions.

Ensure the Edge Delta Pipeline is Running

Using tasklist: Run the following command in PowerShell to check if the Edge Delta pipeline process is running:

tasklist | findstr /i "edgedelta"

Look for the edgedelta process in the output.

Using Task Manager:

  1. Open Task Manager (Ctrl + Shift + Esc).
  2. Go to the Processes tab.
  3. Look for the Edge Delta process.

Check for Windows Event Logs

When setting up observability for a Windows system, the pipeline collects and sends Windows Event Logs to the observability platform. However, if the host system isn’t generating new events, the pipeline will have no data to collect.

  1. Press Win + R to open the Run dialog and enter
eventvwr
  1. Navigate to different event log categories such as Windows Logs - Application, Security, System, etc. Ensure that new events are being recorded. Look for recent entries with timestamps indicating ongoing activity.
  2. Generating Test Events if the logs seem inactive:
  • System Log: Disable and re-enable a network adapter. This should generate system events.
  • Application Log: Open and close various applications, which should generate application-specific events.
  • Security Log: Login and logout, or run the command gpupdate in Command Prompt to generate security-related events.
  1. Recheck the Event Viewer to confirm that new events are created.

View Pipeline Logs

Log File Path:

  1. Identify the log file path for the Edge Delta pipeline. The default should be
C:\Program Files\EdgeDelta\edgedelta.log
  1. Open the log file using a text editor like Notepad:
notepad "C:\Program Files\EdgeDelta\edgedelta.log"

Review the log for any errors or warnings.

Verify the Pipeline Health in the Edge Delta UI

  1. Login to Edge Delta
  2. Click Pipelines - Dashboard
  3. Select the pipeline and click Agents
  4. Check that there is a Processing Agent, a Compactor Agent,and at least one Rollup Agent.
  5. Check that each agent has a healthy flag.

Validate Pipeline ID Configuration

Check Registry Settings:

  1. Open Registry Editor.
regedit
  1. Navigate to the location where Edge Delta stores its configurations: HKEY_LOCAL_MACHINE\SOFTWARE\Edge Delta.
  2. Verify the Pipeline ID is correctly configured:
HKEY_LOCAL_MACHINE\SOFTWARE\Edge Delta\APIKEY

The value should match the Pipeline ID provided during installation.

Check Network Connectivity

Verify Internet Connectivity:

  1. Open PowerShell and try pinging a reliable server:
ping www.google.com

Ensure you receive replies indicating active internet connectivity. 2. Check the connection to Edge Delta:

ping release.edgedelta.com

Ensure you receive responses.

Update or Reinstall the Pipeline

  1. Open PowerShell with elevated permissions.
  2. Uninstall the old pipeline:
Get-WmiObject -Query "SELECT * FROM Win32_Product WHERE Name like 'Edge Delta%'" | ForEach-Object { $_.Uninstall() }
  1. Follow the installation steps to download and install the latest Edge Delta pipeline MSI package.

Contact Support

If these steps do not resolve the issue, gather the necessary logs and details about the system’s configuration and contact support for further assistance.