document behavior of deleted shared files

This commit is contained in:
Carla Schroder
2015-04-10 11:36:49 -07:00
parent 669afc789e
commit 7bb73c61a1

View File

@@ -1,66 +1,57 @@
=======================
Deleted File Management
=======================
======================
Managing Deleted Files
======================
ownCloud maintains a copy of deleted files in case you need them again. To
ensure that individual users do not run out of storage space, the Files app manages
the amount of space allocated for deleted files for each user. When it comes to managing
quotas and calculating how much storage you need, keep the following in mind:
When you delete a file in ownCloud, it is not immediately deleted permanently.
Instead, it is moved into the trash bin. It is not permanently deleted until
you manually delete it, or when the Deleted Files app deletes it to make room
for new files.
* The total storage allocation for deleted files can never exceed more that 50%
of the currently available free space for each user.
Find your deleted files by clicking on the **Deleted files**
button on the Files page of the ownCloud Web interface. You'll have options to
either restore or permanently delete files.
* Once the 50% maximum is reached for deleted files, ownCloud begins to delete files,
starting with the oldest versions, until it reaches the storage limit again.
Quotas
------
You can view all of the deleted files by clicking on the :guilabel:`Deleted
files` button in Files app on the web interface.
Deleted files are not counted against your storage quota. Only files that
originate with users count against their quotas, not files
shared with them that originate from other users. (See :doc:`quota` to learn
more about quotas.)
Restoring Files
---------------
What Happens When Shared Files Are Deleted
------------------------------------------
To restore a deleted file:
Deleting files gets a little complicated when they are shared files, as this
scenario illustrates:
1. In the Files app, click the :guilabel:`Deleted files` button.
1. User1 shares a folder "test" with User2 and User3
2. User2 (the recipient) deletes a file/folder "sub" inside of "test"
3. The folder "sub" will be moved to the trashbin of both User1 (owner) and
User2 (recipient)
4. But User3 will not have a copy of "sub" in her trash bin
The Files app shows all deleted files.
When User1 deletes "sub" then it is moved to User1's trash bin. It is
deleted from User2 and User3, but not placed in their trash bins.
.. figure:: ../images/deleted_files.png
When you share files, other users may copy, rename, move, and share them with
other people, just as they can for any computer files; ownCloud does not have
magic powers to prevent this.
**Deleted files**
How the Deleted Files app Manages Storage Space
-----------------------------------------------
2. Hover the cursor over the file that you want to restore.
To ensure that users doesn't run over their storage quotas, the Deleted Files
app allocates a maximum of 50% of their currently available free space to
deleted files. If your deleted files exceed this limit, ownCloud deletes the
oldest files (files with the oldest timestamps from when they were deleted)
until it meets the memory usage limit again.
Task options appear for the file.
3. Click the :guilabel:`Restore` button.
The Files app restores the file to its original location on the server.
Deleting Files
--------------
To permanently delete a file:
1. In the Files app, click the :guilabel:`Deleted files` button.
See the **Deleted files** image above.
2. Hover the cursor over the file that you want to delete.
Task options appear for the file.
3. Click the :guilabel:`Trash can` button.
The Files app permanently removes the file from the server.
Modifying the Deleted File Age-Out Value
----------------------------------------
Each time a file is added to the deleted files directory, ownCloud checks the
age of the deleted files. By default, deleted files remain in the deleted files
directory for 180 days.
The administrator can adjust the age-out value in the ``config.php`` file by setting the
``trashbin_retention_obligation`` value. Files with ages that exceed this value
are deleted permanently.
ownCloud checks the age of deleted files every time new files are added to the
deleted files. By default, deleted files stay in the trash bin for 180 days. The
ownCloud server administrator can adjust this value in the ``config.php`` file
by setting the ``trashbin_retention_obligation`` value. Files older than the
``trashbin_retention_obligation`` value will be deleted permanently.
Additionally, ownCloud calculates the maximum available space every time a new
file is added. If the deleted files exceed the new maximum allowed space
ownCloud will expire old deleted files until the limit is met once again.