Install - .NET Agent Controller on Windows with no Admin Access for Dynamic Analysis
Installation Steps
Take the following steps to install the vFunction Dotnet Controller on a Windows Server with Admin access:
- Ensure Prerequisites are met
- Download the vFunction Controller Windows Installation ZIP
- Move the Controller ZIP package to the Windows Server
- Extract the ZIP to the desired directory, such as C:\vfunction\
- In a text editor, open the installation.yaml
### Replace the REPLACE_BASE_DIR with the actual value, such as C:\vfunction
### Replace the INSTANCE_NAME with the actual value, such as default-dotnet
REPLACE_BASE_DIR\config\installation\instances\INSTANCE_NAME\installation.yaml
- Set the required and optional Configurable Settings
- Open Powershell as an Administrator and run the following command.
### Replace the REPLACE_BASE_DIR with the actual value, such as C:\vfunction
dir -Path "REPLACE_BASE_DIR" -Recurse | Unblock-File
- In Powershell, run the installation script in Agent Mode
### Replace the REPLACE_BASE_DIR with the actual value, such as C:\vfunction
### Replace the INSTANCE_NAME with the actual value, such as default-dotnet
powershell -NoProfile -ExecutionPolicy unrestricted -Command "REPLACE_BASE_DIR\vfunction\controller-installation\install.ps1 -instance INSTANCE_NAME -agentMode true -runAsServices false"
- Configure the CLR Startup Parameters for the vFunction Agent
- Restart the Application
Optional flags that can be used in the install.ps1 script
| Flag | Purpose |
|---|---|
| -instance | Used to input the Instance Name as a String following the flag |
| -serverUsername | Used to input the server-installation.yaml’s server.admin.email address to create the vFunction App in the Server UI from the Controller |
| -serverPassword | Used to input the server-installation.yaml’s server.admin.password to create the vFunction App in the Server UI from the Controller |
| -agentMode | Used when installing the vFunction Agent but not Viper |
| -viperMode | Used when installing Viper but not the vFunction Agent |
| -scriptMode | Used to run the installation in script mode so that all no user prompts are displayed and console output is minimized |
| -runAsServices | Used to define whether the installation should run in Admin-mode (Services true) or User-mode (Services false) |