Software

Las claves de licencia de software de Supermicro están diseñadas para regular el uso de las funciones de pago del BMC y de las herramientas de software. Cuando los usuarios deseen desbloquear las funciones con licencia en el BMC, deberán activar las claves de licencia de software en el firmware del BMC. Cada clave es exclusiva de una placa base, ya que está vinculada a una dirección MAC del BMC específica. Todas las claves de licencia de software de Supermicro son perpetuas y siguen siendo válidas durante toda la vida útil del hardware (placa base).

Formato de la clave de licencia de software

La clave de licencia de software de Supermicro se almacena en un archivo de texto y se presenta de la siguiente manera:

<License_Key>

El método para activar sus claves de licencia de software varía en función del programa o software. Es posible que deba editar el archivo de la clave de licencia.

Dependiendo del tipo de sistema que utilice, puede acceder a la antigua o nueva BMC Web para activar sus claves de licencia de software. Tenga en cuenta que SFT-OOB-LIC es el único tipo de clave de licencia que puede activar en la antigua BMC Web. Para activar SFT-DCMS-SINGLE, utilice SAA, SUM, SSM o Redfish API.

Antigua BMC Web

1. Vaya a BMC Web e inicie sesión con sus credenciales.
2. Haga clic en Varios en la barra de menú superior.
3. Haga clic en Activar licencia en el menú de la izquierda, ingrese la clave SFT-OOB-LIC de 24 caracteres obtenida de Supermicro, y haga clic en el botón Activar.
4. El estado del nombre de la clave del nodo cambiará de "No activado" a "Activado".

Nueva BMC Web

1. Abra el archivo de la clave de licencia de software (.txt) que ha obtenido de Supermicro. Tenga en cuenta que no se permiten espacios en el archivo de texto.
2. Vaya a BMC Web e inicie sesión con sus credenciales.
3. Haga clic en Mantenimiento en el menú de la izquierda y seleccione Activación de licencia.
4. Haga clic en el botón Seleccionar archivo, elija el archivo de texto con la clave de licencia de Supermicro y haga clic en el botón Subir.
5. Si la activación es exitosa, aparece el mensaje "Éxito" y también encontrará el nombre de la unidad de mantenimiento de stock de la clave de licencia en el campo Estado del nombre de la clave del nodo.

Si obtiene un error de formato, verifique el archivo de texto y vea si hay espacios en blanco o si no se eliminó una dirección MAC.

Esta versión de SAA está pensada para utilizarse únicamente en sistemas de 12.ª generación y posteriores. Para obtener detalles sobre la instalación y el uso, consulte la Guía del usuario de SAA.

Nodo único

Para activar la clave de licencia de un nodo único, puede elegir hacerlo en banda o fuera de banda.

1. Activación en banda (ejecutada en el sistema operativo localhost):

   Abra un símbolo del sistema y ejecute el comando:

   # saa -c ActivateProductKey --key <License_Key> Ejemplo: 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==

2. Activación fuera de banda:

   Abra un símbolo del sistema y ejecute el comando:

   # saa -i <BMC_IP_address> -u <Username> -p <Password> -c ActivateProductKey --key <License_Key> Ejemplo: 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==

Nota: Cuando la clave de licencia de software que compra y recibe de Supermicro está en formato JSON, agregue dos comillas simples antes y después de la clave de activación. Vea el ejemplo a continuación.

# ./saa -c ActivateProductKey --key '{"ProductKey":{"Node":{"LicenseID":"1","LicenseName":"SFT-OOB-LIC","CreateDate":"20200409"},"Signature":"eTFoW1COvxznAnJtet+XeOceIdOjPPhNhOxjIJ03tqCXRZoqxFo73BShTI/yEW5Ljp7Q7NHBbSdFpDGxx89NoWm1NoFIGGfcuqf7ir0w4HXMarcG2WfXS6reLlL3KlQxpy2Djuej3oTQczKV4uW3CVzWYT+bjgMfyk/JV3lTF2CIVxsr4Eqytg0PUC4TR7J20AZOLyA++cyijRN2PbFacybngsfi/SvAha77XWvbTE4HA8IWSmh74IBX56dKu4CbuBmnRGnKOGVVfe8vX1glVFA5ovFuzMc1ENAewFn8qJ/abVLsp1lbvh9XAQTky0J8g2VRfZOK+BfIvWaABE6eVw=="}}'

Nodos múltiples

La activación de las claves de licencia de nodos múltiples solo se puede realizar usando activación fuera de banda.

Para activar varios nodos, prepare dos archivos de texto y luego ejecute un único comando SAA.

1. Cree el archivo de credenciales
   Cree un archivo de texto (por ejemplo, List.txt) que contenga la información de conexión para cada BMC de destino. Cada línea debe incluir la dirección IP de BMC, el nombre de usuario y la contraseña, separados por espacios simples en el siguiente orden:
   
   <BMC_IP_address> <BMC_username> <BMC_password>
   
   Ejemplo (List.txt):
2. Prepare el archivo de clave de licencia
   Prepare el archivo de clave de licencia (por ejemplo, License.txt) obtenido de Supermicro. Cada línea debe contener una entrada con el siguiente formato:
   
   <BMC_MAC_address>; <License_Key>
   
   Ejemplo (License.txt):
3. Ejecutar el comando de activación
   Abra el símbolo del sistema y ejecute el siguiente comando: #saa -l <Credential_File> -c ActivateProductKey --key_file <License_File> Ejemplo: C:\ saa_1.5.0_Win_x86_64> saa.exe -l List.txt -c ActivateProductKey –-key_file License.txt

   Una vez que el comando se complete, SAA mostrará un informe resumido que mostrará el estado de ejecución para cada nodo. Un estado de ÉXITO indica que la clave de licencia se activó correctamente en ese nodo.

   

Nota:

Coloque tanto el archivo de credenciales como el archivo de licencia en el mismo directorio que el ejecutable SAA, o proporcione la ruta completa a cada archivo en el comando.

Las entradas en ambos archivos deben corresponder a los mismos nodos (en el mismo orden).

Cuando la clave de licencia se proporcione en formato JSON, utilícela directamente en el archivo de licencia (no se requieren comillas adicionales).

Esta versión de SUM está diseñada para sistemas de 13.ª generación y anteriores. Los sistemas de 14.ª generación y más recientes no son compatibles. Para obtener detalles sobre la instalación y el uso, consulte la Guía del usuario de SUM.

Nodo único

Para activar la clave de licencia de un nodo único, puede elegir hacerlo en banda o fuera de banda.

1. Activación en banda (ejecutada en el sistema operativo localhost):

   Abra un símbolo del sistema y ejecute el comando:

   # sum -c ActivateProductKey --key <License_Key> Ejemplo: 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==

2. Activación fuera de banda:

   Abra un símbolo del sistema y ejecute el comando:

   # sum -i <BMC_IP_address> -u <Username> -p <Password> -c ActivateProductKey --key <License_Key> Ejemplo: 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==

Nota: Cuando la clave de licencia de software que compra y recibe de Supermicro está en formato JSON, agregue dos comillas simples antes y después de la clave de activación. Vea el ejemplo a continuación.

# ./sum -c ActivateProductKey --key '{"ProductKey":{"Node":{"LicenseID":"1","LicenseName":"SFT-OOB-LIC","CreateDate":"20200409"},"Signature":"eTFoW1COvxznAnJtet+XeOceIdOjPPhNhOxjIJ03tqCXRZoqxFo73BShTI/yEW5Ljp7Q7NHBbSdFpDGxx89NoWm1NoFIGGfcuqf7ir0w4HXMarcG2WfXS6reLlL3KlQxpy2Djuej3oTQczKV4uW3CVzWYT+bjgMfyk/JV3lTF2CIVxsr4Eqytg0PUC4TR7J20AZOLyA++cyijRN2PbFacybngsfi/SvAha77XWvbTE4HA8IWSmh74IBX56dKu4CbuBmnRGnKOGVVfe8vX1glVFA5ovFuzMc1ENAewFn8qJ/abVLsp1lbvh9XAQTky0J8g2VRfZOK+BfIvWaABE6eVw=="}}'

Nodos múltiples

La activación de las claves de licencia de nodos múltiples solo se puede realizar usando activación fuera de banda.

Para activar varios nodos, prepare dos archivos de texto y luego ejecute un único comando SUM.

1. Cree el archivo de credenciales
   Cree un archivo de texto (por ejemplo, List.txt) que contenga la información de conexión para cada BMC de destino. Cada línea debe incluir la dirección IP de BMC, el nombre de usuario y la contraseña, separados por espacios simples en el siguiente orden:
   
   <BMC_IP_address> <BMC_username> <BMC_password>
   
   Ejemplo (List.txt):
2. Prepare el archivo de clave de licencia
   Prepare el archivo de clave de licencia (por ejemplo, License.txt) obtenido de Supermicro. Cada línea debe contener una entrada con el siguiente formato:
   
   <BMC_MAC_address>; <License_Key>
   
   Ejemplo (License.txt):
3. Ejecutar el comando de activación
   Abra el símbolo del sistema y ejecute el siguiente comando: #sum -l <Credential_File> -c ActivateProductKey --key_file <License_File> Ejemplo: C:\ sum_2.7.0_Win_x86_64> sum.exe -l List.txt -c ActivateProductKey –-key_file License.txt

   Una vez que el comando se complete, SUM mostrará un informe resumido que mostrará el estado de ejecución para cada nodo. Un estado de ÉXITO indica que la clave de licencia se activó correctamente en ese nodo.

   

Nota:

Coloque tanto el archivo de credenciales como el archivo de licencia en el mismo directorio que el ejecutable SUM, o proporcione la ruta completa a cada archivo en el comando.

Las entradas en ambos archivos deben corresponder a los mismos nodos (en el mismo orden).

Cuando la clave de licencia se proporcione en formato JSON, utilícela directamente en el archivo de licencia (no se requieren comillas adicionales).

Después de la instalación, conéctese a la web de SSM. Para obtener detalles sobre la instalación y el uso, consulte la Guía del usuario de SSM.

1. Cree un archivo de texto para incluir la siguiente información sobre los nodos: las direcciones MAC de BMC, las direcciones IP de BMC y las claves de licencia. Debe escribirlos en orden y separarlos por punto y coma: <BMC_MAC_Address>;<BMC_IP_Address>;<License_Key>
2. Haga clic en Administración en la barra izquierda del menú.
3. Expanda el menú Configuración de monitoreo y seleccione Activación de PK de nodo.
4. Haga clic en Elegir archivo para subir el archivo de texto, ingrese el nombre de usuario y la contraseña de BMC, y haga clic en el botón Activar.
5. Aparece la ventana Activación de PK de nodo. Haga clic en Ejecutar.
6. Si tiene éxito, el estado mostrará "Éxito" junto con una marca de verificación verde.

Las plataformas de 12ª generación y posteriores admiten la activación de licencia de software a través de una interfaz Redfish. La API de Redfish para la gestión de licencias ha evolucionado a lo largo de las versiones de firmware y es totalmente compatible con el cumplimiento de DMTF.

Prerrequisitos

1. Clave de licencia: Convierte la cadena JSON completa a Base64
2. Acceso remoto: Acceso a la API Redfish de la IP de BMC a través de HTTPS
3. Herramienta: Cliente REST, como Postman, curl, etc.

Uso y ejemplo

1. Active una licencia de software

   Método: POST

   URL: https://<BMC_IP>/redfish/v1/LicenseService/Licenses/

   Cuerpo (sin procesar -> JSON):

    {
  “LicenseString”:“<Base64-encoded JSON string>”
 } Ejemplo de cartero

   Ejemplo de respuesta exitosa (Estado: 201 Creado)

   Ejemplo de línea de comandos de curl curl -X POST \
  https://<BMC_IP>/redfish/v1/LicenseService/Licenses/ \
  -u ADMIN:ADMIN \
  -H "Content-Type: application/json" \
  -d '{
  "LicenseString": "<Base64-encoded JSON string>"
  }'

   * Para omitir las comprobaciones de certificados autofirmados, utilice el parámetro "--insecure". curl -X POST –-insecure ...

2. Consultar/Listar todas las licencias activadas

   Método: GET

   URL: https://<BMC_IP>/redfish/v1/LicenseService/Licenses/

   Ejemplo de cartero

   Ejemplo de respuesta exitosa (Estado: 200 OK)

   Ejemplo de línea de comandos de curl curl -X GET \
  https://<BMC_IP>/redfish/v1/LicenseService/Licenses/ \
  -u ADMIN:ADMIN

3. Ver detalles de una licencia concreta

   Método: GET

   URL: https://<BMC_IP>/redfish/v1/LicenseService/Licenses/SFT-DCMS-SINGLE

   (Reemplace SFT-DCMS-SINGLE con el ID de licencia real que se muestra en LicenseCollection)

   Ejemplo de cartero

   Ejemplo de respuesta exitosa (Estado: 200 OK)

   Ejemplo de línea de comandos de curl curl -X GET \
  https://<BMC_IP>/redfish/v1/LicenseService/Licenses/SFT-DCMS-SINGLE \
  -u ADMIN:ADMIN

Evolución y compatibilidad de la API de gestión de licencias

Funcionamiento	Método HTTP	URI actual (RF Ver. 1.21 y posterior)	URI heredado (antes de RF Ver. 1.21)	Notas
Active una licencia	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 nueva API requiere que la cadena JSON proporcionada por Supermicro se convierta a Base64 y se coloque en el campo LicenseString.
Consultar/Listar todas las licencias activadas	GET	/redfish/v1/LicenseService/Licenses/	/redfish/v1/Managers/1/LicenseManager/QueryLicense	Devuelve la colección de licencias en la nueva URI.
Ver detalles de una licencia concreta	GET	/redfish/v1/LicenseService/Licenses/{LicenseId}	Sin equivalente directo	{LicenseId} Ejemplo: SFT-DCMSSINGLE

* Método de activación heredado (solo para firmware BMC antiguo; no recomendado)

Si el firmware de su BMC aún no admite el punto final LicenseService, utilice el punto final heredado /redfish/v1/Managers/1/LicenseManager/Actions/LicenseManager.ActivateLicense con la clave de producto original en formato JSON. Sin embargo, se recomienda encarecidamente actualizar el firmware de BMC para que utilice la nueva API LicenseService.