Instalación de sistemas RHEL/CentOS

Instalar Relational Migrator

1. Descargar el último binario .tar.gz de la Página de lanzamiento.

2. Instalar Relational Migrator.

   tar -xvzf relational-migrator-<version_number>-linux-amd64.tar.gz -C /opt

   Nota

   Puede extraer la instalación a una ubicación distinta del directorio /opt/.

3. (Opcional) Para conectarse a los controladores de Oracle o MySQL, descargue y coloque los controladores en su directorio de Relational Migrator.

   1. Para descargar e instalar los drivers de MySQL u Oracle, consulta lo siguiente:

      • MySQL: 9.1.x más reciente versión, Versión independiente de la plataforma

      • Oracle: 21.6.0.0 de ojdbc11.jar de Oracle 21c

      • DB2: última 3.x o 4.x db2jcc.jar

   2. Copie los archivos del controlador a ~/.mongodb/relational-migrator/Drivers.

      Para copiar el driver, utiliza el siguiente ejemplo:

      curl https://download.oracle.com/otn-pub/otn_software/jdbc/216/ojdbc11.jar -O -L -b -o

   Nota

   Si Relational Migrator está en ejecución, debe reiniciar la aplicación después de copiar los controladores en el directorio Drivers.

   Para más información, consulte Instalar en una máquina local.

4. Cambie el directorio a la ubicación de Relational Migrator /bin y inicie la aplicación.

   cd /opt/relational-migrator-<version_number>/bin
   ./relational-migrator

5. Permitir que Relational Migrator se ejecute como un servidor autónomo sin supervisión.

   En su archivo user.properties, descomente spring.profiles.active: unattended.

6. (Opcional) Actualice las propiedades de configuración de TLS/SSL.

   En tu archivo user.properties, descomenta y actualiza las propiedades de configuración TLS/SSL.

   Se recomienda que configures TLS/SSL para Relational Migrator en tu servidor desatendido. Puedes vincular el Relational Migrator a cualquier IP y puerto en el servidor. Para obtener información adicional, consulte Propiedades de configuración de SSL.

7. (Opcional) Actualiza el puerto en el que se ejecuta Relational Migrator.

   Por defecto, el Relational Migrator está configurado para ejecutarse en el puerto 8278. Para cambiar el puerto en el que se ejecuta Relational Migrator, actualiza la línea server.port en tu archivo user.properties para especificar tu puerto preferido.

8. Ejecuta Relational Migrator utilizando el binario.

   La ruta al directorio bin es /opt/mongodb-relational-migrator/bin.

   Para ejecutar Relational Migrator usando el binario, ejecuta lo siguiente:

   cd /opt/relational-migrator-<version_number>/bin
   ./relational-migrator

9. (Opcional) Consulta los registros para identificar errores u otra información.

   • Los registros se encuentran en ~/.mongodb/relational-migrator/migrator.log.

   • Al ejecutar Relational Migrator como un servicio del sistema, la ruta se encuentra en el directorio de inicio del usuario del servicio.

Ejecutar como servicio del sistema

Al instalar Relational Migrator en un servidor RHEL/CentOS, también puede configurarlo para que se ejecute como un servicio del sistema. Al ejecutar Relational Migrator como un servicio del sistema, se inicia automáticamente al iniciarse el servidor.

1. Cree un archivo /etc/systemd/system/migrator.service.

   Copia el texto a continuación en el /etc/systemd/system/migrator.service archivo. Reemplace la ruta binaria según sea necesario.

   [Unit]
   Description=MongoDB Relational Migrator
   [Service]
   ExecStart="/opt/relational-migrator-<version_number>/bin/relational-migrator"
   [Install]
   WantedBy=multi-user.target

2. Vuelve a cargar systemd para leer el servicio recién creado:

   systemctl daemon-reload

3. Habilita el servicio de Relational Migrator para ejecutarse al iniciar y durante la sesión actual.

   Puedes gestionar el servicio con los comandos systemctl. Para ejecutarse al inicio y comenzar la sesión actual, ejecuta lo siguiente:

   systemctl enable migrator.service
   systemctl start migrator.service