Instalação de sistemas RHEL/CentOS

Instalar o Relational Migrator

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

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

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

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

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

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

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

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

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

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

   O caminho para o 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

9. (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 RHEL/CentOS, 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 ser executado na inicialização e no início da sessão atual.

   Você pode gerenciar o serviço com comandos systemctl . Para executar na inicialização e iniciar a sessão atual, execute o seguinte:

   systemctl enable migrator.service
   systemctl start migrator.service