[Pkg-owncloud-commits] [owncloud-doc] 01/12: Update configuring_big_file_upload.rst

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch dfsg_clean
in repository owncloud-doc.

commit 4622fae9e31df070d99e4c8c73fa165096ec2993
Author: dietmaroc <dietmar at owncloud.com>
Date:   Fri Sep 6 12:13:34 2013 +0200

    Update configuring_big_file_upload.rst
---
 .../configuration/configuring_big_file_upload.rst  |   52 +++++++++++++-------
 1 file changed, 35 insertions(+), 17 deletions(-)

diff --git a/admin_manual/configuration/configuring_big_file_upload.rst b/admin_manual/configuration/configuring_big_file_upload.rst
index 42437d8..c7ed49f 100644
--- a/admin_manual/configuration/configuring_big_file_upload.rst
+++ b/admin_manual/configuration/configuring_big_file_upload.rst
@@ -1,23 +1,41 @@
-Big Files
-=========
+Uploading big files > 512MB (as set by default)
+===============================================
+It's usefull to know limiting factors, that make it impossible to exceed the values given to the ownCloud-system:
 
-There are a few default configuration settings that you will want to change to enable ownCloud to operate more effectively as a self hosted file sync and share server. When uploading through the web client, ownCloud is governed by PHP and Apache. As a default, PHP is configured for only 2 MB uploads. This is not entirely useful, so it is important to increase these variables to the sizes you want to support on your server. Point your favorite text editor over to your php.ini file. On dif [...]
+Not outnumberable upload limits:
+--------------------------------
+* < 2GB on 32Bit OS-architecture
+* < 2GB with Server Version 4.5 or older
+* < 2GB with IE6 - IE8
+* < 4GB with IE9 - IE10
 
-- upload_max_filesize = 500 MB
-- post_max_size = 600 MB
+Other recommendable preconditions:
+----------------------------------
 
-The defaults for these values are quite small, so change them to to 500 MB and 600MB, or 1G and 1.2G, for example, and you have adjusted the maximum file size that can be uploaded at one time. Make sure you restart your Apache server after these changes, or it will not take affect! Note: You will want these two values to be about the same size, with post_max_size slightly larger to account for headers in the uploaded files. If you find later that files keep timing out on upload, you may  [...]
+* make sure, that the latest version of php (at least 5.4.9) is installed
+* disable user quota. This means set the User quota of the account, you are currently logged in, to "unlimited". This is important, because you could not watch otherwise, whether the desired changes take effect.
 
-- **upload_max_filesize and post_max_size:** Files are usually POSTed to the webserver in a format known as ‘multipart/form-data’. The post_max_size sets the upper limit on the amount of data that a script can accept in this manner. Ideally this value should be larger than the value that you set for upload_max_filesize It’s important to realize that upload_max_filesize is the sum of the sizes of all the files that you are uploading. post_max_size is the upload_max_filesize plus the sum o [...]
-- **memory_limit:** When the PHP engine is handling an incoming POST it needs to keep some of the incoming data in memory. This directive has any effect only if you have used the –enable-memory-limit option at configuration time. Setting too high a value can be very dangerous because if several uploads are being handled concurrently all available memory will be used up and other unrelated scripts that consume a lot of memory might effect the whole server as well. 
-- **max_execution_time and max_input_time:** These settings define the maximum life time of the script and the time that the script should spend in accepting input. If several mega bytes of data are being transfered max_input_time should be reasonably high. You can override the setting in the ini file for max_input_time by calling the set_time_limit() function in your scripts. 
+Enabling uploading big files
+============================
+Note: The order of the following steps is important! If you swap steps or substeps described below, the settings may fail.
 
-**Additional IIS Server Upload Step** Now you have to go back to IIS manager and make one last change to enable file uploads on the webserver larger than 30MB. 
+**Go to the admin section in the ownCloud-WebUI and do the following:**
 
-- Go to the start menu, and type in ‘iis manager’
-- Open IIS Manager
-- Select the website you want enable to accept large file uploads
-- In the main window in the middle double click on the icon “Request filtering”
-- Once the window is opened you will see a bunch of tabs across the top
-- On the far right, select “Edit Feature Settings” and modify the “Maximum allowed content length (bytes)” In here, you can change this to up to 4.1 GB. Note: this entry is in BYTES, not KB!
-- Click OK and then restart IIS.
+* Under "File handling" set the Maximum upload size to the desired value (e.g. 16GB)
+* Klick the "save"-Button
+
+**Open the php.ini - file**
+
+* Under Debian or Suse and their derivates this file lies at /etc/php5/apache2/php.ini
+* On Windows, you can find this file within C:/Program Files (x86)/PHP/PHP.ini 
+
+**Do the following:**
+
+* Set the following three parameters inside th php.ini to the same value as choosen inside the admin-section one step before:
+* upload_max_filesize = 16G   (e.g.)
+* post_max_size = 16G   (e.g.)
+* output_buffering = 16384
+
+whereas the "output_buffering" has to be given in MegaBytes but as a plain figure (without size-units as 'M' or 'G')
+
+These configurations have been prooven by test up to filesizes of 16 GigaBytes.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git