Quali linee guida deve rispettare il mio database esterno per essere collegato a DocuWare? (Oracle - MySQL - MSSQL)

Domanda:
Quali linee guida deve rispettare il database esterno per essere collegato a DocuWare?

Risposta:
DocuWare supporta tre tipi di motori di database: MySQL, Microsoft SQL e Oracle. Il database predefinito fornito con il software è MySQL Engine. Tuttavia, è possibile utilizzare il proprio motore di database invece di quello fornito con il software. Di seguito sono riportate alcune linee guida per la preparazione del server di database prima dell'installazione o dell'utilizzo di DocuWare:
Nota: se si intende utilizzare un database esterno per l'installazione (Autoindex o Select List), si applicano gli stessi prerequisiti.

MySQL esterno (non il database interno di DocuWare) per l'installazione

1. Per ulteriori informazioni sulla versione di DocuWare e sul database supportato, consultare i requisiti di sistema.
2. Scaricare gli strumenti dell'interfaccia grafica di MySQL da www.mysql.com (opzionale). Questo strumento consente di creare backup, ripristini e manutenzione del database.
3. Creare un nuovo utente con gli stessi diritti dell'utente root. In MySQL Administration Tool, fare clic con il tasto destro del mouse sull'utente root e selezionare l'opzione "Clona utente".
4. La porta predefinita per questo database è 3306.

1. Assicurarsi che il server MSSQL sia aggiornato con i service pack (SP), soprattutto se si utilizza una vecchia versione di Microsoft SQL Server.
2. Microsoft SQL Server deve essere configurato con un numero di porta statico per l'installazione. Il porting dinamico non è supportato da DocuWare durante l'installazione. Inoltre, MSSQL Express Edition non è supportato da DocuWare. La porta predefinita per MSSQL è 1433.
   • Per verificare se l'istanza del server SQL è stata configurata con una porta statica o dinamica, è possibile utilizzare lo strumento "SQL Server 20xx Configuration Manager".
   • Inoltre, consultare i "Requisiti di sistema" per ciascuna versione di DocuWare.
3. Microsoft SQL Server deve essere configurato per accettare l'autenticazione SQL e l'autenticazione Windows. Durante l'installazione di DocuWare, verrà utilizzata l'autenticazione SQL. In genere, questa operazione viene eseguita in SQL Server Management Studio.

4. Aprendo "SQL Server Management Studio", accedere al server SQL e creare un utente SQL con i diritti di ruolo Securityadmin:
   • diritti di ruolo Securityadmin
   • Diritti del ruolo Sysadmin
     • Questo utente SQL deve essere in grado di creare database e oggetti con il database (tabelle, trigger, indici, ecc.).
5. Questo utente SQL deve anche essere mappato come ruolo securityadmin per i database tempdb.
6. Se sul server SQL sono in esecuzione più istanze, durante l'installazione è necessario connettersi da DocuWare utilizzando il nome completo dell'istanza (ad esempio: ServerName\InstanceName).

Nota: una volta preparato il database, l'installazione di Authentication Server si connetterà al database e creerà tutti i componenti necessari per il software DocuWare. Se si installa DocuWare in un altro server, è possibile verificare la connessione creando una connessione ODBC di prova dal server DocuWare al server Microsoft SQL Database (solo come prova).

Database Oracle per l'installazione/connessione diretta (non più supportato in DocuWare 7.10)
Innanzitutto, se si utilizza Oracle in Windows, non è possibile installare DocuWare e i motori di database Oracle sullo stesso server.
Per installare DocuWare utilizzando un motore di database Oracle, è necessario preparare il database. Questo vale sia per le nuove installazioni che per l'aggiornamento da versioni precedenti di DocuWare a nuove versioni. In alcuni casi, potrebbe essere necessario rimuovere il vecchio Oracle Client e installare la nuova versione di Oracle Client. Consultare i requisiti di sistema richiesti da Oracle Client per la propria versione di DocuWare.
In ambiente Oracle, tutti gli oggetti creati dall'installazione risiedono in un unico schema utente Oracle.

Fino a DocuWare 6.11:
Oracle Client deve essere installato sul computer in cui saranno installati i server di DocuWare. Installare il client Oracle sotto l'account Windows (locale o di dominio) che eseguirà i servizi DocuWare.

• Assicurarsi di avere un utente Oracle con privilegi di DBA almeno per l'installazione (consigliato). Questo utente deve essere in grado di creare e manipolare qualsiasi oggetto del database all'interno dello schema del database. Una volta completata l'installazione, è possibile limitare i suoi diritti.
• È necessario installare prima Oracle Data Access Components (ODAC) a 32 bit: ODAC 11.2 Release 5
  Installate i seguenti componenti:
  • Oracle Data Provider for .NET 4 - 11.2.0.3.0
  • Oracle Data Provider per .NET 2 - 11.2.0.3.0
  • Provider Oracle per ASP.NET 4 - 11.2.0.3.0
  • Fornitori Oracle per ASP.NET 2 -
  • Oracle Database Extensions for .NET 4 - 11.2.0.3.0 - solo per aggiornamento
  • Oracle Database Extensions for .NET 2 - 11.2.0.3.0 - solo per aggiornamento
  • Fornitori Oracle per OLE DB - 11.2.0.3.0
  • Oggetti Oracle per OLE - 11.2.0.3.0
  • Servizi Oracle per Microsoft Transaction Server - 11.2.0.3.0
  • Driver ODBC Oracle - 11.2.0.3.0
  • Oracle SQL Plus - 11.2.0.3.0
  • Oracle Instant Client - 11.2.0.3.0
• File TNSNAMES.ORA (necessario per l'installazione o l'utilizzo)
  Il file tnsnames.ora è un file di configurazione che contiene nomi di servizi netti mappati su descrittori di connessione per il metodo di denominazione locale, o nomi di servizi netti mappati su indirizzi di protocollo degli ascoltatori.
  Un nome di servizio netto è un alias mappato su un indirizzo di rete del database contenuto in un descrittore di connessione. Un descrittore di connessione contiene la posizione dell'ascoltatore attraverso un indirizzo di protocollo e il nome del servizio del database a cui connettersi. I client e i server di database (che sono client di altri server di database) utilizzano il nome del servizio di rete quando effettuano una connessione con un'applicazione (fonte: https://docs.oracle.com).
  Il file "tnsnames.ora" contiene le informazioni sul server Oracle e sulle sue connessioni. Questo file può essere ottenuto da un DBA. Il file deve essere collocato nel computer in cui verrà installato DocuWare e in una directory di percorso del client Oracle (ad esempio, C:\appproduct\11.2.0\Administrator).
• Creare le variabili d'ambiente del sistema Windows
  1. Aprite il comando di esecuzione (premete [Windows]+[R]) e digitate: sysdm.cpl
     
  2. Aprire la scheda "Avanzate" e aprire il menu "Variabili d'ambiente...".
     
  3. Creare una nuova variabile di sistema
     
  4. Inserire un nome e il percorso in cui si trova il file tnsnames.ora
     
  5. Riavviare la macchina in cui è stato appena installato il client Oracle

• Test della connessione Oracle con SQLPlus+
  Prima di installare DocuWare, è necessario verificare che l'utente possa connettersi al server Oracle. In questo modo si verificherà anche che lo schema utente Oracle sia presente nel database. È possibile utilizzare qualsiasi strumento Oracle per connettersi e creare una tabella di prova. In questo esempio, utilizziamo SQLPlus, che può essere eseguito in DOS. Quando si esegue in DOS, bisogna assicurarsi che le credenziali siano fornite, creare una tabella di prova e visualizzare gli oggetti di prova per l'utente.
  
  
• Quando il server Authentication chiede di connettersi al server di database, è necessario fornire il nome della configurazione presente nel file tnsnames.ora. In genere, si inserisce il nome del server del database, ma in Oracle è necessario inserire il nome della configurazione. Queste informazioni si trovano nel file tnsnames.ora locale. Il numero di porta predefinito per Oracle è 1521.

NOTA: una volta configurato il client Oracle nel server DocuWare, l'installazione del server di autenticazione creerà tutti gli oggetti del database necessari per i servizi DocuWare. Non è necessario eseguire ulteriori configurazioni nel server Oracle.

Configurazione del client Oracle

• Verificare i registri generati dalla configurazione o dall'applicazione in %programdata%\DocuWare\
• DocuWare Client supporta solo 32 bit di Oracle.
• Se il database è nella versione Oracle 12c, provare a installare il client Oracle 12c ODAC.
• Il percorso TNS_NAME non è valido
• L'utente Oracle non ha diritti o non ha diritti sufficienti.
• Il server non è stato riavviato dopo l'installazione di un client Oracle.
• Il numero di porta non è stato aperto dal server DocuWare al server Oracle. Verificare la porta del server Oracle o il firewall.

A partire da DocuWare 6.12, non è richiesto ODAC.

KBA è applicabile SOLO alle organizzazioni on-premise.

Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.