Bug 1376721 - [DOC]:- Add a section in 1.3 install guide with instructions to upgrade from 1.3.2 to 1.3.3
Summary: [DOC]:- Add a section in 1.3 install guide with instructions to upgrade from ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat
Component: Documentation
Version: 1.3.3
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: rc
: 1.3.3
Assignee: Aron Gunn
QA Contact: shylesh
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-09-16 09:06 UTC by shylesh
Modified: 2016-09-30 17:21 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-09-30 17:21:25 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description shylesh 2016-09-16 09:06:15 UTC
Description of problem:

We need a document for upgrading from 1.3.2 to 1.3.3 upgrade. The document will be pretty much same as 1.3.1 to 1.3.2

Comment 1 Red Hat Bugzilla Rules Engine 2016-09-16 09:06:20 UTC
This bug is automatically being proposed for Ceph 2.z by setting the "ceph-2.z" release flag to "?"

Comment 2 Red Hat Bugzilla Rules Engine 2016-09-16 09:06:20 UTC
Setting the Target Release to version 2.1 to match the release flag of "ceph-2.z"

Comment 3 Harish NV Rao 2016-09-16 09:24:28 UTC
What Shylesh meant was to add a section in current 1.3 install/upgrade doc with instructions to upgrade from 1.3.2 to 1.3.3.

Comment 4 Aron Gunn 2016-09-20 02:41:06 UTC
QA Team,

Instead of adding a whole new upgrade section, I've consolidated the upgrade content into two sections, one for upgrading from RHCS 1.2.3 to 1.3.3 and one for upgrading from 1.3.x to 1.3.3.  This eliminates redundant content, since upgrade steps to minor RHCS 1.3 versions are the same.

GitLab Commits:

- https://gitlab.cee.redhat.com/red-hat-ceph-storage-documentation/doc-Red_Hat_Ceph_Storage_1.3-Installation_Guide/compare/9de1e286f7fac72f165a0eae2604748108fd0f17...6a0809b758ad88389db88ca00aace238f8b7cd5a

Preview Links:

RHEL - https://access.qa.redhat.com/documentation/en/red-hat-ceph-storage/1.3/single/installation-guide-for-red-hat-enterprise-linux/#upgrading_your_storage_cluster

Ubuntu - https://access.qa.redhat.com/documentation/en/red-hat-ceph-storage/1.3/single/installation-guide-for-ubuntu/#upgrading_your_storage_cluster

Don't hesitate to yell at me if you have any questions or concerns.

Best Regards,
Aron

Comment 5 Harish NV Rao 2016-09-20 13:29:33 UTC
@Vikhyat,

Can you please take a look at the doc changes done as part of comment 4 and let us know whether this is ok with Support?

Regards,
Harish

Comment 6 Harish NV Rao 2016-09-20 13:30:23 UTC
@Federico,

Can you please take a look at the doc changes done as part of comment 4 and let us know whether this is ok with Product?

Regards,
Harish

Comment 7 Harish NV Rao 2016-09-21 06:35:01 UTC
Vikhyat and Federico, please respond asap. We need this to be finalized before 22nd Sep in order to start upgrade testing with RC build.

Comment 8 Vikhyat Umrao 2016-09-21 06:56:16 UTC
Sorry Harish. I was out of office. 

Thanks Aron, both looks good to me.

Comment 9 shylesh 2016-09-21 14:26:00 UTC
Doc link contains section for "upgrading 1.2.3 to 1.3.3.". QE will not be testing  "Upgrading 1.2.3 to 1.3.3" as this is pm's decision and not in supported matrix.


@Federico,

Could you please confirm this,

Thanks,

Comment 10 Federico Lucifredi 2016-09-22 16:41:15 UTC
PM is aligned with Aaron's plan as defined in #4. I skimmed through the Gitlab draft and I did not see anything amiss.

Comment 11 shylesh 2016-09-26 11:11:00 UTC
(In reply to shylesh from comment #9)
> Doc link contains section for "upgrading 1.2.3 to 1.3.3.". QE will not be
> testing  "Upgrading 1.2.3 to 1.3.3" as this is pm's decision and not in
> supported matrix.
> 
> 
> @Federico,
> 
> Could you please confirm this,
> 
> Thanks,

@Federico,

Could you please reply to comment9

Thanks,
Shylesh

Comment 12 Federico Lucifredi 2016-09-26 16:21:12 UTC
I was discussing this with Harish earlier today.

the docs are *probably* good, however they inherently promise migration paths we do not  support: we only support 1.3.2->1.3.3, we would not support 1.3.0->1.3.3 or 1.3.1->1.3.3 — it is not that it cannot be made to work, it is just not what we are willing to promise all users. If the request arose, we would just ask Support or Consulting to spot-check the case under the conditions of the specific customer.

So, Aaron, I think we need to adjust to offer only what was QE tested (1.3.2->1.3.3).

—-

Secondly, while I would like to include a 1.2.3->1.3.3 migration as something helping any user still running now-EOL 1.2.3, that was not part of the test plan either, so our documentation should just link to the old RHCS 1.3.2 doc on upgrade 1.2.3->1.3.2 if it is still available.

We believe most if not all RHCS customers have successfully moved to 1.3.x and that this is a limited concern.

Comment 13 Harish NV Rao 2016-09-28 17:21:57 UTC
Moving to assigned state to incorporate the contents from comment 12

Comment 15 shylesh 2016-09-29 17:57:59 UTC
A small typo needs to be addressed in https://access.qa.redhat.com/documentation/en/red-hat-ceph-storage/1.3/single/installation-guide-for-red-hat-enterprise-linux/#upgrade-v13-to-v13x.

In section 4.1. Upgrading 1.3.2 to 1.3.3 first line says "There are two ways to upgrade Red Hat Ceph Storage 1.3.x to 1.3.3" please make this as "There are two ways to upgrade Red Hat Ceph Storage 1.3.2 to 1.3.3".

Thanks,
Shylesh

Comment 17 shylesh 2016-09-29 18:22:19 UTC
Looks good, marking this as verified.


Note You need to log in before you can comment on or make changes to this bug.