Pruebas de Verificación

Tras ejecutar el instalador interactivo por consola, se recomienda verificar la integridad del entorno, las variables de sistema y la conectividad de red con el servidor de licencias antes de lanzar simulaciones de producción a gran escala.

1. Verificación de Entorno

Asegúrate de que las siguientes variables están definidas en tu sesión actual de terminal. Si acabas de finalizar la instalación, recuerda recargar la sesión (source ~/.bashrc):

echo $SHARDIAN_API_KEY
echo $LD_LIBRARY_PATH

SHARDIAN_API_KEY debe imprimir tu clave de licencia activa (e.g. sk_live_shardian_...).
LD_LIBRARY_PATH debe incluir el directorio donde se instaló la librería dinámica (habitualmente /usr/local/lib o ~/.shardian/lib).

2. Prueba de Conectividad con el Servidor de Licencias

Puedes verificar la conexión directa y validez de la clave contra la API de Shardian mediante curl:

curl -i -H "Authorization: Bearer $SHARDIAN_API_KEY" https://api.shardian.com/v1/verify

Respuesta de Éxito:

Si la licencia es válida, el servidor responderá con código HTTP 200 OK y un cuerpo JSON con los metadatos de expiración:

HTTP/1.1 200 OK
Content-Type: application/json
Date: Mon, 15 Jun 2026 12:00:00 GMT

{
  "status": "valid",
  "key": "sk_live_shardian_cfd_atmos_2026_eval",
  "scope": "both",
  "expires_at": "2027-06-15T00:00:00Z"
}

Respuestas de Error Comunes:

HTTP 401 Unauthorized: La clave introducida es incorrecta o ha sido revocada. Comprueba que el valor asignado a la variable coincide exactamente con el suministrado por Shardian.
HTTP 403 Forbidden: La licencia es válida, pero el producto seleccionado no está cubierto por su plan (e.g. intentar ejecutar WRF con una clave de Aero).
Timeout de Red: Si curl se bloquea, significa que estás en un nodo sin salida directa a internet o tras un cortafuegos corporativo. Revisa la sección de Errores de Licencias y Configuración de Red para configurar el proxy.

3. Verificar Shardian Aero (OpenFOAM)

Para validar que OpenFOAM puede cargar la librería dinámica zonal correctamente en tiempo de ejecución:

Ejecuta el resolvedor con la opción -help inyectando la librería:
```
simpleFoam -postProcess -libs "libShardianAero.so" -help
```
Si el entorno está bien configurado, el comando listará las opciones del solucionador y finalizará correctamente. Si la librería libShardianAero.so no está en las rutas del sistema, OpenFOAM informará con un error de enlace:
```
Error: cannot open shared object file: No such file or directory
```
Si esto sucede, comprueba que /usr/local/lib/libShardianAero.so existe en tu disco y tiene permisos de lectura para tu usuario.

4. Verificar Shardian Atmos (WRF)

Para validar el contenedor de Singularity y su compatibilidad con el entorno local del host:

Ejecuta el script wrapper de inicio:

shardian_atmos --version

O llama directamente a la imagen de Singularity:

singularity run /usr/local/bin/shardian_atmos.sif --version

La salida debe mostrar la versión del resolvedor acoplado y los detalles de compilación MPI:

Shardian Atmos Solver Container v1.0.4
Compiled with WRFV4.5.1 (Intel compilers)
OpenMPI Binding: v4.1.2 compatible

Si obtienes un error de falta de permisos (Permission Denied), verifica los permisos del contenedor:
```
ls -l /usr/local/bin/shardian_atmos.sif
```
Si es necesario, aplica permisos de lectura y ejecución para todos los usuarios:
```
sudo chmod 755 /usr/local/bin/shardian_atmos.sif
```