Visualizzazioni:
Disclaimer:
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 se l'installazione è stata completata.
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 funzioni per qualche tempo per verificare se la funzionalità completa è ancora disponibile.


Informazioni di base su MySQL:
Durante il KBA, vengono 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 cartella 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\Databaseinterno\.
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, è sufficiente lavorare nella cartella di installazione.
Durante l'aggiornamento a MySQL 8, è necessario aggiungere una cartella allo stesso livello della directory dei dati.

Da MySQL 5.6 a MySQL 5.6 finale

Arrestare il servizio MySQL
Estrarre mysql-5.6.51-winx64.zip

Non eliminare, 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, copiarla potrebbe causare 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 es. root).
Questo aggiornerà le tabelle del database alla versione 5.6 final

MySQL 5.6 final a MySQL 5.7

Fermate il servizio MySQL
Estraete 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 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 in precedenza, 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
Fermate il servizio MySQL

Se volete creare un nuovo servizio usando i nomi corretti, cancellate il servizio MySQL esistente.
Ricreando il servizio con il nuovo nome in un secondo momento, si vedrà il database interno come "Internal Database V3" all'interno del ServiceControl.
Altrimenti è possibile utilizzare il vecchio servizio con il vecchio nome "Internal Database V2".
sc delete DWMySQL2

Andare nella cartella di installazione di MySQL e rimuovere/ricollocare tutti i file attuali.
Estrarre Internal Database V3.zip

Se si desidera spostare la posizione di tutti i file di MySQL tranne i dati, spostare i file estratti nella nuova posizione. In caso contrario, copiare tutti i file estratti nello stesso percorso del vecchio servizio.
(predefinito: C:\Program Files (x86)\DocuWare\Internal Database V2\)

Oltre ai tre file zip di installazione, nel contenitore zip scaricato si trova un my.ini.
Copiare questo my.ini nella cartella creata nel passaggio precedente.
All'interno del my.ini, è necessario modificare i seguenti percorsi:

basedir
datadir
secure-file-priv

Per impostazione predefinita, basedir è impostato su C:/Program Files (x86)/DocuWare/, data in C:/ProgramData/DocuWare/ e secure-file-priv è una cartella allo stesso livello della cartella dati.
È necessario creare manualmente la cartella "Uploads" nella stessa sottocartella della cartella dati.
Il percorso dovrebbe essere simile a C:\ProgramData\DocuWare\Internal Database\Uploads\

Assicurarsi che tutti i percorsi siano validi; in caso di dubbio, accedere a tutti i percorsi nel file explorer.

Se il servizio è stato eliminato all'inizio di questa fase, ricrearlo come mostrato:
Regolare i percorsi come necessario per il proprio ambiente.
sc create DWMySQL3 binPath= "\"C:\Program Files (x86)\DocuWare\Internal Database V2\bin\mysqld.exe\" --defaults-file=\"C:\Program Files (x86)\DocuWare\Internal Database V2\my.ini\"DWMySQL3" DisplayName= "DocuWare Internal Database V3" start= "auto"
Per i percorsi delle cartelle modificati, regolarsi di conseguenza, ma assicurarsi di includere correttamente i caratteri mascherati.

Se tutto è stato eseguito correttamente, è possibile avviare il servizio MySQL utilizzando il Service Control, Windows Services o il comando
sc start DWMySQL3

All'avvio di MySQL 8, le tabelle verranno aggiornate automaticamente.

Se si verificano errori durante l'aggiornamento, si deve purtroppo tornare all'ultima versione funzionante.
Poiché molto probabilmente l'aggiornamento di MySQL è avvenuto in rapida successione, si consiglia di partire dalla versione 5.6 Internal Database V2 con il backup.

Si prega di notare: Questo articolo è una traduzione dalla lingua inglese. Le informazioni contenute in questo articolo si basano sulla/le versione/i originale/i del/i prodotto/i in inglese. Potrebbero esserci errori minori, come nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi troverai che è sufficientemente informativa. In caso di dubbio, fai riferimento alla versione inglese di questo articolo.