How to specify an environment to be specific series

[Ryan Finnie]

The core issue is there is no obvious way for me to say "I would like this environment to be this series, please". juju bootstrap --series is unrelated, and default-series is undocumented in openstack-provider, and the default series logic is undocumented w/r/t distro-info-data.

$ juju --debug bootstrap --series precise
error: --series requires --upload-tools

I'm not sure why this is the case. This cloud's SimpleStreams image and tools buckets contain data for both precise and trusty, and if I use "default-series: precise" in environments.yaml, it works fine.

[Curtis Hovey (sinzui)]

Upload tools uploads the same series as your host. It is most often used by developer. The --series option is used to add additional tools for developers to test. SimpleStreams tells juju how to find every tools it needs on demand, no need to specify. The upload-tools will disappear in the future because simple-streams and sync tools provides the rich information that juju neeed.

--series (= )
    upload tools for supplied comma-separated series list
--upload-tools (= false)
    upload local version of tools before bootstrapping

[Curtis Hovey (sinzui)]

I brought this issue up a month ago on the juju list
    https://lists.ubuntu.com/archives/juju-dev/2014-April/002299.html

I see two classes of confusion working with series that could be
alleviated is the "juju --init" included default-series for every
environment. Users are trying Trusty, or trying to stay with Precise,
and they don't know about default-series.

Some users were deploying local charms without specifying the
series.These users didn't know that they could add default-series to
environments.yaml or do
    juju set-env default-series=precise
to a running env.

Some users want run trusty environments from their precise clients.
default-series is the only way to specify the series of the bootstrap
node. Users have learned this through experimentation.

My own environment.yaml has default-series for some environments
because "juju init" has sometimes included it. Juju-CI always
specifies default series because we like to be clear about what we are
testing. I think every example environment for every provider needs a
commented out line explaining default-series
    # Set series for the state-server and the default series of charms.
    # default-series: trusty

[John A Meinel (jameinel)]

I believe we have plans to allow you to use "juju bootstrap
--series=precise" instead of having to set default-series in order to set
the platform that the bootstrap node will be running.
If we do get that far, then we'll certainly intend to not require
upload-tools.

John
=:->

On Wed, May 7, 2014 at 5:11 PM, Curtis Hovey <email address hidden> wrote:

> Upload tools uploads the same series as your host. It is most often used
> by developer. The --series option is used to add additional tools for
> developers to test. SimpleStreams tells juju how to find every tools it
> needs on demand, no need to specify. The upload-tools will disappear in
> the future because simple-streams and sync tools provides the rich
> information that juju neeed.
>
> --series (= )
> upload tools for supplied comma-separated series list
> --upload-tools (= false)
> upload local version of tools before bootstrapping
>
>
> ** Changed in: juju-core
> Status: New => Won't Fix
>
> --
> You received this bug notification because you are subscribed to juju-
> core.
> https://bugs.launchpad.net/bugs/1316874
>
> Title:
> "--series requires --upload-tools" for some reason
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/juju-core/+bug/1316874/+subscriptions
>

[Anastasia (anastasia-macmood)]

Fixed as part of other work.

So in addition to default-series:

To create a controller, use "juju bootstrap -bootstrap-series=..."
To create a model, use "juju add-model --config default-series=..."
To create a machine, use "juju add-machine --series=..."