Port two WP articles to serve as an example

admin_manual/index.rst

@@ -10,6 +10,8 @@ Contents
    :maxdepth: 2
 
    introduction
+   installation 
+   update 
 .. add more chapters 
 
 

admin_manual/installation.rst

@@ -0,0 +1,94 @@
+Installation
+============
+
+.. todo:: Update the dependencies to 4.5 dependencies
+
+To run ownCloud, your webserver must have the following installed: 
+
+* php5 (>= 5.3)
+* php5-json
+* php-xml
+* php-mbstring
+* php5-zip
+* php5-gd
+
+And as *optional* dependencies: 
+
+* php5-sqlite (>= 3)
+* curl
+* libcurl3
+* libcurl3-dev
+* php5-curl
+* php-pdo
+
+Commands for Ubuntu and Debian:
+.. todo:: Document other distros (Windows, Mac?)
+
+::
+
+  apt-get install apache2 php5 php5-json php-xml php-mbstring php5-zip php5-gd
+  apt-get install php5-sqlite curl libcurl3 libcurl3-dev php5-curl php-pdo
+
+You don’t need any WebDAV support of your webserver (i.e. apache’s mod_webdav)
+to access your ownCloud data via WebDAV, ownCloud has a WebDAV server built in.
+
+Extract ownCloud and copy to your webserver
+-------------------------------------------
+
+::
+
+  tar -xjf path/to/downloaded/owncloud-x.x.x.tar.bz2
+  cp -r owncloud /path/to/your/webserver
+
+Set the directory permissions
+-----------------------------
+
+The owner of your webserver must own the apps/, data/ and config/ directories
+in your ownCloud install. You can do this by running the following command for
+the apps, data and config directories:
+
+::
+
+  chown -R www-data:www-data /path/to/your/owncloud/install/data
+
+Replace ``www-data:www-data`` with the user and group of the owner of your
+webserver.
+
+.. note:: The ``data/`` directory will only be created after setup has run 
+          (see below) and is not present by default in the tarballs.
+
+Enable .htaccess and mod_rewrite if running apache
+--------------------------------------------------
+
+If you are running the apache webserver, it is recommended that you enable
+``.htaccess`` files as ownCloud uses them to enhance security and allows
+you to use webfinger. To enable .htaccess files you need to ensure that
+``AllowOverride`` is set to ``All`` in the ``Directory /var/www/`` section of
+your virtual host file. This is usually in ``/etc/apache2/sites-enabled/000-default``.
+You should also run ``a2enmod rewrite`` and ``a2enmod headers``. Then restart
+apache: service apache2 restart (for Ubuntu systems). In order for the maximum
+upload size to be configurable, the .htaccess file in the owncloud folder needs
+to be made writable by the server.
+
+Follow the install wizard
+-------------------------
+
+Open your web browser and navigate to your ownCloud instance. If you are
+installing ownCloud on the same machine as you will access the install
+wizard from, the url will be: http://localhost/ (or http://localhost/owncloud).
+For basic installs we recommend SQLite as it is easy to setup (ownCloud will do
+it for you). For larger installs you should use MySQL or PostgreSQL. Click on the
+Advanced options to show the configuration options. You may enter admin
+credentials and let ownCloud create its own database user, or enter a
+preconfigured user.  If you are not using apache as the webserver, please set
+the data directory to a location outside of the document root. See the advanced
+install settings.
+
+Finished!
+---------
+
+Login and start using ownCloud! For more details on configuring
+your ownCloud, please visit the Support Centre.  If you plan on using the
+Webfinger app and your ownCloud installation is not in the webroot then you’ll
+have to manually link ``/var/www/.well-known`` to
+``/path/to/your/owncloud/.well-known``.

admin_manual/update.rst

@@ -0,0 +1,45 @@
+Updating ownCloud
+=================
+
+Update
+------
+
+Update is to bring an ownCloud instance to its latest *point release*, e.g.
+ownCloud 4.0.6 → 4.0.7.To update an ownCloud installation manually, follow
+those steps:
+
+1. Do a backup.
+2. Unpack the release tarball in the owncloud directory, i.e. copy all new
+   files into the ownCloud installation.
+3. Make sure that the file permissions are correct.
+4. With the next page request the update procedures will run.
+5. If you installed ownCloud from a repository, your package management
+   should take care of it.
+
+Upgrade
+-------
+
+Upgrade is to bring an ownCloud instance to a new *major release*, e.g.
+ownCloud 4.0.7 → 4.5.0. Always do backups anyway.
+
+To upgrade ownCloud, follow those steps:
+
+1. Make sure that you ran the latest point release of the major ownCloud
+   version, e.g. 4.0.7 in the 4.0 series. If not, update to that version first
+   (see above).
+2. Do a backup.
+3. Deactivate all third party applications.
+4. Delete everything from your ownCloud installation directory, except data and
+   config.
+5. Unpack the release tarball in the owncloud directory (or copy the
+   files thereto).
+6. Make sure that the file permissions are correct.
+7. With the next page request the update procedures will run.
+8. If you had 3rd party applications, check if they provide versions compatible
+   with the new release.
+
+If so, install and enable them, update procedures will run if needed.  9. If
+you installed ownCloud from a repository, your package management should take
+care of it. Probably you will need to look for compatible third party
+applications yourself. Always do backups anyway.
+