diff --git a/templates/landscape/index.html b/templates/landscape/index.html index 1ad5dffb494..c6a2bc86aa8 100644 --- a/templates/landscape/index.html +++ b/templates/landscape/index.html @@ -66,11 +66,10 @@

Save time and improve security at scale

attrs={"class": "p-heading-icon__img p-heading-icon__img--small"} ) | safe }} -

Webinars

+

Datasheet

-

Adopting Linux in - a Windows-centric enterprise ›

+

Overview of Landscape 24.04 LTSAdopting Linux in a Windows-centric enterprise ›

diff --git a/templates/landscape/install.html b/templates/landscape/install.html index 9aa08dc791e..c7e56fd0964 100644 --- a/templates/landscape/install.html +++ b/templates/landscape/install.html @@ -1,270 +1,309 @@ {% extends "landscape/base_landscape.html" %} {% block title %}Install Landscape{% endblock %} -{% block meta_description %}How to set up a self hosted Landscape server{% endblock meta_description %} -{% block meta_copydoc %}https://docs.google.com/document/d/1tU1z9PUm_kSwGJEsopJibE4gI8Gfv_3Dw_qN2_io_ao/edit#{% endblock meta_copydoc %} + +{% block meta_description %} + How to set up a self hosted Landscape server +{% endblock meta_description %} + +{% block meta_copydoc %} + https://docs.google.com/document/d/1tU1z9PUm_kSwGJEsopJibE4gI8Gfv_3Dw_qN2_io_ao/edit# +{% endblock meta_copydoc %} {% block content %} -
-
-
-

Set up a self-hosted Landscape Server
on Ubuntu

+
+
+
+

+ Set up a self-hosted Landscape Server +
+ on Ubuntu +

+
-
-
+ -
-
-
-
-

Minimum requirements for landscape server

-
-
-
    -
  • Ubuntu 20.04 LTS (Focal Fossa) or Ubuntu 22.04 LTS (Jammy Jellyfish)
    • -
    -
  • For hardware: a dual core 2 Ghz processor, 4 GB of RAM, and 20 GB of disk space
    • -
    -
  • For networking: an IP address and FQDN, with TCP communication allowed for SSH (typically port 22), HTTP (port 80), HTTPS (port 443), and gRPC (6554)
    • -
    -
  • DNS administration access for the domain you will use to access Landscape is necessary, if you wish to use LetsEncrypt to obtain an SSL certificate.
    • -
-
-
-
-
-
-

2 ways to install landscape server

+
+
+
+
+

Minimum requirements for landscape server

+
+
+
    +
  • Ubuntu 22.04 LTS (Jammy Jellyfish) or Ubuntu 24.04 LTS (Noble Numbat)
    • +
  • For hardware: a dual core 2 Ghz processor, 4 GB of RAM, and 20 GB of disk space
    • +
  • + For networking: an IP address and FQDN, with TCP communication allowed for SSH (typically port 22), HTTP (port 80), HTTPS (port 443), and gRPC (6554) +
    • +
  • + DNS administration access for the domain you will use to access Landscape is necessary, if you wish to use LetsEncrypt to obtain an SSL certificate. +
    • +
+
-
-
-
-
-

Quickstart install

-
-
-
-
-

Install 15 mins

-
-
-

Config 30 mins

+
+
+
+

2 ways to install landscape server

+
+
+
+
+
+

Quickstart install

+
+
+
+
+

Install 15 mins

+
+
+

Config 30 mins

+
-
-
-
-
-
-

Manual install

-
-
-
-
-

Install 30 mins

-
-
-

Config time varies

+
+
+
+
+

Manual install

+
+
+
+
+

Install 30 mins

+
+
+

Config time varies

+
-
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - -
Installation typeInstall timeConfig time
Juju (Recommended)15 minutes15 minutes
Quickstart15 minutes30 minutes
Manual30 minutes30 hours
+
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + +
Installation typeInstall timeConfig time
Juju (Recommended)15 minutes15 minutes
Quickstart15 minutes30 minutes
Manual30 minutes + 30 hours +
+
-
-
+
- + .install-time { + background-color: #000000; + color: white; + width: calc(var(--install-time) / var(--max-chart-time) * 100%); + display: inline-block; + padding: 0 0.5rem; + } -
-
-
-
-

Install Landscape Server to manage machines and containers

-
-
-
-
-
- -
-
- + .config-time { + background: #E5E5E5; + width: calc(var(--config-time) / var(--max-chart-time) * 100%); + display: inline-block; + padding: 0 0.5rem; + text-align: right; + color: #000000; + } + + +
+
+
+
+

Install Landscape Server to manage machines and containers

+
+
+
+
+
+ +
+
+ +
-
-
+
-
-
-
-

-
-
-
-

Install

-
-
-
    -
  1. -

    Install prerequisites

    -
    - 
    sudo apt update && sudo apt install -y ca-certificates software-properties-common
    -
    -
    2. -
  2. -

    Set your hostname using variables

    -

    Set landscape.example.com with the FQDN pointing to your server.

    -
    - 
    sudo hostnamectl set-hostname "$FQDN"
    -
    -
    3. -
  3. -

    Add the Landscape PPA

    -
    - 
    sudo add-apt-repository -y ppa:landscape/self-hosted-23.03
    -
    -
    4. -
  4. -

    Install Landscape

    -
    - 
    sudo apt update && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y landscape-server-quickstart
    -
    -
    5. -
-
- -
-
-
-

-
-
-
+
+
+
+

+
+
-

Configure SSL

+

Install

+
+
+
    +
  1. +

    Install prerequisites

    +
    + 
    sudo apt update && sudo apt install -y ca-certificates software-properties-common
    +
    +
    2. +
  2. +

    Set your hostname using variables

    +

    + Set landscape.example.com with the FQDN pointing to your server. +

    +
    + 
    sudo hostnamectl set-hostname "$FQDN"
    +
    +
    3. +
  3. +

    Add the Landscape PPA

    +
    + 
    sudo add-apt-repository -y ppa:landscape/self-hosted-24.04
    +
    +
    4. +
  4. +

    Install Landscape

    +
    + 
    sudo apt update && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y landscape-server-quickstart
    +
    +
    5. +
-

If you have the fullchain.pem and privkey.pem files for your SSL certificate, skip these steps and configure Apache manually.

-
-
-
    -
  1. -

    Install certbot

    -
    - 
    sudo snap install certbot --classic
    -
    -
    2. -
  2. -

    Set your email address in a variable

    -
    - 
    EMAIL="YOUR-EMAIL@ADDRESS.COM"
    -
    -
    3. -
  3. -

    Get and install your certificate

    -
    - 
    sudo certbot --apache --non-interactive --no-redirect --agree-tos --email $EMAIL --domains $(hostname --long)
    -
    -
    4. -
+
-
-
-
-

-
-
-
+
+
+

+
+
-

Configure postfix for email

+
+

Configure SSL

+
+

+ If you have the fullchain.pem and privkey.pem files for your SSL certificate, skip these steps and configure Apache manually. +

-

Detailed information is available for Postfix in the Ubuntu Server documentation.

-
-
-
    -
  1. -

    Set SMTP information in variables

    -

    The value of SMTP_PASSWORD should be the SendGrid API Key

    -
    - 
    SMTP_HOST='smtp.sendgrid.net'
+              
    
+                
      
+                  
    1. 
+                    
      Install certbot
      
+                    
      
+                      
      sudo snap install certbot --classic
      
+                    
      
+                  
      2. 
+                  
    2. 
+                    
      Set your email address in a variable
      
+                    
      
+                      
      EMAIL="YOUR-EMAIL@ADDRESS.COM"
      
+                    
      
+                  
      3. 
+                  
    3. 
+                    
      Get and install your certificate
      
+                    
      
+                      
      sudo certbot --apache --non-interactive --no-redirect --agree-tos --email $EMAIL --domains $(hostname --long)
      
+                    
      
+                  
      4. 
+                
    
+              
    
+
    +
    +
    +

    +
    +
    +
    +
    +

    Configure postfix for email

    +
    +

    + Detailed information is available for Postfix in the Ubuntu Server documentation. +

    +
    +
    +
      +
    1. +

      Set SMTP information in variables

      +

      + The value of SMTP_PASSWORD should be the SendGrid API Key +

      +
      + 
      SMTP_HOST='smtp.sendgrid.net'
 SMTP_PORT='587'
 SMTP_USERNAME='apikey'
 SMTP_PASSWORD='YOUR_API_KEY_GOES_HERE'
      -
      -
      2. -
    2. -

      Install postfix

      -
      - 
      sudo DEBIAN_FRONTEND=noninteractive apt-get install -y postfix
      -
      -
      3. -
    3. -

      Configure postfix

      -
      - 
      sudo postconf -e myhostname="$(hostname --long)"
+
      +
      4. +
    4. +

      Install postfix

      +
      + 
      sudo DEBIAN_FRONTEND=noninteractive apt-get install -y postfix
      +
      +
      5. +
    5. +

      Configure postfix

      +
      + 
      sudo postconf -e myhostname="$(hostname --long)"
 sudo postconf -e mydomain="$(hostname --domain)"
 sudo postconf -e myorigin="$(hostname --domain)"
 sudo postconf -e masquerade_domains="$(hostname --domain)"
@@ -280,311 +319,380 @@ 
      Configure postfix for email
      
 sudo postconf -e smtp_use_tls=yes
 sudo postconf -e smtp_tls_security_level=encrypt
 sudo postconf -e smtp_sasl_tls_security_options=noanonymous
      -
      -
      6. -
    6. -

      Write sasl_passwd

      -
      - 
      sudo sh -c "echo \"[$SMTP_HOST]:$SMTP_PORT $SMTP_USERNAME:$SMTP_PASSWORD\" > /etc/postfix/sasl_passwd"
      -
      -
      7. -
    7. -

      Generate sasl_passwd.db

      -
      - 
      sudo postmap /etc/postfix/sasl_passwd
      -
      -
      8. -
    8. -

      Secure sasl_passwd.db

      -
      - 
      sudo chmod 600 /etc/postfix/sasl_passwd.db
      -
      -
      9. -
    9. -

      Remove sasl_passwd

      -
      - 
      sudo rm /etc/postfix/sasl_passwd
      -
      -
      10. -
    10. -

      Restart postfix

      -
      - 
      sudo /etc/init.d/postfix restart
      -
      -
      11. -
    +
    +
    2. +
  2. +

    Write sasl_passwd

    +
    + 
    sudo sh -c "echo \"[$SMTP_HOST]:$SMTP_PORT $SMTP_USERNAME:$SMTP_PASSWORD\" > /etc/postfix/sasl_passwd"
    +
    +
    3. +
  3. +

    Generate sasl_passwd.db

    +
    + 
    sudo postmap /etc/postfix/sasl_passwd
    +
    +
    4. +
  4. +

    Secure sasl_passwd.db

    +
    + 
    sudo chmod 600 /etc/postfix/sasl_passwd.db
    +
    +
    5. +
  5. +

    Remove sasl_passwd

    +
    + 
    sudo rm /etc/postfix/sasl_passwd
    +
    +
    6. +
  6. +

    Restart postfix

    +
    + 
    sudo /etc/init.d/postfix restart
    +
    +
    7. +
+
-
-
-
-
-

-
-
-

Set aside some time

-

Read the Manual Installation documentation

-
-
-
-

-
-
-

Install Landscape

-

Follow the Manual Installation documentation

+
+
+
+

+
+
+

Set aside some time

+

+ Read the Manual Installation documentation +

+
+
+
+

+
+
+

Install Landscape

+

+ Follow the Manual Installation documentation +

+
-
-
-
+
+
-
-
-
-
-
-

4 ways to install landscape client

-
-
-
-

Install Landscape Client
to manage machines and containers

+
+
+
+
+
+

4 ways to install landscape client

-

Landscape Client can be installed from Ubuntu's main repository. The latest version can be obtained from the Landscape 23.03 PPA. The latest features, including awareness of Ubuntu Pro, is only available in Landscape Client hosted in the 23.03 PPA for Ubuntu versions 18.04 (Bionic Beaver), 20.04 (Focal Fossa), and 22.04 (Jammy Jellyfish). The latest features are available in the main repository for 23.04 (Lunar Lobster).

-
-
-
-
-
-
- -
-
- -
-
- -
-
- +
+
+

+ Install Landscape Client +
+ to manage machines and containers +

+
+

+ Landscape Client can be installed from Ubuntu's main repository. The latest version can be obtained from the Landscape 24.04 PPA. The latest features, including awareness of Ubuntu Pro, is only available in Landscape Client hosted in the 24.04 PPA for Ubuntu versions 18.04 (Bionic Beaver), 20.04 (Focal Fossa), and 22.04 (Jammy Jellyfish). The latest features are available in the main repository for 24.04 (Noble Numbat). +

+
+
+
+
+
+
+ +
+
+ +
+
+ +
+
+ +
-
-
+
-
-
-
-

The main repository and PPA installation methods are suitable when performing the installation through a terminal or shell scripting. Cloud Init is suitable if it is available during a machine's provisioning stage, and the subordinate charm is most appropriate when using charmed operators.

-
-
-
-
-
-

-
-
-
-

Install

-
-
-
    -
  1. -

    Install the package

    -
    - 
    sudo apt update && sudo apt install -y landscape-client
    -
    -
    2. -
+
+
+
+

+ The main repository and PPA installation methods are suitable when performing the installation through a terminal or shell scripting. Cloud Init is suitable if it is available during a machine's provisioning stage, and the subordinate charm is most appropriate when using charmed operators. +

-
-
-

-
-
-
-

Configure

-
-
-
    -
  1. -

    Define parameters in variables

    -

    Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.

    -
    - 
    LANDSCAPE_ACCOUNT_NAME='standalone'
+          
    
+            
    
+            
    
+              
    
+            
    
+            
    
+              
    
+                
    Install
    
+              
    
+              
    
+                
      
+                  
    1. 
+                    
      Install the package
      
+                    
      
+                      
      sudo apt update && sudo apt install -y landscape-client
      
+                    
      
+                  
      2. 
+                
    
+              
    
+            
    
+            
    
+            
    
+              
    
+            
    
+            
    
+              
    
+                
    Configure
    
+              
    
+              
    
+                
      
+                  
    1. 
+                    
      Define parameters in variables
      
+                    
      
+                      Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.
+                    
      
+                    
      
+                      
      LANDSCAPE_ACCOUNT_NAME='standalone'
 LANDSCAPE_FQDN='landscape.example.com'
 LANDSCAPE_COMPUTER_TITLE='My Computer'
      
-                  
      
-                
      2. 
-                
    2. 
-                  
      Configure
      
-                  
      
-                    
      sudo landscape-config --silent --account-name="${LANDSCAPE_ACCOUNT_NAME}" --computer-title="${LANDSCAPE_COMPUTER_TITLE}" --tags="" --script-users='nobody,landscape,root'
      
-                  
      
-                
      3. 
-              
    
+                    
    
+
    2. +
  2. +

    Configure

    +
    + 
    sudo landscape-config --silent --account-name="${LANDSCAPE_ACCOUNT_NAME}" --computer-title="${LANDSCAPE_COMPUTER_TITLE}" --tags="" --script-users='nobody,landscape,root'
    +
    +
    3. +
+
-
-
-
-
-

-
-
-
-

Install

-
-
-
    -
  1. -

    Install prerequisites

    -
    - 
    sudo apt update && sudo apt install -y software-properties-common
    -
    -
    2. -
  2. -

    Add the PPA

    -
    - 
    sudo add-apt-repository -y ppa:landscape/self-hosted-23.03
    -
    -
    3. -
  3. -

    Install

    -
    - 
    sudo apt update && sudo apt install -y landscape-client
    -
    -
    4. -
+
+
+
+

-
-
-
-

-
-
-
-

Configure

-
-
-
    -
  1. -

    Define parameters in variables

    -

    Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.

    -
    - 
    LANDSCAPE_ACCOUNT_NAME='standalone'
+            
    
+              
    
+                
    Install
    
+              
    
+              
    
+                
      
+                  
    1. 
+                    
      Install prerequisites
      
+                    
      
+                      
      sudo apt update && sudo apt install -y software-properties-common
      
+                    
      
+                  
      2. 
+                  
    2. 
+                    
      Add the PPA
      
+                    
      
+                      
      sudo add-apt-repository -y ppa:landscape/self-hosted-24.04
      
+                    
      
+                  
      3. 
+                  
    3. 
+                    
      Install
      
+                    
      
+                      
      sudo apt update && sudo apt install -y landscape-client
      
+                    
      
+                  
      4. 
+                
    
+              
    
+            
    
+            
    
+            
    
+              
    
+            
    
+            
    
+              
    
+                
    Configure
    
+              
    
+              
    
+                
      
+                  
    1. 
+                    
      Define parameters in variables
      
+                    
      
+                      Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.
+                    
      
+                    
      
+                      
      LANDSCAPE_ACCOUNT_NAME='standalone'
 LANDSCAPE_FQDN='landscape.example.com'
 LANDSCAPE_COMPUTER_TITLE='My Computer'
      
-                  
      
-                
      2. 
-                
    2. 
-                  
      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"
      
-                  
      
-                
      3. 
-              
    
+                    
    
+
    2. +
  2. +

    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"
    +
    +
    3. +
+
-
-
-
-
-

-
-
-
-

Install

-
-
-
    -
  1. -

    Define parameters in variables

    -

    Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.

    -
    - 
    LANDSCAPE_ACCOUNT_NAME='standalone'
+        
    
+          
    
+            
    
+              
    
+            
    
+            
    
+              
    
+                
    Install
    
+              
    
+              
    
+                
      
+                  
    1. 
+                    
      Define parameters in variables
      
+                    
      
+                      Self-hosted Landscape users should set LANDSCAPE_ACCOUNT_NAME as standalone, Landscape SaaS customers should specify their account name and set LANDSCAPE_FQDN as landscape.canonical.com.
+                    
      
+                    
      
+                      
      LANDSCAPE_ACCOUNT_NAME='standalone'
 LANDSCAPE_FQDN='landscape.example.com'
      
-                  
      
-                
      2. 
-                
    2. 
-                  
      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"
      
-                  
      
-                
      3. 
-              
    
+                    
    
+
    2. +
  2. +

    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"
    +
    +
    3. +
+
-
-
-
-

-
-
-
-

Configure

-
-
-
    -
  1. -

    Relate the charm

    -
    - 
    juju relate landscape-client <charm-name>
    -
    -
    2. -
+
+
+

+
+
+
+

Configure

+
+
+
    +
  1. +

    Relate the charm

    +
    + 
    juju relate landscape-client <charm-name>
    +
    +
    2. +
+
-
- -
-
-
-

-
-
-

To install landscape-client from a PPA

-
- 
apt:
+
+        

+          

+            

+              

+            

+            

+              
To install landscape-client from a PPA

+              

+                
apt:
   sources:
     trunk-testing-ppa:
-      source: ppa:landscape/self-hosted-23.03
+      source: ppa:landscape/self-hosted-24.04
             

+              

             

-          

-          

-          

-            

-          

-          

-            
Configure landscape-client

-            
To discover additional supported client keys visit the cloud-init Landscape module documentation.

-            
Self-hosted Landscape users should set account_name as `standalone` and define the url and ping_url keys. Landscape SaaS customers should specify their account name, and the url and ping_url keys can be omitted.

-            

-              
landscape:
+            

+            

+              

+            

+            

+              
Configure landscape-client

+              

+                To discover additional supported client keys visit the cloud-init Landscape module documentation.
+              

+              

+                Self-hosted Landscape users should set account_name as `standalone` and define the url and ping_url keys. Landscape SaaS customers should specify their account name, and the url and ping_url keys can be omitted.
+              

+              

+                
landscape:
   client:
     account_name: standalone
     computer_title: "My Computer"
     url: "https://landscape.example.com/message-system"
     ping_url: "http://landscape.example.com/ping"
             

+              

             

           

         

       

-
-
-
+
+
- + {% endblock content %}