Como restaurar backups

Aviso: se a instância for hospedada pelo cliente, não modifique os arquivos LookML diretamente no sistema de arquivos dela. Isso pode causar erros inesperados no fluxo de trabalho do Git. Para fazer mudanças nos arquivos LookML, siga as etapas em Como usar o controle de versões e a implantação.

Para saber mais sobre como criar backups do Looker, consulte a página de documentação Como criar backups.

Para restaurar o Looker em um novo host, siga apenas estas etapas das instruções de instalação do Looker:

• Verifique se o novo servidor obedece às especificações mínimas do servidor.
• Ative ntpd ou chronyd.
• Crie o usuário, o grupo e o diretório inicial do looker.
• Pule o download do aplicativo Looker e de todas as etapas de instalação restantes.

Quando o novo host estiver preparado:

• Restaure os arquivos do backup.

• Inicie o Looker:

  sudo su - looker
  cd looker
  ./looker start
  

Ambientes em cluster

Para restaurar o banco de dados MySQL para um ambiente em cluster:

• Interrompa qualquer Looker em execução no cluster.
• Restaure o banco de dados.
• Inicie as instâncias do Looker, uma de cada vez.

Consulte a documentação do MySQL para mais detalhes sobre como restaurar bancos de dados MySQL.

Como restaurar um backup independente do keystore

As instalações hospedadas pelo cliente que migraram para a criptografia AES-256 do GCM e geraram um backup independente de keystore precisam atualizar o banco de dados interno do Looker depois de realizar uma restauração.

Depois de restaurar um backup independente do keystore, siga este procedimento para descriptografar a KEK, criptografá-la novamente usando o novo keystore local e atualizar a entrada da chave no banco de dados interno:

1. Parar o Looker:

   cd looker
   ./looker stop
   

   Se o Looker estiver em cluster, pare todos os nós antes de continuar.

   Se algum nó ainda estiver em execução quando você emitir o comando restore_dr_backup, ele falhará com a mensagem: "Há outros nós ativos conectados a esse banco de dados do back-end do Looker. Se o Looker foi encerrado no último minuto, tente novamente em breve. Caso contrário, verifique se todos os nós do cluster estão desligados."

2. Verifique se o Looker pode acessar a CMK do armazenamento de chaves local do local em que você restaurou o Looker. Se o CMK do local de restauração estiver armazenado em um arquivo, use a variável de ambiente LKR_MASTER_KEY_FILE para apontar para o caminho do arquivo CMK:

   export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
   

   Ou, se quiser fornecer a CMK do local de restauração diretamente em uma variável de ambiente, você pode usar a variável de ambiente LKR_MASTER_KEY_ENV:

   export LKR_MASTER_KEY_ENV=<CMK_value>
   

3. Atualize o banco de dados interno:

   ./looker restore_dr_backup <path_to_CMK_file>
   

   em que <path_to_CMK_file> é o caminho e o nome do arquivo da chave de texto simples criado quando o backup independente do keystore foi feito. O arquivo de chave tem o seguinte formato:

   {"dbmk":"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\n","backup_uid":"XCXvRa38mNeqT6+HRBCo2Q=="}
   

   em que o valor de dbmk é uma chave de criptografia de 256 bits com codificação Base64 e backup_uid é um nome exclusivo usado ao salvar a chave no banco de dados.

Depois de atualizar o banco de dados interno do Looker, é possível iniciar o Looker normalmente. Depois que o Looker estiver em execução, recomendamos que você exclua o arquivo de chave de texto simples usado para criar o backup independente do keystore.