ecommun / owncloud_ynh

Blame view

sources/core/doc/user/files/quota.html 13.7 KB
edit raw normal view history
d1bafeea1   Kload   [fix] Upgrade to ... 
1
2
3
4
5
6
7
8
9
 
  
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
  
  <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6d9380f96   Cédric Dupont   Update sources OC... 
10
 
      <title>Storage Quota &mdash; ownCloud User Manual 7.0 documentation</title>
d1bafeea1   Kload   [fix] Upgrade to ... 
11
12
13
14
15
16
17
18
19
 
      
      <link rel="stylesheet" href="../_static/style.css" type="text/css" />
      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../_static/style.css" type="text/css" />
      <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
      
      <script type="text/javascript">
        var DOCUMENTATION_OPTIONS = {
          URL_ROOT:    '../',
6d9380f96   Cédric Dupont   Update sources OC... 
20
 
          VERSION:     '7.0',
d1bafeea1   Kload   [fix] Upgrade to ... 
21
22
23
24
25
26
27
28
29
 
          COLLAPSE_INDEX: false,
          FILE_SUFFIX: '.html',
          HAS_SOURCE:  true
        };
      </script>
      <script type="text/javascript" src="../_static/jquery.js"></script>
      <script type="text/javascript" src="../_static/underscore.js"></script>
      <script type="text/javascript" src="../_static/doctools.js"></script>
      <script type="text/javascript" src="../_static/bootstrap.js"></script>
6d9380f96   Cédric Dupont   Update sources OC... 
30
 
      <link rel="top" title="ownCloud User Manual 7.0 documentation" href="../index.html" />
d1bafeea1   Kload   [fix] Upgrade to ... 
31
 
      <link rel="up" title="Files &amp; Synchronization" href="index.html" />
6d9380f96   Cédric Dupont   Update sources OC... 
32
33
 
      <link rel="next" title="Managing Big Files" href="configuring_big_file_upload.html" />
      <link rel="prev" title="Encrypting Files" href="encryption.html" />
d1bafeea1   Kload   [fix] Upgrade to ... 
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
  <script type="text/javascript">
  (function () {
    /**
     * Patch TOC list.
     *
     * Will mutate the underlying span to have a correct ul for nav.
     *
     * @param $span: Span containing nested UL's to mutate.
     * @param minLevel: Starting level for nested lists. (1: global, 2: local).
     */
    var patchToc = function ($ul, minLevel) {
      var findA;
  
      // Find all a "internal" tags, traversing recursively.
      findA = function ($elem, level) {
        var level = level || 0,
          $items = $elem.find("> li > a.internal, > ul, > li > ul");
  
        // Iterate everything in order.
        $items.each(function (index, item) {
          var $item = $(item),
            tag = item.tagName.toLowerCase(),
            pad = 15 + ((level - minLevel) * 10);
  
          if (tag === 'a' && level >= minLevel) {
            // Add to existing padding.
            $item.css('padding-left', pad + "px");
            console.log(level, $item, 'padding-left', pad + "px");
          } else if (tag === 'ul') {
            // Recurse.
            findA($item, level + 1);
          }
        });
      };
  
      console.log("HERE");
      findA($ul);
    };
  
    $(document).ready(function () {
      // Add styling, structure to TOC's.
      $(".dropdown-menu").each(function () {
        $(this).find("ul").each(function (index, item){
          var $item = $(item);
          $item.addClass('unstyled');
        });
        $(this).find("li").each(function () {
          $(this).parent().append(this);
        });
      });
  
      // Patch in level.
      patchToc($("ul.globaltoc"), 2);
      patchToc($("ul.localtoc"), 2);
  
      // Enable dropdown.
      $('.dropdown-toggle').dropdown();
    });
  }());
  </script>
  
    </head>
    <body>
    
  
  <div class="container">
    <div class="content">
      <div class="page-header">
        <h1><a href="../contents.html">ownCloud User Manual</a></h1>
  
      </div>
      
  			<div class="row">
  				<div class="span3">
  					<div class="sidebar">
  						<div class="well">
  							<div class="menu-support-container">
  								<ul id="menu-support" class="menu">
  									<ul>
  										<li><a href="../contents.html">Overview</a></li>
  									</ul>
                    <ul>
6d9380f96   Cédric Dupont   Update sources OC... 
116
 
  <li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 7.0 User Documentation</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
117
118
 
  </ul>
  <ul class="current">
6d9380f96   Cédric Dupont   Update sources OC... 
119
 
  <li class="toctree-l1"><a class="reference internal" href="../whats_new.html">New in ownCloud 7</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
120
121
 
  <li class="toctree-l1"><a class="reference internal" href="../webinterface.html">The ownCloud Web Interface</a></li>
  <li class="toctree-l1 current"><a class="reference internal" href="index.html">Files &amp; Synchronization</a><ul class="current">
6d9380f96   Cédric Dupont   Update sources OC... 
122
123
 
  <li class="toctree-l2"><a class="reference internal" href="filesweb.html">Accessing your Files Using the Web Interface</a></li>
  <li class="toctree-l2"><a class="reference internal" href="files.html">Accessing Files Using WebDAV</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
124
 
  <li class="toctree-l2"><a class="reference internal" href="versioncontrol.html">Version Control</a></li>
6d9380f96   Cédric Dupont   Update sources OC... 
125
126
 
  <li class="toctree-l2"><a class="reference internal" href="server_to_server_using.html">Using Server-to-Server Sharing</a></li>
  <li class="toctree-l2"><a class="reference internal" href="deletedfiles.html">Managing Deleted Files</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
127
 
  <li class="toctree-l2"><a class="reference internal" href="sync.html">Desktop Synchronization</a></li>
6d9380f96   Cédric Dupont   Update sources OC... 
128
 
  <li class="toctree-l2"><a class="reference internal" href="encryption.html">Encrypting Files</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
129
 
  <li class="toctree-l2 current"><a class="current reference internal" href="">Storage Quota</a><ul>
6d9380f96   Cédric Dupont   Update sources OC... 
130
131
 
  <li class="toctree-l3"><a class="reference internal" href="#checking-available-space">Checking Available Space</a></li>
  <li class="toctree-l3"><a class="reference internal" href="#available-space-and-sharing">Available Space and Sharing</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
132
133
134
 
  <li class="toctree-l3"><a class="reference internal" href="#excluded-from-quota">Excluded from quota</a></li>
  </ul>
  </li>
6d9380f96   Cédric Dupont   Update sources OC... 
135
 
  <li class="toctree-l2"><a class="reference internal" href="configuring_big_file_upload.html">Managing Big Files</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
136
137
138
139
140
141
142
 
  </ul>
  </li>
  <li class="toctree-l1"><a class="reference internal" href="../pim/index.html">Contacts &amp; Calendar</a></li>
  <li class="toctree-l1"><a class="reference internal" href="../bookmarks.html">Using the Bookmarks App</a></li>
  <li class="toctree-l1"><a class="reference internal" href="../documents.html">Documents</a></li>
  <li class="toctree-l1"><a class="reference internal" href="../migration.html">User Account Migration</a></li>
  <li class="toctree-l1"><a class="reference internal" href="../userpreferences.html">Changing Preferences</a></li>
6d9380f96   Cédric Dupont   Update sources OC... 
143
 
  <li class="toctree-l1"><a class="reference internal" href="../external_storage/google_drive.html">Configuring External Storage</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
  </ul>
  
  								</ul>
  							</div>
  						</div>
  					</div>
  				</div>
          
  
  				<div class="span9">
  					<div class="page-content">
  						
    <div class="section" id="storage-quota">
  <h1>Storage Quota<a class="headerlink" href="#storage-quota" title="Permalink to this headline">¶</a></h1>
6d9380f96   Cédric Dupont   Update sources OC... 
158
159
160
 
  <p>ownCloud enables you to specify a storage quota for users which is the
  <strong>maximum space</strong> a user is allowed to use for files located in their
  individual home storage.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
161
162
 
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
6d9380f96   Cédric Dupont   Update sources OC... 
163
164
165
166
 
  <p class="last">Quota settings <strong>only apply to actual files</strong>, not application
  metadata. Application metadate consumes an added 10% of space for any given
  user.  When allocating quotas, you must ensure that there is at least 10% more
  space available for each user.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
167
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
 
  <div class="section" id="checking-available-space">
  <h2>Checking Available Space<a class="headerlink" href="#checking-available-space" title="Permalink to this headline">¶</a></h2>
  <p>You can check available space by accessing the &#8220;Personal Settings&#8221; page.  To
  access your personal settings:</p>
  <ol class="arabic simple">
  <li>Click the Personal Settings dropdown menu to the right of the Search field
  in the ownCloud Main User Interface.</li>
  </ol>
  <blockquote>
  <div><div class="figure">
  <img alt="../_images/oc_personal_settings_dropdown.png" src="../_images/oc_personal_settings_dropdown.png" />
  <p class="caption">Personal Settings menu</p>
  </div>
  </div></blockquote>
  <ol class="arabic" start="2">
  <li><dl class="first docutils">
  <dt>Select &#8220;Personal&#8221; from the menu. The Personal Settings window opens.</dt>
  <dd><div class="first last figure">
  <img alt="../_images/oc_personal_settings_window.png" src="../_images/oc_personal_settings_window.png" />
  </div>
  </dd>
  </dl>
  </li>
  </ol>
d1bafeea1   Kload   [fix] Upgrade to ... 
192
193
194
195
 
  <p>The available space of a given user is calculated using the following formula:</p>
  <div class="highlight-python"><div class="highlight"><pre><span class="n">available_space</span> <span class="o">=</span> <span class="nb">min</span><span class="p">(</span><span class="n">quota</span><span class="p">,</span> <span class="n">disk_free_space</span><span class="p">)</span> <span class="o">-</span> <span class="n">used_space</span>
  </pre></div>
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
196
197
198
199
200
201
 
  <p><tt class="docutils literal"><span class="pre">disk_free_space</span></tt> is the space available on the partition on which the home
  storage for a user is located on the server.</p>
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">It is possible that the available space on a partition is less than
  the user quota.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
202
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
203
204
205
 
  <div class="admonition-todo admonition" id="index-0">
  <p class="first admonition-title">Todo</p>
  <p class="last">??So what do we do in that case??</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
206
 
  </div>
d1bafeea1   Kload   [fix] Upgrade to ... 
207
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
208
209
210
211
212
213
214
215
216
217
218
219
220
221
 
  <div class="section" id="available-space-and-sharing">
  <h2>Available Space and Sharing<a class="headerlink" href="#available-space-and-sharing" title="Permalink to this headline">¶</a></h2>
  <p>When sharing files or folders, the space that each file or folder (along with
  the folder contents) uses is counted in the quota for the user who is sharing
  the files or folders.  For example:</p>
  <p><strong>Example: Available Space and Shared Files</strong></p>
  <p>If user &#8216;A&#8217; shares a file with user &#8216;B,&#8217; the size of the file is counted
  against the storage quota for user &#8216;A&#8217;, even if the file is modified or its
  size is increased by user &#8216;B.&#8217;&#8216;</p>
  <p><strong>Example: Available Space and Shared Folders</strong></p>
  <p>If user &#8216;A&#8217; shares a folder with user &#8216;B,&#8217; the size of the folder (along with
  its contents) is counted against the storage quota for user &#8216;A.&#8217;  This means
  that any file that is modified or uploaded by user &#8216;B&#8217; inside of the shared
  folder counts against the storage quota for user &#8216;A.&#8217;</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
222
223
 
  <div class="section" id="resharing">
  <h3>Resharing<a class="headerlink" href="#resharing" title="Permalink to this headline">¶</a></h3>
6d9380f96   Cédric Dupont   Update sources OC... 
224
225
 
  <p>When resharing a file or a directory, the used space is still counted in the
  quota of the owner who shared it initially.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
226
227
228
 
  </div>
  <div class="section" id="public-sharing-with-upload-permission">
  <h3>Public sharing with upload permission<a class="headerlink" href="#public-sharing-with-upload-permission" title="Permalink to this headline">¶</a></h3>
6d9380f96   Cédric Dupont   Update sources OC... 
229
230
231
 
  <p>If user A publicly shares (share with link) a directory D and enables the
  &#8220;public upload&#8221; permission, people with the link will be able to upload files
  into D and their sizes will be counted in user A&#8217;s used space.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
232
233
234
235
236
237
 
  </div>
  </div>
  <div class="section" id="excluded-from-quota">
  <h2>Excluded from quota<a class="headerlink" href="#excluded-from-quota" title="Permalink to this headline">¶</a></h2>
  <div class="section" id="metadata-and-cache">
  <h3>Metadata and cache<a class="headerlink" href="#metadata-and-cache" title="Permalink to this headline">¶</a></h3>
6d9380f96   Cédric Dupont   Update sources OC... 
238
239
240
241
242
243
 
  <p>Application metadata and cached information are excluded from the total used
  space.</p>
  <p>Such data could be thumbnails (icon previews, pictures app), temporary files,
  encryption keys, etc.</p>
  <p>Some apps are also storing information directly in the database (not as files)
  like the <a class="reference internal" href="../pim/calendar.html"><em>calendar</em></a> and <a class="reference internal" href="../pim/contacts.html"><em>contacts</em></a> apps. This data is also excluded from the total used space.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
244
245
246
247
 
  </div>
  <div class="section" id="deleted-files">
  <h3>Deleted files<a class="headerlink" href="#deleted-files" title="Permalink to this headline">¶</a></h3>
  <p>When deleting files, these are moved/copied to the <a class="reference internal" href="deletedfiles.html"><em>trashbin</em></a> at first. These files do not count in the user&#8217;s used space.</p>
6d9380f96   Cédric Dupont   Update sources OC... 
248
249
250
251
 
  <p>For example with a quota of 10 GB, if the user has 4 GB used space and 5 GB in
  the trashbin, they will still see 6 GB free space. If the user uploads 6 GB of
  files at this point, the <a class="reference internal" href="deletedfiles.html"><em>trashbin app</em></a> will discard
  deleted files when necessary to make room for the new files.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
252
253
254
255
 
  </div>
  <div class="section" id="version-control">
  <h3>Version Control<a class="headerlink" href="#version-control" title="Permalink to this headline">¶</a></h3>
  <p>The size of older file versions does not count in the used space.</p>
6d9380f96   Cédric Dupont   Update sources OC... 
256
257
258
259
 
  <p>For example with a quota of 10 GB, if the user has 4 GB used space and 5 GB of
  older file versions, they will still see 6 GB free space. If the user uploads 6
  GB of files at this point, the <a class="reference internal" href="versioncontrol.html"><em>versions app</em></a> will
  discard older versions when necessary to make room for the new files.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
260
261
262
263
 
  <p>See <a class="reference internal" href="versioncontrol.html"><em>Version Control</em></a> for details about the version expiration behavior.</p>
  </div>
  <div class="section" id="encryption">
  <h3>Encryption<a class="headerlink" href="#encryption" title="Permalink to this headline">¶</a></h3>
6d9380f96   Cédric Dupont   Update sources OC... 
264
265
266
 
  <p>When files are <a class="reference internal" href="encryption.html"><em>encrypted</em></a>, they take slightly more physical
  space than the original files. Only the original size will be counted in the
  used space.</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
267
268
269
 
  </div>
  <div class="section" id="external-storage">
  <h3>External storage<a class="headerlink" href="#external-storage" title="Permalink to this headline">¶</a></h3>
6d9380f96   Cédric Dupont   Update sources OC... 
270
271
 
  <p>When mounting external storage, either as administrator or as user, the space
  available on that storage is not taken into account for the user&#8217;s quota.
d1bafeea1   Kload   [fix] Upgrade to ... 
272
273
274
275
276
277
278
279
280
281
282
283
284
285
 
  It is currently not possible to set a quota for external storage.</p>
  </div>
  </div>
  </div>
  
  
  					</div>
  				</div>
  			</div>
      
    </div>
  </div>
    </body>
  </html>