Instalación de sistemas RHEL/CentOS

Instalar Relational Migrator

1. Descargue el último binario .tar.gz desde 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 controladores MySQL u Oracle, consulte lo siguiente:

      • MySQL: última versión 9.1.x, versión independiente de la plataforma

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

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

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

      Para copiar el controlador, utilice el siguiente ejemplo:

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

   Nota

   Si Relational Migrator se está ejecutando, debe reiniciar la aplicación después de copiar los controladores al 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 e inicie la aplicación.

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

5. Habilite Relational Migrator para que se ejecute como un servidor independiente desatendido.

   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 configurar TLS/SSL para Relational Migrator en su servidor desatendido. Puede vincular Relational Migrator a cualquier IP y puerto del servidor. Para obtener más información, consulte Propiedades de configuración de SSL.

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

   De forma predeterminada, Relational Migrator está configurado para ejecutarse en el puerto 8278. Para cambiar el puerto de ejecución de Relational Migrator, actualice la línea server.port en el archivo user.properties para especificar el puerto que prefiera.

8. Ejecute Relational Migrator usando el binario.

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

   Para ejecutar Relational Migrator usando el binario, ejecute 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 un 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.

   Copie el texto a continuación en el archivo /etc/systemd/system/migrator.service. 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. Recargue systemd para leer el servicio recién creado:

   systemctl daemon-reload

3. Habilite el servicio Relational Migrator para que se ejecute al iniciarse y se inicie para la sesión actual.

   Puedes administrar el servicio con los comandos systemctl. Para ejecutarlo al iniciar e iniciar la sesión actual, ejecuta lo siguiente:

   systemctl enable migrator.service
   systemctl start migrator.service