OSG Connect provides two locations for uploading files (data and software) that are needed for running jobs:

home: /home/<username>          (general storage from which ALL jobs should be submitted)
public: /public/<username>      (only for large job input and output using `http` or `stashcp`)

In general, OSG Connect users are responsible for managing data in these folders and for using appropriate mechanisms for delivering data to/from jobs, as detailed below. Each is controlled with a quota and should be treated as temporary storage for active job execution. OSG Connect has no routine backup of data in these locations, and users should remove old data after jobs complete, in part, to make room for future submissions. If you think you'll need more space for a set of concurrently-queued jobs, even after cleaning up old data, please send a request to support@opensciencegrid.org!

For additional data information, see also the "Data Storage and Transfer" section of our FAQ.

Note: OSG Connect staff reserve the right to monitor and/or remove data without notice to the user IF doing so is necessary for ensuring proper use or to quickly fix a performance or security issue.

Data Locations and Quotas

Your OSG Connect account includes access to two data storage locations: /home and /public. Where you store your files and how your files are made accessible to your jobs depends on the size of the file and how much data is needed or produced by your jobs.

Location Storage Needs Network mounted Backed Up? Initial Quota
/home Storage of submit files, input files <100MB each, and per-job output
up to a 1GB. Jobs should ONLY be submitted from this folder.
No No 50 GB
/public Staging ONLY for large input files (100MB-50GB, each) for publicly-accessible
download into jobs (using HTTP or stashcp, see below) and large output files (1-10GB).
Yes No 500 GB

Your quota status will be displayed when you connect to your OSG Connect login node:

Disk utilization for alice:
/public   : [                        ] 0% (0/500000 MB)
/home     : [ #                      ] 4% (2147/53687 MB)

You can also display your quota usage at any time using the command quota while connected to your login node.

Don't hesitate to contact us at support@opensciencegrid.org if you think you need a quota increase! We can support very large amounts of data.

/home Usage And Policies

User directories within /home are meant for general-use storage of your files needed for job submission. The initial quota per user is 50 GBs.

ALL JOBS MUST BE SUBMITTED FROM WITHIN /home. Users are also prohibited from making their /home directory world-readable due to security concerns. See Policies for Using OSG via OSG Connect Submit Servers for more details.

If you're unable to submit jobs or your jobs are going on hold because you've reached your /home quota, please contact us at support@opensciencegrid.org about a quota increase.

/public Usage and Policies

User directories within /public are meant ONLY for staging job files too large for HTCondor file transfer (input greater than 100MB, output greater than 1GB).

JOBS MUST NEVER BE SUBMITTED FROM WITHIN /public, and should not list /public files in the transfer_input_files line of a submit file, unless as an HTTP address (see more details below). Files place in /public should only be accessed by jobs using the below tools (see Transferring Data To/From Jobs). Users violating these policies may lose the ability to submit jobs until their submissions are corrected.

The initial disk quota of /public is 500 GBs. Contact support@opensciencegrid.org if you will need an increase for concurrently running work, after cleaning up all data from past jobs. Given that users should not be storing long-term data (like submit files, software, etc.) in /public, files and directories that have not been accessed for over six months may be deleted by OSG Connect staff with or without notifying the user.

Files placed within a user's /public directory are publicly accessible, discoverable and readable by anyone. Data is made public via http/https or stash, and mirrored to /cvmfs/stash.osgstorage.org/osgconnect/public which is available on a large number of systems around the world.

Is there any support for private data?

If you do not want your data to be downloadable by anyone, and it's small enough for HTCondor file transfer, then it should be staged in your /home directory and transferred to jobs with HTCondor file transfer (transfer_input_files in the submit file). If it cannot be public (cannot use http or stash for job delivery), and is too large for HTCondor file transfer, then it's not a good fit for the open environment of the Open Science Grid, and another resource will likely be more appropriate. As a reminder, if the data is not being used for active computing work on OSG Connect, it should not be stored on OSG Connect systems, and our data storage locations are not backed up or suitable for project-duration storage.

External Data Transfer to/from OSG Connect Login Nodes

The following tools should be used to upload data from your computer to the OSG Connect login node, or to download files from the OSG Connect login node.

Data Size Tools More Info
UNIX tools < 1 GB rsync, scp, Putty, WinSCP, gFTP, etc. SCP

Transferring Data To/From Jobs

Transferring Input Data to Jobs

This table summarizes the options for sending input files from the OSG Connect login node to the execution node where a job is running. This assumes that you have already uploaded these input files from your own computer to your OSG Connect login node.

Transfer Method File Sizes File Location Command More Info
File Transfer
<100 MB;
<500 MB total per job
/home transfer_input_files HTCondor File Transfer
/public or
non-OSG web server
http address in transfer_input_files HTTP Access
<10 GB per job
/public stash address in transfer_input_files StashCache
GridFTP > 10 GB /public gfal-copy contact us

Transferring Output Data from Jobs

This table summarizes a job's options for returning output files generated by the job back to the OSG Connect login node.

Transfer Method File Sizes Transfer To Command More Info
HTCondor File Transfer < 1 GB /home HTCondor default output transfer or transfer_output_files HTCondor Transfer
StashCache >1GB and
< 10 GB
/public stashcp in job executable StashCache
GridFTP > 10 GB /public gfal-copy contact us

Watch this video from the 2021 OSG Virtual School for more information about Handling Data on OSG:

Get Help

For assistance or questions, please email the OSG User Support team at support@opensciencegrid.org or visit the help desk and community forums.


This page was updated on Nov 30, 2021 at 19:04 from start/data/osgconnect-storage.md.