[Pkg-owncloud-commits] [owncloud-doc] 99/110: update and correct big file upload page

Fri Feb 6 21:10:40 UTC 2015

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

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

commit dd09ddef4968727d61f7d001466a0dea7382d325
Author: Carla Schroder <carla at owncloud.com>
Date:   Wed Jan 28 10:15:52 2015 -0800

    update and correct big file upload page
---
 .../big_file_upload_configuration.rst              | 98 +++++++++++-----------
 1 file changed, 48 insertions(+), 50 deletions(-)

diff --git a/admin_manual/configuration/big_file_upload_configuration.rst b/admin_manual/configuration/big_file_upload_configuration.rst
index 5b4f0a7..8660508 100644
--- a/admin_manual/configuration/big_file_upload_configuration.rst
+++ b/admin_manual/configuration/big_file_upload_configuration.rst
@@ -1,75 +1,73 @@
 Uploading big files > 512MB (as set by default)
 ===============================================
-It's useful to know limiting factors that make it impossible to exceed the 
-values given by the ownCloud-system:
 
-Not outnumberable upload limits:
---------------------------------
+The default maximum file size for uploads is 512MB. You can increase this 
+limit up to what your filesystem and operating system allows. There are certain 
+hard limits that cannot be exceeded:
+
 * < 2GB on 32Bit OS-architecture
 * < 2GB with Server Version 4.5 or older
 * < 2GB with IE6 - IE8
 * < 4GB with IE9 - IE10
 
-Other recommendable preconditions:
-----------------------------------
+64-bit filesystems have much higher limits; consult the documentation for your 
+filesystem.
 
-* 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".
+System Configuration
+--------------------
 
-This is important, because you possibly could not watch otherwise whether the 
-desired changes take effect.
+* Make sure that the latest version of PHP (at least 5.4.9) is installed
+* Disable user quotas, which makes them unlimited
+* Your temp file or partition has to be big enough to hold multiple 
+  parallel uploads from multiple users; e.g. if the max upload size is 10GB and 
+  the average users uploading the same time is 100: temp space has to hold at 
+  least 10x100 GB
 
-.. note:: If you are running ownCloud on a 32-bit system, any open_basedir directive in 
-   your ``php.ini`` file needs to be removed; otherwise you may have problems uploading 
-   large files.
+Configuring Your Webserver
+--------------------------
 
-Enabling uploading big files
-----------------------------
+ownCloud comes with its own ``owncloud/.htaccess`` file. Set the following 
+two parameters inside this ``.htaccess`` file::
 
-**Configuring your webserver**
+ upload_max_filesize = 16G
+ post_max_size = 16G
 
-ownCloud comes with a .htaccess - file which propagates all config to your 
-webserver. To adapt those settings go to the ownCloud - Folder on your server 
-and set the following two parameters inside the .htaccess file:
+Adjust these values for your needs. If you see PHP timeouts in your logfiles, 
+increase the timeout values, which are in seconds::
 
-* ``upload_max_filesize = 16G``   (e.g., to stay consistent with the example 
-  value above)
-* ``post_max_size = 16G``   (e.g., to stay consistent with the example value 
-  above)
+ php_value max_input_time 3600
+ php_value max_execution_time 3600
 
-If you don't want to use the shipped .htaccess - file, outcomment those options 
-there and edit them in your global php.ini file:
+Configuring PHP
+---------------
 
-You can easily learn the loaded configuration file by saving ``<?php phpinfo(); 
-?>`` code piece into a php file and calling it with your browser. Then look for 
-the **Loaded Configuration File** value.
+If you don't want to use the ownCloud ``.htaccess`` file, you may 
+configure PHP instead. Make sure to comment out any lines ``.htaccess`` 
+pertaining to upload size, if you entered any.
 
-Alternatively:
+To view your current PHP configuration and to see the location of your 
+``php.ini`` file, create a plain text file named ``phpinfo.php`` with just this 
+single line of code in it: ``<?php phpinfo(); ?>``. Place this file in your Web 
+root, for example ``/var/www/html``, and open it in your Web browser, for 
+example ``http://localhost/phpinfo.php``. This will display your complete 
+current PHP configuration. Look for the **Loaded Configuration File** section 
+to see which ``php.ini`` file your server is using. This is the one you want to 
+edit.
 
-* Under Debian or SUSE and their derivatives this file lies at 
-  /etc/php5/apache2/php.ini
-* On Windows, you can find this file within C:/Program Files (x86)/PHP/PHP.ini
+If you are running ownCloud on a 32-bit system, any ``open_basedir`` directive 
+in your ``php.ini`` file needs to be commented out
 
-Set the following two parameters inside the php.ini to the same value as chosen 
-inside the admin-section one step before:
+Set the following two parameters inside ``php.ini``, using your own desired 
+file size values::
 
-* ``upload_max_filesize = 16G``   (e.g., to stay consistent with the example 
-  value above)
-* ``post_max_size = 16G``   (e.g., to stay consistent with the example value 
-  above)
+ upload_max_filesize = 16G
+ post_max_size = 16G
+ 
+Tell PHP which temp file you want it to use::
+ 
+ upload_tmp_dir = /var/big_temp_file/
 
 **Output Buffering** must be turned off in ``.htaccess`` or ``php.ini``, or PHP 
-will return memory-related errors.
+will return memory-related errors:
 
 * ``output_buffering = 0``
-
-**These client configurations have been proven by testing maximum file sizes of 16 GB:**
-
-* Linux 32 Bit: Ubuntu, Firefox => 16GB
-* Windows 8  64 Bit: Google Chrome => 8GB
-
-**Note:**
-You will need a minimum of 16GB (e.g, to stay consistent with the example value 
-above), in your upload_tmp_dir. Normally this points to /tmp. If your /tmp has 
-not enough space, you can change the value of upload_tmp_dir in your php.ini

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

