Configuring an RHMI cluster

Cluster backups, upgrades, and maintenance

The rhmi-config CR configures backups and upgrades for RHMI. It can be found in the redhat-rhmi-operator namespace

Important

All dates and times used to specified upgrades and maintenance are internall stored as UTC (Coordenated Universal Time)

Scheduling backups

Default setting?

Scheduling maintenance windows

Default setting?

6 hour window

how frequent?

what happens, aside from applying CVEs and/or upgrades?

Scheduling upgrades

If an upgrade has been scheduled it will be displayed in the .Status.Upgrade.Scheduled.For field. The following rules are applied to calculate this date and time, based on the fields of the RHMI Config CR:

• If the value of waitForMaintenance is false ⇒ n days after the upgrade is made available, being n the value of notBeforeDays

• If the value of waitForMaintenance is true ⇒ the next maintenance window n days after the upgrade is made available, being n the value of notBeforeDays, and the maintenance window the next day of the week and time specified in .spec.maintenance.applyFrom

Default

By default, the upgrades will be scheduled in the next maintenance window after seven days of the upgrade being available. The values of the upgrade spec are:

• waitForMaintenance: true

• notBeforeDays: 7

Example

Having the following scenario:

Upgrade made available	Monday, the 13th of July of 2020
Value of notBeforeDays	3
Value of waitForMaintenance	true
Maintenance window	Tuesdays at 00:00

The upgrade will be scheduled the next Tuesday at 00:00, 3 days after the upgrade was made available, that is, Tuesday, the 21st of July of 2020, at 00:00

Handling of critical CVEs

Details required in this section

Scheduling upgrades in Solution Explorer

Note	The notes that are in this section has been taken from unreleased Marvel Mocks and are subject to change. This UI is believed to come in version 2.5.

As a customer administer, Solution Explorer is the expected means for editing the scheduling settings. The setting covered in this section is under the title of Managed Integration upgrades.

This section does not cover the setting of the Backups or Maintenance window which can be done in the same settings page.

1. New upgrade available as of: - Shows the date which current release made available. The date and time given should be local to the cluster which is been updated. UTC time is also give.

2. Apply upgrades - Is a radio button with two time slots to do the upgrade in. Both slots will provide the date and time for the upgrade in the cluster local timezone as well as UTC time.

   1. During the next maintenance window

   2. During the following maintenance window - The following maintenance window should be one week after the next maintenance window

3. Upgrade release notifications - When there is a new upgrade available and email is send out to the people stated in this section. Details are still been worked on in this section. One question that has not been answered yet is do the email addresses listed get notified when the upgrade has been completed.

   1. Default administrator email addresses - These address would not be customer editable and would be set up cluster creation or added by SRE. (Note to reader: This is a my understanding, it maybe worth following up on this once the UI is along)

   2. Additional email addresses - This is where the customer can add extra emails address that will be notified when there is a new upgrade available. (Note to reader: it is my understanding that will be a list separated by commas)

This is then followed by the save and cancel buttons. These buttons are for the whole page and not jus that section.