Install - Java Agent Controller on Linux VM with Sudoless Access for Dynamic Analysis



Installation Steps

  1. Ensure Prerequisites are met
  2. Download the vFunction Sudoless Controller Installation TGZ
  3. Move the Installation TGZ to the location on the Linux VM where vFunction should run
  4. Extract the vFunction Installation Package
### Replace VERSION with the actual value

tar xvf vfunction-controller-sudo-less-installation.vVERSION.tgz
  1. Open the installation.yaml
### Replace the REPLACE_BASE_DIR with the actual value, such as /tmp/vfunction/
### Replace the INSTANCE_NAME with the actual value, such as default-java

vi REPLACE_BASE_DIR/etc/sysconfig/vfunction/installation/instances/INSTANCE_NAME/installation.yaml
  1. Modify the Configurable Settings
  2. Run the installation script
### Replace the REPLACE_BASE_DIR with the actual value, such as /tmp/vfunction/
### Replace the INSTANCE_NAME with the actual value, such as default-java

bash REPLACE_BASE_DIR/opt/vfunction/controller-installation/install.sh -i INSTANCE_NAME -a
  1. Configure the JVM Startup Parameters for the vFunction Agent
  2. Restart the application

Optional flags that can be used in the install.sh script

Flag Full Command Purpose
-i –instance Used to input the Instance Name as a String following the flag
-u –server-username Used to input the server-installation.yaml’s server.admin.email address to create the vFunction App in the Server UI from the Controller
-p –server-password Used to input the server-installation.yaml’s server.admin.password to create the vFunction App in the Server UI from the Controller
-s –script-mode Used to run the installation in script mode so that all no user prompts are displayed and console output is minimized
-n –no-services Used to install but not start the vFunction services
-v –viper-mode Used when installed Viper but not the vFunction Agent
-a –agent-mode Used when installing the vFunction Agent but not Viper