After Sudoless Server upgrade, Fluentd Container is unhealthy

Overview of the Issue

This issue occurs in the following circumstances:

  1. A vFunction organization installs the vFunction Docker Sudoless Server
  2. The Fluentd Container is configured to write logs to the **$BASE_DIR/vfunction/var/log/vfunction directory. Ownership of this directory is given to the user who performs the installation
  3. The organization upgrades the vFunction Server using a different sudoless user
  4. Unexpectedly, the Fluentd Container comes up as unhealthy during the upgrade. The following is printed to the Console output
2026-06-16 16:12:15.430 Upgrading fluentd...
2026-06-16 16:12:17.944 Running docker with command: sudo docker run --name vfunction-fluentd -e VFUNCTION_FQDN=vfunction.mycompany.com -e ORG=cvent -e IMAGE_VERSION=v4.6.2035 -e OFFLINE=true -e TZ=UTC -e BASE_DIR=/ -v //var/log/vfunction://var/log/vfunction -p 24224:24224 -p 9880:9880 --restart=unless-stopped --user 1002:1002 --security-opt no-new-privileges --cap-drop=all -d vfunction/vfunction-fluentd-alpine:v4.6.2035
7314bcc72ad7ba6fc72e1973b8d0713eb834e14efc79c0f2e58e0e13e81b6fa9
2026-06-16 16:12:23.743 Waiting for fluentd to start...
2026-06-16 16:12:23.973 vfunction-fluentd: starting
2026-06-16 16:12:34.263 vfunction-fluentd: starting
2026-06-16 16:12:44.494 vfunction-fluentd: starting
2026-06-16 16:12:54.733 vfunction-fluentd: unhealthy

Solution

The following steps can be used to resolve this issue:

  1. SSH to the Linux Host running the vFunction Server
  2. Review the vFunction Server Installation Log for the user who did the original installation
grep 'vfunction-fluentd' $BASE_DIR/vfunction/var/log/vfunction/server-installation.log

### The relevant information is the Userid from this installation line, for example "--user 1002:1002" from below
### 2026-06-16 16:12:17.944 Running docker with command: sudo docker run --name vfunction-fluentd -e VFUNCTION_FQDN=vfunction.mycompany.com -e ORG=cvent -e IMAGE_VERSION=v4.6.2035 -e OFFLINE=true -e TZ=UTC -e BASE_DIR=/ -v //var/log/vfunction://var/log/vfunction -p 24224:24224 -p 9880:9880 --restart=unless-stopped --user 1002:1002 --security-opt no-new-privileges --cap-drop=all -d vfunction/vfunction-fluentd-alpine:v4.6.2035
  1. Find the user who coincides with the Userid
grep '$Userid' /etc/passwd
  1. Switch users to the relevant user
su $User_matching_Userid
  1. Run the vFunction Server Upgrade again
cd $BASE_DIR/vfunction/opt/vfunction/server-installation/
bash upgrade.sh

Updated on 18 Jun 2026