Restaurer des sauvegardes

Pour en savoir plus sur la création de sauvegardes Looker, consultez la page de documentation Créer des sauvegardes.

Pour restaurer une instance Looker hébergée par un client vers un nouvel hôte, suivez uniquement ces étapes des instructions d'installation de Looker:

  • Vérifiez que le nouveau serveur respecte les spécifications minimales du serveur.
  • Activer ntpd ou chronyd.
  • Créez l'utilisateur, le groupe et le répertoire d'accueil looker.
  • Ignorez le téléchargement de l'application Looker et toutes les étapes d'installation restantes.

Une fois que le nouvel hôte est prêt:

  • Restaurez les fichiers à partir d'une sauvegarde.
  • Lancez Looker:

    sudo su - looker
    cd looker
    ./looker start
    

Environnements en cluster

Pour restaurer la base de données MySQL pour un environnement en cluster:

  • Arrêtez tous les Looker en cours d'exécution dans le cluster.
  • Restaurez la base de données.
  • Démarrez les instances Looker une par une.

Consultez la documentation MySQL pour en savoir plus sur la restauration de bases de données MySQL.

Restaurer une sauvegarde indépendante du keystore

Les installations hébergées par le client qui ont migré vers le chiffrement AES-256 GCM et généré une sauvegarde indépendante du keystore doivent mettre à jour la base de données interne de Looker après avoir effectué une restauration.

Après avoir restauré une sauvegarde indépendante du keystore, procédez comme suit pour déchiffrer la KEK, la rechiffrer à l'aide du nouveau keystore local et mettre à jour l'entrée de clé dans la base de données interne:

  1. Arrêtez Looker:

    cd looker
    ./looker stop
    

    Si Looker est en cluster, assurez-vous d'arrêter tous les nœuds avant de continuer.

    Si des nœuds sont toujours en cours d'exécution lorsque vous exécutez ultérieurement la commande restore_dr_backup, celle-ci échoue et affiche le message suivant : "D'autres nœuds actifs sont connectés à cette base de données Looker backend. Si Looker a été arrêté au cours de la dernière minute, réessayez dans quelques instants. Sinon, vérifiez que tous les nœuds du cluster sont arrêtés."

  2. Assurez-vous que Looker peut accéder à la clé CMK utilisée pour le keystore local de l'emplacement où vous avez restauré Looker. Si la clé CMK de l'emplacement de restauration est stockée dans un fichier, vous pouvez utiliser la variable d'environnement LKR_MASTER_KEY_FILE pour pointer vers le chemin d'accès du fichier CMK:

    export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
    

    Si vous souhaitez fournir la clé CMK de l'emplacement de restauration directement dans une variable d'environnement'environnement, vous pouvez utiliser la variable d'environnement LKR_MASTER_KEY_ENV:

    export LKR_MASTER_KEY_ENV=<CMK_value>
    
  3. Mettez à jour la base de données interne:

    ./looker restore_dr_backup <path_to_CMK_file>
    

    <path_to_CMK_file> est le chemin d'accès et le nom du fichier de clé en texte brut créé lors de la sauvegarde indépendante du keystore. Le fichier de clé a le format suivant:

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

    où la valeur de dbmk est une clé de chiffrement 256 bits encodée en Base64 et backup_uid est un nom unique utilisé lors de l'enregistrement de la clé dans la base de données.

Après avoir mis à jour la base de données interne de Looker, vous pouvez démarrer Looker normalement. Une fois que Looker est en cours d'exécution, nous vous recommandons de supprimer le fichier de clé en texte brut utilisé pour créer la sauvegarde indépendante du keystore.