{"result":{"depiction_url":null,"edges":{"relation":{"objects":[{"created":"2026-10-07T11:13:17Z","object_id":{"id":3063,"is_a":["text","documentation","adminguide"],"name":"admin_deploy_release","title":{"_type":"trans","tr":{"en":"Deploy and verify a release"}},"uri":"https:\/\/zotonic.com\/id\/3063"},"seq":1},{"created":"2026-10-07T11:13:17Z","object_id":{"id":3076,"is_a":["text","documentation","adminguide"],"name":"admin_rollback","title":{"_type":"trans","tr":{"en":"Prepare and carry out recovery from a failed release"}},"uri":"https:\/\/zotonic.com\/id\/3076"},"seq":2},{"created":"2026-10-07T11:13:17Z","object_id":{"id":3072,"is_a":["text","documentation","adminguide"],"name":"admin_make_backup","title":{"_type":"trans","tr":{"en":"Create and check a site backup"}},"uri":"https:\/\/zotonic.com\/id\/3072"},"seq":3}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-10-07T11:13:17Z","object_id":{"id":2554,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_how_to_guide","title":"How-to guide","uri":"https:\/\/zotonic.com\/id\/2554"},"seq":1},{"created":"2026-10-07T11:13:17Z","object_id":{"id":2566,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_operator","title":"Operator","uri":"https:\/\/zotonic.com\/id\/2566"},"seq":2},{"created":"2026-10-07T11:13:17Z","object_id":{"id":2605,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_site_management","title":"Site management","uri":"https:\/\/zotonic.com\/id\/2605"},"seq":3},{"created":"2026-10-07T11:13:17Z","object_id":{"id":2689,"is_a":["categorization","keyword","keyword_quality"],"name":"zotonic_topic_reliability","title":"Reliability","uri":"https:\/\/zotonic.com\/id\/2689"},"seq":4},{"created":"2026-10-07T11:13:17Z","object_id":{"id":2658,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_migrate","title":"Migrate","uri":"https:\/\/zotonic.com\/id\/2658"},"seq":5}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":3075,"is_a":["text","documentation","adminguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/3075"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"admin_upgrade","page_url":{"en":"https:\/\/zotonic.com\/docs\/3075\/plan-and-apply-an-upgrade","x-default":"https:\/\/zotonic.com\/docs\/3075\/plan-and-apply-an-upgrade"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"<p><strong>Access needed:<\/strong> Deployment and server access.<\/p>\n<ol><li>Read the release and upgrade notes for both Zotonic and changed site modules.<\/li><li>Record the current code revision and configuration. Identify schema migrations and changes to dependencies or external programs.<\/li><li>Build the target revision in acceptance using Erlang\/OTP 28 for this guide&#39;s supported path.<\/li><li>Test startup with a representative data copy, then exercise login, editing, media processing, mail, and important integrations.<\/li><li>Confirm a recoverable pre-upgrade backup and a recovery plan for schema changes.<\/li><li>Schedule and deploy the tested revision using the release procedure.<\/li><li>Check logs and user workflows after deployment, then record the deployed revision.<\/li><\/ol>\n<p>Do not combine unrelated configuration and dependency changes merely because the site is already being updated. A restart that succeeds does not prove background migrations or processing jobs completed. Check those before declaring the upgrade finished.<\/p>"}},"category_id":{"id":2773,"is_a":["meta","category"],"name":"adminguide","title":"Administration guide","uri":"https:\/\/zotonic.com\/id\/adminguide"},"content_group_id":{"id":339,"is_a":["meta","content_group"],"name":"default_content_group","title":{"_type":"trans","tr":{"en":"Default Content Group"}},"uri":"https:\/\/zotonic.com\/id\/default_content_group"},"created":"2026-10-07T11:12:59Z","creator_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"doc_editorial_bundle":true,"doc_editorial_edges":{"relation":[3063,3072,3076],"subject":[2554,2566,2605,2658,2689]},"is_authoritative":true,"is_dependent":false,"is_featured":false,"is_protected":false,"is_published":true,"is_unfindable":false,"language":["en"],"modified":"2026-10-07T11:13:19Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"admin_upgrade","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2026-10-07T11:12:59Z","slug":"plan-and-apply-an-upgrade","summary":{"_type":"trans","tr":{"en":"Test version-specific changes and establish a recovery point."}},"title":{"_type":"trans","tr":{"en":"Plan and apply an upgrade"}},"title_slug":{"_type":"trans","tr":{"en":"plan-and-apply-an-upgrade"}},"tz":"UTC","uri":null,"version":20,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/3075","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/3075"}},"status":"ok"}