Install - Java Viper Controller on Windows with Admin Access for Static Analysis
Installation Steps
Take the following steps to install the vFunction Java Controller on a Windows Server with Admin access:
- Ensure Prerequisites are met
- Download the vFunction Controller Windows Installation ZIP from the vFunction Portal
- 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 INSTANCE_NAME and REPLACE_BASE_DIR with the actual values.
REPLACE_BASE_DIR\vfunction\config\installation\instances\INSTANCE_NAME\installation.yaml
- Set the required and optional Configurable Settings
- Open Powershell as an Administrator and unblock the files in the installation directory. Replace REPLACE_BASE_DIR with the actual value.
dir -Path "REPLACE_BASE_DIR" -Recurse | Unblock-File
- In Powershell, run the installation script. Replace the INSTANCE_NAME and REPLACE_BASE_DIR with the actual values.
powershell -NoProfile -ExecutionPolicy unrestricted -Command "REPLACE_BASE_DIR\vfunction\controller-installation\install.ps1 -instance INSTANCE_NAME -viperMode true"
- Configure the JVM 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) |