Document how to run multiple local providers.

[mbruzek]

Juju can run multiple local environments. To create a different local environment in Juju, define a new section in the .juju/environments.yaml file.

# mbruzek's local environment on this system.
local-mbruzek:
        type: local
        storage-port: 8041
        state-port: 37018
        api-port: 17071

The port numbers must be different than the default local port numbers which are 8040 for storage-port, 37017 for state-port, and 17071 for api-port.

[mbruzek]

Note that the section can any name the user wants.

[evilnick]

Thanks for this. I think that in general, people know they can run multpile environments, but it would be useful to note the special circumstances of this one, by adding a section on the config page.

[mbruzek]

Hi Nick.
It was not clear to me that you could run 2 local environments until yesterday. And to run 2 local environments on the system you have to set these port values to not conflict.

I also could not find any documentation on the default port numbers for state-port and api-port, they did not appear in any of the environment.yaml files that looked at.

[marcoceppi]

local is the only environment that requires special considerations to run multiple of the same type, this should just be documented as a caveat on the config-LXC page IMO

[evilnick]

On Wed, Mar 26, 2014 at 3:19 PM, Marco Ceppi notifications@github.comwrote:

local is the only environment that requires special considerations to run
multiple of the same type, this should just be documented as a caveat on
the config-LXC page IMO

that's what i said! I think it should go on that page at the end of the
config section if anyone wants to have a go at it, otherwise I will do it
when I get around to the open issues.