Skip to content

Upgrade guide to release-6#463

Merged
ShyamsundarR merged 2 commits intogluster:masterfrom
amarts:upgrade-to-6
Mar 25, 2019
Merged

Upgrade guide to release-6#463
ShyamsundarR merged 2 commits intogluster:masterfrom
amarts:upgrade-to-6

Conversation

@amarts
Copy link
Member

@amarts amarts commented Mar 22, 2019

Signed-off-by: Amar Tumballi amarts@redhat.com

@amarts amarts requested a review from ShyamsundarR March 22, 2019 07:26
@@ -0,0 +1,81 @@
## Upgrade procedure to Gluster 6, from Gluster 5.x, 4.1.x, and 3.12.x
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't we need to add this file to the mkdocs.yml file at the root of the repo? I always thought the build depended on the same.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


## Deprecated translator upgrade guide

With glusterfs-6.0 release, we are planning to deprecate few of the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reword, to say we have already done this, currently reads "we are planning to..."

So something like so:
With this release of Gluster, the following xlator/features are deprecated and are not available in the distribution specific packages. If any of these xlators or features are in use, refer to instructions on steps needed pre-upgrade to plan for an upgrade to this release"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

instructions below, so you can preserve sanity in your glusterfs
release.

### Stripe volume
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we need some rewording here as and like so in other cases as well:

Stripe xlator, provided the ability to stripe data across bricks. This functionality was used to create and support files larger than a single brick and also to provide better disk utilization across large file IO, by spread the IO blocks across bricks and hence disks.

This functionality is now provided by the shard xlator (any links here wold help, to configure and use shard).

There is no in place upgrade feasible for volumes using the stripe feature, and users are encouraged to migrate their data from existing stripe based volumes to sharded volumes.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


### Tier volume

If you are using Tier feature, this is not supported in glusterfs-6.0.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here the salient bullets would be:

  • Tier no longer supported
  • No replacement feature in the release
  • Convert tiered volumes to regular volumes by detaching the tier
  • Then upgrade

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


All the above translators were not supported in previous versions, but
users had an option to create the volumes. Now, if you had created these
volumes, please delete these volumes and then upgrade to glusterfs-6.0
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

migrate data out of these volumes, not delete the volumes :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

Signed-off-by: Amar Tumballi <amarts@redhat.com>
Signed-off-by: ShyamsundarR <srangana@redhat.com>
Copy link
Member Author

@amarts amarts left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the edits @ShyamsundarR

LGTM.

@ShyamsundarR ShyamsundarR merged commit dc6d45a into gluster:master Mar 25, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants