CCSINTL-471: 1st set of premigration updates to RPM install and upgrade docs #4231
Conversation
sayjadha
added
Not ready for peer review
| [role="_additional-resources"] | ||
| .Additional resources | ||
| See {LinkGettingStarted} for post installation instructions. | ||
| * {LinkGettingStarted} |
There was a problem hiding this comment.
This link sends a 404 error from the preview I built locally.
There was a problem hiding this comment.
@jonquilwilliams good catch. For some weird reason the attribute usage is giving a 404 error. Corrected it, and used the URL instead.
|
|
||
| * 2.4 services will only include {ControllerName} and {HubName}. | ||
| * 2.5 parts will always include {EDAName} and the unified UI ({Gateway}). | ||
| * Combining install methods for these topologies is not supported. |
There was a problem hiding this comment.
suggest/ install -> installation (IBM word list - adjective/noun usage)
| == Upgrade considerations | ||
|
|
||
| * You must maintain two separate inventory files: one for the 2.4 services and one for the 2.5 services. | ||
| * You must maintain two separate "installations" within this scenario: one for the 2.4 services and one for the 2.5 services. |
There was a problem hiding this comment.
This is a nit and might just be my personal preference, but I think you can remove all of the quotation marks in this section. I think it's clear enough without them. It's up to you though.
There was a problem hiding this comment.
Agreed, made the edit.
|
|
||
| . Run `setup.sh` | ||
| + | ||
| The installer upgrades {ControllerName} and {HubName} from 2.4 to {PlatformNameShort} 2.5.latest, {EDAName} and the unified UI ({Gateway}) from the fresh install of 2.5 to the latest version of 2.5, and connects {ControllerName} and {HubName} properly with the unified UI ({Gateway}) node to initialize the unified experience. |
There was a problem hiding this comment.
I think there should be a serial comma between these: "{EDAName}, and the unified UI ({Gateway})"
| .Verification | ||
|
|
||
| * Verify that everything has upgraded to 2.5 and is working properly in one of two ways: | ||
| ** performing an SSH to {ControllerName} and {EDAName}. |
There was a problem hiding this comment.
Suggest init cap: performing -> Performing
There was a problem hiding this comment.
Changed to 'Perform'
|
Verified updates that were suggested during thorough review from @jonquilwilliams . LGTM |
…de docs (ansible#4231) * CCSINTL-471: 1st set of premigration updates to RPM install and upgrade docs * CCSINTL-471: 2nd set of premigration updates * CCSINTL-471: Incorporated 3rd set of premigration check updates * CCSINTL-471: Incorporated peer feedback
…de docs (ansible#4231) * CCSINTL-471: 1st set of premigration updates to RPM install and upgrade docs * CCSINTL-471: 2nd set of premigration updates * CCSINTL-471: Incorporated 3rd set of premigration check updates * CCSINTL-471: Incorporated peer feedback
This PR addresses JIRA https://issues.redhat.com/browse/CCSINTL-471.
Changes made: