~charmers/charms/precise/roundcube/trunk

« back to all changes in this revision

Viewing changes to readme.txt

  • Committer: matthew.bruzek at canonical
  • Date: 2014-04-08 14:08:18 UTC
  • mfrom: (28.1.1 roundcube)
  • Revision ID: matthew.bruzek@canonical.com-20140408140818-pzp233h17omtvtom
[jose] Added categories, icon, reformatted README to Markdown
[mbruzek] Set Nick as maintainer, minor Mardown fixes in README.md

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Juju charm Roundcube
2
 
author: Nick Barcet <nick.barcet@canonical.com>
3
 
 
4
 
Example deployment:
5
 
 
6
 
1. Setup your site specific parameters in roundcube.yaml
7
 
> vi roundcube.yaml
8
 
a list of all settable parameter with description is available using
9
 
> juju get roundcube
10
 
or listing config.yaml
11
 
 
12
 
2. Deployment with mysql and haproxy
13
 
>juju bootstrap
14
 
>juju deploy --config roundcube.yaml roundcube
15
 
>juju deploy mysql
16
 
>juju deploy haproxy
17
 
>juju add-relation mysql roundcube
18
 
>juju add-relation roundcube haproxy
19
 
>juju expose haproxy
20
 
 
21
 
3. Accessing your new roundcube site should be ready at 
22
 
http://<haproxy-machine-addr>/.  To find out the public address of haproxy,
23
 
look for it in the output of the 'juju status' command.  
24
 
 
25
 
Note about HTTPS:
26
 
-----------------
27
 
to enable https access to your site, you can set "do_https" to the value of the
28
 
 https port you want to listen to (443 is the default for https).  You will 
29
 
also need to provide the paths to *existing* SSLCertificate (ssl_crt) and key 
30
 
(ssl_key). This means that you will have to use juju scp to upload your certicates
31
 
*before* making the config changes and adding other units.
32
 
 
33
 
You can also use the default ssl snake oil certificates provided by the ssl-cert
34
 
package:
35
 
  # This config activates https on port 443
36
 
  do_https: 443
37
 
  ssl_crt: /etc/ssl/certs/ssl-cert-snakeoil.pem 
38
 
  ssl_key: /etc/ssl/private/ssl-cert-snakeoil.key
39
 
 
40
 
If the certificate you provide is invalid, apache will fail to load.
41
 
If the paths you provide are invalid, the https site will no be activated.
42
 
juju debug-log should be your friend, go have a look.
43
 
 
44
 
The certificates should be uploaded to the first unit you start, a peer relation 
45
 
between all units will ensure that they will be reused identically everywhere.