17 Env Updates
The Env updates functionality gives the Retail Home patch administrator the ability to upgrade an application to a newer version.
The Env Updates tab is displayed on the Details and Updates contextual pane, which can be accessed by clicking the View Version History link for the applicable cloud service on the Application Dashboard page.
The Env Updates tab is only visible to users who have been assigned the RH_PATCH_ADMIN
role.
Figure 17-1 Env Updates Tab
![Env Updates Tab Env Updates Tab](img/env-updates-tab.png)
Patch Request
The user can request an upgrade to a version that is greater than the one currently installed using the Request Patch button.
The required fields for requesting a patch are:
-
Version number (from the Available Versions dropdown)
-
Planned Start Date and Time
The Planned Start Date and Time must be set to a value in the future.
Once a patch request is successfully created, the status of the request would be appended to the corresponding version in the Available Versions dropdown. The possible statuses are Accepted, Pending Approval, Rejected, and Scheduled. The Request For Planned Patch button would be disabled at this point and would only be enabled if the patch request is Rejected.
Below are the patch request flows:
-
Request Patch -> Request Accepted -> Request Approved -> Patch Scheduled
-
Request Patch -> Request Accepted -> Patch Rejected
The administrator also can also create a new patch request while the previous one is in “Scheduled and Approved” status.
-
Request Patch -> Request Accepted -> Request Approved -> Patch Scheduled -> Reschedule Patch -> Reschedule Request Accepted -> Reschedule Request Approved -> Patch Scheduled
-
Request Patch -> Request Accepted -> Request Approved -> Patch Scheduled
-
Request Patch -> Request Accepted -> Request Approved -> Patch Scheduled -> Reschedule Patch -> Reschedule Request Rejected -> (Initial) Patch Scheduled
-
Request Patch -> Request Accepted -> Request Approved -> Reschedule Patch -> Reschedule Request Accepted -> Reschedule Request Approved -> Patch Scheduled
Figure 17-2 Status Display After Requesting a Patch
![Status Display After Requesting a Patch Status Display After Requesting a Patch](img/status-disp-after-req-patch.png)
Once the patch run is kicked off, the status will no longer be appended to the version and instead would be displayed in a status bar along with version name.
Figure 17-3 In Progress Patch with Status Bar
![In Progress Patch with Status Bar In Progress Patch with Status Bar](img/in-prog-patch-stat-bar.png)
The Request Patch button is only be enabled for the version once the patch is completed (with or without errors/warnings).
The completed patch run would have the following additional details.
-
Actual Start Date and Time
-
Actual End Date and Time
Figure 17-4 Completed Patch Run with Error Display
![Completed Patch Run with Error Display Completed Patch Run with Error Display](img/cmplt-patch-run-err-disp.png)