Resetting the mzadmin Password(4.1)

Owned by Philip Yeo
Oct 24, 2024
1 min read

If the password for mzadmin is lost, it can either be changed by another user belonging to the Administration group or be set according to the following procedure:

  1. Access the pod’s platform terminal using kubectl exec command and using the command mzsh encryptpassword to get the encryption which will be used in the following step.

    mzadmin@platform-0:/opt/mz$ mzsh encryptpassword samplepw DR-4-CC7A55C17B6EA7A4CFBCFFFE5AA296C8

     

  2. Locate and open values.yaml file. Find the section, systemProperties and add the following configuration property.

    mz.user.emergency.unlock=<encrypted pw value from prior step>

     

    Example:

    mz.user.emergency.unlock=DR-4-CC7A55C17B6EA7A4CFBCFFFE5AA296C8

     

  3. Locate the persistence section, and set the property enabled to true.

    Also under the persistence section, setup the existingClaim to your own pv and pvc setup in your own environment. The example above uses the existingClaim value of ‘pe-pv-claim’. This should change depending on your setup.

  4. Restart the Platform pod. Based on the changed values.yaml, upgrade the existing Helm release so that Platform pod is restarted.

  5. Login with the new temporary password and key in your new password twice to change it. Once successfully logged in, remove the property, mz.user.emergency.unlock and restart the Platform pod again.

Â