apache/flink · error · IllegalConfigurationException

GPU discovery script ('%s') is not configured.

Error message

GPU discovery script ('%s') is not configured.

What it means

Error "GPU discovery script ('%s') is not configured." thrown in apache/flink.

Source

Thrown at flink-external-resources/flink-external-resource-gpu/src/main/java/org/apache/flink/externalresource/gpu/GPUDriver.java:66

import static org.apache.flink.externalresource.gpu.GPUDriverOptions.DISCOVERY_SCRIPT_PATH;

/**
 * Driver takes the responsibility to discover GPU resources and provide the GPU resource
 * information. It retrieves the GPU information by executing a user-defined discovery script.
 */
class GPUDriver implements ExternalResourceDriver {

    private static final Logger LOG = LoggerFactory.getLogger(GPUDriver.class);

    private static final long DISCOVERY_SCRIPT_TIMEOUT_MS = 10000;

    private final File discoveryScriptFile;
    private final String args;

    GPUDriver(Configuration config) throws Exception {
        final String discoveryScriptPathStr = config.get(DISCOVERY_SCRIPT_PATH);
        if (StringUtils.isNullOrWhitespaceOnly(discoveryScriptPathStr)) {
            throw new IllegalConfigurationException(
                    String.format(
                            "GPU discovery script ('%s') is not configured.",
                            ExternalResourceOptions.genericKeyWithSuffix(
                                    DISCOVERY_SCRIPT_PATH.key())));
        }

        Path discoveryScriptPath = Paths.get(discoveryScriptPathStr);
        if (!discoveryScriptPath.isAbsolute()) {
            discoveryScriptPath =
                    Paths.get(
                            System.getenv().getOrDefault(ConfigConstants.ENV_FLINK_HOME_DIR, "."),
                            discoveryScriptPathStr);
        }
        discoveryScriptFile = discoveryScriptPath.toFile();

        if (!discoveryScriptFile.exists()) {
            throw new FileNotFoundException(
                    String.format(

View on GitHub (pinned to 2f3c205e92)

Solutions

1. Address the cause reported by the error message: GPU discovery script ('the reported value') is not configured.
2. Verify the inputs, configuration values, and classpath/dependency setup related to this operation, then retry.

Example fix

Correct the condition described ("GPU discovery script ('the reported value') is not configured.") and rerun the job or command.

When it happens

Trigger: Triggered at runtime when the operation fails because: GPU discovery script ('the reported value') is not configured.

Common situations: Commonly caused by misconfiguration, missing dependencies or files, unsupported types or operations, or invalid user input leading to: GPU discovery script ('the reported value') is not configured.

AI-assisted analysis of apache/flink@2f3c205e92 (2026-08-14). Data as JSON: /api/errors/fc18f6ddc123aad8. Report an issue: GitHub.