Install - .NET Viper Controller on Linux with Sudo / Root Access for Static Analysis
Installation Wizard
To help with the installation process, vFunction offers an Installation Wizard. This Wizard provides additional information about the Prerequisites as well as the Required and Optional Settings for installing the vFunction Server and Agents. This Wizard also walks you through each step in the Installation process.
Please contact support@vfunction.com or your vFunction Contact(s) for the password to start using this Wizard.
Installation Workflow
- Ensure Prerequisites are met
- Download the vFunction Sudo Controller Installation TGZ
- SSH to the Linux VM as the root user or a user with Sudo access
- Move the Installation TGZ to the Linux VM
- Extract the vFunction Installation Package
### Replace VERSION with the actual value
tar -Pxvzf vfunction-controller-installation.vVERSION.tgz
- Create the Viper vFunction instance
sudo bash /opt/vfunction/controller-installation/create-instance.sh -i viperinst -t dotnet -v
Path #1: Use Environment Variables to set the Configurable Settings
- Add Environment Variables for the vFunction Static Agent
# See descriptions in https://kb.vfunction.com/installations/configurable-settings/mono-static-agent/dotnet/linux
export VF_CONTROLLER_VIPERINST_CONTROLLER_NAME="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_HOST="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_ORG_ID="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_APP_ID="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_CLIENT_ID="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_CLIENT_SECRET="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_INSTANCE_ID="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_CONTROLLER_TAGS="CHANGE_ME"
export VF_CONTROLLER_VIPERINST_VIPER_ASSEMBLIES="CHANGE_ME"
### Sample Values
export VF_CONTROLLER_VIPERINST_CONTROLLER_NAME="prod-viper"
export VF_CONTROLLER_VIPERINST_CONTROLLER_HOST="http://172.31.15.51"
export VF_CONTROLLER_VIPERINST_CONTROLLER_ORG_ID="1111-11-11-1111"
export VF_CONTROLLER_VIPERINST_CONTROLLER_APP_ID="1111-11-11-1111"
export VF_CONTROLLER_VIPERINST_CONTROLLER_CLIENT_ID="1111-11-11-1111"
export VF_CONTROLLER_VIPERINST_CONTROLLER_CLIENT_SECRET="1111-11-11-1111"
export VF_CONTROLLER_VIPERINST_CONTROLLER_INSTANCE_ID="viper"
export VF_CONTROLLER_VIPERINST_CONTROLLER_TAGS="prod,qa"
export VF_CONTROLLER_VIPERINST_VIPER_ASSEMBLIES="/app/bin"
Path #2: Use the installation.yaml to set the Configurable Settings
- Edit the /etc/sysconfig/vfunction/installation/instances/viperinst/installation.yaml
controller:
name: qa-viper ### This is an identifier in the VF Server UI to help locate the desired Agent
host: http://127.0.0.0.1 ### This is the VF Server's Address
org_id: 1111-11-11-1111 ### This is taken from the VF Server UI's Installation Instruction dialog box
app_id: 1111-11-11-1111 ### This is taken from the VF Server UI's Installation Instruction dialog box
client_id: 1111-11-11-1111 ### This is taken from the VF Server UI's Installation Instruction dialog box
client_secret: 1111-11-11-1111 ### This is taken from the VF Server UI's Installation Instruction dialog box
type: dotnet
...
viper:
assemblies:
- /opt/dummy ### This is the folder path that contains the DLLs of the Application, such as the Application's bin/ directory
...
- Run the installation script
sudo bash /opt/vfunction/controller-installation/install.sh -i viperinst
- Confirm that the Viper comes up as expected in the vFunction Server UI