How to upgrade to Landscape Server 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