mc license register

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

The registration process collects the following information about the cluster for upload to SUBNET:

• Deployment ID
• Cluster Name
• Used capacity
• AIStor Object Store version
• Number of server pools
• Number of servers
• Number of drives
• Space on each drive
• Space used on each drive
• Number of buckets
• Number of objects

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

mc license register myaistor

mc [GLOBALFLAGS] license register ALIAS                      \
                         [--airgap]                          \
                         [--api-key <string>]                \
                         [--license <path to license file>]  \
                         [--name <value>]

Required

The alias of the AIStor deployment.

Optional

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

For instructions, see the airgap example.

If the deployment is airgapped, but the local device where you are using the AIStor Client has network access, you do not need to use the --airgap flag.

API of the account on SUBNET.

Corresponds with the MC_SUBNET_API_KEY environment variable.

To find the API key:

1. Log in to SUBNET
2. Select License Key near the top of the page on the right side of the account statistics information box
3. Select copy button to the right of the key field to copy the key value to your clipboard

Optional

Path to the license file to use for registering the deployment.

You must first download the license file for the account.

To download the license file:

1. Log in to SUBNET
2. Select License Key near the top of the page on the right side of the account statistics information box
3. Select Download

Optional

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

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

Register the AIStor deployment at alias myaistor on SUBNET, using myaistor as the deployment name:

mc license register myaistor

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

Register a new AIStor deployment at alias myaistor2 on SUBNET, using the license file downloaded for the account:

mc license register myaistor2 /path/to/minio.license

If not already downloaded, you can download the license file from SUBNET.

To download the license file:

1. Log in to SUBNET
2. Select License Key near the top of the page on the right side of the account statistics information box
3. Select Download

Register an AIStor deployment at alias myaistor5 on SUBNET, using second-deployment as the name:

mc license register myaistor5 --name second-deployment

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

1. Download the license file.

   1. Log in to SUBNET
   2. Select License Key near the top of the page on the right side of the account statistics information box
   3. Select Download

2. Register the cluster with mc license register.

   mc license register myaistor7 --airgap --license ~/path/to/minio.license
   

   AIStor returns a URL.

3. Copy the URL and access the URL from a browser on a device with internet access.

This command supports any of the global flags.