Software
Les clés de licence logicielle Supermicro sont conçues pour régir l'utilisation des fonctionnalités payantes du BMC et des outils logiciels. Pour débloquer des fonctionnalités sous licence dans le BMC, les utilisateurs doivent activer les clés de licence logicielle dans le micrologiciel du BMC. Chaque clé est unique à une carte mère, car elle est liée à une adresse MAC BMC spécifique. Toutes les clés de licence logicielle Supermicro sont perpétuelles ; elles restent valides pendant toute la durée de vie du matériel (la carte mère).
Format de la clé de licence logicielle
La clé de licence logicielle fournie par Supermicro est stockée dans un fichier texte et se présente comme suit :
<License_Key>
La méthode d'activation des clés de licence logicielle varie selon le logiciel. Il peut être nécessaire de modifier le fichier de la clé de licence.
Selon le type de système utilisé, vous devrez peut-être accéder à l'ancienne ou à la nouvelle version de BMC Web pour activer vos clés de licence logicielle. Notez que SFT-OOB-LIC est le seul type de clé de licence que vous pouvez activer sur l'ancienne version de BMC Web. Pour activer une clé SFT-DCMS-SINGLE, utilisez SAA, SUM, SSM ou l'Redfish API.
Ancien BMC Web
- Accédez à BMC Web et connectez-vous à l'aide de vos informations d'identification.
- Cliquez sur Miscellaneous dans la barre de menu supérieure.
- Cliquez sur Activate License dans le menu de gauche, entrez la clé SFT-OOB-LIC à 24 caractères obtenue auprès de Supermicro, puis cliquez sur le bouton Activate.
- L'état de la clé de produit du nœud passera de "Not activated" à "Activated."
Nouveau BMC Web
- Ouvrez le fichier de clé de licence logicielle (.txt) fourni par Supermicro. Notez qu'aucun espace n'est autorisé dans le fichier texte.
- Accédez à BMC Web et connectez-vous à l'aide de vos informations d'identification.
- Cliquez sur Maintenance dans le menu de gauche et sélectionnez License Activation.
- Cliquez sur le bouton Select File, choisissez le fichier texte contenant la clé de licence de Supermicro et cliquez sur le bouton Upload.
- Si l'activation est réussie, le message « Success » apparaît et vous trouverez également le nom de l'UGS de la clé de licence dans le champ Node Product Key Status (État de la clé de produit du nœud).
Si vous obtenez une erreur de format, veuillez vérifier le fichier texte et voir s'il y a des espaces vides ou si une adresse MAC n'est pas supprimée.
Cette version de SAA est uniquement destinée à être utilisée sur les systèmes de 12e génération et ultérieurs. Pour plus de détails sur l'installation et l'utilisation, reportez-vous au Guide de l'utilisateur SAA.
Nœud unique
Pour activer la clé de licence d'un nœud unique, vous pouvez choisir de le faire en bande ou hors bande.
-
Activation en bande (exécutée sur le système d'exploitation local) :
Ouvrez une invite de commande et exécutez la commande :
# saa -c ActivateProductKey --key <License_Key>Exemple:C:\ saa_1.5.0_Win_x86_64> saa.exe -c ActivateProductKey –-key AAYAAAAAAAAAAAAAAAAAAGSw1zjcokBJrE1va2uIhi1umjMFAUZVqBuP06oZmZkT4y1pOvSYXDuMbJ8S27SyrA8A3S7XgblZeEYbrUF+JzAg6SSAgN6TxAwc8QZS5rIqi7oDARAjJkxMJJKHwYcHiCW1/pSeclAMquDl/g0mTWNxYeG01mGsrtclIKIm3tvN8i6/zpEeV6jfE7AUOAAunFOVWt/OMcD+iTiY7pN3HhQ39cS3t7dBYoWv/a1sPjtlCelA0iLjoXi8TCbqVCxpVv4QQRI7Qv2wH4hNcl5dwndiMkamCYDwU4P7DlN/v+++bAgQ1N0hE/zwLqnxchD+iw== -
Activation hors bande :
Ouvrez une invite de commande et exécutez la commande :
# saa -i <BMC_IP_address> -u <Username> -p <Password> -c ActivateProductKey --key <License_Key>Exemple:C:\ saa_1.5.0_Win_x86_64> saa.exe -i 172.16.104.224 -u ADMIN -p ADMIN -c ActivateProductKey –-key AAYAAAAAAAAAAAAAAAAAAGSw1zjcokBJrE1va2uIhi1umjMFAUZVqBuP06oZmZkT4y1pOvSYXDuMbJ8S27SyrA8A3S7XgblZeEYbrUF+JzAg6SSAgN6TxAwc8QZS5rIqi7oDARAjJkxMJJKHwYcHiCW1/pSeclAMquDl/g0mTWNxYeG01mGsrtclIKIm3tvN8i6/zpEeV6jfE7AUOAAunFOVWt/OMcD+iTiY7pN3HhQ39cS3t7dBYoWv/a1sPjtlCelA0iLjoXi8TCbqVCxpVv4QQRI7Qv2wH4hNcl5dwndiMkamCYDwU4P7DlN/v+++bAgQ1N0hE/zwLqnxchD+iw==
Remarque : Lorsque la clé de licence logicielle que vous achetez et recevez de Supermicro est au format JSON, ajoutez deux guillemets simples avant et après la clé d'activation. Voir l'exemple ci-dessous.
# ./saa -c ActivateProductKey --key '{"ProductKey":{"Node":{"LicenseID":"1","LicenseName":"SFT-OOB-LIC","CreateDate":"20200409"},"Signature":"eTFoW1COvxznAnJtet+XeOceIdOjPPhNhOxjIJ03tqCXRZoqxFo73BShTI/yEW5Ljp7Q7NHBbSdFpDGxx89NoWm1NoFIGGfcuqf7ir0w4HXMarcG2WfXS6reLlL3KlQxpy2Djuej3oTQczKV4uW3CVzWYT+bjgMfyk/JV3lTF2CIVxsr4Eqytg0PUC4TR7J20AZOLyA++cyijRN2PbFacybngsfi/SvAha77XWvbTE4HA8IWSmh74IBX56dKu4CbuBmnRGnKOGVVfe8vX1glVFA5ovFuzMc1ENAewFn8qJ/abVLsp1lbvh9XAQTky0J8g2VRfZOK+BfIvWaABE6eVw=="}}'
Nœuds multiples
L'activation des clés de licence de plusieurs nœuds ne peut être effectuée qu'en mode hors bande.
Pour activer plusieurs nœuds, préparez deux fichiers texte, puis exécutez une seule commande SAA.
- Créer le fichier d'informations d'identification
Créez un fichier texte (par exemple, List.txt) contenant les informations de connexion pour chaque BMC cible. Chaque ligne doit inclure l'adresse IP du BMC, le nom d'utilisateur et le mot de passe, séparés par un espace, dans l'ordre suivant :
<BMC_IP_address> <BMC_username> <BMC_password>
Exemple (List.txt):
- Préparer le fichier de clé de licence
Préparez le fichier de clé de licence (par exemple, License.txt) fourni par Supermicro. Chaque ligne doit contenir une entrée au format suivant :
<BMC_MAC_address>; <License_Key>
Exemple (License.txt):
- Exécuter la commande d'activation
Ouvrez une invite de commande et exécutez la commande suivante :#saa -l <Credential_File> -c ActivateProductKey --key_file <License_File>Exemple:C:\ saa_1.5.0_Win_x86_64> saa.exe -l List.txt -c ActivateProductKey –-key_file License.txtUne fois la commande terminée, SAA affichera un rapport récapitulatif indiquant l'état d'exécution pour chaque nœud. Un statut SUCCESS indique que la clé de licence a été activée avec succès sur ce nœud.
Remarque :
Cette version de SUM est conçue pour les systèmes de 13e génération et antérieurs. Les systèmes de 14e génération et plus récents ne sont pas pris en charge. Pour plus de détails sur l'installation et l'utilisation, reportez-vous au Guide de l'utilisateur SUM.
Nœud unique
Pour activer la clé de licence d'un nœud unique, vous pouvez choisir de le faire en bande ou hors bande.
-
Activation en bande (exécutée sur le système d'exploitation local) :
Ouvrez une invite de commande et exécutez la commande :
# sum -c ActivateProductKey --key <License_Key>Exemple:C:\ sum_2.7.0_Win_x86_64> sum.exe -c ActivateProductKey –-key AAYAAAAAAAAAAAAAAAAAAGSw1zjcokBJrE1va2uIhi1umjMFAUZVqBuP06oZmZkT4y1pOvSYXDuMbJ8S27SyrA8A3S7XgblZeEYbrUF+JzAg6SSAgN6TxAwc8QZS5rIqi7oDARAjJkxMJJKHwYcHiCW1/pSeclAMquDl/g0mTWNxYeG01mGsrtclIKIm3tvN8i6/zpEeV6jfE7AUOAAunFOVWt/OMcD+iTiY7pN3HhQ39cS3t7dBYoWv/a1sPjtlCelA0iLjoXi8TCbqVCxpVv4QQRI7Qv2wH4hNcl5dwndiMkamCYDwU4P7DlN/v+++bAgQ1N0hE/zwLqnxchD+iw== -
Activation hors bande :
Ouvrez une invite de commande et exécutez la commande :
# sum -i <BMC_IP_address> -u <Username> -p <Password> -c ActivateProductKey --key <License_Key>Exemple:C:\ sum_2.7.0_Win_x86_64> sum.exe -i 172.16.104.224 -u ADMIN -p ADMIN -c ActivateProductKey –-key AAYAAAAAAAAAAAAAAAAAAGSw1zjcokBJrE1va2uIhi1umjMFAUZVqBuP06oZmZkT4y1pOvSYXDuMbJ8S27SyrA8A3S7XgblZeEYbrUF+JzAg6SSAgN6TxAwc8QZS5rIqi7oDARAjJkxMJJKHwYcHiCW1/pSeclAMquDl/g0mTWNxYeG01mGsrtclIKIm3tvN8i6/zpEeV6jfE7AUOAAunFOVWt/OMcD+iTiY7pN3HhQ39cS3t7dBYoWv/a1sPjtlCelA0iLjoXi8TCbqVCxpVv4QQRI7Qv2wH4hNcl5dwndiMkamCYDwU4P7DlN/v+++bAgQ1N0hE/zwLqnxchD+iw==
Remarque : Lorsque la clé de licence logicielle que vous achetez et recevez de Supermicro est au format JSON, ajoutez deux guillemets simples avant et après la clé d'activation. Voir l'exemple ci-dessous.
# ./sum -c ActivateProductKey --key '{"ProductKey":{"Node":{"LicenseID":"1","LicenseName":"SFT-OOB-LIC","CreateDate":"20200409"},"Signature":"eTFoW1COvxznAnJtet+XeOceIdOjPPhNhOxjIJ03tqCXRZoqxFo73BShTI/yEW5Ljp7Q7NHBbSdFpDGxx89NoWm1NoFIGGfcuqf7ir0w4HXMarcG2WfXS6reLlL3KlQxpy2Djuej3oTQczKV4uW3CVzWYT+bjgMfyk/JV3lTF2CIVxsr4Eqytg0PUC4TR7J20AZOLyA++cyijRN2PbFacybngsfi/SvAha77XWvbTE4HA8IWSmh74IBX56dKu4CbuBmnRGnKOGVVfe8vX1glVFA5ovFuzMc1ENAewFn8qJ/abVLsp1lbvh9XAQTky0J8g2VRfZOK+BfIvWaABE6eVw=="}}'
Nœuds multiples
L'activation des clés de licence de plusieurs nœuds ne peut être effectuée qu'en mode hors bande.
Pour activer plusieurs nœuds, préparez deux fichiers texte, puis exécutez une seule commande SUM.
- Créer le fichier d'informations d'identification
Créez un fichier texte (par exemple, List.txt) contenant les informations de connexion pour chaque BMC cible. Chaque ligne doit inclure l'adresse IP du BMC, le nom d'utilisateur et le mot de passe, séparés par un espace, dans l'ordre suivant :
<BMC_IP_address> <BMC_username> <BMC_password>
Exemple (List.txt):
- Préparer le fichier de clé de licence
Préparez le fichier de clé de licence (par exemple, License.txt) fourni par Supermicro. Chaque ligne doit contenir une entrée au format suivant :
<BMC_MAC_address>; <License_Key>
Exemple (License.txt):
- Exécuter la commande d'activation
Ouvrez une invite de commande et exécutez la commande suivante :#sum -l <Credential_File> -c ActivateProductKey --key_file <License_File>Exemple:C:\ sum_2.7.0_Win_x86_64> sum.exe -l List.txt -c ActivateProductKey –-key_file License.txtUne fois la commande terminée, SUM affichera un rapport récapitulatif indiquant l'état d'exécution pour chaque nœud. Un statut SUCCESS indique que la clé de licence a été activée avec succès sur ce nœud.
Remarque :
Après l'installation, veuillez vous connecter au SSM Web. Pour plus de détails sur l'installation et l'utilisation, reportez-vous au Guide de l'utilisateur SSM.
- nœuds : les adresses MAC des BMC, les adresses IP des BMC et les clés de licence. Vous devez les saisir dans l'ordre et les séparer par des points-virgules :
<BMC_MAC_Address>;<BMC_IP_Address>;<License_Key> - Cliquez sur Administration dans la barre de menu gauche.
- Développez le menu Configuration de la surveillance et sélectionnez Node PK Activation.
- Cliquez sur Choose File pour télécharger le fichier texte, saisissez le nom d'utilisateur et le mot de passe BMC, puis cliquez sur le bouton Activate.
- La fenêtre Activation PK du nœud s'affiche. Cliquez sur Run.
- En cas de succès, l'état affichera « Success » accompagné d'une coche verte.
Les plateformes de 12e génération et ultérieures prennent en charge l'activation des licences logicielles via l’interface Redfish. L'API Redfish de gestion des licences a évolué au fil des versions du micrologiciel et est entièrement conforme à la norme DMTF.
Prérequis
- Clé de licence : Convertissez la chaîne JSON complète en Base64
- Accès distant : Accès à l'API Redfish de l'adresse IP du BMC via HTTPS
- Outil : Client REST, tel que Postman, curl, etc.
Utilisation et exemple
-
Activer une licence logicielle
Méthode : POST
URL : https://<BMC_IP>/redfish/v1/LicenseService/Licenses/
Corps (brut -> JSON) :
{Exemple Postman
“LicenseString”:“<Base64-encoded JSON string>”
}
Exemple de réponse positive (Statut : 201 Créé)
Exemple en ligne de commande curlcurl -X POST \
https://<BMC_IP>/redfish/v1/LicenseService/Licenses/ \
-u ADMIN:ADMIN \
-H "Content-Type: application/json" \
-d '{
"LicenseString": "<Base64-encoded JSON string>"
}'* Pour ignorer la vérification des certificats auto-signés, utilisez le paramètre « --insecure ».
curl -X POST –-insecure ... -
Interroger/Lister toutes les licences activées
Méthode : GET
URL : https://<BMC_IP>/redfish/v1/LicenseService/Licenses/
Exemple Postman
Exemple de réponse positive (Statut : 200 OK)
Exemple en ligne de commande curlcurl -X GET \
https://<BMC_IP>/redfish/v1/LicenseService/Licenses/ \
-u ADMIN:ADMIN -
Afficher les détails d'une licence spécifique
Méthode : GET
URL : https://<BMC_IP>/redfish/v1/LicenseService/Licenses/SFT-DCMS-SINGLE
(Remplacez SFT-DCMS-SINGLE par l'identifiant de licence réel affiché dans la collection de licences)
Exemple Postman
Exemple de réponse positive (Statut : 200 OK)
Exemple en ligne de commande curlcurl -X GET \
https://<BMC_IP>/redfish/v1/LicenseService/Licenses/SFT-DCMS-SINGLE \
-u ADMIN:ADMIN
Évolution et compatibilité de l'API de gestion des licences
| Fonctionnement | Méthode HTTP | URI actuelle (RF Ver. 1.21 et versions ultérieures) | URI précédente (avant RF Ver. 1.21) | Remarques |
|---|---|---|---|---|
| Activer une licence | POST | /redfish/v1/LicenseService/Licenses/ | /redfish/v1/Managers/1/LicenseManager/Actions/LicenseManager.ActivateLicense /redfish/v1/Managers/1/LicenseManager/ActivateLicense (Removed since RF Ver. 1.11) |
La nouvelle API exige que la chaîne JSON fournie par Supermicro soit convertie en Base64 et placée dans le champ LicenseString. |
| Interroger/Lister toutes les licences activées | GET | /redfish/v1/LicenseService/Licenses/ | /redfish/v1/Managers/1/LicenseManager/QueryLicense | Renvoie la collection de licences dans la nouvelle URI. |
| Afficher les détails d'une licence spécifique | GET | /redfish/v1/LicenseService/Licenses/{LicenseId} | Aucun équivalent direct | {LicenseId} Exemple: SFT-DCMSSINGLE |
* Méthode d'activation héritée (pour les anciens micrologiciels BMC uniquement –Non recommandée)
Si votre micrologiciel BMC ne prend pas encore en charge le point de terminaison LicenseService, utilisez l'ancien point de terminaison /redfish/v1/Managers/1/LicenseManager/Actions/LicenseManager.ActivateLicense avec la clé de produit d'origine au format JSON. Toutefois, il est fortement recommandé de mettre à niveau le micrologiciel BMC pour utiliser la nouvelle API LicenseService.
