[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-31。"],[],[],null,["# Preparing your Looker deployment for updates\n\nLooker releases a new product version every month --- with rare exceptions --- that is full of new features, updates, and changes. Most Looker customers are able to take advantage of these updates as soon as they are available, because [Looker hosts, manages, and updates their Looker deployments](/looker/docs/looker-hosted-installation-steps). However, if you [self-host](/looker/docs/customer-hosted-installation-steps) your Looker deployment or are holding off on updating because of [feature deprecations](/looker/docs/legacy-feature-schedule#migrating_away_from_legacy_features), you can fall behind and miss the latest and greatest Looker has to offer.\n\nWhy should you update your Looker deployment?\n---------------------------------------------\n\nIn addition to the fact that Looker is constantly releasing new functionality to improve user experience, there are important reasons to stay current:\n\n- Looker provides product support coverage for Looker instances on the latest stable version and the two previous versions, as well as the [extended support release (ESR)](/looker/docs/standard-extended-support-release-program-overview). Because a new Looker version is released every month --- with rare exceptions --- going three months without updating puts you outside the stable window. The latest version provides all new features and updates, along with the latest bug fixes.\n- Looker takes [security](https://looker.com/product/security) very seriously and updates the product to address any new web vulnerabilities. While Looker keeps supported releases as safe as possible, you can do your part by staying current with Looker to ensure that your Looker instance has access to the latest security patches.\n\nSteps and considerations when updating\n--------------------------------------\n\nThe following steps can help you prepare your Looker deployment for updates:\n\n1. [Address any concerns about updating](#address_any_concerns_about_updating).\n2. [Review the release notes](#review_the_release_notes).\n3. [Prepare for LookML parameter and feature deprecations](#prepare_for_lookml_parameter_and_feature_deprecations).\n4. [Create a backup of your instance --- and restore to any staging environments](#create_a_backup_of_your_instance_%E2%80%94_and_restore_to_any_staging_environments).\n5. [Update your staging instances and test](#update_your_staging_instances_and_test).\n6. [Update your production environment](#update_your_production_environment).\n\nThese steps may or may not apply to your deployment, depending on whether or not you have staging environments.\n\n### Address any concerns about updating\n\nSometimes you may want to prevent updates for a specific functional reason. This could be a significant change in functionality for which you need more time to train your users, or it could be a feature, tool, or LookML parameter that was deprecated in a new release that is operationally critical for your business, such as an API endpoint that is used by a script or separate application.\n\nIf the reason is a feature or LookML parameter deprecation, be sure to review the release notes and [prepare for the deprecation](#prepare_for_lookml_parameter_and_feature_deprecations).\n\n### Review the release notes\n\nLooker's release notes describe what is new in each release so that you can stay abreast of new features that your users should take advantage of and any breaking changes that may affect rollout of a new version. See the [Looker releases](/looker/docs/looker-releases) page for links to the release notes and changelog for the latest release:\n\n- See the release highlights to read about the most exciting new features, and make sure to review the **Potentially breaking changes** section to identify breaking changes that you may need to prepare for.\n\n- See the changelog for more granular details about feature updates and bug fixes.\n\n### Prepare for LookML parameter and feature deprecations\n\nEnhancements to LookML can include parameter deprecations. Update your LookML to keep everything working in the new version. Check the [legacy feature schedule](/looker/docs/legacy-feature-schedule#legacy_feature_schedule) for deprecated LookML parameters that have been completely removed, in or prior to the version to which you are updating.\n\nTo prepare for feature deprecations, follow the steps suggested in the [Migrating away from legacy features](/looker/docs/legacy-feature-schedule#migrating_away_from_legacy_features) section of the **Legacy features** documentation page.\n\u003e It's best practice to update your LookML to remove ALL deprecated LookML, as those parameters will be removed in a future release.\n\n### Create a backup of your instance --- and restore to any staging environments\n\n[Creating regular backups](/looker/docs/creating-backups) is strongly recommended and should be completed before each update. Additionally, while this is not required, if you are updating several versions it's a good idea to set up a staging server where you can test the updated version before rolling it out to your entire company.\n\nThere are different steps for creating backups depending on whether your Looker deployment is [self-hosted](#creating_backups_for_customer-hosted_looker_deployments) or is [hosted by Looker](#creating_backups_for_looker-hosted_looker_deployments).\n\n#### Creating backups for customer-hosted Looker deployments\n\nIf you host your own Looker instance, you can follow the guide for [creating backups](/looker/docs/creating-backups) and use the guide for [restoring backups](/looker/docs/restoring-backups) to a new staging environment.\n\n#### Creating backups for Looker-hosted Looker deployments\n\nIf your instance is hosted by Looker, reach out to your Looker contact or [Looker Support](http://console.cloud.google.com/support/cases) to have our team create a backup and set up a staging server for you.\n\n### Update your staging instances and test\n\nIf you have a staging instance, you can deploy and test the update prior to updating your production instance. There are different steps for updating your Looker instance depending on whether your Looker deployment is [self-hosted](#updating_a_staging_instance_for_customer-hosted_looker_deployments) or [hosted by Looker](#updating_a_staging_instance_for_looker-hosted_looker_deployments).\n\n#### Updating a staging instance for customer-hosted Looker deployments\n\nIf you host your own Looker instance, download the latest [release JAR](/looker/docs/downloading-looker-jar-files) and follow the instructions on the [Updating a Looker instance](/looker/docs/updating-looker-instance) documentation page to update your staging instance to the latest Looker version. Be sure to check the [Deployment specifications](/looker/docs/installing-looker-application#server_specifications) section on the **Installing the Looker application** documentation page for the latest server requirements --- particularly for the Java version.\n\n#### Updating a staging instance for Looker-hosted Looker deployments\n\nIf your instance is hosted by Looker, reach out to your Looker contact or [Looker Support](http://console.cloud.google.com/support/cases) to have our team update your staging instance for you.\n\nOnce your staging instance is up to date, log in and test the new features and updates. Make sure your important dashboards and Looks run without errors and that there are no (new) LookML errors when you validate your LookML models.\n\n### Update your production environment\n\nIf all tests are successful on your staging instance, you can go ahead and update your production instance to the latest version of Looker, following the same process you used for staging. *Before updating your production instance, be sure you have performed a recent backup in case you need to restore for any reason.*"]]