Actualizar la versión de MySQL para Tekla PowerFab

Tekla PowerFab es oficialmente compatible con MySQL hasta la versión 8.0.35. Para actualizar la versión MySQL desde 5.0.90, se debe ejecutar Tekla PowerFab 2020 SP2 o una versión posterior.

Versiones de MySQL compatibles


Versión de Tekla PowerFab/EPM	MySQL 8.0.35¹	MySQL 5.7.41	MySQL 5.7.29	MySQL 5.6.36	MySQL 5.0.90
2022–Versión vigente	✓²	✓	✓	✓	✓
2021i:	-	✓	✓	✓	✓
2021	-	-	✓	✓	✓
2020i	-	-	✓	✓	✓
2020	-	-	-	✓	✓

¹El uso de MySQL 8 está restringido a equipos de 64 bits. Las versiones de 32 bits de MySQL 8 no están disponibles.

²Tekla PowerFab Se requiere 2023i SP3, Tekla PowerFab 2023 SP8, Tekla EPM 2022i SP9, Tekla EPM 2022 SP10 o una versión posterior para compatibilidad con MySQL 8.

Recomendamos actualizar a la última versión de Tekla PowerFab disponible antes de actualizar la versión de MySQL. También recomendamos reparar los errores del programa y comprimir la base de datos de Tekla PowerFab antes de realizar una copia de seguridad de la base de datos. Para obtener instrucciones, ver:

Nota: Todos los pasos deben realizarse desde el servidor donde está instalado MySQL. Al actualizar la versión de MySQL, todos los usuarios deben cerrar sesión en Tekla PowerFab y MySQL.

Opción 1: Actualización limpia de MySQL

Esta actualización consiste en desinstalar la versión anterior e instalar una nueva versión de MySQL.

Nota: Antes de empezar:

Al actualizar la versión de MySQL, es necesario asegurarse de que todos los usuarios hayan cerrado sesión en Tekla PowerFab y MySQL antes de guardar una copia de seguridad de la base de datos de Tekla PowerFab hasta que la base de datos de Tekla PowerFab se haya restaurado en la nueva versión.

Antes de realizar los pasos siguientes, consulte las siguientes instrucciones:

Localizar el instalador de la versión de MySQL que se desea instalar de cualquiera de las siguientes maneras:
- En Actualizar MySQL para Tekla PowerFab en el Tekla Warehouse.
  Solo se proporcionan las versiones mantenidas por MySQL MySQL en el Tekla Warehouse.
- En la ubicación de instalación predeterminada de los Carpetas predeterminadas para la copia de seguridad (C:\Users\Public\Documents\Tekla\Backup), debería encontrarse mysql_setup_<version>.exe.
  Si no se cuenta con la versión del instalador que se desea, comunicarse con el soporte para obtenerla.
  Para obtener más información, ver:
  - Carpetas Predeterminadas
  - Contactar a soporte
En el servidor, abrir Tekla PowerFab como administrador.
(Opcional, recomendado) Reparar errores del programa.
(Opcional, recomendado) Comprimir la base de datos de Tekla PowerFab.
Guardar una copia de seguridad de la base de datos de Tekla PowerFab.

No guardar esto en la ubicación de instalación de MySQL.
Cerrar Tekla PowerFab.
Abrir la aplicación Servicios de Windows, ubicar el servicio MySQL para la base de datos de Tekla PowerFab y detener el servicio.

Según la versión con la que se haya comenzado, el nombre del servicio puede ser MySQL_TeklaPowerFab, MySQL_TeklaEPM o MySQL_Fabsuite. El nombre del servicio se puede personalizar con MySQL Service Manager, por lo que se puede usar cualquier nombre.
(Opcional) Para desinstalar la versión actual de MySQL, ejecutar uninstall.exe desde la ubicación de instalación de MySQL.

Normalmente, la ubicación es C:\mysql\, pero podría haberse personalizado.

Nota: Antes de desinstalar la versión actual de MySQL, es necesario asegurarse de que no haya otros programas o servicios que también la utilicen. Si los hay, se debe instalar un segundo MySQL para la nueva versión.
Para instalar MySQL, ejecutar mysql_setup_<version>.exe ubicado en la ubicación de instalación predeterminada de los directorios predeterminados para la copia de seguridad.

Ver el paso 2.

Si se está instalando una segunda instancia del programa MySQL, se debe especificar un nuevo directorio predeterminado, como, por ejemplo, C:\MySQL8. Al ejecutar el mysql_setup_8.exe proporcionado por Trimble, se crea un nuevo servicio MySQL_TeklaPowerFab en el puerto 3306.
Abrir Tekla PowerFab como administrador
Restaurar la base de datos Tekla PowerFab.

Usar la copia de seguridad de la base de datos creada en el paso 6.
Volver a crear el servicio Tekla PowerFab Remote Server.
1. Abrir el Tekla PowerFab Remote Monitor.
  
  Normalmente, se encuentra en el directorio de instalación de Tekla PowerFab y el nombre de la aplicación es Tekla.PowerFab.Remote.Monitor.exe.
  
  Ver también Monitor Remoto de Tekla PowerFab.
2. Para eliminar el servicio existente, seleccionarlo en el menú desplegable y hacer clic en el botón Menos (-).
3. Para crear un nuevo servicio, hacer clic en el botón Más (+).
  
  La dependencia del servicio debe ser MySQL_Tekla PowerFab.
Configurar e iniciar Servidor remoto de Tekla PowerFab.

Después de completar todos estos pasos, los usuarios pueden volver a iniciar sesión en la aplicación de escritorio Tekla PowerFab y Tekla PowerFab Go.

Opción 2: Actualizar con la utilidad MySQL_Upgrade

Los usuarios que no deseen desinstalar la versión de MySQL existente e instalar la nueva versión, pueden utilizar la utilidad MySQL_Upgrade.exe.

Nota: Antes de empezar:

Es necesario asegurarse de que todos los usuarios hayan cerrado sesión en Tekla PowerFab y que ningún usuario inicie sesión hasta que se complete la actualización.

Ver las siguientes instrucciones:

Descargar y extraer la mysql-upgrade-<version>.exe deseada desde Actualizar MySQL para Tekla PowerFab en el Tekla Warehouse.

Solo se proporcionan las versiones mantenidas por MySQL MySQL en el Tekla Warehouse.
En el servidor, abrir Tekla PowerFab como administrador.
(Opcional, recomendado) Reparar errores del programa.
(Opcional, recomendado) Comprimir la base de datos de Tekla PowerFab.
Guardar una copia de seguridad de la base de datos de Tekla PowerFab.

No guardar esto en la ubicación de instalación de MySQL.
Abrir Windows Explorador y buscar el directorio de instalación del programa Tekla PowerFab.

La ubicación predeterminada es C:\Program Files\Tekla\Tekla PowerFab.
Cerrar todas las instancias de Tekla PowerFab, incluidas Tekla PowerFab Remote Monitor y MySQL Service Manager.
Ejecutar MySQL_Upgrade.exe desde el directorio de instalación del programa Tekla PowerFab.

La ubicación predeterminada es C:\Program Files\Tekla\Tekla PowerFab.

Se abre el cuadro de diálogo Ajustes Actualizar.
Para abrir el cuadro de diálogo de selección de archivos, hacer clic en el botón de puntos suspensivos a la derecha del Instalador Actualizar y seleccionar el mysql-upgrade-<version>.exe que se obtuvo en el paso 1.
En la sección MySQL del cuadro de diálogo Configuración de actualización , ingrese la siguiente información:

Dirección IP Maestro: Dejar como localhost.

Puerto Maestro: El puerto predeterminado de MySQL es 3306. Cambiar solo si se ha configurado MySQL específicamente para que se ejecute en otro puerto.

Dirección IP Actualizar y Puerto Actualizar: Estos parámetros rara vez se utilizan y deben dejarse en blanco a menos que el soporte técnico indique lo contrario.

Nombre de usuario y Contraseña: Ingresar las credenciales de un usuario de Tekla PowerFab con permisos de administrador.

Nombre Servicio: Este es el nombre del servicio de Windows que administra el proceso de MySQL.

El nombre del servicio predeterminado cuando Tekla PowerFab se instala MySQL es MySQL_TeklaPowerFab.

Según la versión con la que se haya comenzado, el nombre del servicio puede ser MySQL_TeklaPowerFab, MySQL_TeklaEPM o MySQL_Fabsuite. El nombre del servicio se puede personalizar con MySQL Service Manager, por lo que se puede usar cualquier nombre.

Algunos usuarios instalan un segundo servicio de MySQL en el mismo servidor, utilizando el mismo conjunto de ejecutables de MySQL, pero trabajando en otros directorios de datos y escuchando en otro puerto.

Si este es el caso, dicho servicio adicional debe agregarse a Ajustes Actualizar para que ambos directorios de datos se actualicen. Si se está ejecutando otro servicio de MySQL que utiliza el mismo conjunto de ejecutables de MySQL y no se ha especificado en los ajustes, la actualización fallará o el segundo servicio de MySQL dejará de funcionar correctamente.
Para instalar un segundo servicio de MySQL, hacer lo siguiente:
1. Hacer clic en el botón Más (+) para agregar un conjunto adicional de entradas del servidor MySQL.
2. Ingresar Dirección IP Maestro, Puerto Maestro, Nombre de usuario, Contraseña y Nombre Servicio.
  
  Repetir estos pasos para cualquier servicio de MySQL adicional que opere desde el mismo conjunto de ejecutables de MySQL.
Para iniciar la actualización, hacer clic en Actualizar Servidor MySQL.

El cuadro de diálogo Configuración de actualización se cierra y se muestran los mensajes de estado.

Nota: No se debe intentar finalizar el programa de actualización mientras está en curso. Si se hace, es probable que la instalación de MySQL no funcione.

Los pasos de actualización se completan sin que se requiera ninguna acción adicional por parte del usuario.

Los pasos que se completan automáticamente son los siguientes:

Verificar los ajustes que se ingresaron en la pantalla anterior.
Realizar una copia de seguridad de la base de datos.
Detener el servicio de MySQL.
Copiar los archivos de la nueva versión de MySQL.
Ajustar la configuración de MySQL.
Iniciar el servicio de MySQL.
Restaurar la base de datos.
Completar la actualización de los archivos de datos.

Una vez finalizada la actualización, aparece el mensaje ¡Actualización completada! en el cuadro de diálogo de estado. A continuación, se puede cerrar de forma segura el programa de actualización y abrir e iniciar sesión en Tekla PowerFab.

Actualización fallida

Si la actualización falla, aparece un cuadro de diálogo con el texto Actualización fallida.

Hacer clic en Aceptar.

Aparece otro mensaje que indica que la actualización se revierte a su estado anterior.
Para continuar con la reversión, hacer clic en OK.

Se revertirán todos los pasos realizados hasta este momento. Esto deja MySQL en el mismo estado que se encontraba antes de la actualización y vuelve a aparecer el cuadro de diálogo Ajustes Actualizar.

A continuación, se puede ajustar cualquier configuración e intentar la actualización nuevamente o comunicarse con el soporte técnico para obtener más ayuda.