juicedata/juicefs · error

mount %s: %s

Error message

mount %s: %s

What it means

The gfapi Volume.Mount call failed for a gluster volume after successful Init and logging setup. Indicates the client could not establish a native gluster connection to the volume — commonly due to unreachable hosts, the volume not being started, or gluster authentication errors.

Source

Thrown at pkg/object/gluster.go:338

	}
	for i := range ostore.vols {
		v := &gfapi.Volume{}
		// TODO: support port in host
		err = v.Init(name, hosts...)
		if err != nil {
			return nil, fmt.Errorf("init %s: %s", name, err)
		}
		if logPath == "" {
			err = v.SetLogging(fmt.Sprintf("/var/log/glusterfs/%s-%s-%d-%d.log", hosts[0], name, pid, i), level)
		} else {
			err = v.SetLogging(logPath, level)
		}
		if err != nil {
			logger.Warnf("Set gluster logging for vol %s: %s", name, err)
		}
		err = v.Mount()
		if err != nil {
			return nil, fmt.Errorf("mount %s: %s", name, err)
		}
		ostore.vols[i] = v
	}
	return &ostore, nil
}

func init() {
	Register("gluster", newGluster)
}

View on GitHub (pinned to c9a67b23e8)

Solutions

1. Check gluster volume status and start it if stopped
2. Look at gluster client logs for mount rejection reasons

When it happens

Trigger: Thrown at pkg/object/gluster.go:338 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of juicedata/juicefs@c9a67b23e8 (2026-09-06). Data as JSON: /api/errors/a326bb66e4d71ee8. Report an issue: GitHub.