General Troubleshooting - Java Agent running on Linux



Gather Logs

  1. Run the vFunction Script to Gather Logs
Root / Sudo Installation
bash /opt/vfunction/controller-installation/collect-logs.sh
Sudoless Installation

Find-and-replace $BASE_DIRECTORY with the location of the vFunction Installation

bash $BASE_DIRECTORY/vfunction/opt/vfunction/controller-installation/collect-logs.sh
  1. Unpack the vFunction logs TGZ created in the /tmp directory
  • Find-and-replace $VERSION with the version of the vFunction Server, such as v3.6.1436
  • Find-and-replace $TIMESTAMP with the current timestamp, such as 20240821143907
cd /tmp
ls -l *.tgz
tar -xvzf v3.6.1436-20240821143907-controller-logs.tgz
  1. Review the vFunction logs and look for errors that give obvious next steps
  2. Send symptoms and logs to support@vfunction.com for additional support

Add Debugging Flags to Java Options

  1. Open the location where the current vFunction Java Options are set
  2. Add the flag to turn the Logging Level to DEBUG
-Dcom.vfunction.logging.level=DEBUG
  1. If an issue with Beans is suspected, add the flag to turn Beans Tracking Level to DEBUG
-Dcom.vfunction.logging.level.beanstracking=DEBUG
  1. If an issue with the DB Tracking is suspected, add the flag to turn the DB Tracking Level to DEBUG
-Dcom.vfunction.logging.level.dbtracking=DEBUG
  1. Restart the Application
  2. Gather Logs
  3. Remove the DEBUG flags