Install - .NET Startup Parameters for Framework Agent started on Windows from the Command Line for Dynamic Analysis

.NET Framework Compatibility

vFunction supports C# .NET Framework version 4.x applications.

Installation Workflow

  1. Install the Dynamic Analysis Controller
  2. Open the vFunction Framework Standard-Executables startup parameters in a text editor

    ### Replace the REPLACE_BASE_DIR and INSTANCE_NAME below with the actual values

    REPLACE_BASE_DIR\config\agent\instances\INSTANCE_NAME\vmargs-examples\standard-executables
  3. Open a new, blank document in a text editor
  4. Copy-and-paste either the Batch Script or PowerShell Script section of the vmargs-examples\standard-executables into the new, blank document
  5. Modify the line for 'RunApp.exe' to point to the full path to launch the Application
  6. Save and close the new, blank document. Be sure to use the .bat or .ps1 file extension when saving the document
  7. Launch the .bat or .ps1 script
  8. Confirm that the Application comes up and functions as expected
  9. If any issues arise:

Sample contents of vmargs-example/standard-executables file

If using this sample below, you will need to:

  1. Find-and-replace the REPLACE_BASE_DIR with the value relevant to your vFunction installation
  2. Find-and-replace the REPLACE_INSTANCE with the value relevant to your vFunction installation

This sample file can be found in REPLACE_BASE_DIR\controller-installation\stuff\agent\vmargs-examples\dotnet\framework\standard-executables. Once the install.sh script is run, the relevant placeholder fields are replaced in the version of the environmentally-specific file in REPLACE_BASE_DIR\config\agent\instances\INSTANCE_NAME\vmargs-examples\standard-executables.

Examples:

# bat
set VF_AGENT_CONF_LOCATION=REPLACE_BASE_DIR\config\agent\instances\REPLACE_INSTANCE\conf.json
set COR_PROFILER_PATH_64=REPLACE_BASE_DIR\agent\vfagent.net.dll
set COR_PROFILER_PATH_32=REPLACE_BASE_DIR\agent\vfagent.net.x86.dll
set COR_ENABLE_PROFILING=1
set COR_PROFILER={cd7d4b53-96c8-4552-9c11-6e41df8eab8a}
set COMPlus_TailCallOpt=0
RunApp.exe

# PS
$env:VF_AGENT_CONF_LOCATION='REPLACE_BASE_DIR\config\agent\instances\REPLACE_INSTANCE\conf.json'
$env:COR_PROFILER_PATH_64 = 'REPLACE_BASE_DIR\agent\vfagent.net.dll'
$env:COR_PROFILER_PATH_32 = 'REPLACE_BASE_DIR\agent\vfagent.net.x86.dll'
$env:COR_ENABLE_PROFILING = '1'
$env:COR_PROFILER = '{cd7d4b53-96c8-4552-9c11-6e41df8eab8a}'
$env:COMPlus_TailCallOpt = 0
& 'RunApp.exe'

Updated on 02 Feb 2024