Preguntas Frecuentes (FAQ)#

Soporte#

¿Con quién me pongo en contacto si tengo un problema técnico?: Contacta con la Oficina Técnica de BIQAIN en soporte@biqain.com. Podemos ayudarte con incidencias de acceso, problemas con jobs, dependencias de software, configuración del cluster Fujitsu y cualquier otra cuestión técnica del proyecto.

General#

¿Puedo añadir librerías adicionales a mi solver?: Sí. Añade todas las dependencias en el archivo requirements.txt, en la raíz del repositorio, siguiendo el formato pip. La plataforma las instalará automáticamente al construir el solver. Si necesitas una librería que no está disponible en pip o tienes dudas, contacta con la Oficina Técnica de BIQAIN.
¿Puedo usar cualquier lenguaje de programación?: Los solvers se implementan en Python. El archivo de entrada qcentroid.py debe ser Python y la función run() debe mantener su firma exacta.
¿Dónde veo los errores si mi solver falla?: En la plataforma, accede al job fallido y ve a la pestaña Raw results. Verás la traza completa del error. También puedes revisar la pestaña Execution logs para ver los logs que hayas añadido con logger.info().

Créditos#

¿Cuántos créditos tiene mi organización?: Puedes consultarlo en el menú de usuario (esquina superior derecha) > Credits. Allí verás el saldo total asignado a tu organización y el desglose por usuario.
Mi job ha sido rechazado por créditos insuficientes. ¿Qué hago?: Cualquier miembro de tu organización puede reasignar créditos desde el menú de usuario > Credits. Si la bolsa total de tu organización está agotada, contacta con la Oficina Técnica de BIQAIN.
¿Cuántos créditos consume cada ejecución?: Depende del solver y del proveedor de hardware utilizado. El coste estimado de cada solver se muestra en su página de detalle en la plataforma. Puedes consultar el coste real de cada ejecución en la pestaña Cost details de la página de detalle del job, una vez finalizado.
¿Puedo ver el historial de consumo de créditos?: Sí, en la sección Credits del menú de usuario encontrarás el historial de consumo asociado a tu cuenta.

Plataforma#

Accedo a la plataforma pero no veo mis casos de uso o solvers.: Verifica que estás accediendo con la cuenta correcta. La URL de la plataforma es https://app.sandbox.qcentroid.com/. Si el problema persiste, contacta con el equipo de soporte.
Lancé un Build y está tardando demasiado.: Puedes hacer clic en el botón Build de nuevo para cancelar el proceso en curso y relanzarlo. Si sigue fallando, revisa el log del build para ver el error concreto. Las causas más habituales son un requirements.txt con dependencias conflictivas o la rama configurada que no existe en el repositorio.
Mi job lleva mucho tiempo en estado Pending o Running.: Es normal que los jobs tarden según la carga del sistema y el proveedor de hardware utilizado. Si un job lleva más de 30 minutos sin avanzar, contacta con el equipo de soporte indicando el Job ID.
¿Dónde descargo los resultados de mi job?: En la página de detalle del job, ve a la pestaña Raw results y usa el botón de descarga. Los archivos adicionales generados por el solver (gráficos, CSVs, etc.) aparecen en la pestaña Assets.
Obtuve un error 403 Forbidden al intentar acceder.: Cierra la sesión completamente y vuelve a iniciarla. Si el problema persiste, puede que tu sesión haya caducado o que la cuenta no tenga acceso al recurso. Contacta con el equipo de soporte.

LaunchPad y desarrollo#

Entro al LaunchPad pero el servidor tarda mucho en arrancar.

El arranque inicial puede tardar hasta un par de minutos. Si pasado ese tiempo la pantalla sigue en blanco o muestra un error, recarga la página. Si persiste, contacta con soporte.

No veo mi repositorio en el IDE.

Verifica que el solver con el que has iniciado el LaunchPad tiene un repositorio conectado en la plataforma y que el proceso de conexión (incluyendo la Deploy Key) se completó correctamente. Consulta el Paso 4 del tutorial.

Modifiqué el código en el IDE pero la plataforma sigue ejecutando la versión antigua.

Asegúrate de haber hecho commit y push de los cambios desde el IDE al servidor Git, y después lanzado el proceso Build en la plataforma. La plataforma no recoge los cambios del IDE directamente, solo del repositorio Git.

Mi solver funciona bien en el Launcher.ipynb pero falla en la plataforma.

Las causas más comunes son:

Una dependencia que falta en requirements.txt.

Una ruta de archivo local que no existe en el entorno de la plataforma.

Una excepción capturada localmente que en la plataforma se comporta distinto.

Diferencias en la versión de Python o de alguna librería.

Añade logs con logger.info() para tener más visibilidad del punto exacto de fallo.

¿Puedo instalar paquetes directamente en el IDE con pip install?

Sí, puedes instalarlos en la sesión activa del IDE para probar, pero esa instalación no persiste entre sesiones ni se aplica en la plataforma. Para que el solver funcione en la plataforma, añade siempre las dependencias en requirements.txt.

Proveedor Fujitsu#

No puedo conectarme al cluster por SSH desde el LaunchPad.

Verifica que has iniciado el LaunchPad con un solver asociado al proveedor Fujitsu. Si el solver es de otro proveedor, la VPN no estará activa y el host login.lantik.lab no será accesible desde esa sesión.

El comando SSH me pide contraseña pero la rechaza.

Comprueba que estás usando el usuario y contraseña exactos que recibiste del equipo de Fujitsu. Las credenciales del cluster son distintas a las de la plataforma QCentroid. Si el problema persiste, contacta con soporte.

Mi trabajo en SLURM lleva mucho tiempo en cola.

Usa squeue -u tu_usuario para ver el estado. Si aparece como PD (pending), el cluster está ocupado. Puedes usar sinfo para ver qué nodos están disponibles. Si el trabajo sigue en cola pasadas varias horas, contacta con el equipo de Fujitsu o con soporte de BIQAIN.

Mi script de SLURM falla inmediatamente con errores extraños.

Probablemente tenga saltos de línea en formato Windows (CRLF). Conviértelo a formato Unix antes de enviarlo:

sed -i 's/\r//' mi_script.sh

¿Puedo guardar mis datos y scripts entre sesiones del LaunchPad?

Sí. Tanto el LaunchPad como el servidor de acceso al Digital Annealer de Fujitsu disponen de un volumen de almacenamiento persistente: tus archivos, scripts y datos se conservan aunque reinicies la sesión o el servidor. Aun así, es recomendable hacer commit y push al servidor Git de forma habitual para tener una copia de seguridad del código fuera del entorno.

¿Debo apagar el servidor del LaunchPad cuando termino de trabajar?

Es recomendable apagarlo cuando no vayas a usarlo durante un período prolongado. El LaunchPad incluye un mecanismo de apagado automático que detiene el servidor tras 1 hora de inactividad, pero apagarlo manualmente libera recursos antes y es una buena práctica.

¿Dónde encuentro la documentación específica del Digital Annealer de Fujitsu?

La documentación técnica del DA (formulación QUBO, parámetros, librerías cliente) fue proporcionada directamente por el equipo de Fujitsu en el onboarding del proyecto. Consulta los materiales de formación recibidos. Para la parte de infraestructura y acceso, consulta la sección Proveedor: Fujitsu de esta documentación.