There are four possible ways to install Landscape Client. This document describes each method.
Contents:
Install Landscape Client from the main repository
This method is suitable when performing the installation through a terminal or shell scripting. To install Landscape Client from the main repository:
-
Install the
landscape-client
package:sudo apt update && sudo apt install -y landscape-client
-
Set environment variables:
LANDSCAPE_ACCOUNT_NAME='{ACCOUNT_NAME}' LANDSCAPE_FQDN='{FQDN}' LANDSCAPE_COMPUTER_TITLE='{COMPUTER_NAME}'
This code block includes the following values which must be changed:
{ACCOUNT_NAME}
: Self-hosted Landscape users should set this tostandalone
. Landscape SaaS users should specify the account name in their Landscape account.{FQDN}
: Self-hosted Landscape users should set this to the FQDN used during their Landscape Server installation. Landscape SaaS users should set this tolandscape.canonical.com
.{COMPUTER_NAME}
: The name of the computer you’re installing Landscape Client on. You choose this name. -
Configure:
sudo landscape-config --silent --account-name="${LANDSCAPE_ACCOUNT_NAME}" --computer-title="${LANDSCAPE_COMPUTER_TITLE}" --tags="" --script-users='nobody,landscape,root'
Install Landscape Client from the 23.03 PPA
This method is suitable when performing the installation through a terminal or shell scripting. To install Landscape Client from the 23.03 PPA:
-
Install the prerequisites:
sudo apt update && sudo apt install -y software-properties-common
-
Add the PPA:
sudo add-apt-repository -y ppa:landscape/self-hosted-23.03
-
Install the
landscape-client
package:sudo apt update && sudo apt install -y landscape-client
-
Set environment variables:
LANDSCAPE_ACCOUNT_NAME='{ACCOUNT_NAME}' LANDSCAPE_FQDN='{FQDN}' LANDSCAPE_COMPUTER_TITLE='{COMPUTER_NAME}'
This code block includes the following values which must be changed:
{ACCOUNT_NAME}
: Self-hosted Landscape users should set this tostandalone
. Landscape SaaS users should specify the account name in their Landscape account.{FQDN}
: Self-hosted Landscape users should set this to the FQDN used during their Landscape Server installation. Landscape SaaS users should set this tolandscape.canonical.com
.{COMPUTER_NAME}
: The name of the computer you’re installing Landscape Client on. You choose this name. -
Configure:
sudo landscape-config --silent --account-name="${LANDSCAPE_ACCOUNT_NAME}" --computer-title="${LANDSCAPE_COMPUTER_TITLE}" --tags='' --script-users='nobody,landscape,root' --ping-url="http://${LANDSCAPE_FQDN}/ping" --url="https://${LANDSCAPE_FQDN}/message-system"
Install Landscape Client with the subordinate charm
This method is suitable when using charmed operators. To install Landscape Client with the subordinate charm:
-
Set environment variables:
LANDSCAPE_ACCOUNT_NAME='{ACCOUNT_NAME}' LANDSCAPE_FQDN='{FQDN}'
This code block includes the following values which must be changed:
{ACCOUNT_NAME}
: Self-hosted Landscape users should set this tostandalone
. Landscape SaaS users should specify the account name in their Landscape account.{FQDN}
: Self-hosted Landscape users should set this to the FQDN used during their Landscape Server installation. Landscape SaaS users should set this tolandscape.canonical.com
. -
Deploy the charm:
juju deploy landscape-client --config account-name='standalone' --config tags='' --config script-users='nobody,landscape,root' --config ping-url="http://${LANDSCAPE_FQDN}/ping" --config url="https://${LANDSCAPE_FQDN}/message-system"
-
Relate the charm:
juju relate landscape-client <charm-name>
Install Landscape Client with Cloud-init
This method is suitable if it’s available during a machine’s provisioning stage. To install Landscape Client with Cloud-init:
-
Install
landscape-client
from a PPA:apt: sources: trunk-testing-ppa: source: ppa:landscape/self-hosted-23.03
-
Configure
landscape-client
. Landscape SaaS users should omiturl
andping_url
:landscape: client: account_name: {ACCOUNT_NAME} computer_title: "{COMPUTER_NAME}" url: "https://{FQDN}/message-system" ping_url: "http://{FQDN}/ping"
This code block includes the following values which must be changed:
{ACCOUNT_NAME}
: Self-hosted Landscape users should set this tostandalone
. Landscape SaaS users should specify the account name in their Landscape account.{COMPUTER_NAME}
: The name of the computer you’re installing Landscape Client on. You choose this name.{FQDN}
: Self-hosted Landscape users should set this to the FQDN used during their Landscape Server installation. Landscape SaaS users should omiturl
andping_url
.For additional information, see the cloud-init Landscape module documentation.