Instalação de sistemas Debian

Instalar o Relational Migrator

1. Baixe o binário .tar.gz mais recente napágina de lançamentodo .

2. Atualize os repositórios do gerenciador de pacote do sistema:

   sudo apt update

3. (Para distribuições Linux headless) Crie os diretórios necessários:

   sudo mkdir /usr/share/desktop-directories/

4. Instale o Relational Migrator.

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

   Observação

   Você pode extrair a instalação para um local diferente do diretório /opt/.

5. (Opcional) Para se conectar aos drivers Oracle ou MySQL, baixe e coloque os drivers no diretório do Relational Migrator.

   1. Para baixar e instalar drivers MySQL ou Oracle, consulte o seguinte:

      • MySQL: últimas 9.1.x versão, Versão independente de plataforma

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

      • DB2: últimas 3.x ou 4.x db2jcc.jar

   2. Copie os arquivos do driver para ~/.mongodb/relational-migrator/Drivers.

      Para copiar o driver, use o seguinte exemplo:

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

   Observação

   Se o Relational Migrator estiver em execução, você deverá reiniciar o aplicação após copiar os drivers para o diretório Drivers.

   Para obter mais informações, consulte Instalação do em uma máquina local.

6. Altere o diretório para o local do Relational Migrator /bin e inicie o aplicativo.

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

7. Habilite o Relational Migrator para ser executado como um servidor standalone autônomo.

   No seu arquivo user.properties , descomente spring.profiles.active: unattended.

8. (Opcional) Atualize as propriedades de configuração TLS/SSL.

   Em seu arquivo user.properties , descomente e atualize as propriedades de configuração TLS/SSL.

   É recomendável configurar TLS/SSL para o Relational Migrator em seu servidor autônomo. Você pode vincular o Relational Migrator a qualquer IP e porta no servidor. Para obter informações adicionais, consulte Propriedades de configuração TLS/SSL.

9. (Opcional) Atualize a porta em que o Relational Migrator é executado.

   Por padrão, o Relational Migrator é configurado para ser executado na porta 8278. Para alterar a porta em que o Relational Migrator é executado, atualize a linha server.port em seu arquivo user.properties para especificar sua porta preferida. Por exemplo, você pode querer usar a porta 80 para HTTP ou a porta 443 para HTTPS.

10. Execute o Relational Migrator usando o binário.

    O caminho do diretório bin é /opt/mongodb-relational-migrator/bin. Para executar o Relational Migrator usando o binário, execute o seguinte:

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

11. (Opcional) Verifique os registros em busca de erros ou outras informações.

    • Os logs estão localizados em ~/.mongodb/relational-migrator/migrator.log..

    • Ao executar o Relational Migrator como um serviço do sistema, o caminho está sob o diretório inicial do usuário do serviço.

Executar como um serviço do sistema

Ao instalar o Relational Migrator em um servidor Debian, você também pode configurar o Relational Migrator para ser executado como um serviço do sistema. Ao executar o Relational Migrator como um serviço do sistema, o Relational Migrator é iniciado automaticamente quando o servidor é iniciado.

1. Crie um arquivo /etc/systemd/system/migrator.service .

   Copie o texto abaixo para o arquivo /etc/systemd/system/migrator.service . Substitua o caminho binário conforme necessário.

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

2. Recarregue systemd para ler o serviço recém-criado.

   systemctl daemon-reload

3. Ative o serviço Relational Migrator para iniciar automaticamente quando o servidor iniciar.

   Você pode managed o serviço com os seguintes comandos do systemctl :

   systemctl enable migrator.service
   systemctl start migrator.service