← Back to branch summary

~jose/charms/precise/juju-gui/add-blank-defaults

« back to all changes in this revision

Viewing changes to README.md

  • Committer: Francesco Banconi
  • Date: 2014-01-22 09:09:01 UTC
  • mfrom: (60.13.77 juju-gui-trunk)
  • Revision ID: francesco.banconi@canonical.com-20140122090901-o89b944jb13kk1o9
New charm release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.md
72
72
By default, the deployment uses self-signed certificates. The browser will ask
73
73
you to accept a security exception once.
74
74
 
75
 
You will see a login form with the username fixed to "user-admin" (for juju-
76
 
core) or "admin" (for pyjuju). The password is the same as your Juju
77
 
environment's `admin-secret`, found in `~/.juju/environments.yaml`.
 
75
You will see a login form with the username fixed to "user-admin". The
 
76
password is the same as your Juju environment's `admin-secret`, found in
 
77
`~/.juju/environments.yaml`.
78
78
 
79
79
### Deploying behind a firewall ###
80
80
 
85
85
    juju deploy juju-gui
86
86
 
87
87
There are situations and customizations in which the charm needs to connect to
88
 
Launchpad:
 
88
the Internet:
89
89
 
90
 
- juju-gui-source is set to "stable" or "trunk": in this cases the charm pulls
91
 
  the latest stable or development release from Launchpad;
92
 
- juju-gui-source is set to a branch (e.g. "lp:juju-gui"): in this case the
93
 
  charm retrieves a checkout of the specified branch from Launchpad, and adds
94
 
  an external Launchpad PPA to install build dependencies;
95
 
- juju-gui-source is set to a specific version number not available in the
96
 
  local store (i.e. in the releases directory of the deployed charm): in this
97
 
  case the release is downloaded from Launchpad;
 
90
- juju-gui-source is set to a configuration that requires accessing an
 
91
  external source in order to fetch a release tarball or a Git checkout in order
 
92
  to build the source used by the charm.
98
93
- builtin-server is set to false: in this case the charm adds an external
99
94
  Launchpad PPA to install the legacy server dependencies.
100
95
 
102
97
deploy behind a firewall configuring the charm to pull the GUI release from a
103
98
location you specify.
104
99
 
105
 
For both Juju Core and PyJuju, you must simply do the following steps.  Note
106
 
that PyJuju must do these steps, plus another set described further below.
107
 
 
108
100
The config variable `juju-gui-source` allows a `url:` prefix which understands
109
101
both `http://` and `file://` protocols.  We will use this to load a local copy
110
102
of the GUI source.
125
117
 
126
118
    `juju resolved --retry juju-gui/0`
127
119
 
128
 
These steps are sufficient for Juju Core.  If you are using PyJuju, you need to
129
 
do another set of steps in addition.
130
 
 
131
 
1. Use bzr to branch lp:~hazmat/juju/rapi-rollup locally ("bzr branch
132
 
lp:~hazmat/juju/rapi-rollup") and copy the branch to the gui service machine.
133
 
 
134
 
2. Use "juju set juju-gui juju-api-branch=PATH_TO_LOCAL_BZR_BRANCH" (where the
135
 
path is *not* a file:// URI).
136
 
 
137
 
3. Retry as described in the step 3 above (`juju resolved --retry juju-gui/0`).
138
 
 
139
120
### Upgrading the charm behind a firewall ###
140
121
 
141
122
When a new version of Juju GUI is released, the charm is updated to include the
166
147
 
167
148
    juju deploy --force-machine 0 cs:precise/juju-gui
168
149
 
169
 
#### pyjuju ####
170
 
 
171
 
Colocation support is not included by default in the pyjuju implementation; to
172
 
activate it, you will need to install Jitsu:
173
 
 
174
 
    sudo apt-get install juju-jitsu
175
 
 
176
 
and then replace "juju deploy cs:precise/juju-gui" from the previous
177
 
instructions with this:
178
 
 
179
 
    jitsu deploy-to 0 cs:precise/juju-gui
180
 
 
181
150
## Contacting the Developers ##
182
151
 
183
152
If you run into problems with the charm, please feel free to contact us on the