Skip to main content

General

When working with Fusion, you might encounter the following issues.

Common issues

Too many open files

Tasks fail with an error about too many open files.

This issue occurs when the default file descriptor limit is too low for the container workload.

To resolve, increase the ulimit for the container. Append the following to your Nextflow configuration:

process.containerOptions = '--ulimit nofile=1048576:1048576'

Exit code 143 on Kubernetes

When a task fails with exit code 143, pipelines halt instead of retrying the affected task.

Exit code 143 indicates the container received SIGTERM and shut down gracefully. On Kubernetes this most commonly signals Spot instance reclamation.

To retry tasks that exit with 143, configure an errorStrategy in your Nextflow configuration:

process {
maxRetries = 3
errorStrategy = { task.exitStatus == 143 ? 'retry' : 'terminate' }
}

See errorStrategy for more configuration options.

A task reads incomplete data written by a Studio session

A task fails when it reads a Fusion-mounted path that a running Studio session wrote to. The files exist but are 0 bytes, or the directory appears empty.

This issue occurs because Fusion uploads data to object storage in chunks and consolidates those chunks into a complete object only when the Fusion instance that wrote them shuts down. For a Studio session, that happens when the session stops. Separate Fusion instances also do not share a live view of each other's in-progress writes.

To resolve, stop the Studio session and wait for its status to change to stopped before you launch the run. To avoid the problem, upload data for a pipeline with Data Explorer or the Seqera Platform CLI (tw) instead of writing it from a running session.

See Data written by a running session is not visible to pipeline runs for the Studios troubleshooting entry.

Jobs stay pending with CODE_GCE_QUOTA_EXCEEDED

On Google Cloud Batch, jobs stay pending and Nextflow logs a Batch job cannot be run warning containing CODE_GCE_QUOTA_EXCEEDED.

This issue occurs when the local SSD capacity a run requests exceeds your Google Cloud quota, which is capped per project, per region, and per machine family.

To resolve, open IAM & Admin > Quotas & System Limits in the Google Cloud console, filter for Local SSD per machine family (GB) (LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY), and submit a new value. To avoid the quota, request a persistent disk instead, which draws on a separate quota:

process {
disk = [request: 100.GB, type: 'pd-balanced']
}

See Scratch disk to choose a disk type.

On this Page