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 alterações nos arquivos do LookML, siga as etapas em Como usar o controle de versões e a implantação.

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

Para restaurar uma instância do Looker hospedada pelo cliente para um novo host, siga apenas estas etapas das instruções de instalação do Looker:

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

Depois que o novo host estiver preparado:

• Restaure os arquivos do backup.

• Iniciar o Looker:

  sudo su - looker
  cd looker
  ./looker start
  

Ambientes em cluster

Para restaurar o banco de dados MySQL em um ambiente clusterizado:

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

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

Como restaurar um backup independente do keystore

Instalações hospedadas pelo cliente que migraram para a criptografia AES-256 GCM e geraram um backup independente do 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 de chave no banco de dados interno:

1. Parar o Looker:

   cd looker
   ./looker stop
   

   Se o Looker estiver agrupado, 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 vai falhar com a mensagem "Há outros nós ativos conectados a este banco de dados do Looker de back-end. 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 encerrados."

2. Verifique se o Looker pode acessar a CMK usada 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, 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 você quiser fornecer o CMK do local de 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 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, você pode iniciá-lo normalmente. Quando 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.