L'installazione di database MySQL non fa parte del supporto di DocuWare.
Poiché MySQL è un'applicazione di terze parti, non abbiamo modo di risolvere eventuali problemi, consigliare impostazioni aggiuntive o controllare che l'installazione sia completa.
DocuWare non è responsabile di eventuali sistemi danneggiati se il database viene danneggiato durante o dopo l'installazione.
Domanda:
Come aggiornare un Internal Database V2 (MySQL 5.6) a un Internal Database V3 (MySQL 8)
Risposta:
L'aggiornamento da MySQL 5.6 a MySQL 8 richiede tre passaggi.
È possibile verificare la versione di MySQL attualmente installata eseguendo
SHOW VARIABLES LIKE "%version%";
Tutti i file necessari possono essere trovati utilizzando il seguente download:
Download-MySQL56TO8
Note importanti:
Assicurarsi di chiudere tutte le applicazioni che accedono al database prima di qualsiasi tentativo di backup/dump.
Assicurarsi di avere un backup valido del database.
Assicurarsi di avere un backup della directory di installazione.
Non aggiornare DocuWare direttamente dopo l'aggiornamento di MySQL.
Lasciare che il sistema venga eseguito per qualche tempo per verificare che la funzionalità sia ancora completa.
Informazioni di base su MySQL:
Durante il KBA, verranno menzionate la directory di installazione e la directory dei dati.
La directory di installazione contiene tutti i file necessari per l'esecuzione del servizio MySQL e si trova in C:\Program Files (x86)\DocuWare\Internal Database V1\ o C:\Program Files (x86)\DocuWare\Internal Database V2\ a seconda delle installazioni precedenti.
Se non si sa dove trovare la directory di installazione, controllare il servizio MySQL all'interno dei Servizi di Windows; si otterrà il percorso del file MySQLD.exe e con esso la cartella di installazione.
In questa cartella si trovano il file my.ini e molte sottocartelle, ad esempio \bin.
\bin contiene la maggior parte degli eseguibili ed è successivamente necessario per eseguire gli aggiornamenti.
La cartella dei dati si trova in C:\ProgramData\DocuWare\Internal Database\.
La cartella si chiama giustamente data.
Contiene il contenuto e la struttura di tutte le tabelle del database MySQL installato.
Per la parte iniziale dell'aggiornamento, si deve lavorare solo nella cartella di installazione.
Durante l'aggiornamento a MySQL 8, è necessario aggiungere una cartella allo stesso livello della directory dei dati.
MySQL 5.6 a MySQL 5.6 final
Arrestare il servizio MySQL
Estrarre mysql-5.6.51-winx64.zip
Non cancellare, ma sostituire i file all'interno della cartella di installazione (predefinita C:\Program Files (x86)\DocuWare\Internal Database V2)
NOTA: I file inclusi forniranno una cartella "Data".Non copiare la cartella Data; la copia di questa cartella causerà comportamenti imprevisti.
Avviare il servizio MySQL, tramite ServiceControl o Windows Services.
Avviare una riga di comando con diritti amministrativi e navigare nella directory di installazione e nella sua sottocartella \bin.
(default: C:\Program Files (x86)\DocuWare\Internal Database V2\bin)
Eseguire il seguente comando.
mysql_upgrade --user=root --password=admin
Scegliere un utente amministrativo di MySQL (ad esempio root).
Questa operazione aggiornerà le tabelle del database alla versione 5.6 final
MySQL 5.6 final a MySQL 5.7
Arrestare il servizio MySQL
Estrarre mysql-5.7.38-winx64.zip
Non cancellate, ma sostituite i file all'interno della cartella di installazione (predefinita C:\Program Files (x86)\DocuWare\Internal Database V2)
Aprite il file my.ini esistente e cercate "innodb_additional_mem_pool_size".
Rimuovete l'attributo, cancellando la riga o commentando con un # all'inizio della riga.
Avviate il servizio MySQL, tramite ServiceControl o Windows Services.
Come prima, usate il cmd amministrativo per eseguire il comando di aggiornamento.
mysql_upgrade --user=root --password=admin
Questo aggiornerà le tabelle del database alla versione 5.7
Mysql 5.7 a MySQL 8
NOTA: prima di completare i passaggi descritti, è consigliabile creare un backup completo di tutti i database DocuWare e collocarlo in una posizione diversa dal server DocuWare.
- Arrestare i servizi MySQL in DocuWare facendo clic con il pulsante destro del mouse su DocuWare Service Control e selezionando Stop services (Arresta servizi) per eseguire un arresto graduale.
NOTA: NON ARRESTIRE TUTTI I SERVIZI! L'arresto di tutti i servizi causerà l'uccisione del processo e una grave corruzione del database, che richiederà una ristrutturazione completa del database. - Estrarre il database interno V3.zip.
- Spostare la cartella Internal Database V3 nella cartella di installazione di Internal Database V2 situata in C:\Program Files (x86)\DocuWare Internal Database V2.
- Aprire la cartella Internal Database V3 e creare una nuova cartella denominata "Uploads".
- Aggiungere la cartella dei dati copiata da Internal Database V2 a Internal Database V3.
- Nel file zip principale, scaricare il file my.ini nella cartella Internal Database V3.
NOTA: Si consiglia di utilizzare Notepad++ per modificare il file my.ini. Durante la modifica del file, assicurarsi che il formato di codifica sia impostato su UTF-8.
- All'interno del file my.ini, regolare i seguenti percorsi:
basedir=C:/Program Files (x86)/DocuWare/Internal Database V3
datadir=C:/Program Files (x86)/DocuWare/Internal Database V3/data
secure-file-priv=C:/Program Files (x86)/DocuWare/Internal Database V3/Uploads - Ora, eliminare il servizio V2 eseguendo la seguente query nel Prompt dei comandi come amministratore.
sc delete DWMySQL2
Per creare il servizio per V3, eseguire il seguente comando.
“Adjust the paths as needed for your environment.”
sc create DWMySQL3 binPath= "\"C:\Program Files (x86)\DocuWare\Internal Database V3\bin\mysqld.exe\" --defaults-file=\"C:\Program Files (x86)\DocuWare\Internal Database V3\my.ini\"
DWMySQL3" DisplayName= "DocuWare Internal Database V3" start= "auto"
Nota: Il comando deve essere utilizzato esattamente come scritto.
Una volta completato il comando, eseguire il seguente comando per avviare il servizio MySQL.
sc start DWMySQL3
All'avvio di MySQL 8, le tabelle verranno aggiornate automaticamente. Se si verifica un errore durante l'aggiornamento, è possibile trovare l'errore nel file InternalDatabasev3.err situato in C:Program Files (x86)\Internal Database v3\Data. Dopo aver letto l'errore specifico, si può procedere in due modi per risolverlo.
Una soluzione consiste nel completare i seguenti passaggi per forzare l'aggiornamento.
- Aprire il Prompt dei comandi come amministratore.
- Nell'esploratore di file, seguire il percorso C:¿Programmi (x86)¿DocuWare¿Internal Database V3¿bin¿
3. Eseguire il seguente comando nel Prompt dei comandi
mysqld --upgrade=Force
NOTA: Questo processo può richiedere un po' di tempo, ma è necessario assicurarsi che venga completato correttamente.
Un'altra opzione per risolvere l'errore è la seguente:
- Trasferire la cartella dei dati InternalDatabaseV3 situata in C:\Program Files (x86)\DocuWare\Internal Database V3\ in un percorso diverso.
- Aprire il Prompt dei comandi come amministratore.
- Aprire il percorso del file C:\Program Files (x86)\DocuWare\Internal Database V3\bin\
- Eseguite il comando mysqld --initialize -- console. In questo modo verrà ricreato un nuovo database con una nuova tabella di sistema e un nuovo utente. Si noti che il comando darà l'utente root e la password temporanea.
- Avviare il server MySQL e all'apertura dell'applicazione verrà richiesto di modificare la password. Se si utilizza l'utente root, immettere la stessa password utilizzata per l'utente del database DocuWare. Se si utilizzava un altro utente del database, ricreare l'utente con la stessa password.
Dopo aver completato questi passaggi, si dovrebbe essere in grado di avviare i servizi e testare il sistema DocuWare. Se si verificano errori durante il processo di ripristino, contattare il gestore del database per assistenza. Se non è possibile avviare i servizi ed è necessario ripristinare il sistema alla versione V2, notare che la cartella V2 è disponibile perché non è stata eliminata. Nominare la cartella V3 "Non eliminare" e creare un ticket per l'assistenza del Support di DocuWare per risolvere il problema. Fornire tutti i passaggi effettuati fino al momento in cui non è possibile continuare.
Per tornare ai servizi V2:
1. Aprire il Prompt dei comandi come amministratore.
2. Eseguire il seguente comando
sc eliminare DWMySQL3
Per creare il servizio per V2, eseguire il seguente comando:
“Adjust the paths as needed for your environment.”
sc create DWMySQL2 binPath= "\"C:\Program Files (x86)\DocuWare\Internal Database V2\bin\mysqld.exe\" --defaults-file=\"C:\Program Files (x86)\DocuWare\Internal Database V2\my.ini\" DWMySQL2" DisplayName= "DocuWare Internal Database V2" start= "auto"
Nota: Il comando deve essere utilizzato esattamente come scritto.
Per avviare il servizio MySQL, utilizzare Service Control, Servizi di Windows o eseguire il comando:
sc start DWMySQL2
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.