How to upgrade to Landscape Server 24.04 LTS

You must be running Ubuntu 24.04 LTS Noble Numbat or 22.04 Jammy Jellyfish to upgrade to Landscape 24.04 LTS.

To upgrade your self-hosted Landscape server to 24.04 LTS, you should first follow the basic upgrade instructions. See how to upgrade Landscape.

After you’ve completed the basic upgrade instructions, you need to add the following to your service.conf file. This is commonly located in /etc/landscape/service.conf.

[broker]
hostagent_virtual_host = landscape-hostagent
hostagent_task_queue = landscape-server-hostagent-task-queue

[grpc]
grpc.max_connection_age_ms = 2592000000 # 30 days

[hostagent-message-consumer]
threads = 1
stores = main account-1

And in your Apache config file (commonly in /etc/apache2/sites-available/landscape.conf), you need to add the following RewriteRule.

RewriteRule ^/(new_dashboard.*) http://localhost:8080/$1 [P,L]

You can see a full Apache config example in our how to configure the web server guide.

To configure Windows Subsystem for Linux (WSL), you should also complete the steps in our how to configure WSL-related services guide.

Manual installations

If you’re upgrading a Landscape Server instance that was manually installed (instead of Quickstart), you also need to complete the following steps. These changes are needed to access the new web portal introduced in Landscape 24.04 LTS.

In your service.conf file, add an entry for secret-token in the [landscape] section and set it as a random string. You can set any string you want, but it should be reasonably long. You can use openssl to create a random string. For example, openssl rand -base64 128 | tr -d '\n'.
Update your Apache vhost if it wasn’t already auto-upgraded

Previous Upgrade Landscape Next Ubuntu Pro: Attach Ubuntu Pro

This page was last modified 2 months ago. Help improve this document in the forum.