Instalación de sistemas Debian

Instalar Relational Migrator

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

2. Actualiza los repositorios del gestor de paquetes del sistema:

   sudo apt update

3. (Para distribuciones Linux sin cabeza) Cree los directorios necesarios:

   sudo mkdir /usr/share/desktop-directories/

4. 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/.

5. (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.

6. 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

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

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

8. (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, consulta Propiedades de configuración TLS/SSL.

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

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

10. Ejecuta Relational Migrator utilizando el binario.

    La ruta del directorio bin es /opt/mongodb-relational-migrator/bin. Para ejecutar Relational Migrator con el binario, ejecute lo siguiente:

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

11. (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

Cuando intalas Relational Migrator en un servidor Debian, también puedes configurar Relational Migrator para que se ejecute como un servicio del sistema. Cuando se ejecuta Relational Migrator como un servicio del sistema, Relational Migrator se inicia automáticamente cuando se inicia 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. Recarga systemd para leer el servicio recién creado.

   systemctl daemon-reload

3. Habilita el servicio Relational Migrator para que se inicie automáticamente cuando el servidor se inicie.

   Puede gestionar el servicio con los siguientes comandos systemctl:

   systemctl enable migrator.service
   systemctl start migrator.service