La instalación de bases de datos MySQL no forma parte del Support de DocuWare.
Dado que MySQL es una aplicación de terceros, no tenemos forma de solucionar ningún problema, recomendar ajustes adicionales o comprobar si la instalación se ha completado por completo.
DocuWare no se hace responsable de ningún sistema dañado si la base de datos se daña durante o después de la instalación.
Pregunta:
Cómo actualizar una base de datos interna V2 (MySQL 5.6) a una base de datos interna V3 (MySQL 8)
Respuesta:
La actualización de MySQL 5.6 a MySQL 8 requiere tres pasos.
Puede comprobar la versión de MySQL que tiene instalada ejecutando
SHOW VARIABLES LIKE "%version%";
Puede encontrar todos los archivos necesarios mediante la siguiente descarga:
Download-MySQL56TO8
Notas importantes:
Asegúrese de cerrar todas las aplicaciones que acceden a la base de datos antes de realizar cualquier copia de seguridad o volcado.
Asegúrese de tener una copia de seguridad válida de su base de datos.
Asegúrese de tener una copia de seguridad de su directorio de instalación.
No actualice DocuWare directamente después de actualizar MySQL.
Deje que el sistema funcione durante algún tiempo para comprobar si se sigue dando la funcionalidad completa.
Información básica sobre MySQL:
Durante el KBA, se mencionará el directorio de instalación así como el directorio de datos.
El directorio de instalación contiene todos los archivos necesarios para ejecutar el servicio MySQL, y se encuentra en C:\Archivos de programa (x86)\DocuWare\Base de datos interna V1\ o C:\Archivos de programa (x86)\DocuWare\Base de datos interna V2\ dependiendo de las instalaciones anteriores.
Si no está seguro de dónde encontrar el directorio de instalación, compruebe el servicio MySQL dentro de Servicios de Windows, obtendrá la ruta al archivo MySQLD.exe y con él la carpeta de instalación.
En esta carpeta, encontrará el archivo my.ini y muchas subcarpetas, por ejemplo, \bin.
\bin contiene la mayoría de los ejecutables y es necesario más adelante para ejecutar los actualizadores.
El directorio de datos se encuentra en C:\ProgramData\DocuWare\Internal Database\.
La carpeta se llama datos.
Contiene el contenido y la estructura de todas las tablas de la base de datos MySQL instalada.
Para la parte inicial de la actualización, sólo tiene que trabajar en la carpeta de instalación.
Durante la actualización a MySQL 8, deberá añadir una carpeta en el mismo nivel que el directorio de datos.
MySQL 5.6 a MySQL 5.6 final
Detenga el servicio MySQL
Extraiga mysql-5.6.51-winx64.zip
No elimine, sino sustituya los archivos dentro de la carpeta de instalación (Por defecto C:\Program Files (x86)\DocuWare\Internal Database V2)
NOTA: Los archivos incluidos proporcionarán una carpeta "Data".No copie la carpeta Data, copiar esta carpeta causará comportamientos inesperados.
Inicie el Servicio MySQL, ya sea a través de ServiceControl o Servicios de Windows.
Inicie una línea de comandos con derechos administrativos y navegue hasta el directorio de instalación y su subcarpeta \bin.
(por defecto: C:\Program Files (x86)\DocuWare\Internal Database V2\bin)
Ejecute el siguiente comando.
mysql_upgrade --user=root --password=admin
Elija un usuario administrativo de MySQL (por ejemplo, root).
Esto actualizará las tablas de su base de datos a la versión 5.6 final
MySQL 5.6 final a MySQL 5.7
Detenga el servicio MySQL
Extraiga mysql-5.7.38-winx64.zip
No elimine, sino reemplace los archivos dentro de la carpeta de instalación (Por defecto C:\Program Files (x86)\DocuWare\Internal Database V2)
Abra el archivo my.ini existente y busque "innodb_additional_mem_pool_size".
Elimine el atributo, ya sea eliminando la línea o comentando añadiendo un # al principio de la línea.
Inicie el Servicio MySQL, ya sea a través de ServiceControl o Servicios de Windows.
Como antes, utilice el cmd administrativo para ejecutar el comando de actualización.
mysql_upgrade --user=root --password=admin
Esto actualizará las tablas de su base de datos a la 5.7
Mysql 5.7 a MySQL 8
NOTA: Antes de completar los pasos descritos, lo mejor es crear una copia de seguridad completa de todas las bases de datos de DocuWare y colocarla en una ubicación diferente fuera del servidor DocuWare.
- Detenga los servicios MySQL en DocuWare haciendo clic con el botón derecho del ratón en DocuWare Service Control y seleccionando Detener servicios para realizar un cierre suave.
NOTA: ¡NO CIERRE TODOS LOS SERVICIOS! EL CIERRE DE TODOS LOS SERVICIOS CAUSARÁ LA MUERTE DEL PROCESO Y PRODUCIRÁ UNA CORRUPCIÓN GRAVE DE LA BASE DE DATOS, LO QUE OBLIGARÁ A UNA REESTRUCTURACIÓN COMPLETA DE LA BASE DE DATOS. - Extraiga el archivo Internal Database V3.zip.
- Mueva la carpeta Internal Database V3 a la carpeta de instalación que tiene Internal Database V2 ubicada en C:\Program Files (x86)\DocuWare Internal Database V2.
- Abra la carpeta Internal Database V3 y cree una nueva carpeta llamada "Uploads".
- Añada la carpeta de datos copiada de Internal Database V2 a Internal Database V3.
- En el archivo zip principal, descargue el archivo my.ini en la carpeta Internal Database V3.
NOTA: Se recomienda utilizar Notepad++ para editar el archivo my.ini. Al editar el archivo, asegúrese de que el formato de codificación está establecido en UTF-8.
- Dentro del archivo my.ini, ajuste las siguientes rutas:
basedir=C:/Archivos de programa (x86)/DocuWare/Internal Database V3
datadir=C:/Archivos de programa (x86)/DocuWare/Internal Database V3/data
secure-file-priv=C:/Archivos de programa (x86)/DocuWare/Internal Database V3/Uploads - Ahora, elimine el servicio V2 ejecutando la siguiente consulta en Símbolo del sistema como administrador.
sc delete DWMySQL2
Para crear el servicio para V3 ejecute el siguiente 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: El comando debe usarse exactamente como está escrito.
Una vez completado el comando, ejecute el siguiente comando para iniciar ahora el servicio MySQL.
sc start DWMySQL3
Al iniciarse MySQL 8, las tablas se actualizarán automáticamente. Si se produce algún error durante la actualización, puede encontrar el error en el archivo InternalDatabasev3.err ubicado en C:Archivos de programa (x86)\NInternal Database v3\Data. Después de leer el error específico, se puede hacer una de dos cosas para resolverlo.
Una solución es completar los siguientes pasos para forzar la actualización.
- Abra el Símbolo del sistema como administrador.
- En el explorador de archivos, siga la ruta de archivo C:\Program Files (x86)\DocuWare\Internal Database V3\bin\\
3. Ejecute el siguiente comando en Símbolo del sistema
mysqld --upgrade=Force
NOTA: Este proceso puede tardar algún tiempo, pero debe asegurarse de que se completa correctamente.
Otra opción para solucionar el error es la siguiente:
- Reubique la carpeta de datos InternalDatabaseV3 situada en C:\Program Files (x86)\DocuWare\Internal Database V3\ a una ruta de archivo diferente.
- Abra el símbolo del sistema como administrador.
- Abra la ruta de archivo C:Archivos de programa (x86) DocuWare Base de datos interna V3.
- Ejecute el comando mysqld --initialize -- console. Esto recreará una nueva base de datos con una nueva tabla de sistema de base de datos y un nuevo usuario. Tenga en cuenta que el comando dará el usuario root y la contraseña temporal.
- Inicie el servidor MySQL y, al abrir la aplicación, se le pedirá que cambie la contraseña. Si está utilizando la raíz como usuario, introduzca la misma contraseña utilizada para el usuario de base de datos de DocuWare. Si estaba utilizando otro usuario de base de datos, vuelva a crear el usuario con la misma contraseña que antes.
Después de completar estos pasos, debería poder iniciar los servicios y probar su sistema DocuWare. Si encuentra errores en el proceso de restauración, póngase en contacto con su gestor de base de datos para obtener ayuda. Si no puede iniciar los servicios y necesita revertir el sistema a V2, tenga en cuenta que la carpeta V2 está disponible porque no se eliminó. Asigne a la carpeta V3 el nombre "No eliminar" y cree un ticket para que DocuWare Support le ayude a resolver el problema. Indique todos los pasos realizados hasta el momento en que no puede continuar.
Para volver a los servicios V2:
1. Abra el símbolo del sistema como administrador.
2. Ejecute el siguiente comando
sc eliminar DWMySQL3
3. Para crear el servicio para V2 ejecute el siguiente 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: El comando debe usarse exactamente como está escrito.
Para iniciar el servicio MySQL, utilice Service Control, Servicios de Windows o ejecute el comando:
sc start DWMySQL2
Tenga en cuenta: Este artículo es una traducción del idioma inglés. La información contenida en este artículo se basa en la(s) versión(es) original(es) del producto(s) en inglés. Puede haber errores menores, como en la gramática utilizada en la versión traducida de nuestros artículos. Si bien no podemos garantizar la exactitud completa de la traducción, en la mayoría de los casos, encontrará que es lo suficientemente informativa. En caso de duda, vuelva a la versión en inglés de este artículo.