Installation - Startup Parameters forJava Agent on a Jeus Application Server

Jetty Compatibility

vFunction supports Jeus version 8 and later.

Installation Workflow

  1. Install the Dynamic Analysis Controller
  2. Open the vFunction Agent Startup Parameters in a text editor

    ### Replace the INSTANCE_NAME with the actual value

    less etc/sysconfig/vfunction/agent/instances/INSTANCE_NAME/vmargs-examples/jeus
  3. In the Jeus WebAdmin Console, click Servers from the left menu
  4. Select a server from the server list and go to the server configuration screen
  5. Click the Basic tab in the configuration screen
  6. Click Lock & Edit at the bottom of the left menu to switch to dynamic configuration mode
  7. Copy-and-paste the vFunction Agent Startup Parameters from the VFUN_OPTS into the Jvm Option setting and then click OK
  8. Click Apply Changes
  9. Restart the Jeus instance
  10. Confirm that the Application comes up and functions as expected
  11. If any issues arise:

Sample contents of vmargs-example/jeus 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 exists in the Installation TGZ in /opt/vfunction/controller-installation/stuff/agent/vmargs-examples/java/websphere. Once the install.sh script is run, the relevant placeholder fields are replaced in the version of the environmentally-specific file in /etc/sysconfig/vfunction/agent/instances/INSTANCE_NAME/websphere.

Sudo Installation Sample
# vFunction stuff inside to put inside jeus/script/env.sh

VFUN_OPTS="-agentpath:REPLACE_BASE_DIR/opt/vfunction/agent/libJVMTIAgent.so -javaagent:REPLACE_BASE_DIR/opt/vfunction/agent/runtime-agent.jar REPLACE_EXTRA_JVM -Dcom.vfunction.instance=REPLACE_INSTANCE"

export JAVA_VM_PROPERTIES="$VFUN_OPTS $JAVA_VM_PROPERTIES"
Sudoless Installation Sample
# vFunction stuff inside to put inside jeus/script/env.sh

VFUN_OPTS="-agentpath:REPLACE_BASE_DIR/opt/vfunction/agent/libJVMTIAgent.so=conf=REPLACE_BASE_DIR/etc/sysconfig/vfunction/agent/instances/REPLACE_INSTANCE/native-conf.json -javaagent:REPLACE_BASE_DIR/opt/vfunction/agent/runtime-agent.jar=ConfigLocation=REPLACE_BASE_DIR/etc/sysconfig/vfunction/agent/instances/REPLACE_INSTANCE/vfunction-runtime-override.properties REPLACE_EXTRA_JVM -Dcom.vfunction.runtime.shared.folder=REPLACE_BASE_DIR/opt/vfunction/controller/instances/REPLACE_INSTANCE/temp/ -Dcom.vfunction.runtime.offload.tmpFolder=REPLACE_BASE_DIR/opt/vfunction/agent/instances/REPLACE_INSTANCE/temp/ -Dcom.vfunction.logging.logFile=REPLACE_BASE_DIR/var/log/vfunction/instances/REPLACE_INSTANCE/vfagent.log"

export JAVA_VM_PROPERTIES="$VFUN_OPTS $JAVA_VM_PROPERTIES"

Updated on 02 Feb 2024