Re: [atomic-devel] Documenting "rpm-ostree override"

[Chris Negus <cnegus redhat com>]

----- Original Message -----
> On 05/17/2018 03:38 PM, Chris Negus wrote:
> > ----- Original Message -----
> >> On 05/17/2018 11:04 AM, Chris Negus wrote:
> >>> Thanks. I added a write-up of "rpm-ostree override" to the Atomic Install
> >>> and Config guide (currently in QA). I'd be glad for any comments:
> >>>
> >>>     https://access.qa.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html-single/installation_and_configuration_guide/#overriding_an_existing_rpm_package
> >>
> >> The changes for `rpm-ostree override` look good, but I noticed that
> >> earlier in that chapter I noticed that we are still telling folks to use
> >> `ostree admin undeploy` and `ostree admin cleanup`.  While those
> >> commands still work, it is preferred to use `rpm-ostree cleanup`.
> >>
> >> You can pass in various flags to the `cleanup` command to affect how it
> >> operates:
> >>
> >>     -b, --base            Clear temporary files; will leave deployments
> >> unchanged
> >>     -p, --pending         Remove pending deployment
> >>     -r, --rollback        Remove rollback deployment
> >>     -m, --repomd          Delete cached rpm repo metadata
> > 
> > Thanks Micah. I removed the "ostree admin" commands and added several
> > examples of "rpm-ostree cleanup" commands. Take a look (scroll up from the
> > same link) and let me know if that looks okay. If so, and there are no
> > other objections, I'll publish the new content.
> 
> Caught one small error:
> 
> "The -r option causes the pending deployment to be removed, while -r
> removes the rollback deployment"
> 
> The first "-r" should be "-p"

Thanks Micah. I made that fix and published it along with the new "rpm-ostree override" part of the Package Layering section (scroll up a bit to see that last fix):

  https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html-single/installation_and_configuration_guide/#package_layering

--Chris Negus

> > -- Chris Negus
> > 
> >>> ----- Original Message -----
> >>>> On Tue, May 15, 2018 at 3:51 PM, Chris Negus <cnegus redhat com> wrote:
> >>>>> In the wake of James Mills' excellent article on replacing docker in
> >>>>> Atomic
> >>>>> (https://access.redhat.com/solutions/3414221), I realized we had missed
> >>>>> documenting "rpm-ostree override" in the RHEL Atomic user docs. I'll
> >>>>> point
> >>>>> to that article, but I want to add some new content as well.
> >>>>>
> >>>>> As I've played around with rpm-ostree override, a few questions have
> >>>>> come
> >>>>> up:
> >>>>>
> >>>>> * Can someone suggest a good package to use to override an Atomic
> >>>>> package
> >>>>> in the base system? Each package I try fails with some dependency
> >>>>> issues
> >>>>> I
> >>>>> don't know how to get around.
> >>>>
> >>>> Hmm, interesting -- can you share an example? Remember you'll want to
> >>>> pass it all the related packages.
> >>>> Any leaf package is easy for demo purposes. E.g. strace is probably a
> >>>> good
> >>>> one.
> >>>> Though a more realistic example is probably more convincing. If you
> >>>> don't want to copy the docker one, maybe openssh?
> >>>> I just tried this here:
> >>>>
> >>>> ```
> >>>> rpm-ostree override replace openssh-7.4p1-15.el7.x86_64.rpm
> >>>> openssh-clients-7.4p1-15.el7.x86_64.rpm
> >>>> openssh-server-7.4p1-15.el7.x86_64.rpm
> >>>> ```
> >>>>
> >>>> We've also done some work upstream recently to fully support systemd
> >>>> and kernel replacements.
> >>>> https://github.com/projectatomic/rpm-ostree/releases/tag/v2018.5
> >>>>
> >>>>> * Must a base system package always be removed before it is replaced?
> >>>>
> >>>> Nope, the `override replace` operation will take care of that.
> >>>>
> >>>>> * Is there a proper way to back out, if you decide you want to go back
> >>>>> to
> >>>>> the original packages?
> >>>>
> >>>> For specific packages: `override reset $pkg1 $pkg2 ...`
> >>>> To clear *all* overrides: `override reset --all`
> >>>>
> >>>
> >>
>