diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst index 48b5af411..9078fcba7 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -14,11 +14,15 @@ interface. You can perform many common server operations with ``occ``:: ``occ`` is in the :file:`owncloud/` directory; for example :file:`/var/www/owncloud` on Ubuntu Linux. ``occ`` is a PHP script. You must run it as your HTTP user to ensure that the correct permissions are maintained on -your ownCloud files and directories. +your ownCloud files and directories. -The HTTP user is different on the various Linux distributions. See the -**Setting Strong Directory Permissions** section of :doc:`../installation/installation_wizard` -to learn how to find your HTTP user +.. _http_user: + +Run occ As Your HTTP User +------------------------- + +The HTTP user is different on the various Linux distributions. See +:ref:`strong_perms` to learn how to find your HTTP user * The HTTP user and group in Debian/Ubuntu is www-data. * The HTTP user and group in Fedora/CentOS is apache. @@ -201,8 +205,10 @@ intended to be run manually. ``files:cleanup`` tidies up the server's file cache by deleting all file entries that have no matching entries in the storage table. -Installation ------------- +.. _cli_installation: + +Command Line Installation +------------------------- You can install ownCloud entirely from the command line. After downloading the tarball and copying ownCloud into the appropriate directories, or diff --git a/admin_manual/configuration_user/user_auth_ldap.rst b/admin_manual/configuration_user/user_auth_ldap.rst index 9583d663a..f4dcc375a 100644 --- a/admin_manual/configuration_user/user_auth_ldap.rst +++ b/admin_manual/configuration_user/user_auth_ldap.rst @@ -522,6 +522,7 @@ If you have trouble with certificate validation make sure that .. commenting out windows section as windows server is not supported .. *C:\\openldap\\sysconf\\ldap.conf* or .. *C:\\ldap.conf* on Windows) using a **TLS_CACERT /path/to/cert** line. + * Using LDAPS, also make sure that the port is correctly configured (by default 636) @@ -578,9 +579,8 @@ Caching The LDAP cache has changed in ownCloud 8.1. There is no more file cache, but only a memory cache, and you must install and configure the memory cache. The -simplest memory cache to use is APCu. This is supplied by the -``php5-apcu`` package on Debian/Ubuntu/Mint, and by ``php-pecl-apcu``on Red -Hat/CentOS/Fedora. +simplest memory cache to use is APCu. This is supplied by the ``php5-apcu`` +package on Debian/Ubuntu/Mint, and by ``php-pecl-apcu``on Red Hat/CentOS/Fedora. After installing APCu you must modify ``config.php`` to select APCu as the ownCloud cache:: @@ -593,8 +593,9 @@ each unique request expires. User logins are not cached, so if you need to improve login times set up a slave LDAP server to share the load. The Redis key-value cache and store is an excellent fast and robust cache, and -if you are using the new experimental file locking (see :doc:``) then you must -use Redis. Redis configuration looks like this:: +if you are using the new experimental file locking (see +:doc:`../configuration_files/files_locking_experimental`) then you must use +Redis. Redis configuration looks like this:: 'filelocking.enabled' => 'true', 'memcache.local' => '\OC\Memcache\Redis', diff --git a/admin_manual/installation/command_line_installation.rst b/admin_manual/installation/command_line_installation.rst new file mode 100644 index 000000000..590a1c267 --- /dev/null +++ b/admin_manual/installation/command_line_installation.rst @@ -0,0 +1,36 @@ +========================================= +Installing ownCloud From the Command Line +========================================= + +It is now possible to install ownCloud entirely from the command line. This is +convenient for scripted operations, headless servers, and sysadmins who prefer +the command line. There are three stages to installing ownCloud via the command +line: + +1. Download and install the ownCloud code via your package manager, or download +and unpack the tarball in the appropriate directories. (See +:doc:`linux_installation` and :doc:`source_installation`.) + +2. Apply the correction permissions to your ownCloud files and directories (see +:ref:`strong_perms`.) + +3. Use the ``occ`` command to complete your installation. This takes the place +of running the graphical Installation Wizard. + +You must run ``occ`` as your HTTP user; see :ref:`http_user`. This example +shows how to complete your ownCloud installation with ``occ`` on Ubuntu Linux:: + + $ sudo -u www-data php /var/www/owncloud/occ maintenance:install --database + "mysql" --database-name "owncloud" --database-user "root" --database-pass + "password" --admin-user "admin" --admin-pass "password" + ownCloud is not installed - only a limited number of commands are available + ownCloud was successfully installed + +Supported databases are:: + + - sqlite (SQLite3 - Server Edition Only) + - mysql (MySQL/MariaDB) + - pgsql (PostgreSQL) + - oci (Oracle) + +See :ref:`cli_installation` for more information. diff --git a/admin_manual/installation/index.rst b/admin_manual/installation/index.rst index 41008f39e..614b850a9 100644 --- a/admin_manual/installation/index.rst +++ b/admin_manual/installation/index.rst @@ -6,6 +6,7 @@ Installation :maxdepth: 2 linux_installation + command_line_installation installation_wizard appliance_installation apps_management_installation diff --git a/admin_manual/installation/source_installation.rst b/admin_manual/installation/source_installation.rst index 33740f4e6..04bdf0e0f 100644 --- a/admin_manual/installation/source_installation.rst +++ b/admin_manual/installation/source_installation.rst @@ -45,7 +45,7 @@ To run ownCloud, your web server must have the following installed: Database connectors (pick at least one): * PHP module sqlite (>= 3, usually not recommended for performance reasons) -* PHP module mysql +* PHP module mysql (MySQL/MariaDB) * PHP module pgsql (requires PostgreSQL >= 9.0) *Recommended* packages: @@ -82,20 +82,6 @@ For preview generation (*optional*): * avconv or ffmpeg * OpenOffice or LibreOffice -**Remarks:** - -* Please check your distribution, operating system or hosting partner - documentation on how to install and enable these modules. - -* Make sure your distribution's PHP version fulfills the version requirements - specified above. If it doesn't, there might be custom repositories you can - use. If you are e.g. running Ubuntu 10.04 LTS, you can update your PHP using - a custom `PHP PPA `_:: - - sudo add-apt-repository ppa:ondrej/php5 - sudo apt-get update - sudo apt-get install php5 - * You don’t need the WebDAV module for your web server (i.e. Apache’s ``mod_webdav``) to access your ownCloud data via WebDAV. ownCloud has a built-in WebDAV server of its own, SabreDAV. @@ -114,14 +100,9 @@ Apache and MariaDB, by issuing the following commands in a terminal:: on running additional apps, keep in mind that they might require additional packages. See the Prerequisites section (above) for details. -* At the execution of each of the above commands you might be prompted whether - you want to continue; press "Y" for Yes (that is if your system language is - English. You might have to press a different key if you have a different - system language). - -* At the installation of the MySQL server, you will be prompted to create a root - password. Be sure to remember the password you enter there for later use - as you will need it during ownCloud database setup. +* At the installation of the MySQL/MariaDB server, you will be prompted to + create a root password. Be sure to remember the password you enter there + for later use as you will need it during ownCloud database setup. Now download the archive of the latest ownCloud version: @@ -168,8 +149,8 @@ configuration so all you have to do is create a .. code-block:: xml - Alias /owncloud /var/www/html/owncloud - + Alias /owncloud /var/www/owncloud + AllowOverride All @@ -213,7 +194,7 @@ Additional Apache Configurations service apache2 restart -.. note:: You can use ownCloud over plain http, but we strongly encourage you to +.. note:: You can use ownCloud over plain HTTP, but we strongly encourage you to use SSL/TLS to encrypt all of your server traffic, and to protect user's logins and data in transit. @@ -232,25 +213,22 @@ the according site. Open a terminal and run:: plan to make your ownCloud server publicly accessible. You might want to consider getting a certificate signed by commercial signing authority. Check with your domain name registrar or hosting service, - if you're using one, for good deals on commercial certificates. - + if you're using one, for good deals on commercial certificates. Installation Wizard ------------------- -Finish setting up your ownCloud server by following -the :doc:`installation_wizard`. +You may complete your installation by running either the graphical Installation +Wizard, or on the command line with the ``occ`` command. To use ``occ`` see +:doc:`command_line_installation`. -After running the Installation Wizard your ownCloud installation is complete. -However, you should perform the following steps to improve your server's -security. +To use the graphical Installation Wizard see :doc:`installation_wizard`. Setting Strong Directory Permissions ------------------------------------ We recommend setting the directory permissions in your ownCloud installation as -strictly as possible for stronger security. Please refer to the ``Setting -Strong Directory Permissions`` section of :doc:`installation_wizard`. +strictly as possible for stronger security. Please refer to :ref:`strong_perms`. SELinux -------