Skip to content

Commit b146677

Browse files
committed
Move checking quota to one page
1 parent b8a8fcb commit b146677

File tree

2 files changed

+45
-47
lines changed

2 files changed

+45
-47
lines changed

_uw-research-computing/check-quota.md

Lines changed: 40 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -10,29 +10,25 @@ guide:
1010
---
1111

1212
The following commands will allow you to monitor the amount of disk
13-
space you are using in your home directory on our (or another) submit node and to determine the
14-
amount of disk space you have been allotted (your quota).
15-
16-
If you also have a `/staging` directory on the HTC system, see our
17-
[staging guide](file-avail-largedata.html#5-checking-your-quota-data-use-and-file-counts) for
18-
details on how to check your quota and usage.
19-
\
20-
The default quota allotment on CHTC submit nodes is 20 GB with a hard
21-
limit of 30 GB (at which point you cannot write more files).\
22-
\
23-
**Note: The CHTC submit nodes are not backed up, so you will want to
13+
space you are using in your home directory on the access point and to determine the
14+
amount of disk space you have been allotted (your quota).
15+
16+
The default quota allotment in your `/home` directory is 20 GB with a hard
17+
limit of 30 GB (at which point you cannot write more files).
18+
19+
**Note: The CHTC access points are not backed up, so you should
2420
copy completed jobs to a secure location as soon as a batch completes,
2521
and then delete them on the submit node in order to make room for future
26-
jobs.** If you need more disk space to run a single batch or concurrent
27-
batches of jobs, please contact us ([Get Help!](get-help.html)). We have multiple ways of dealing with large disk space
28-
requirements to make things easier for you.
22+
jobs.** Disk space provided is intended for *active* calculations only, not permanent storage.
23+
If you need more disk space to run a single batch or concurrent
24+
batches of jobs, please contact us ([Get Help!](get-help.html)). We have multiple ways of dealing with large disk space requirements to make things easier for you.
2925

3026
If you wish to change your quotas, please see [Request a Quota Change](quota-request).
3127

32-
**1. Checking Your User Quota and Usage**
28+
**1. Checking Your `/home` Quota and Usage**
3329
-------------------------------------
3430

35-
From any directory location within your home directory, type
31+
From any directory location within your `/home` directory, use the command
3632
`quota -vs`. See the example below:
3733

3834
```
@@ -43,18 +39,39 @@ Disk quotas for user alice (uid 20384):
4339
```
4440
{:.term}
4541

46-
The output will list your total data usage under `blocks`, your soft
42+
The output will list your total data usage under `space`, your soft
4743
`quota`, and your hard `limit` at which point your jobs will no longer
48-
be allowed to save data. Each of the values given are in 1-kilobyte
44+
be allowed to save data. Each value is given in 1-kilobyte
4945
blocks, so you can divide each number by 1024 to get megabytes (MB), and
50-
again for gigabytes (GB). (It also lists information for ` files`, but
51-
we don\'t typically allocate disk space by file count.)
46+
again for gigabytes (GB). (It also lists information for number of `files`, but
47+
we don't typically allocate disk space in `/home` by file count.)
48+
49+
**2. Checking Your `/staging` Quota and Usage**
50+
------------------------------------------------
51+
Users may have a `/staging` directory, meant for staging large files and data intended for
52+
job submission. See our [Managing Large Data in HTC Jobs](file-avail-largedata) guide for
53+
more information.
54+
55+
To check your `/staging` quota, use the command `get_quotas /staging/username`.
56+
57+
```
58+
[alice@submit]$ get_quotas /staging/alice
59+
Path Quota(GB) Items Disk_Usage(GB) Items_Usage
60+
/staging/alice 20 5 3.18969 5
61+
```
62+
{:.term}
63+
64+
Your `/staging` directory has a disk and item quota. In the example above, the disk quota is
65+
20 GB, and the items quota is 5 items. The current usage is printed in the following columns;
66+
in the example, the user has used 3.19 GB and 5 items.
67+
68+
To request a quota increase, [fill out our quota request form](quota-request).
5269

53-
**2. Checking the Size of Directories and Contents**
70+
**3. Checking the Size of Directories and Contents**
5471
------------------------------------------------
5572

56-
Move to the directory you\'d like to check and type `du` . After several
57-
moments (longer if you\'re directory contents are large), the command
73+
Move to the directory you'd like to check and type `du` . After several
74+
moments (longer if the contents of your directory are large), the command
5875
will add up the sizes of directory contents and output the total size of
5976
each contained directory in units of kilobytes with the total size of
6077
that directory listed last. See the example below:

_uw-research-computing/file-avail-largedata.md

Lines changed: 5 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ familiar with:**
4040
* [A. Transferring Large Input Files](#a-transferring-large-input-files)
4141
* [B. Transferring Large Output Files](#b-transferring-large-output-files)
4242
- [4. Submit Jobs Using Staged Data](#4-submit-jobs-using-staged-data)
43-
- [5. Checking your Quota, Data Use, and File Counts](#5-checking-your-quota-data-use-and-file-counts)
43+
- [5. Related Pages](#5-related-pages)
4444
{% endcapture %}
4545
{% include /components/directory.html title="Table of Contents" %}
4646

@@ -224,27 +224,8 @@ Requirements = (Target.HasCHTCStaging == true)
224224
queue
225225
```
226226

227-
# 5. Checking your Quota, Data Use, and File Counts
227+
# 5. Related Pages
228228

229-
You can use the command `get_quotas` to see what disk
230-
and items quotas are currently set for a given directory path.
231-
This command will also let you see how much disk is in use and how many
232-
items are present in a directory:
233-
234-
```
235-
[username@transfer ~]$ get_quotas /staging/username
236-
```
237-
{:.term}
238-
239-
Alternatively, the `ncdu` command can also be used to see how many
240-
files and directories are contained in a given path:
241-
242-
```
243-
[username@transfer ~]$ ncdu /staging/username
244-
```
245-
{:.term}
246-
247-
When `ncdu` has finished running, the output will give you a total file
248-
count and allow you to navigate between subdirectories for even more
249-
details. Type `q` when you\'re ready to exit the output viewer. More
250-
info here: <https://lintut.com/ncdu-check-disk-usage/>
229+
* [Data Storage Locations on the HTC](htc-job-file-transfer)
230+
* [Check Disk Quota and Usage](check-quota)
231+
* [Request a /staging directory or quota change](quota-request)

0 commit comments

Comments
 (0)