Beta documentation: upgrades

[Adam Williamson]

Hey, folks. I just wanted to check in and see if someone's on top of
documenting the upgrade process for Beta, as it's still somewhat manual.
I don't believe it's going to be as simple as 'yum install fedup; fedup'
- it'll at least involve feeding an explicit URL to fedup.

We have a test case that documents the current procedure:

https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...

I believe the target URL will change for the public release, but the
procedure I think will stay more or less the same.

Does someone want to co-ordinate with wwoods and tflink (who know the
most about fedup, I think) to make sure this is documented in the Beta
relnotes or whatever? Thanks!
-- 
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
http://www.happyassassin.net

[Eric Christensen]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

I'm not sure if this has been completed or not.  I'll see if I can pull the latest
Install Guide source down and take a look.

Eric

Adam Williamson <awilliam(a)redhat.com&gt; wrote:

> Hey, folks. I just wanted to check in and see if someone's on top
> of
> documenting the upgrade process for Beta, as it's still somewhat
> manual.
> I don't believe it's going to be as simple as 'yum install fedup;
> fedup'
> - it'll at least involve feeding an explicit URL to fedup.
>
> We have a test case that documents the current procedure:
>
> https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...
>
> I believe the target URL will change for the public release, but the
> procedure I think will stay more or less the same.
>
> Does someone want to co-ordinate with wwoods and tflink (who know the
> most about fedup, I think) to make sure this is documented in the Beta
> relnotes or whatever? Thanks!
> --
> Adam Williamson
> Fedora QA Community Monkey
> IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
> http://www.happyassassin.net
>
> --
> docs mailing list
> docs(a)lists.fedoraproject.org
> To unsubscribe:
> https://admin.fedoraproject.org/mailman/listinfo/docs 
- --
Sent from my Android phone with K-9 Mail. Please excuse my brevity.
> -----BEGIN PGP SIGNATURE-----
> Version: APG v1.0.8
>
> iQIVAwUBULEORYB2q94CS7PRAQpAbRAA6YyaywLTzYgJwFAmP9nHl+tKaxKOu87l
> 9qdynNORvLgybUpA2/DrlVyUiknBp9ak2tgFOteW1fQF/ClplpZpp2PBUlEhLhVV
> ZSOAVPMdtYMU8OYL5YJvjUTsA42RYZZE9IXve64/YGbw0O3/ECTWVJWKAMyIqU8e
> j63BMg73fVZhooZHuYj7NrCvcSgGXSFOwKGhLGpTsVx14udj6M6mFhvm3R114Xzz
> tpl3R7I+3kYILGIoTLA01mY9tKpDjCO52AexvdB4HrK4xsCPoEH9uV0LpDQdQ57s
> Hu5zlruumilRB1M91Mhn/LTeQHA5YdXFJ1a6yEpiIk8twEqjkrUolKCx/7n+ef2a
> bWMFvPxZmh6G8hhUSmWpqgqCDkoq7/jFRrBP8fzRFpN1Fe4bphmh3ka+8XPrx1Tx
> gnpyVxsZBk2nXk6lw6MBSHuY1MTTlcJPmZ0aHBstapO1b5wCrXugogjIPtxcEMfA
> Y1JP0yBVIBnPiRnGzUsDIFZ3LUPs8NSwTWhO/xMml9s1vLLaycpNkkOwoJXCJmqM
> Cy5R2MUENjSIZgttwKsqsTS7d3mnJKmPIq9KQb7fqa0rN5EWg2pEC1VN1SLmPBl4
> gSAwjCXIjNYiMKSKjVrSAqWBWWJoepLTpzIJwx1y4u8CsxLHSUpC49Z0z9pmBeXU
> mZ/2u9iJeGA=
> =nabS
> -----END PGP SIGNATURE-----

[Jack Reed]

Sorry for my delay in notifying the list. Yes, I've just exchanged 
emails with Will about this to see how the Install Guide is affected.

Given that it will no longer be possible to upgrade using the installer 
itself, I will be removing the section that covers that. I'll explain 
the new fedup procedure in place of preupgrade in the short 'Upgrading 
Your Current System' chapter later in the guide.

I will keep in touch with Will and tflink to ensure fedup is documented 
accurately.

Cheers,

Jack

On 11/25/2012 04:13 AM, Eric Christensen wrote:
>  -----BEGIN PGP SIGNED MESSAGE-----
>  Hash: SHA512
>
>  I'm not sure if this has been completed or not.  I'll see if I can pull the
> latest Install Guide source down and take a look.
>
>  Eric
>
>  Adam Williamson <awilliam(a)redhat.com&gt; wrote:
>
> > Hey, folks. I just wanted to check in and see if someone's on top of
> > documenting the upgrade process for Beta, as it's still somewhat
> > manual.
> > I don't believe it's going to be as simple as 'yum install fedup;
> > fedup'
> > - it'll at least involve feeding an explicit URL to fedup.
> >
> > We have a test case that documents the current procedure:
> >
> > https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...
> >
> > I believe the target URL will change for the public release, but the
> > procedure I think will stay more or less the same.
> >
> > Does someone want to co-ordinate with wwoods and tflink (who know the
> > most about fedup, I think) to make sure this is documented in the Beta
> > relnotes or whatever? Thanks!
> > --
> > Adam Williamson
> > Fedora QA Community Monkey
> > IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
> > http://www.happyassassin.net
> >
> > --
> > docs mailing list
> > docs(a)lists.fedoraproject.org
> > To unsubscribe:
> > https://admin.fedoraproject.org/mailman/listinfo/docs
>  - --
>  Sent from my Android phone with K-9 Mail. Please excuse my brevity.
> >  -----BEGIN PGP SIGNATURE-----
> >  Version: APG v1.0.8
> >
> >  iQIVAwUBULEORYB2q94CS7PRAQpAbRAA6YyaywLTzYgJwFAmP9nHl+tKaxKOu87l
> >  9qdynNORvLgybUpA2/DrlVyUiknBp9ak2tgFOteW1fQF/ClplpZpp2PBUlEhLhVV
> >  ZSOAVPMdtYMU8OYL5YJvjUTsA42RYZZE9IXve64/YGbw0O3/ECTWVJWKAMyIqU8e
> >  j63BMg73fVZhooZHuYj7NrCvcSgGXSFOwKGhLGpTsVx14udj6M6mFhvm3R114Xzz
> >  tpl3R7I+3kYILGIoTLA01mY9tKpDjCO52AexvdB4HrK4xsCPoEH9uV0LpDQdQ57s
> >  Hu5zlruumilRB1M91Mhn/LTeQHA5YdXFJ1a6yEpiIk8twEqjkrUolKCx/7n+ef2a
> >  bWMFvPxZmh6G8hhUSmWpqgqCDkoq7/jFRrBP8fzRFpN1Fe4bphmh3ka+8XPrx1Tx
> >  gnpyVxsZBk2nXk6lw6MBSHuY1MTTlcJPmZ0aHBstapO1b5wCrXugogjIPtxcEMfA
> >  Y1JP0yBVIBnPiRnGzUsDIFZ3LUPs8NSwTWhO/xMml9s1vLLaycpNkkOwoJXCJmqM
> >  Cy5R2MUENjSIZgttwKsqsTS7d3mnJKmPIq9KQb7fqa0rN5EWg2pEC1VN1SLmPBl4
> >  gSAwjCXIjNYiMKSKjVrSAqWBWWJoepLTpzIJwx1y4u8CsxLHSUpC49Z0z9pmBeXU
> >  mZ/2u9iJeGA=
> >  =nabS
> >  -----END PGP SIGNATURE----- 
>  
-- 
Jack Reed
Content Author
Engineering Content Services

Red Hat Asia Pacific
Brisbane, Australia
Phone: [phone]

[Zach Oglesby]

On Thu, 2012-11-22 at 14:48 -0800, Adam Williamson wrote:
>  Hey, folks. I just wanted to check in and see if someone's on top
> of
>  documenting the upgrade process for Beta, as it's still somewhat manual.
>  I don't believe it's going to be as simple as 'yum install fedup; fedup'
>  - it'll at least involve feeding an explicit URL to fedup.
>  
>  We have a test case that documents the current procedure:
>  
>  https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...
>  
>  I believe the target URL will change for the public release, but the
>  procedure I think will stay more or less the same.
>  
>  Does someone want to co-ordinate with wwoods and tflink (who know the
>  most about fedup, I think) to make sure this is documented in the Beta
>  relnotes or whatever? Thanks!
>  -- 
>  Adam Williamson
>  Fedora QA Community Monkey
>  IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
>  http://www.happyassassin.net
>   
Along with this I think that we need to put something in the release
notes, possibly in the installer section. 

Some along the lines of what is already on this[1] page should be
sufficient.

"Beginning with Fedora 18 Beta, a new upgrade tool fedup has been
introduced, replacing older PreUpgrade. FedUp currently only supports
Fedora 17 -> Fedora 18 upgrades. If you want to upgrade Fedora 16, you
need to go through Fedora 17 as an intermediary step. More information
about the process [see the Install Guide]."

[1]: https://fedoraproject.org/wiki/Common_F18_bugs


Zach

[Pete Travis]

On Nov 26, 2012 10:51 AM, "Zachary Oglesby" <zach(a)oglesby.co&gt; wrote:
>  On Thu, 2012-11-22 at 14:48 -0800, Adam Williamson wrote:
>  > Hey, folks. I just wanted to check in and see if someone's on top of
>  > documenting the upgrade process for Beta, as it's still somewhat manual.
>  > I don't believe it's going to be as simple as 'yum install fedup;
> fedup'
>  > - it'll at least involve feeding an explicit URL to fedup.
>  >
>  > We have a test case that documents the current procedure:
>  >
>  > 
https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...
>  >
>  > I believe the target URL will change for the public release, but the
>  > procedure I think will stay more or less the same.
>  >
>  > Does someone want to co-ordinate with wwoods and tflink (who know the
>  > most about fedup, I think) to make sure this is documented in the Beta
>  > relnotes or whatever? Thanks!
>  > --
>  > Adam Williamson
>  > Fedora QA Community Monkey
>  > IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
>  > http://www.happyassassin.net
>  >
>  Along with this I think that we need to put something in the release
>  notes, possibly in the installer section.
>
>  Some along the lines of what is already on this[1] page should be
>  sufficient.
>
>  "Beginning with Fedora 18 Beta, a new upgrade tool fedup has been
>  introduced, replacing older PreUpgrade. FedUp currently only supports
>  Fedora 17 -> Fedora 18 upgrades. If you want to upgrade Fedora 16, you
>  need to go through Fedora 17 as an intermediary step. More information
>  about the process [see the Install Guide]."
>
>  [1]: https://fedoraproject.org/wiki/Common_F18_bugs
>
>
>  Zach
>
>  -- 
+1. The fedup section of the Installation Guide is already underway, so
this looks like the ideal way to handle it.

I'll drop in some copy along these lines, along with an admonishment shment
that fedup replaces both preupgrade *and* upgrading via the installation
image, when I get home this evening. Unless someone gets to it first.

--Pete

[Zach Oglesby]

On Mon, 2012-11-26 at 11:04 -0700, Pete Travis wrote:
>  
>  On Nov 26, 2012 10:51 AM, "Zachary Oglesby" <zach(a)oglesby.co&gt; wrote:
>  >
>  > On Thu, 2012-11-22 at 14:48 -0800, Adam Williamson wrote:
>  > > Hey, folks. I just wanted to check in and see if someone's on top
>  of
>  > > documenting the upgrade process for Beta, as it's still somewhat
>  manual.
>  > > I don't believe it's going to be as simple as 'yum install fedup;
>  fedup'
>  > > - it'll at least involve feeding an explicit URL to fedup.
>  > >
>  > > We have a test case that documents the current procedure:
>  > >
>  > >
>  https://fedoraproject.org/wiki/QA:Testcase_upgrade_fedup_cli_previous_des...
>  > >
>  > > I believe the target URL will change for the public release, but
>  the
>  > > procedure I think will stay more or less the same.
>  > >
>  > > Does someone want to co-ordinate with wwoods and tflink (who know
>  the
>  > > most about fedup, I think) to make sure this is documented in the
>  Beta
>  > > relnotes or whatever? Thanks!
>  > > --
>  > > Adam Williamson
>  > > Fedora QA Community Monkey
>  > > IRC: adamw | Twitter: AdamW_Fedora | identi.ca: adamwfedora
>  > > http://www.happyassassin.net
>  > >
>  > Along with this I think that we need to put something in the release
>  > notes, possibly in the installer section.
>  >
>  > Some along the lines of what is already on this[1] page should be
>  > sufficient.
>  >
>  > "Beginning with Fedora 18 Beta, a new upgrade tool fedup has been
>  > introduced, replacing older PreUpgrade. FedUp currently only
>  supports
>  > Fedora 17 -> Fedora 18 upgrades. If you want to upgrade Fedora 16,
>  you
>  > need to go through Fedora 17 as an intermediary step. More
>  information
>  > about the process [see the Install Guide]."
>  >
>  > [1]: https://fedoraproject.org/wiki/Common_F18_bugs
>  >
>  >
>  > Zach
>  >
>  > --
>  
>  +1. The fedup section of the Installation Guide is already underway,
>  so this looks like the ideal way to handle it. 
>  
>  
>  I'll drop in some copy along these lines, along with an admonishment
>  shment that fedup replaces both preupgrade *and* upgrading via the
>  installation image, when I get home this evening. Unless someone gets
>  to it first. 
>  
>  --Pete 
I should have git pulled before I typed this. There is already something
in the release notes about this (in Installation.xml). But as others
have pointed out the process is still evolving so we need to make sure
that the documentation is accurate come release time.

Sorry for any confusion,
Zach