Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour savoir comment créer des sauvegardes Looker, consultez la page de documentation Créer des sauvegardes.
Pour restaurer une instance Looker hébergée par le client sur un nouvel hôte, suivez uniquement les étapes suivantes des instructions d'installation de Looker:
Vérifiez que le nouveau serveur respecte les spécifications minimales.
Activez ntpd ou chronyd.
Créez l'utilisateur, le groupe et le répertoire d'accueil du rechercheur.
Ignorez le téléchargement de l'application Looker et toutes les étapes d'installation restantes.
Une fois le nouvel hôte préparé:
Restaurez les fichiers à partir de la sauvegarde.
Démarrez 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 Lookers en cours d'exécution dans le cluster.
Restaurez la base de données.
Démarrez les instances Looker une par une.
Pour savoir comment restaurer des bases de données MySQL, consultez la documentation MySQL.
Après avoir restauré une sauvegarde indépendante du keystore, suivez cette procédure 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:
Arrêter Looker:
cd looker
./looker stop
Si Looker est configuré en cluster, veillez à arrêter chaque nœud 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 le message suivant s'affiche : "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 rapidement. Sinon, vérifiez que tous les nœuds du cluster sont arrêtés."
Assurez-vous que Looker peut accéder à la CMK utilisée pour le keystore local de l'emplacement où vous avez restauré Looker. Si le CMK de l'emplacement de restauration est stocké dans un fichier, vous pouvez utiliser la variable d'environnement LKR_MASTER_KEY_FILE pour indiquer le chemin d'accès du fichier CMK:
export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
Si vous souhaitez fournir le CMK de l'emplacement de restauration directement dans une variable d'environnement, vous pouvez utiliser la variable d'environnement LKR_MASTER_KEY_ENV:
export LKR_MASTER_KEY_ENV=<CMK_value>
Mettez à jour la base de données interne:
./looker restore_dr_backup <path_to_CMK_file>
où <path_to_CMK_file> est le chemin d'accès et le nom de fichier du fichier de clé en texte brut créé lors de la sauvegarde indépendante du keystore. Le fichier de clé a le format suivant:
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.
Une fois la base de données interne de Looker mise à jour, vous pouvez démarrer Looker normalement. Une fois Looker 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/31 (UTC)."],[],[],null,["# Restoring backups\n\n| **Warning:** If your instance is customer-hosted, do not modify LookML files directly on the filesystem of your instance. This can cause unexpected errors in your Git workflow. To make changes to your LookML files, follow the steps at [Using version control and deploying](/looker/docs/version-control-and-deploying-changes).\n\nTo learn about *creating* Looker backups, see the [Creating backups](/looker/docs/creating-backups) documentation page.\n\nTo *restore* a customer-hosted Looker instance to a new host, complete only these steps of the [Looker installation instructions](/looker/docs/installing-looker-application):\n\n- Verify that the new server complies with the minimum server specifications.\n- Enable ntpd or chronyd.\n- Create the **looker** user, group, and home directory.\n- Skip downloading the Looker application and all remaining installation steps.\n\nOnce the new host is prepared:\n\n- Restore the files from backup.\n- Start Looker:\n\n sudo su - looker\n cd looker\n ./looker start\n\nClustered environments\n----------------------\n\nTo restore the MySQL database for a clustered environment:\n\n- Stop any running Lookers in the cluster.\n- Restore the database.\n- Start the Looker instances one at a time.\n\nSee the [MySQL documentation](https://dev.mysql.com/doc/refman/5.0/en/backup-and-recovery.html) for more details on how to restore MySQL databases.\n\nRestoring a keystore-independent backup\n---------------------------------------\n\nCustomer-hosted installations that have [migrated to AES-256 GCM encryption](/looker/docs/migrating-to-aes-256-gcm-encryption) and [generated a keystore-independent backup](/looker/docs/creating-backups#generating_a_keystore-independent_backup) need to update Looker's internal database after performing a restore.\n\nAfter restoring a keystore-independent backup, follow this procedure to decrypt the KEK, re-encrypt it using the new local keystore, and update the key entry in the internal database:\n\n1. Stop Looker:\n\n cd looker\n ./looker stop\n\n If Looker is clustered, make sure to stop every node before proceeding.\n\n If any nodes are still running when you later issue the `restore_dr_backup` command, the command will fail with the message, \"There are other live nodes connected to this backend Looker database. If Looker was shutdown within the last minute, try again shortly, otherwise verify all nodes in the cluster are shut down.\"\n2. Ensure that Looker can access the CMK used for the local keystore of the location where you restored Looker. If the CMK of the restore location is stored in a file, you can use the environment variable `LKR_MASTER_KEY_FILE` to point to the path of the CMK file:\n\n export LKR_MASTER_KEY_FILE=\u003cpath_to_CMK_file\u003e\n\n or, if you want to provide the CMK of the restore location directly in an environment variable, you can use the `LKR_MASTER_KEY_ENV` environment variable: \n\n export LKR_MASTER_KEY_ENV=\u003cCMK_value\u003e\n\n3. Update the internal database:\n\n ./looker restore_dr_backup \u003cpath_to_CMK_file\u003e\n\n where `\u003cpath_to_CMK_file\u003e` is the path and filename of the plain text key file created when the keystore-independent backup was made. The key file has the following format: \n\n {\"dbmk\":\"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\\n\",\"backup_uid\":\"XCXvRa38mNeqT6+HRBCo2Q==\"}\n\n where the value for `dbmk` is a Base64 encoding 256-bit encryption key and `backup_uid` is a unique name used when saving the key to the database.\n\nAfter you have updated Looker's internal database, you can start Looker normally. Once Looker is running, we recommend that you delete the plaintext key file used to create the keystore-independent backup."]]
