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.conffile, add an entry forsecret-tokenin 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 useopensslto create a random string. For example,openssl rand -base64 128 | tr -d '\n'. - Update your Apache vhost if it wasn’t already auto-upgraded