Licensing

[brianbancroft]

In MKE-Dashboard, the licensing page will point to a licensing docs page for more information and one does not exist yet.

What is needed

• How to procure a new license (including contact points) for those who are unaware
• Anything relevant from https://docs.mirantis.com/mke/3.7/install/obtain-license.html?highlight=license

[byDimasik]

License can be set either via config file or UI.

Config

The config way is straightforward

1. Set the license token under spec.license.token

spec:
  license:
    token: <your-license-token>

2. Run mkectl apply

To check the license status, users can see the status of the mkeconfig resource

kubectl -n mke get mkeconfig mke -ojsonpath="{.status.licenseStatus}" | jq 

Example output

{
  "expiration": "2027-10-10T07:00:00Z",
  "licenseType": "Offline",
  "maxEngines": 10,
  "scanningEnabled": true,
  "subject": "sf|0014W0000341gYFQAY|a2X4W000000ZeatUAC",
  "tier": "Production"
}

UI

UI should be almost identical to what we have in MKE 3 docs

Just the upload button is named differently and in addition to uploading a file we allowed pasting the token as a string into a text box. @brianbancroft do you have a screenshot of the most recent version of the license page

[brianbancroft]

@byDimasik I'm not asking for a technical solution. This help page is meant as a first step towards an administrative solution.

This is where a user would likely access the page from:

[rachaelbrownie]

That said, the "learn more" in the screenshot above could be good to go to a page with the content that you have written here (so long as we update the text next to the link to not be misleading, as Brian said) @byDimasik, but then to address the concern Brian has raised for this specific issue, we should also need some place to direct users to that describes how to purchase/renew a license; whether thats a page, a phone number, email etc).

We could have two separate pages or one page. either way, but we need both. And they should link to each other if they are separate.

There is also a link in the License Banner to "purchase a license" and it would need to go directly to somewhere they can purchase/renew or learn how to purchase/renew as well.

[rachaelbrownie]

Moreover, once they are on the page for adding a License, documentation on how to get there or how to update it by CLI probably isn't that helpful 😅 . So it's good to have, but yeah, not specifically what we are looking for here.

[brianbancroft]

here is a cleaned, clear screenshot on the page used to add a license as well.

[brianbancroft]

Still noticing that the obtain-license.md has plenty on how to use a license. Will there be instructions on how to obtain a license? https://github.com/Mirantis/mke-docs/blob/32044c349da238aadd7910716bd4cf7beecbf0b2/content/docs/getting-started/obtain-license.md

[MagdaDziadosz]

I used the sources and examples provided in this issue to create this document. The name and most of the content reflects Obtain the license in MKE 3. If you want me to add more on how to obtain a license, I would need some input content for that part. If such content is not available at the moment, will you be open to changing the name to “Licensing” or something similar to be less misleading for the users.

[ry4nz]

@MagdaDziadosz If we’re currently missing details on obtaining a license in MKE 4, what would you recommend the page should include to ensure it’s clear and useful for users? Your insights as both a writer and potential user would be highly valuable.