t8y2/dbx · error

read Cassandra configfile %s: %w

Error message

read Cassandra configfile %s: %w

What it means

Wraps an os.Stat failure (other than not-exist) when checking the Cassandra config file. The path resolved fine but could not be stat'ed — typically a permission problem or an I/O error, not a missing file (missing files are silently ignored by design).

Source

Thrown at agents/drivers/cassandra-go/config_file.go:33

	"github.com/gurkankaymak/hocon"
)

const javaDriverConfigPrefix = "datastax-java-driver."

func applyCassandraConfigFile(config *cassandraConfig, rawPath string) error {
	path, err := normalizeLocalFilePath(rawPath)
	if err != nil {
		return fmt.Errorf("invalid Cassandra configfile: %w", err)
	}
	if path == "" {
		return nil
	}
	info, err := os.Stat(path)
	if err != nil {
		if errors.Is(err, os.ErrNotExist) {
			return nil
		}
		return fmt.Errorf("read Cassandra configfile %s: %w", path, err)
	}
	if !info.Mode().IsRegular() {
		return fmt.Errorf("Cassandra configfile is not a regular file: %s", path)
	}
	parsed, err := hocon.ParseResource(path)
	if err != nil {
		return fmt.Errorf("parse Cassandra configfile %s: %w", path, err)
	}
	config.configFile = path
	if err := applyJavaDriverHOCON(config, parsed); err != nil {
		return fmt.Errorf("apply Cassandra configfile %s: %w", path, err)
	}
	return nil
}

func applyJavaDriverHOCON(config *cassandraConfig, parsed *hocon.Config) error {
	if value, ok, err := hoconDuration(parsed, javaDriverConfigPrefix+"basic.request.timeout"); err != nil {
		return err

View on GitHub (pinned to c0390bff16)

Solutions

1. Fix filesystem permissions (chmod/chown) so the process user can stat the file and traverse its directories
2. Verify the mount/volume is present in the container (kubectl exec + ls -la)
3. Check SELinux/AppArmor denials if permissions look correct
4. If the file is optional, ensure the wrapper environment grants at least search permission on parent dirs

Example fix

// before
# /etc/odigos/cassandra.conf mode 0600 owned by root, agent runs as uid 10001
// after
chmod 0644 /etc/odigos/cassandra.conf && chown 10001 /etc/odigos/cassandra.conf

if _, err := os.Stat(cfg.ConfigFile); err != nil {
    if !errors.Is(err, os.ErrNotExist) {
        return fmt.Errorf("configfile %s not accessible: %w (check permissions/mount)", cfg.ConfigFile, err)
    }
}

func configFileAccessible(p string) bool {
    _, err := os.Stat(p)
    return err == nil || errors.Is(err, os.ErrNotExist)
}

_, err := os.Stat(path)
if err != nil && !errors.Is(err, os.ErrNotExist) {
    return fmt.Errorf("cannot access Cassandra configfile %s: %w", path, err)
}

When it happens

Trigger: configfile points to a path where os.Stat returns a non-ErrNotExist error: permission denied on a parent directory, I/O error, or a broken symlink resolution issue on some filesystems.

Common situations: Container running as non-root user without read access to the mounted config path; Kubernetes secret mounted with restrictive permissions; path inside a directory that is not readable/executable.

Understand the failure class

Background: Permission denied / not authorized / 403 Forbidden: access-control rejections when the caller lacks the required role, grant, or ownership — this error's family across 18 libraries.

Related errors

• load Cassandra secure connect bundle: %w
• invalid Cassandra configfile: %w
• Cassandra configfile is not a regular file: %s
• read Kerberos JAAS config: %w
• read Hive CA certificate: %w

AI-assisted analysis of t8y2/dbx@c0390bff16 (2026-09-05). Data as JSON: /api/errors/20125e1d75ebbeed. Report an issue: GitHub.