Acceldata
Pulse

Last updated: Nov 12, 2026 06:13 UTC

Configure Custom User ID for FSAnalytics

In Pulse 4.1.8, if the FSAnalytics connector uses a user ID other than the default 1000:1000, it may fail with the following exception:

java.io.IOException: Invalid UID, could not determine effective user

Resolution

  1. Navigate to the users configuration directory:
cd /data01/acceldata/config/users
  1. Create copies of the existing passwd and group files:

cp passwd passwd_fs
cp group group_fs
  1. Edit passwd_fs and group_fs to configure the required user ID and group ID. For example, for UID and GID 1008:
    passwd_fs
hdfs:x:1008:1008::/nonexistent:/bin/bash
  1. group_fs
hdfs:x:1008:
  1. Update the file ownership:
chown 1008:1008 /data01/acceldata/config/users/passwd_fs /data01/acceldata/config/users/group_fs
  1. Navigate to the add-on configuration directory:
cd /data01/acceldata/config/docker/addons
  1. Edit ad-fsanalyticsv2-connector.yml and add the following volume mounts under the existing volumes section:

volumes:
  # Retain existing volume mounts
  - ./config/users/passwd_fs:/etc/passwd
  - ./config/users/group_fs:/etc/group
  1. Restart the ad-fsanalytics_connector service to apply the changes.

Info

For multi-cluster deployments, repeat these steps for each affected cluster. Ensure the configured UID and GID match the values used by the FSAnalytics service.