Como restaurar backups

Aviso: se a instância for hospedada pelo cliente, não modifique os arquivos do LookML diretamente no sistema de arquivos da instância. Isso pode causar erros inesperados no seu 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 uma instância do Looker hospedada pelo cliente em um novo host, conclua estas etapas das instruções de instalação do Looker:

• Verifique se o novo servidor está em conformidade com as especificações mínimas do servidor.
• Ative ntpd ou chronyd.
• Crie o usuário, o grupo e o diretório principal looker.
• Pule o download do aplicativo Looker e todas as etapas 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 de um ambiente em cluster:

• Interrompa todos os Lookers em execução no cluster.
• Restaure o banco de dados.
• Inicie uma instância do Looker de cada vez.

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

Como restaurar um backup independente de keystore

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

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

1. Parar o Looker:

   cd looker
   ./looker stop
   

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

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

2. Verifique se o Looker pode acessar o CMK usado para o keystore local do local em que você restaurou o Looker. Se o CMK do local de restauração estiver armazenado em um arquivo, será possível usar 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>
   

   Se você quiser fornecer o CMK do local da restauração diretamente em uma variável de ambiente, use 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 de chave em texto simples criado quando o backup independente de 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, inicie o Looker normalmente. Quando o Looker estiver em execução, recomendamos excluir o arquivo de chave em texto simples usado para criar o backup independente de keystore.