Bug 1371577

Summary: [Doc RFE] Add a new chapter in Deployment guide on how to use Gluster with GCP
Product: Red Hat Gluster Storage Reporter: Anjana Suparna Sriram <asriram>
Component: DocumentationAssignee: Divya <divya>
Status: CLOSED CURRENTRELEASE QA Contact: Rahul Hinduja <rhinduja>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: unspecifiedCC: mzywusko, rcyriac, rhs-bugs, sankarshan, storage-doc, storage-qa-internal
Target Milestone: ---Keywords: FutureFeature, ZStream
Target Release: RHGS 3.1.3 Async   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Anjana Suparna Sriram 2016-08-30 14:00:03 UTC
Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Deployment_Guide_for_Public_Cloud/index.html



Additional information:

Comment 2 Divya 2016-10-17 10:58:01 UTC
Added "Chapter 4. Using Red Hat Gluster Storage in the Google Cloud Platform " in the "Deployment Guide for Public Cloud" guide.

Link to the doc: http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Deployment_Guide_for_Public_Cloud%20(html-single)/lastStableBuild/artifact/tmp/en-US/html-single/index.html#chap-Documentation-Deployment_Guide_for_Public_Cloud-Google_Cloud_Platform

Some of the updates to the GCP chapter includes:

- Added “Obtaining Red Hat Gluster Storage for Google Cloud Platform” new section.

- Added “Subscribing to the Red Hat Gluster Storage Server Channels” section

- Added “Convert the downloaded” section

- Moved Section Building Red Hat Gluster Storage Compute Engine Image from Scratch as an Appendix

- Updated the Prerequisites section with information on subscribing to RHGS 3.1 channels

- Deleted “Software Entitlements” section and partial information of this section is added in Prerequisites section.

- Updated the guide wrt GUI labels.  

- To maintain consistency with other RHGS guides, replaced “$ sudo” with “#” in the commands.

- Added “4.15.3. Subscribing to the Red Hat Gluster Storage Server Channels” section

As I have made fair amount of changes across the chapter, request a detailed review of the entire chapter.

Comment 3 Bhaskarakiran 2016-10-18 06:47:53 UTC
There are couple of modifications that are needed :

-------------------------------------------------------------------------------
Section 4.1.2. Prerequisites

Add Google cloud sdk and refer the section 4.2.3 for installation
-------------------------------------------------------------------------------
Section 4.5 Uploading the Image into Google Cloud Storage.

Add a note says "You need to login before uploading the images to the google cloud. The command to login is "gcloud auth login" which opens up a browser and prompts for google account credentials and follow the subsequent CLI instructions."
-------------------------------------------------------------------------------
Section 4.15,

Remove till "A public image for Red Hat Gluster Storage is not available. However,"
-------------------------------------------------------------------------------

Comment 4 Divya 2016-10-19 00:56:46 UTC
(In reply to Bhaskarakiran from comment #3)
> There are couple of modifications that are needed :
> 
> -----------------------------------------------------------------------------
> --
> Section 4.1.2. Prerequisites
> 
> Add Google cloud sdk and refer the section 4.2.3 for installation

I have added the google cloud SDK as a prerequisite with a cross-reference to section 4.2.3.

As section 4.2.3 information is only one para, we can move the 4.2.3 content to prerequisite itself, what do you suggest?

> -----------------------------------------------------------------------------
> --
> Section 4.5 Uploading the Image into Google Cloud Storage.
> 
> Add a note says "You need to login before uploading the images to the google
> cloud. The command to login is "gcloud auth login" which opens up a browser
> and prompts for google account credentials and follow the subsequent CLI
> instructions."

Done

> -----------------------------------------------------------------------------
> --
> Section 4.15,
> 
> Remove till "A public image for Red Hat Gluster Storage is not available.
> However,"

Done 

> -----------------------------------------------------------------------------
> --

Link to the latest doc:  http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Deployment_Guide_for_Public_Cloud%20(html-single)/lastStableBuild/artifact/tmp/en-US/html-single/index.html#chap-Documentation-Deployment_Guide_for_Public_Cloud-Google_Cloud_Platform

Comment 5 Bhaskarakiran 2016-10-19 06:12:53 UTC
Changed needed. Moving back the bug.

-------------------------------------------------------------------------------
4.1.2. Prerequisites

Change:

Install the gcloud SDK. For more information on installing the Google Cloud SDK, see Section 4.2.3, “Install the gcloud SDK”

to:

Google Cloud SDK. For more information on installing it, see Section 4.2.3, “Install the gcloud SDK”

--------------------------------------------------------------------------------

Section 4.1.3:

Change:

Custom Red Hat Gluster Storage 3.1 on Red Hat Enterprise Linux 7

to:

Custom Red Hat Gluster Storage on Red Hat Enterprise Linux 7
--------------------------------------------------------------------------------

Section 4.1.4:

Change:

Custom Red Hat Gluster Storage 3.1 on Red Hat Enterprise Linux 7

to:

Custom Red Hat Gluster Storage on Red Hat Enterprise Linux 7
--------------------------------------------------------------------------------

Section :4.1.5

Change:

Custom RHGS 3.1 on RHEL 7

to:

Custom RHGS on RHEL 7
--------------------------------------------------------------------------------

Section 4.5 :

Change:

You must login using gcloud auth login command to upload the images to the google cloud. Running the command will open a browser and prompts for google account credentials. Follow the subsequent CLI instructions. 

to:

You must login using "gcloud auth login" command before uploading the images to the google cloud. Running the command will open a browser and prompts for google account credentials. The PROJECT_ID is set by default and follow the subsequent CLI instructions if it needs to be changed.

--------------------------------------------------------------------------------

Comment 7 Bhaskarakiran 2016-10-19 09:05:00 UTC
As discussed with Anjana, sections 4.1.4 and 4.15 can remain the same.

Comment 8 Divya 2016-10-19 09:33:44 UTC
(In reply to Bhaskarakiran from comment #5)
> Changed needed. Moving back the bug.
> 
> -----------------------------------------------------------------------------
> --
> 4.1.2. Prerequisites
> 
> Change:
> 
> Install the gcloud SDK. For more information on installing the Google Cloud
> SDK, see Section 4.2.3, “Install the gcloud SDK”
> 
> to:
> 
> Google Cloud SDK. For more information on installing it, see Section 4.2.3,
> “Install the gcloud SDK”
> 

Further to my Comment 4 and discussion with Bhaskarakiran, moved the 4.2.3 content to the Prerequisite section.

> -----------------------------------------------------------------------------
> ---
> 
> Section 4.1.3:
> 
> Change:
> 
> Custom Red Hat Gluster Storage 3.1 on Red Hat Enterprise Linux 7
> 
> to:
> 
> Custom Red Hat Gluster Storage on Red Hat Enterprise Linux 7

Retaining it as is.

> -----------------------------------------------------------------------------
> ---
> 
> Section 4.1.4:
> 
> Change:
> 
> Custom Red Hat Gluster Storage 3.1 on Red Hat Enterprise Linux 7
> 
> to:
> 
> Custom Red Hat Gluster Storage on Red Hat Enterprise Linux 7

Retaining it as is.
> -----------------------------------------------------------------------------
> ---
> 
> Section :4.1.5
> 
> Change:
> 
> Custom RHGS 3.1 on RHEL 7
> 
> to:
> 
> Custom RHGS on RHEL 7

Changed it to "Custom Red Hat Gluster Storage 3.1 on Red Hat Enterprise Linux 7".

> -----------------------------------------------------------------------------
> ---
> 
> Section 4.5 :
> 
> Change:
> 
> You must login using gcloud auth login command to upload the images to the
> google cloud. Running the command will open a browser and prompts for google
> account credentials. Follow the subsequent CLI instructions. 
> 
> to:
> 
> You must login using "gcloud auth login" command before uploading the images
> to the google cloud. Running the command will open a browser and prompts for
> google account credentials. The PROJECT_ID is set by default and follow the
> subsequent CLI instructions if it needs to be changed.

Updated the text based on the suggestion.            
> 
> -----------------------------------------------------------------------------
> ---

Link to the latest doc: http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Deployment_Guide_for_Public_Cloud%20(html-single)/lastStableBuild/artifact/tmp/en-US/html-single/index.html#sect-Documentation-Deployment_Guide_for_Public_Cloud-Google_Cloud_Platform-Primary_Storage_Pool

Comment 9 Bhaskarakiran 2016-10-19 10:05:23 UTC
Looks good. Marking this bug as verified.