Documentation

Documentation

mc license register

Table of Contents

Note

Changed in version RELEASE.2022-07-15T09-20-55Z.

mc license register replaces the mc support register command.

Description

The mc license register command connects your deployment with your MinIO SUBNET account.

After registration, you can upload deployment health reports directly to SUBNET using the mc support diag command.

Examples

Register a Deployment Using the Deployment’s Name

Register the MinIO deployment at alias minio1 on SUBNET, using minio1 as the deployment name:

mc license register minio1

If not already registered, a prompt asks for SUBNET credentials for the deployment.

Register a Deployment with a Different Deployment Name

Register a MinIO deployment at alias minio2 on SUBNET, using second-deployment as the name:

mc license register minio2 --name second-deployment

Register a Deployment Without Direct Internet Access

Register a MinIO deployment at alias minio3 on SUBNET that does not have direct Internet access due to a firewall, airgap, or the like.

mc license register minio3 --airgap
  1. Run the command to return a registration token

  2. Copy the registration token

  3. In a web browser, go to https://subnet.min.io and log in with your MinIO SUBNET credentials

  4. Select the Register button

  5. Select No for the question “Is the cluster connected to the internet?”

  6. Paste the copied token into the box for Register using MinIO Client Utility

  7. Select Register

  8. Copy the API token that displays

  9. Back in the terminal, paste or enter the API token to complete the registration process

Syntax

The command has the following syntax:

mc [GLOBALFLAGS] license register       \
                         ALIAS          \
                         [--name value] \
                         [--airgap]

Parameters

ALIAS
Required

The alias of the MinIO deployment.

--name
Optional

Specify a name other than the alias to associate to the MinIO deployment in SUBNET.

Use --name <value> replacing <value> with the name you want to use for the deployment on SUBNET.

--airgap
Optional

Use in environments without network access to SUBNET (for example, airgapped, firewalled, or similar configuration).

For instructions, see the airgap example.

Global Flags

This command supports any of the global flags.