Added a downgrading guide doc #10

RichardLitt · 2015-12-14T21:37:48Z

Thought this might be useful: I had to ask @diasdavid how to do this.

jbenet · 2015-12-15T14:45:55Z

downgrading.md

@@ -0,0 +1,26 @@
+## Downgrading IPFS versions
+
+Downgrading your IPFS version (for instance, from 4.0 to 3.8) is not as complicated as upgrading. You can't use the same repository simultaneously for both versions. Here is how you switch


0.4.0 and 0.3.8

RichardLitt · 2015-12-15T15:51:10Z

Added a section for using ipfs-update and a TODO; I can write that, but will need help as I'm unfamiliar with ipfs-update.

jbenet · 2015-12-15T16:24:09Z

Cc @whyrusleeping
On Tue, Dec 15, 2015 at 10:51 Richard Littauer [email protected]
wrote:

Added a section for using ipfs-update and a TODO; I can write that, but
will need help as I'm unfamiliar with ipfs-update.

—
Reply to this email directly or view it on GitHub
#10 (comment)
.

whyrusleeping · 2015-12-15T18:08:11Z

I would add a bit on what the actions taken in your code actually do, your new daemon won't have any of the same data as before.

If you really want to do a downgrade (and not a clean install of an older version) you would have to revert your repo:

$ ipfs-2-to-3 -revert -path=$IPFS_PATH

jbenet · 2015-12-16T09:29:17Z

your new daemon won't have any of the same data as before.

no guide that we give users should ever do this (unless it makes it absolutely clear with a huge warning). i propose we stick to always getting users to downgrade the migration.

we can mention that "you can just get rid of your old repo, or move it to a backup location and init a new node" as a secondary option.

daviddias · 2015-12-16T10:02:33Z

Oh, there is a -revert option? nice!

jbenet · 2015-12-16T10:48:04Z

Oh, there is a -revert option? nice!

:)

RichardLitt · 2015-12-16T15:32:45Z

ipfs-2-to-3 -revert -path=$IPFS_PATH

Does this work for ifps-3-to-4?

jbenet · 2015-12-16T19:40:14Z

yeah they should all be the same. though 3-to-4 isnt merged yet

RichardLitt · 2015-12-18T00:03:16Z

I think this is the edit suggested, but I am not sure. I've only ever used the method described in the manual section, because that was what was suggested for me. Thoughts?

whyrusleeping · 2015-12-18T07:28:56Z

I'll admit the numbering is a tad confusing '2' here refers to ipfs 0.3.*, and '3' refers to ipfs 0.4.0

jbenet · 2015-12-18T19:13:59Z

The numbers are independent sequences. The fs-repo versions 2 and 3
coincide with go-ipfs versions 0.3 and 0.4, but are different numbers.
On Fri, Dec 18, 2015 at 02:28 Jeromy Johnson [email protected]
wrote:

I'll admit the numbering is a tad confusing '2' here refers to ipfs 0.3.*,
and '3' refers to ipfs 0.4.0

—
Reply to this email directly or view it on GitHub
#10 (comment)
.

RichardLitt · 2015-12-18T19:33:24Z

So, ipfs-2-to-3 doesn't actually refer to IPFS 2, or 3? That is really confusing. How about ipfs-fs-2-to-3 or something as a name, instead?

whyrusleeping · 2015-12-18T19:33:59Z

i mean, thats why its the 'fs-repo-migrations', but yeah. maybe we could rename slightly

ghost · 2015-12-18T19:50:24Z

fs-repo-2-to-3 would match fs-repo-migrations. Also just in case: blue! :):)

jbenet · 2015-12-18T20:08:27Z

+1 for fs-repo-2-to-3
On Fri, Dec 18, 2015 at 2:50 PM Lars Gierth [email protected]
wrote:

fs-repo-2-to-3 would match fs-repo-migrations. Also just in case: blue!
:):)

—
Reply to this email directly or view it on GitHub
#10 (comment)
.

RichardLitt · 2015-12-21T19:17:21Z

Is that all needs to happen to make that name change a change of the dir_names in this directly from ipfs-* to fs-*?

dignifiedquire · 2016-01-07T17:29:03Z

downgrading.md

+
+## Manually downgrading IPFS versions
+
+**You should not have to do this manually. Automatically downgrading is the preferred method.*


One * either too much or too little

RichardLitt · 2016-01-07T18:05:13Z

Good catch @dignifiedquire, thanks.

chriscool · 2016-01-28T16:32:41Z

@whyrusleeping or @jbenet could you take a look at merging this? Thanks!

jbenet · 2016-02-03T02:47:30Z

downgrading.md

+
+**You should not have to do this manually. Automatically downgrading is the preferred method.**
+
+Manually downgrading your IPFS version (for instance, from `0.4.0` to `0.3.8`) is not as complicated as upgrading. You can't use the same repository simultaneously for both versions. Here is how you switch. Note that this is actually a clean install, and that your daemon won't have the same data as before.


No, this is not downgrading, this is "installing a different version from scratch."

Downgrading the version of a repo MUST ALWAYS preserve all user data.

I feel like we make that clear? But I've pushed a slightly different version making this blatant.

chriscool · 2016-02-18T10:11:32Z

Ping!

whyrusleeping · 2016-03-01T18:22:44Z

This should be updated, the instructions it gives are incorrect, it is possible to downgrade safely without losing data using the ipfs-X-to-Y tools. We should document that here.

RichardLitt · 2016-03-07T16:04:26Z

@whyrusleeping I am confused. It looks like it says that, to me. That's the first section.

RichardLitt · 2016-07-14T10:02:28Z

@whyrusleeping What do you need from me, here?

ghost · 2017-01-06T23:13:54Z

downgrading.md

+```sh
+cd $GOPATH/src/github.com/ipfs/go-ipfs
+git checkout master # (or the version you want)
+go install ./cmd/ipfs


this should be make install now

RichardLitt · 2017-01-06T23:32:50Z

@lgierth Fixed!

ghost · 2017-01-07T00:05:51Z

downgrading.md

-cd $GOPATH/src/github.com/ipfs/go-ipfs
-git checkout master # (or the version you want)
-go install ./cmd/ipfs
+make install


Oh I meant only that go install is make install now :)

Fixed again.

hsanjuan · 2020-01-30T10:07:23Z

This is a bit old, and this repo is probably not the place to document a general downgrade process now we have dedicated websites.

RichardLitt · 2020-01-31T10:18:19Z

Sounds good. Thanks, @hsanjuan.

jbenet reviewed Dec 15, 2015
View reviewed changes

RichardLitt force-pushed the feature/downgrading branch from 4983966 to 4a1938a Compare December 15, 2015 15:49

RichardLitt force-pushed the feature/downgrading branch from 4a1938a to df54848 Compare December 18, 2015 00:02

dignifiedquire reviewed Jan 7, 2016
View reviewed changes

RichardLitt force-pushed the feature/downgrading branch from df54848 to 3e4079c Compare January 7, 2016 18:04

RichardLitt mentioned this pull request Jan 7, 2016

Migrating downward to a previous version is not documented #16

Closed

jbenet reviewed Feb 3, 2016
View reviewed changes

Added a downgrading guide doc

c8b49f9

RichardLitt force-pushed the feature/downgrading branch from 3e4079c to c8b49f9 Compare February 3, 2016 18:33

chriscool mentioned this pull request Mar 1, 2016

RFM: fs-repo-migrations: Added a downgrading guide doc whyrusleeping/todo#3

Closed

whyrusleeping mentioned this pull request Mar 1, 2016

update fs-repo-migration downgrading doc RichardLitt/todo#1

Closed

RichardLitt assigned whyrusleeping Mar 7, 2016

RichardLitt mentioned this pull request Mar 21, 2016

Sprint: March 7-20 ipfs/team-mgmt#97

Closed

RichardLitt added the needs review label Jun 22, 2016

ghost reviewed Jan 6, 2017

View reviewed changes

ghost reviewed Jan 7, 2017

View reviewed changes

Added make install instead

0fe21f4

RichardLitt force-pushed the feature/downgrading branch from e5e4139 to 0fe21f4 Compare January 7, 2017 00:43

hsanjuan closed this Jan 30, 2020

hsanjuan mentioned this pull request May 22, 2020

Explain the downgrade procedure for Go-IPFS. ipfs/ipfs-docs#278

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added a downgrading guide doc #10

Added a downgrading guide doc #10

RichardLitt commented Dec 14, 2015

jbenet Dec 15, 2015

RichardLitt commented Dec 15, 2015

jbenet commented Dec 15, 2015

whyrusleeping commented Dec 15, 2015

jbenet commented Dec 16, 2015

daviddias commented Dec 16, 2015

jbenet commented Dec 16, 2015

RichardLitt commented Dec 16, 2015

jbenet commented Dec 16, 2015

RichardLitt commented Dec 18, 2015

whyrusleeping commented Dec 18, 2015

jbenet commented Dec 18, 2015

RichardLitt commented Dec 18, 2015

whyrusleeping commented Dec 18, 2015

ghost commented Dec 18, 2015

jbenet commented Dec 18, 2015

RichardLitt commented Dec 21, 2015

dignifiedquire Jan 7, 2016

RichardLitt commented Jan 7, 2016

chriscool commented Jan 28, 2016

jbenet Feb 3, 2016

RichardLitt Feb 3, 2016

chriscool commented Feb 18, 2016

whyrusleeping commented Mar 1, 2016

RichardLitt commented Mar 7, 2016

RichardLitt commented Jul 14, 2016

ghost Jan 6, 2017

RichardLitt commented Jan 6, 2017

ghost Jan 7, 2017

RichardLitt Jan 7, 2017

hsanjuan commented Jan 30, 2020

RichardLitt commented Jan 31, 2020

		@@ -0,0 +1,26 @@
		## Downgrading IPFS versions

		Downgrading your IPFS version (for instance, from 4.0 to 3.8) is not as complicated as upgrading. You can't use the same repository simultaneously for both versions. Here is how you switch


		## Manually downgrading IPFS versions

		*You should not have to do this manually. Automatically downgrading is the preferred method.


		You should not have to do this manually. Automatically downgrading is the preferred method.

		Manually downgrading your IPFS version (for instance, from `0.4.0` to `0.3.8`) is not as complicated as upgrading. You can't use the same repository simultaneously for both versions. Here is how you switch. Note that this is actually a clean install, and that your daemon won't have the same data as before.

Added a downgrading guide doc #10

Added a downgrading guide doc #10

Conversation

RichardLitt commented Dec 14, 2015

jbenet Dec 15, 2015

Choose a reason for hiding this comment

RichardLitt commented Dec 15, 2015

jbenet commented Dec 15, 2015

whyrusleeping commented Dec 15, 2015

jbenet commented Dec 16, 2015

daviddias commented Dec 16, 2015

jbenet commented Dec 16, 2015

RichardLitt commented Dec 16, 2015

jbenet commented Dec 16, 2015

RichardLitt commented Dec 18, 2015

whyrusleeping commented Dec 18, 2015

jbenet commented Dec 18, 2015

RichardLitt commented Dec 18, 2015

whyrusleeping commented Dec 18, 2015

ghost commented Dec 18, 2015

jbenet commented Dec 18, 2015

RichardLitt commented Dec 21, 2015

dignifiedquire Jan 7, 2016

Choose a reason for hiding this comment

RichardLitt commented Jan 7, 2016

chriscool commented Jan 28, 2016

jbenet Feb 3, 2016

Choose a reason for hiding this comment

RichardLitt Feb 3, 2016

Choose a reason for hiding this comment

chriscool commented Feb 18, 2016

whyrusleeping commented Mar 1, 2016

RichardLitt commented Mar 7, 2016

RichardLitt commented Jul 14, 2016

ghost Jan 6, 2017

Choose a reason for hiding this comment

RichardLitt commented Jan 6, 2017

ghost Jan 7, 2017

Choose a reason for hiding this comment

RichardLitt Jan 7, 2017

Choose a reason for hiding this comment

hsanjuan commented Jan 30, 2020

RichardLitt commented Jan 31, 2020