Installer fails validation checks

Version/Environment (if relevant):

Domino 5.3+, Installer v57+

Issue:

If you are trying to rerun the Domino installer to make a change to one of the components in the domino.yaml that should not be changed post install, you will receive one of the following errors from the installer depending on your version:

You are attempting to modify an immutable config value

Forbidden: updates to statefulset spec for fields other than 'replicas', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden.

The following components that are restricted from change post install by the Installer are below.

Immutable Components

• name:
• hostname:
• ssl_enabled:
• namespaces.compute.name:
• storage_classes:
• blob_storage:
• email_notifications:
• telemetry:

Root Cause:

These components are blocked from update to avoid breaking the deployment. 

Resolution:

If you have made a typo that needs to be corrected in a deployment that is already running and understand the impact of the change you are making, you can delete the most recent fleetcommand-agent configmap.  If you are uncertain of the impact of your change, reach out to Domino Support prior to rerunning the installer.

To find the fleetcommand-agent configmap, run the following:

# kubectl get cm -n domino-system | grep fleetcommand-agent

Results will look similar to the following:

fleetcommand-agent-sup570ds        1 9d
fleetcommand-agent-sup570ds-2568   1 9d

Delete the most recent copy of the configmap:

# kubectl delete cm -n domino-system fleetcommand-agent-sup570ds