Errores de Licencias y Configuración de Red
Los resolvedores de Shardian Aero y Atmos validan tu clave de API al iniciar la simulación (en la primera iteración o paso de tiempo) enviando un ping seguro por HTTPS a api.shardian.com. Si la licencia no es válida o existen problemas de conectividad, la simulación abortará inmediatamente para evitar el cálculo incorrecto.
1. Síntomas de Errores de Licencia Comunes
A. Error: Falta Variable de Entorno
Si no has configurado la clave en tu sesión actual, la simulación fallará al arrancar:
- En Shardian Aero (OpenFOAM):
Error Fatal: La variable de entorno SHARDIAN_API_KEY no esta configurada. Por favor, configure su licencia y contacte con [email protected] si necesita ayuda. --> FOAM FATAL ERROR: (openfoam-2406) Licencia de Shardian invalida o expirada. Por favor, contacte con [email protected] FOAM exiting - En Shardian Atmos (WRF):
B. Error: Clave Inválida o Expirada (HTTP 401/403)
Si la clave introducida ha expirado o no es correcta, obtendrás el siguiente error:
Error Fatal: Licencia de Shardian invalida o expirada (HTTP 401).
Por favor, contacte con [email protected] para adquirir una licencia valida.
2. Pasos para Solucionar Problemas
Paso 1: Comprobar la Variable de Entorno
Verifica que la clave está definida en tu entorno actual:
Si la salida está en blanco, ejecuta:
Para hacer este cambio permanente, asegúrate de añadir esa línea al final de tu archivo ~/.bashrc y luego recárgalo con source ~/.bashrc.
3. Conectividad de Red y Servidor de Proxy
Para validar la licencia, el nodo de cálculo que ejecuta la simulación debe poder conectarse a https://api.shardian.com a través del puerto seguro 443 (HTTPS).
A. Verificar Acceso Externo
Comprueba la conectividad externa desde el nodo de cálculo ejecutando:
Deberías recibir una respuesta HTTP 401 Unauthorized (lo cual es correcto, ya que no enviamos clave, pero confirma que el servidor responde) en lugar de un error de timeout o de resolución de nombre.
B. Configuración tras Cortafuegos Corporativos (Proxy)
Si tus nodos de cálculo se encuentran en una red privada o en un clúster HPC institucional protegido por un cortafuegos sin salida directa a internet, deberás configurar las variables de entorno de proxy en tu script de lanzamiento para que curl (usado por los solucionadores) pueda enrutar la petición:
Añade las siguientes líneas a tu script de lanzamiento (SLURM o Bash) antes de ejecutar el solucionador:
# Configura las variables de proxy de red de tu institucion
export http_proxy="http://user:[email protected]:port"
export https_proxy="http://user:[email protected]:port"
El motor de validación de licencias de Shardian leerá automáticamente estas variables y enrutará la petición HTTPS de forma segura a través del servidor proxy especificado.