WRT migration of existing projects, we have a very good users guide which
Tom Pantelis put together here [0], which actually contains a migration
guide [1], for those who are attempting to make the move.  Along with the
documentation, there are a great number of patches that many folks have
worked on to migrate projects already [2].  Hopefully this helps existing
applications' contributors, both open source and proprietary, to make the
move from CSS to blueprint.

Regards,

Ryan

[0] https://wiki.opendaylight.org/view/Using_Blueprint
[1]
https://wiki.opendaylight.org/view/Using_Blueprint#Migrating_from_config_subsytem_.28CSS.29
[2] https://git.opendaylight.org/gerrit/#/q/status:merged+topic:blueprint

On Thu, Nov 17, 2016 at 8:57 AM, FREEMAN, BRIAN D <bf1...@att.com> wrote:

> I agree with Ryan that the problem is more existing applications that use
> the config system – ones that we wouldn’t normally be re-using the mvn
> archetype but have to re-factor the app to use blueprint instead of Config
> subsystem.
>
>
>
> Brian
>
>
>
>
>
> *From:* Ryan Goulding [mailto:ryandgould...@gmail.com]
> *Sent:* Thursday, November 17, 2016 8:06 AM
> *To:* Colin Dixon
> *Cc:* FREEMAN, BRIAN D; controller-dev
>
> *Subject:* Re: [controller-dev] deprecating the config subsystem in
> Carbon?
>
>
>
> You could thus deprecate the generated class: in this case
> org.opendaylight.yang.gen.v1.urn.opendaylight.lacp.lacp.main.rev141216.
> AbstractLacpMainModule
>
>
> Yeah because LCAP team modified the Module and thus copied it into src/.
> The @Deprecated generation would never traverse to this file... it would
> just be present in new generated Module(s) (in target), which is really
> only helpful to projects that:
>
> 1) don't modify the Module
> 2) are implementing a new service from scratch without using the archetype.
>
> Since the archetypes have already been modified to utilize blueprint,  I'd
> wager that most people wouldn't see any effect from making a change to the
> code generator.  Not to mention the fact that I highly doubt it would be
> "simple"... it would probably require special casing code generation for
> provider yang since I believe it utilizes the standard
> mdsal-binding-java-api-generator.
>
> Just my $0.02, someone else may have a good idea for this.  IMHO the best
> approach is to advertise this loud and clear across mailing lists and
> release notes, since most people ignore deprecated notices anyway (coming
> from someone who did the initial work to deprecate DCL, which is still used
> EVERYWHERE).
>
>
>
>
> Best Regards,
>
> Ryan
>
>
>
> On Wed, Nov 16, 2016 at 9:33 PM, Colin Dixon <co...@colindixon.com> wrote:
>
> So, even though the file is in src/ it imports a generated file, see here:
> https://github.com/opendaylight/lacp/blob/master/
> lacp-main/implementation/src/main/java/org/opendaylight/
> yang/gen/v1/urn/opendaylight/lacp/lacp/main/rev141216/
> LacpMainModule.java#L35
>
> You could thus deprecate the generated class: in this case
> org.opendaylight.yang.gen.v1.urn.opendaylight.lacp.lacp.main.rev141216.
> AbstractLacpMainModule
>
>
>
> That would work with a relatively simple change in the code generator and
> apply everywhere, right?
>
>
>
> --Colin
>
>
>
> On Wed, Nov 16, 2016 at 7:11 PM, Ryan Goulding <ryandgould...@gmail.com>
> wrote:
>
> You mean the Provider?  Most people adapt the Provider and put it in src/
> anyway;  I would guess this wouldn't really raise much awareness but that
> is my own $0.02.  The easiest path forward is probably to make sweeping
> announcements via email and strong suggestions in the release notes... but
> I could be wrong.  Open to discussion on the strategy going forward.  Tom
> Pantelis may have a clever suggestion for this too...
>
>
> Regards,
>
> Ryan Goulding
>
>
>
> On Wed, Nov 16, 2016 at 2:50 PM, Colin Dixon <co...@colindixon.com> wrote:
>
> That sounds good to me. What's the right way for us to "deprecate" the
> config subsystem. I guess the simplest thing would be add an @deprecated
> decorator to the relevant classes that get generated with a pointer to the
> docs on how to migrate.
>
> --Colin
>
>
>
> On Tue, Nov 15, 2016 at 5:07 PM, FREEMAN, BRIAN D <bf1...@att.com> wrote:
>
> I think Option 2 is a reasonable approach.
>
> Brian
>
>
>
> -----Original Message-----
> From: controller-dev-boun...@lists.opendaylight.org [mailto:
> controller-dev-boun...@lists.opendaylight.org] On Behalf Of Robert Varga
> Sent: Tuesday, November 15, 2016 4:46 PM
> To: Alexis de Talhouët; thomas nadeau
> Cc: controller-dev
> Subject: Re: [controller-dev] deprecating the config subsystem in Carbon?
>
> On 11/15/2016 10:08 PM, Alexis de Talhouët wrote:
> >
> > Option 2:
> > Deprecation notice in Carbon
> > Adaptation in Nitrogen
> > Removal in Oxygen
> >
> > During the kernel meeting I was more after option 3, but I think option
> > 2 make sense so downstream consumer can be notified earlier in the
> > process and start migrating things to blueprint.
>
> I think option 2 works best, especially since we can decide on when the
> actual removal takes place -- which I think should be one release after
> we have shipped without internal projects using it.
>
> Bye,
> Robert
>
> _______________________________________________
> controller-dev mailing list
> controller-dev@lists.opendaylight.org
> https://lists.opendaylight.org/mailman/listinfo/controller-dev
>
>
>
>
> _______________________________________________
> controller-dev mailing list
> controller-dev@lists.opendaylight.org
> https://lists.opendaylight.org/mailman/listinfo/controller-dev
>
>
>
>
>
>
>
_______________________________________________
controller-dev mailing list
controller-dev@lists.opendaylight.org
https://lists.opendaylight.org/mailman/listinfo/controller-dev

Reply via email to