Install - .NET Windows Dynamic Agent started as a Windows Service

.NET Core Compatibility

vFunction supports C# .NET Core version 3.0, 6.0, 7.0, 8.0 applications.

Installation Workflow

  1. Ensure Prerequisites are met
  2. Download the vFunction Windows Controller Installation ZIP
  3. RDP to the Windows Server as the user who runs the Application
  4. Move the Installation ZIP to the location on the Windows Server where vFunction should run
  5. Extract the vFunction Installation Package
  6. Open PowerShell
  7. Add Environment Variables for the vFunction Dynamic Agent and install the Agent
### Replace the $CHANGE_ME values with the Required Configuration Settings. For detailed Settings explanations, see:
### https://kb.vfunction.com/installations/configurable-settings/mono-dynamic-agent/dotnet/windows/#required
### Replace $BASE_DIR with the Windows location where the vFunction Installation ZIP was extracted
powershell -NoProfile -ExecutionPolicy unrestricted -Command "
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_NAME -Value '$CHANGE_ME';
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_HOST -Value '$CHANGE_ME';
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_SERVER_APPLICATION_SERVER_USERNAME -Value '$CHANGE_ME';
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_SERVER_APPLICATION_SERVER_PASSWORD -Value '$CHANGE_ME';
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_SERVER_APPLICATION_NAME -Value '$CHANGE_ME';
New-Item -Path Env:\VF_CONTROLLER_DEFAULT_DOTNET_SERVER_APPLICATION_INCLUDE_CLASSES -Value '$CHANGE_ME';
$BASE_DIR\controller-installation\install.ps1 -instance default-dotnet -scriptMode true"
  1. Open the Windows Server’s Registry Editor
  1. Open the Start Menu
  2. Search for regedit
  3. Launch the Registry Editor
  1. In the left-hand sidebar, expand the folders to get to Application until you get to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\$SERVICE_NAME (where $SERVICE_NAME is relevant to the Application)
  2. Right-click in the white space below the list of Registry Keys for the Service
  3. Select New > Multi-String Value
  4. Replace New Value #1 with Environment
  5. Double-click the new Environment variable to add Value Data entries
  6. Paste the Value Data strings below into the Edit Multi-String Value Data text box
VF_AGENT_CONF_LOCATION=$BASE_DIR\config\agent\instances\default-dotnet\conf.json
CORECLR_PROFILER_PATH_64=$BASE_DIR\agent\vfagent.net.dll
CORECLR_PROFILER_PATH_32=$BASE_DIR\agent\vfagent.net.x86.dll
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={cd7d4b53-96c8-4552-9c11-6e41df8eab8a}
DOTNET_TailCallOpt=0
  1. Click the OK button
  2. Restart the Windows Service
  3. Confirm that the Application comes up and functions as expected. If any issues arise:
  1. Start Learning in the vFunction UI
  2. Validate the vFunction data collectioncollecting data

Updated on 14 Mar 2025