Run install command

Important

Mirantis has transitioned to an OCI-based Helm registry for registry.mirantis.com. As a result, Helm repository management is no longer required. Commands that rely on Helm repository operations, such as helm repo update and helm upgrade, will fail with HTTP 4xx errors.

For both new installations and upgrades, use the OCI-based registry URL directly. To check for available upgrades, run helm upgrade --dry-run without specifying a version.

For more details, see the Helm documentation.

Note

You can configure settings either in the YAML file or as command-line flags during installation. If the same setting is defined in both, the command-line flag takes precedence.

  1. Use a Helm chart to install MSR:

    helm install msr oci://registry.mirantis.com/msr/helm/msr \
  --version <helm-chart-version> \
  --timeout 20m0s \
  --set-file license=path/to/file/license.lic
    MSR version compatibility with Helm charts

    MSR 3.1 version

    Chart version

    3.1.14

    1.1.18

    3.1.13

    1.1.17

    3.1.12

    1.1.16

    3.1.11

    1.1.15

    3.1.10

    1.1.12

    3.1.9

    1.1.11

    3.1.8

    1.1.10

    3.1.7

    1.1.9

    3.1.6

    1.1.8

    3.1.5

    1.1.6

    3.1.4

    1.1.5

    3.1.3

    1.1.4

    3.1.2

    1.1.3

    3.1.1

    1.1.2

    3.1.0

    1.1.0

    3.0.12

    1.0.14

    3.0.11

    1.0.13

    3.0.10

    1.0.12

    3.0.9

    1.0.10

    3.0.8

    1.0.9

    3.0.7

    1.0.8

    3.0.6

    1.0.7

    3.0.5

    1.0.6

    3.0.4

    1.0.5

    3.0.3

    1.0.4

    3.0.2

    1.0.2

    3.0.1

    1.0.1

    3.0.0

    1.0.0

    Note

    If the installation fails and MSR Pods continue to run in your cluster, it is likely that MSR failed to complete the initialization process, and thus you must reinstall MSR. To delete the Pods and completely uninstall MSR:

    1. Delete any running msr-initialize Pods:

      kubectl delete job msr-initialize

    2. Delete any remaining Pods:

      helm uninstall msr

  2. Verify the success of your MSR installation.

    1. Verify that all msr-* Pods are in the running state. For more detail, refer to Check the Pods.

    2. Set up your load balancer.

    3. Log into the MSR web UI.

    4. Log into MSR from the command line:

      docker login $FQDN

    5. Push an image to MSR using docker push.

    Note

    The default credentials for MSR are:

    • User name: admin

    • password: password

    Be aware that the Helm chart values also include the default MSR credentials information. As such, Mirantis strongly recommends that you change the credentials immediately following installation.

See also