Error Reference

Look up Federation exceptions, error classes, and common failure scenarios with resolutions.

This reference lists Federation-related exceptions, error classes, and common failure scenarios.

Exception Hierarchy

All RTFS exceptions extend ArtifactoryFederationException.

Field	Type	Description
`internalMessage`	String	Detailed message for internal logs
`publicMessage`	String	User-facing message returned via API
`status`	int	HTTP status code (varies by exception type)

Federation operations throw these exception classes for common failure types.

Exception	Category	Description
`SyncException`	Sync	General synchronization failure
`MembersManagementException`	Member mgmt	Add/remove/update member errors
`MemberStateException`	Member mgmt	Member state transition error
`FederationPrioritizationException`	Priority	Priority configuration or limit error
`TokenExchangeException`	Authentication	Failure exchanging master token
`BinariesTasksException`	Infrastructure	Binary task processing failure
`MasterTokenNotFoundException`	Authentication	Master token not found during authentication
`JpdResolveException`	Infrastructure	Failure resolving JPD address

Use the following scenarios to troubleshoot common Federation errors.

Scenario	Likely exception	Likely cause	Suggested resolution
Member unreachable	`SyncException`	Network, DNS, firewall	Validate connectivity and member URL reachability
Priority limit exceeded	`FederationPrioritizationException`	Too many HIGH/URGENT repositories	Reduce prioritized repositories or tune limits
Full Sync stuck	`SyncException`	Large repository or slow I/O	Check Full Sync phase, monitor queue health, tune Full Sync settings
JPD resolution failure	`JpdResolveException`	Incorrect JPD address or DNS	Verify JPD URLs and DNS resolution
Token exchange failed	`TokenExchangeException`	Stale or invalid trust/token setup	Re-establish trust, refresh tokens
Mirror not found	Heartbeat `MIRROR_NOT_FOUND`	Missing remote repository	Verify remote repository exists and key matches
Version conflict	Heartbeat `VERSION_CONFLICT`	Incompatible member versions	Align versions or verify multi-version compatibility