Installazione di Sambha2

Requisiti tecnici

Sambha2 è composto da un'applicazione web Java, che gli utenti usano dal browser e che contiene il database, e da tre motori di ricerca AI che girano come servizi separati sullo stesso server. L'applicazione web interroga i motori AI tramite gRPC.

Istruzioni di installazione

Nei comandi la cartella di installazione è C:\Sambha2, con l'applicazione web in web e i motori AI in ai: è un esempio, potete usare un percorso diverso. Tutti i comandi vanno eseguiti da un prompt dei comandi aperto come amministratore.

1. 01

   Preparazione dell'ambiente

   • Server Windows 64 bit con un account amministratore.
   • Nel firewall, aprite la porta 8080 verso i client degli utenti; le porte dei motori AI servono solo all'applicazione web.
   • Solo con GPU NVIDIA: installate il driver NVIDIA e controllate che la scheda sia riconosciuta.

   nvidia-smi

2. 02

   Installazione dei componenti

   Copiate sul server il pacchetto fornito da Soltea. La struttura attesa è questa:

   C:\Sambha2\
     web\
       Sambha2Web.war
       java\                    JDK 21 incluso
       config\                  instance-config.yaml, application-service.properties
       logs\
       prunsrv.exe
       Sambha2WebServiceInstall.bat
     ai\
       dinov3_embedder_service.exe
       siamesanet_service.exe
       ransac_comparator_service.exe
       _internal\               librerie Python, PyTorch e CUDA
       models\                  file dei modelli
       config\                  file .env e *_logging.ini dei servizi
       logs\
       prunsrv.exe
       Sambha2*ServiceInstall.bat

   Registrate i servizi Windows: ogni script rimuove l'eventuale servizio con lo stesso nome e lo reinstalla con avvio automatico.

   cd /d C:\Sambha2\ai
   Sambha2DinoV3EmbedderServiceInstall.bat
   Sambha2SiamesaNetServiceInstall.bat
   Sambha2RansacComparatorServiceInstall.bat
   
   cd /d C:\Sambha2\web
   Sambha2WebServiceInstall.bat

   Il servizio dell'applicazione web gira con l'account NetworkService: deve poter scrivere nelle cartelle data e logs della sua directory.

3. 03

   Configurazione

   Motori AI. Ogni servizio legge il proprio file .env in C:\Sambha2\ai\config: porta gRPC, percorso del modello e parametri di elaborazione. Esempio per l'embedder DINOv3:

   # C:\Sambha2\ai\config\dinov3_embedder_service.env (estratto)
   EMBEDDER_PORT=50056
   MODEL_PATH=models\vit_large_patch16_dinov3.pth
   # elaborazioni contemporanee sulla GPU: alzarlo aumenta la VRAM usata
   GPU_MAX_CONCURRENCY=1

   Applicazione web. In C:\Sambha2\web\config\instance-config.yaml, nella sezione searchEngines, ogni motore AI deve indicare host e porta del proprio servizio. Indicate sempre la porta in modo esplicito, uguale a quella del file .env.

   # C:\Sambha2\web\config\instance-config.yaml (estratto)
   searchEngines:
   - name: "DINOv3"
     jsonConfig: '{ "rpcServer": "localhost", "rpcPort": 50056 }'
     enabled: true

   Licenza. La licenza viene fornita da Soltea insieme alle indicazioni per attivarla.

4. 04

   Avvio come servizio

   I servizi partono da soli all'avvio di Windows. Per avviarli la prima volta, prima i motori AI e poi l'applicazione web:

   sc start Sambha2DinoV3EmbedderService
   sc start Sambha2SiamesaNetService
   sc start Sambha2RansacComparatorService
   sc start Sambha2WebService

   Il primo caricamento dei modelli DINOv3 può essere lento. Se il servizio resta in stato «Starting», aumentate --StartTimeout (predefinito 30 secondi) nello script di installazione e rieseguitelo.

5. 05

   Verifica del funzionamento

   Controllate che i servizi siano in esecuzione e che le porte rispondano:

   sc query Sambha2WebService
   sc query Sambha2DinoV3EmbedderService
   
   powershell Test-NetConnection -ComputerName localhost -Port 50056
   powershell Test-NetConnection -ComputerName localhost -Port 8080

   • Aprite http://localhost:8080 nel browser del server: deve comparire Sambha2.
   • I log sono nelle cartelle logs di web e ai; se un servizio si ferma subito, guardate il file *-stderr.*.log.
   • Con GPU, il log dell'embedder DINOv3 riporta CUDA is available, using GPU.; senza GPU riporta CUDA is not available, using CPU.
6. 06

   Aggiornamento

   Fermate i servizi, sostituite i file della nuova versione e riavviate. Prima di aggiornare conviene copiare la cartella data dell'applicazione web: all'avvio la nuova versione aggiorna lo schema del database.

   sc stop Sambha2WebService
   sc stop Sambha2DinoV3EmbedderService
   sc stop Sambha2SiamesaNetService
   sc stop Sambha2RansacComparatorService
   
   rem motori AI: sostituire *.exe, _internal\ e models\ (e i .env in config\ se cambiati)
   rem applicazione web: sostituire Sambha2Web.war
   
   sc start Sambha2DinoV3EmbedderService
   sc start Sambha2SiamesaNetService
   sc start Sambha2RansacComparatorService
   sc start Sambha2WebService

   Gli script di installazione vanno rieseguiti solo se cambiano percorsi, nomi degli eseguibili o parametri dei servizi.