Instalación en Linux

Esta guía explica cómo ejecutar SetFN SpaceBuilder directamente en un host Linux. Los ejemplos se basan en distribuciones derivadas de Ubuntu; los nombres de los paquetes y los comandos de instalación pueden variar en otras distribuciones.

Antes de comenzar

• Privilegios sudo, necesarios para instalar paquetes y configurar el inicio automático
• Espacio en disco suficiente para los datos del servicio y los archivos que se cargarán posteriormente
• Acceso al puerto del servidor a través del cortafuegos si se conectará desde otros dispositivos

No necesita privilegios sudo para ejecutar SpaceBuilder. Ejecútelo con una cuenta de usuario normal.

Servidores con GPU y estaciones de trabajo de IA

Además de los PC y servidores Linux convencionales, puede utilizar como host Linux sistemas personales de IA basados en GB10, como NVIDIA DGX Spark, ASUS Ascent GX10, Dell Pro Max with GB10, HP ZGX Nano AI Station, Lenovo ThinkStation PGX y MSI EdgeXpert. Estos equipos son adecuados para tareas que utilizan la GPU, como la ejecución de modelos de IA locales y la indexación de conocimiento.

La arquitectura de CPU, la distribución Linux, los controladores de NVIDIA y la compatibilidad con entornos de ejecución de IA varían según el equipo. Antes de instalar, compruebe que el archivo de instalación de SpaceBuilder y el entorno de ejecución de IA que utilizará sean compatibles con el sistema.

Instalación sencilla Full (en preparación)

Descargar el archivo de instalación

Descargue el archivo de instalación para Linux desde la página de descargas.

Conceda permiso de ejecución al archivo descargado.

chmod +x ~/setfn-spacebuilder

Instalar las bibliotecas necesarias

SpaceBuilder utiliza programas (bibliotecas) instalados en el ordenador para analizar imágenes y generar vistas previas. En Ubuntu 24.04 o posterior, instale primero los siguientes paquetes.

sudo apt update
sudo apt install -y \
  libvips42t64 libvips-tools \
  libheif1 libheif-plugin-libde265 \
  libglib2.0-0

Instalar paquetes para las funciones recomendadas

El servidor de SpaceBuilder también procesa directamente el OCR de archivos cargados, el análisis de PDF, las vistas previas de documentos y la conversión de formatos. Las funciones básicas del servidor se ejecutan sin los siguientes paquetes, pero algunas funciones estarán limitadas al procesar los archivos correspondientes o habrá menos motores de conversión disponibles.

Para utilizar todas las funciones de OCR y conversión de documentos, recomendamos instalar también los siguientes paquetes.

sudo apt install -y \
  tesseract-ocr tesseract-ocr-kor tesseract-ocr-jpn \
  poppler-utils \
  libreoffice pandoc

Puede comprobar el estado de la instalación con los siguientes comandos.

vips --version
vips list classes | grep -i heif
tesseract --version
tesseract --list-langs
pdftotext -v
libreoffice --version
pandoc --version

Ejecutar el instalador

Ejecute el archivo de instalación.

./setfn-spacebuilder

De forma predeterminada, el instalador abre la página de configuración inicial en el puerto 18510. Si otro programa utiliza ese puerto, selecciona automáticamente el siguiente puerto disponible. Acceda siempre a la dirección que aparece en el terminal.

Cuando la página de configuración inicial se abra en el navegador, consulte y acepte los términos de uso y configure la cuenta de administrador y el entorno del servicio. Consulte los campos y las precauciones en Configuración inicial.

Iniciar automáticamente al encender el ordenador

Después de completar la configuración inicial, recomendamos configurar el inicio automático para mantener SpaceBuilder siempre en funcionamiento. Con el inicio automático configurado:

• SpaceBuilder seguirá funcionando aunque cierre el terminal desde el que lo ejecutó.
• SpaceBuilder se iniciará automáticamente después de apagar y volver a encender el ordenador.
• SpaceBuilder se reiniciará automáticamente si se cierra debido a un error.

En Linux, los programas que deben permanecer en ejecución se registran en el servicio de administración estándar systemd. Siga los comandos que aparecen a continuación en orden.

1. Consultar el nombre de usuario y la ubicación del archivo

Ejecute estos dos comandos, uno por línea.

whoami

realpath ~/setfn-spacebuilder

• whoami muestra el nombre del usuario que ha iniciado sesión.
• realpath muestra la ubicación exacta del archivo ejecutable de SpaceBuilder.

Anote los resultados; los necesitará en el paso siguiente.

2. Crear el archivo de configuración del inicio automático

Si SpaceBuilder está ejecutándose en el terminal actual, pulse Ctrl+C para cerrarlo primero. Abra el archivo de configuración del inicio automático con el siguiente comando.

sudo nano /etc/systemd/system/setfn-spacebuilder.service

Pegue el siguiente contenido. Sustituya cada aparición de <user> por el nombre de usuario consultado en el paso 1 e introduzca en ExecStart la ubicación del archivo ejecutable.

[Unit]
Description=SetFN SpaceBuilder
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=<usuario>
WorkingDirectory=/home/<usuario>
Environment=HOME=/home/<usuario>
ExecStart=/home/<usuario>/setfn-spacebuilder
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

En nano, pulse Ctrl+O y Enter para guardar y, a continuación, pulse Ctrl+X para salir.

3. Activar el inicio automático

Ejecute los siguientes comandos, uno por línea. El primero informa a Linux de la configuración creada; el segundo inicia SpaceBuilder ahora y activa su inicio automático a partir del próximo arranque.

sudo systemctl daemon-reload

sudo systemctl enable --now setfn-spacebuilder

Compruebe que se esté ejecutando correctamente.

systemctl status setfn-spacebuilder

Si aparece active (running), la configuración del inicio automático se ha completado. Pulse q para cerrar la pantalla de estado.

4. Consultar la causa si no se ejecuta

Si no aparece active (running) o no puede acceder a SpaceBuilder, consulte los registros recientes con el siguiente comando.

journalctl -u setfn-spacebuilder -n 100 --no-pager

Utilice el siguiente comando para supervisar el proceso de ejecución en tiempo real. Cuando termine, pulse Ctrl+C para salir.

journalctl -u setfn-spacebuilder -f

Comandos para administrar el inicio automático

Si modifica el archivo de configuración del inicio automático, ejecute sudo systemctl daemon-reload y reinicie SpaceBuilder para aplicar los cambios.

Si no puede iniciar sesión en la página de administración, consulte Administrar el servidor mediante comandos para recuperar la cuenta o las restricciones de acceso.