Skip to content

feat(ckpt): expose validate_access_integrity knob on dist-ckpt load - #4422

Merged
asolergi-nv merged 7 commits into
NVIDIA:mainfrom
asolergi-nv:expose_knob
Apr 25, 2026
Merged

feat(ckpt): expose validate_access_integrity knob on dist-ckpt load#4422
asolergi-nv merged 7 commits into
NVIDIA:mainfrom
asolergi-nv:expose_knob

Conversation

@asolergi-nv

Copy link
Copy Markdown
Contributor

What does this PR do ?

Expose validate_access_integrity on the distributed-checkpoint load path via a new --no-ckpt-load-validate-sharding-integrity CLI flag, so users can opt out of the shard access integrity check when loading. Default preserves the previous hardcoded behavior (True).

Details

  • megatron/training/checkpointing.py::_load_global_dist_base_checkpoint previously called dist_checkpointing.load(...) without forwarding validate_access_integrity, effectively hardcoding it to the serialization.py default (True). The save path already exposes the equivalent toggle via args.ckpt_assume_constant_structure (validate_sharding_integrity), so this restores symmetry between save and load.
  • Added CheckpointConfig.ckpt_load_validate_sharding_integrity: bool = True. The existing ArgumentGroupFactory auto-generates --no-ckpt-load-validate-sharding-integrity / --disable-ckpt-load-validate-sharding-integrity for a bool field defaulting to True, which is the intended opt-out UX.
  • Forwarded the new arg into dist_checkpointing.load(...).

No behavior change with default flags.

Contribution process

Pre-checks

  • I have added relevant unit tests
  • I have added relevant functional tests
  • I have added proper typing to my code Typing guidelines
  • I have added relevant documentation
  • I have run the autoformatter.sh on my PR

The training load path in `_load_global_dist_base_checkpoint` invoked
`dist_checkpointing.load(...)` without forwarding `validate_access_integrity`,
effectively hardcoding it to the default `True`. The save path already
exposes the equivalent toggle through `args.ckpt_assume_constant_structure`,
so this restores symmetry.

Add a new CheckpointConfig field `ckpt_load_validate_sharding_integrity`
(default `True`, matching prior behavior) which the argument factory turns
into `--no-ckpt-load-validate-sharding-integrity`, and forward it to
`dist_checkpointing.load`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@copy-pr-bot

copy-pr-bot Bot commented Apr 22, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@asolergi-nv
asolergi-nv marked this pull request as ready for review April 22, 2026 13:14
@asolergi-nv
asolergi-nv requested review from a team as code owners April 22, 2026 13:14
@svcnvidia-nemo-ci svcnvidia-nemo-ci added the Approved All necessary approvals have been made label Apr 24, 2026
@asolergi-nv

Copy link
Copy Markdown
Contributor Author

/ok to test 81b024b

@asolergi-nv

Copy link
Copy Markdown
Contributor Author

/ok to test 6afe4d9

@asolergi-nv
asolergi-nv added this pull request to the merge queue Apr 24, 2026
@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/24912906725

@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/24914629181

@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/24916866735

Merged via the queue into NVIDIA:main with commit 377af02 Apr 25, 2026
67 of 68 checks passed
@asolergi-nv
asolergi-nv deleted the expose_knob branch April 25, 2026 00:41
yangbofun pushed a commit to xlm-research/Megatron-LM that referenced this pull request May 22, 2026
…VIDIA#4422)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
yhgalaxy pushed a commit to yhgalaxy/Megatron-LM that referenced this pull request Jun 17, 2026
…VIDIA#4422)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: yhgalaxy <yhgalaxy@outlook.com>
jon-barker pushed a commit to jon-barker/Megatron-LM that referenced this pull request Jul 10, 2026
…VIDIA#4422)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Jon Barker <jbarker@aws-cmh-slurm-1-vscode-02.cm.cluster>
terminator123 pushed a commit to 021ai/Megatron-LM that referenced this pull request Aug 3, 2026
…VIDIA#4422)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Approved All necessary approvals have been made complexity: low

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants