Reducing disk usage: Difference between revisions

From ULYSSIS documentation
Line 6: Line 6:


== Identifying which files & folders use the most disk space  ==
== Identifying which files & folders use the most disk space  ==
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool '''ncdu''' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>.
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool '''ncdu''' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, a step-by-step guide can be found below. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>.  


* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH
Line 13: Line 13:
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.
* You can check your progress on https://ucc.ulyssis.org/quota
* You can check your progress on https://ucc.ulyssis.org/quota
=== Common sources of unnecessary disk usage ===
* Deleted emails: if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.

Revision as of 00:47, 7 March 2021

This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota .

What happens when I go over my quota?

If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your username@ulyssis.org email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.

Identifying which files & folders use the most disk space

It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool ncdu which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, a step-by-step guide can be found below. However, should you get stuck, do not hesitate to contact us at ulyssis@ulyssis.org.

  • SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH
  • Type in ncdu and press enter. You will then see that ncdu is scanning your account.
  • Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with / it is a folder.
  • You select different files/folders using the up and down arrow keys, navigate the directory structure using the enter and escape keys, quit ncdu by pressing q and delete a file or folder with d. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.
  • You can check your progress on https://ucc.ulyssis.org/quota

Common sources of unnecessary disk usage

  • Deleted emails: if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the Trash folder of your @ulyssis.org email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this Trash folder. You can do this on https://webmail.ulyssis.org or by deleting the folder Maildir/.Trash using ncdu (see previous section).
  • Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.