Instalación de sistemas Debian

Instalar Relational Migrator

1. Descargue el último binario .tar.gz desde Página de lanzamiento.

2. Actualice los repositorios del administrador 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 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.

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

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

   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 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 TLS/SSL.

9. (Opcional) Actualice 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. Ejecute Relational Migrator usando 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 un servicio del sistema

Al instalar Relational Migrator en un servidor Debian, 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 iniciar 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 inicie automáticamente cuando se inicie el servidor.

   Puede gestionar el servicio con los siguientes comandos systemctl:

   systemctl enable migrator.service
   systemctl start migrator.service