Your submission was sent successfully! Close

You have successfully unsubscribed! Close

Landscape Quickstart deployment

The quickstart mode of deploying Landscape consists of installing all the necessary software on a single machine. This is useful for quickly checking out a new version of Landscape when you don’t have Juju, but should not be used for production deployments because it can’t be scaled.

Advantages:

  • quick installation suitable for demo purposes or a small number of registered computers
  • simple layout: everything on one machine

Disadvantages;

  • single process per application
  • no HA
  • no horizontal scaling
  • not recommended when using more than 500 clients

Contents:

  1. Install Landscape
  2. Create first user
  3. Register clients

Install Landscape


To install Landscape 23.03 using quickstart on Ubuntu 20.04 LTS (“focal”) or 22.04 LTS (“jammy”), follow these simple steps:
sudo add-apt-repository ppa:landscape/self-hosted-23.03
sudo apt-get install landscape-server-quickstart

As an optional step, if you have a valid Landscape license, copy it over to /etc/landscape/license.txt and restart the services. Otherwise, a free license with 10+50 seats (bare metal plus LXC containers) will be applied. Any machine with Ubuntu Pro can be managed by Landscape without requiring a Landscape license.

To add the license.txt file provided by your Canonical Sales Rep to your Landscape Server, upload or copy the file to the appropriate folder:

sudo cp license.txt /etc/landscape/license.txt
sudo lsctl restart

Create first user

The first user that is created in Landscape automatically becomes the administrator of the “standalone” account. To create it, please go to https://<servername> and fill in the requested information.

Register clients

In order to register a computer with Landscape, you need to install the landscape-client package:

sudo apt-get update
sudo apt-get install landscape-client

The quickstart package generates and installs a self-signed SSL certificate in /etc/ssl/certs/landscape_server_ca.crt using the FQDN of the host for the commonName field of the certificate. A copy of this file will be needed on each computer that you register with Landscape.

On each computer, copy that certificate over to a new file, such as /etc/landscape/server.pem, and add this line to the configuration file /etc/landscape/client.conf:

ssl_public_key = /etc/landscape/server.pem

Then proceed with the registration request. Replace <server> with the FQDN of the quickstart host:

sudo landscape-config --account-name standalone --url https://<server>/message-system --ping-url http://<server>/ping

If you get registration errors on the client, the reason why it failed will most likely be in the /var/log/landscape/broker.log log file. If it’s SSL related, double check:

  • ssl_public_key in /etc/landscape/client.conf should be pointing at a copy of the server self-signed certificate
  • <server> in the URL of the landscape-config command-line must match the server hostname as used in the certificate. Check the outputs of hostname -f and hostname on the server
  • check the commonName field of the certificate with openssl x509 -in <certificate-file> -noout -subject

Last updated 15 days ago. Help improve this document in the forum.