Caricamento...

Installazione

Documenos ®

Documenos® è compatibile sia con l'architettura x86 sia con quella ARM.

Il processore del vostro server può essere basato su x86 o su ARM. Documenos® è compatibile con entrambi. Potete scaricare i file di installazione adatti a ciascuna architettura server da questa pagina: Scaricamento

Sono disponibili due modalità di installazione: con Docker tutti i componenti si avviano con un unico comando ed è il metodo consigliato. L'installazione su Windows IIS è preferibile se desiderate eseguire l'applicazione sulla vostra infrastruttura server Windows esistente.

ARM / x86

Installazione con Docker

Un unico pacchetto installa insieme l'applicazione, il database PostgreSQL, il servizio di firma digitale, il motore di ricerca Elasticsearch e il servizio di traduzione LibreTranslate.

  1. Preparate i prerequisiti. Sul server devono essere installati Docker Engine (20.10+) e il plugin Docker Compose (2.0+). Al container dell'applicazione devono poter essere assegnati almeno 8 GB RAM e il server deve disporre di accesso a Internet per scaricare le immagini dei container. Funziona su Linux, Windows e macOS.
  2. Scaricate il pacchetto. Scaricate il pacchetto Docker Compose (ZIP) dalla pagina Scaricamento. Il pacchetto è composto da docker-compose.yml, con le definizioni dei servizi, .env, con i valori di configurazione, e readme.md, con le note di installazione. Copiate la cartella così com'è sul vostro server.
  3. Impostate le password. Aprite il file .env e, prima di avviare i container, sostituite obbligatoriamente questi due valori con valori propri, robusti e univoci: DB_PASSWORD (password dell'utente del database PostgreSQL) e DEFAULT_PWD (password iniziale assegnata ai nuovi utenti; gli utenti devono modificarla dopo il primo accesso). Non utilizzate mai password di esempio o predefinite in produzione.
  4. Verificate le impostazioni di rete e delle porte. Controllate i valori *_BIND_IP e *_PORT. Per impostazione predefinita, i servizi di database, firma, ricerca e traduzione sono associati solo a 127.0.0.1 e non sono raggiungibili dall'esterno; l'unica porta esposta è quella dell'applicazione (APP_PORT, predefinita 8080). Se l'applicazione si trova dietro un bilanciatore di carico o un reverse proxy, impostate il valore CLIENT_IP_HEADER (ad esempio X-Forwarded-For).
  5. Avviate i servizi. Nella cartella che contiene il file docker-compose.yml, eseguite il seguente comando: docker compose up -d
  6. Attendete il completamento del primo avvio. Al primo avvio, il servizio di traduzione scarica i modelli linguistici specificati in TRANSLATE_LOAD_ONLY; con una connessione normale richiede 5–10 minuti e avviene una sola volta. Potete seguire l'avanzamento con i comandi docker compose ps e docker compose logs -f documenos_translate. Durante il download il servizio risulta starting e, quando è pronto, healthy. Se la connessione è lenta, aumentate il valore TRANSLATE_START_PERIOD.
  7. Aprite l'applicazione. Aprite nel browser http://indirizzo-del-server:8080 (o il valore APP_PORT che avete impostato), seguite le istruzioni del primo avvio per creare l'account amministratore e registrate la vostra licenza.

Aggiornamento: Scaricate il pacchetto più recente, trasferite i valori di configurazione esistenti nel nuovo file .env ed eseguite docker compose pull seguito da docker compose up -d. I vostri dati sono conservati in volumi Docker denominati e non sono influenzati da aggiornamenti o riavvii.

Installazione su Windows IIS

Documenos® è un'applicazione ASP.NET Core; viene eseguita su IIS tramite il modulo ASP.NET Core.

  1. Preparate i prerequisiti. Attivate il ruolo IIS su Windows Server e installate l'ASP.NET Core Hosting Bundle. L'Hosting Bundle deve essere installato dopo IIS, altrimenti il modulo ASP.NET Core non viene registrato in IIS. Dopo l'installazione, riavviate IIS con il comando iisreset.
  2. Preparate il server di database. Installate PostgreSQL (v15 o successiva) oppure garantite l'accesso a un server PostgreSQL esistente. Documenos® utilizza database separati per il nucleo (DOCUMENOS_CORE), la reportistica (DOCUMENOS_REPORT) e il riconoscimento facciale (DOCUMENOS_FACE).
  3. Preparate i servizi ausiliari. Sono necessari Elasticsearch per la ricerca full-text, il servizio di firma digitale per la firma elettronica e LibreTranslate per la traduzione automatica sul vostro server. Eseguite questi servizi su un server separato utilizzando le definizioni del pacchetto Docker e annotate gli indirizzi a cui l'applicazione può raggiungerli.
  4. Scaricate il pacchetto ZIP. Scaricate il pacchetto inserendo la vostra chiave di download nella sezione File ZIP per Windows IIS della pagina Scaricamento.
  5. Estraete i file sul server. Estraete il contenuto dello ZIP nella cartella destinata al sito web, ad esempio C:\inetpub\documenos.
  6. Configurate le impostazioni di connessione. Nel file appsettings.json della cartella dell'applicazione, inserite i dati di connessione PostgreSQL (CnStrServer, CnStr, CnStrBI, CnStrFA) nella sezione ConnectionStrings. Definite nello stesso file anche gli indirizzi dei servizi di firma e traduzione (SignatureServiceUrl, TranslateServiceUrl). La connessione al server di ricerca Elasticsearch si configura dal pannello di amministrazione dopo l'installazione.
  7. Create un pool di applicazioni. In Gestione IIS aggiungete un nuovo pool di applicazioni (Application Pool) e impostate la versione .NET CLR su Nessun codice gestito (No Managed Code).
  8. Aggiungete il sito web. In Gestione IIS create un nuovo sito tramite Siti → Aggiungi sito Web; selezionate come percorso fisico la cartella in cui avete estratto i file e come pool di applicazioni quello appena creato. Definite i binding (porta, nome host) e, in produzione, assegnate un certificato SSL per HTTPS.
  9. Concedete le autorizzazioni sulla cartella. Concedete all'identità IIS AppPool\<nome del pool> i permessi di lettura e scrittura sulla cartella dell'applicazione. L'applicazione scrive log, file temporanei e chiavi di protezione dei dati con questa identità.
  10. Avviate e aprite il sito. Avviate il sito e aprite nel browser l'indirizzo che avete definito. Lo schema del database viene applicato automaticamente all'avvio dell'applicazione. Seguite le istruzioni del primo avvio per creare l'account amministratore e registrate la vostra licenza.

Aggiornamento: I passaggi per l'aggiornamento di versione di un'installazione IIS sono descritti nella pagina Manutenzione e aggiornamenti. Per informazioni sulla registrazione della licenza e sulla modalità di prova, consultate la pagina Licenze.