Skip to content

Article gpfs snapshots#1220

Open
iam4tune wants to merge 10 commits into
uabrc:mainfrom
iam4tune:article-gpfs-snapshots
Open

Article gpfs snapshots#1220
iam4tune wants to merge 10 commits into
uabrc:mainfrom
iam4tune:article-gpfs-snapshots

Conversation

@iam4tune

@iam4tune iam4tune commented May 8, 2026

Copy link
Copy Markdown
Contributor

Pull Request

The article explains how users can access their user and project snapshot directories.

Intent

The intent of this article is to guide Cheaha users on how to independently access and restore files using GPFS snapshots. It explains how GPFS snapshots are and how they work. It shows instructions for navigating and retrieving files.

Proposed Changes

Changes to Section Headers

N/A

Changes to Page URLs

N/A

Related or Fixed Issues

Fixes #1143

Accessibility Checklist

I have ensured all of the following for new or changed content:

  • [ X] all images have appropriate alt text. Guidelines
  • [ X] all images with text have sufficient contrast ratio. Checker
  • [ X] all image text is transcribed or described in body text.
  • [ X] all technical terms, jargon, and abbreviations are introduced before they are used.

Style Checklist

I have done all of the following:

  • [ X] searched for other relevant pages and crosslinked from my content to them.
  • [ X] searched for other relevant pages and crosslinked from them to my content.
  • added redirects in mkdocs.yml for any moved headers or pages.
  • defined new technical terms, jargon, and abbreviations in the glossary.
  • searched for existing technical terms, jargon, and abbreviations in the glossary and added crosslinks to them.
  • properly formatted and introduced key branding terms. List here.

@iam4tune iam4tune self-assigned this May 8, 2026
@iam4tune iam4tune added the pr: review PR is ready for review label May 8, 2026
@iam4tune iam4tune added this to the Sprint 26-09 milestone May 8, 2026
@iam4tune iam4tune requested review from Premas and bdu-birhanu May 10, 2026 21:36
@bdu-birhanu

Copy link
Copy Markdown
Contributor

Everything looks good. I followed the steps and found them easy to follow. I also tested this in both the user home and data directories. There is a snapshot available for each, organized in the same format we see under /gpfs/.snapshot.

In addition, by running: cd /home/$USER/.snapshot we can access snapshots of the home directory. The same approach works for /data/user/$USER/ as well.

Let's see whether this would help, or if @mdefende or other teams may want to add more information.

Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
@mdefende

Copy link
Copy Markdown
Member

In addition, by running: cd /home/$USER/.snapshot we can access snapshots of the home directory. The same approach works for /data/user/$USER/ as well.

@bdu-birhanu I didn't know this. Just running ls -a $HOME also doesn't show a .snapshots directory, but it works just like you said. Did you run across this information somewhere or did you just randomly try it yourself? That's very cool

@bdu-birhanu

Copy link
Copy Markdown
Contributor

In addition, by running: cd /home/$USER/.snapshot we can access snapshots of the home directory. The same approach works for /data/user/$USER/ as well.

@bdu-birhanu I didn't know this. Just running ls -a $HOME also doesn't show a .snapshots directory, but it works just like you said. Did you run across this information somewhere or did you just randomly try it yourself? That's very cool

As I wasn't aware of the path you posted today /gpfs/.snapshots/<snapshot_id>/user/home/<username> , for accessing $HOME files, I searched around and found something similar on: https://docs.ycrc.yale.edu/data/backups/. I then tried it randomly, and it worked.

Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated

@bdu-birhanu bdu-birhanu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for addressing and including the discussion. This looks much better! I have a few points below that I wanted to share. We can include them now, or maybe in another issue.

Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
Comment thread docs/data_management/storage/cheaha_storage_gpfs/gpfs_snapshots.md Outdated
@bdu-birhanu bdu-birhanu added pr: changes requested Review complete, needs changes and removed pr: review PR is ready for review labels May 21, 2026
@iam4tune iam4tune added pr: merge PR is ready to merge pr: review PR is ready for review and removed pr: changes requested Review complete, needs changes labels Jun 9, 2026
Updated retention policy for snapshots to specify the retention of the most recent 14 days and the past 4 Saturdays.
@bdu-birhanu bdu-birhanu removed the pr: review PR is ready for review label Jul 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr: merge PR is ready to merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

How to access GPFS snapshots

3 participants