~jose/charms/precise/owncloud/port-change+repo+ssl-support

# OwnCloud

- Author: Atul Jha <koolhead17@gmail.com>

- Maintainer: José Antonio Rey <jose@ubuntu.com>

# Overview

ownCloud provides universal access to your files via the web, your computer or

your mobile devices — wherever you are. It also provides a platform to easily

view & sync your contacts, calendars and bookmarks across all your devices and

enables basic editing right on the web.

This charm installs Apache2, Apache-Mod-PHP5, and configures OwnCloud with

sqlite as a standalone server. Provides relationship hooks with NFS file

storage, MySQL Databases, and HAProxy reverse proxy charms.

# Configuration

This charm comes with different configuration options. Optional configuration

options include:

`domain`: This is the domain or IP address for your ownCloud instance. If you

do not know what it is, execute `juju status` to find out the public address. If

not provided, the charm will refuse to configure.

`downloadurl`: This is the download URL that the charm will use in case the src

option is set to `source`. It defaults to the 6.0.4 URL.

`sha1sum`: This is the SHA1SUM for the `downloadurl` file. It defaults to the

SHA1SUM for the 6.0.4 file.

`port`: This is the alias port that will be used for the ownCloud instance. It

will redirect to 443, which is the HTTPS port. It defaults to 80.

`src`: This is the source from which the package will be installed. You can

choose between `repo`, which will install it from a repository built by

ownCloud, or `source`, which will download the tarball and extract it. It

defaults to `repo`.

`customssl`: This charm provides default SSL support for ownCloud. This means

that if you do not provide a custom SSL key and certificate, a self-signed one

will be auto-generated for you. If you want to use a custom SSL certificate,

please set this option to `true`. It defaults to `false`.

`sslkey`: If `customssl` is set to true, this is the SSL key that will be used.

If not provided and `customssl` is true, the charm will refuse to configure.

`sslcert`: If `customssl` is set to true, this is the SSL cert that will be

used. If not provided and `customssl` is true, the charm will refuse to

configure.

`user`: This user will be used in case you want to do a setup of Shared

Instances. If not provided, it will be defaulted to `ownCloud`.

`password`: This password will be used in case you want to do a setup of

Shared Instances. If not provided, it will be randomly generated when a DB

relation is joined.

You can put any of this options in a config.yaml file and specify it at the

moment of deploying. Otherwise, you can change them by executing:

    juju set owncloud [option]=[value]

# Usage

## Standalone Instance

First, bootstrap your environment:

    juju bootstrap

Then, deploy ownCloud by executing the following command:

    juju deploy owncloud

Finally, expose the service:

    juju expose owncloud

Access OwnCloud service directly, and complete the setup, providing user

credentials and initializing sqlite database.

## Shared Instances

If you want to deploy shared instances, execute the following commands after

doing a Standalone Instance setup:

    juju deploy mysql

    juju add-relation mysql owncloud

    juju deploy nfs

    juju add-relation nfs owncloud

We're now done! To find out the address for your ownCloud instance, execute

`juju status` and navigate to it.

# Scale out Usage

In order to do a scalabe deploy of ownCloud, execute the following commands

    juju bootstrap

    juju deploy owncloud

    juju deploy mysql

    juju deploy haproxy

    juju add-relation mysql owncloud

    juju add-relation haproxy owncloud

    juju add-unit owncloud

# Internet Connection Requirements

This charm downloads files from the Internet, and requires Internet connectivity

in order to properly install. The requirements vary for each setup type.

## When installing from the source

When installing from the source packages available for download, this charm will

connect to the following Internet sites:

 * download.owncloud.org with port 443

 * The Ubuntu repositories or a private mirror of them

## When installing from the repository

ownCloud offers the option to install from a repository. This is the default

configuration value for the charm. With this, the charm will connect to the

following Internet sites:

 * download.opensuse.org with port 80

 * download.opensuse.org as a repository

 * The Ubuntu repositories or a private mirror of them

# Known Limitations

If you have been using a standalone instance and want to migrate to a shared

instance, please note that adding the mysql relation will not preserve the file

structure in the database. This means that your file listing will not be

available. Make sure to have this in mind when doing the migration.

Also, if you leave the `customssl` option set to false or provide a self-signed

SSL certificate, ownCloud will throw a WebDAV error after creating the admin

username and password. Ignore this error as it does not affect the working of

ownCloud (it is silently fixed), and enter your website again.

If port is different than 80, it looks like the instance throws an SSL

error when connecting. Recommendation is to set the `port` value to 80 to avoid

problems.

Finally, on the tests side, the tests will fail on the local provider due to

NFS not being able to deploy correctly (this is an NFS-related issue).

#TODO

Genericize shared-fs-relation-* for non-nfs shared-fs providers