canonical-livepatch-server

Canonical Publisher Verified account Verified account

Install latest/stable of canonical-livepatch-server

Ubuntu 16.04 or later?

Make sure snap support is enabled in your Desktop store.


Install using the command line

sudo snap install canonical-livepatch-server

Don't have snapd? Get set up for snaps.

Channel Version Published

Canonical Livepatch Server

Canonical Livepatch Server enables the delivery of Livepatch's to Livepatch clients, allowing reboots of critical infrastructure to be scheduled at a convenient time.

Requirements:

  • PostgreSQL 12

Quick Start:

  • Install the snap

    sudo snap install canonical-livepatch-server
    
  • Now we require a Postgres database, for simplicity let's launch Postgres via docker:

    docker run \
    --name postgresql \
    -e POSTGRES_USER=livepatch \
    -e POSTGRES_PASSWORD=testing \
    -p 5432:5432 \
    -d postgres:12.11
    
  • Migrate the database, run:

    canonical-livepatch-server.schema-tool \
    postgresql://livepatch:testing@localhost:5432/livepatch
    
  • Update Livepatch with the DSN of our local Postgres, run:

    sudo snap \
    set canonical-livepatch-server \
    lp.database.connection-string=postgresql://livepatch:testing@localhost:5432/livepatch
    
  • We can check the server is running via the logs:

    sudo snap logs \
    canonical-livepatch-server.livepatch -n 100
    

If you're a customer of Ubuntu Pro and have access to Livepatch on-premise, you can enable on-premise within the snap the same as you would for the charm.

You can obtain your token from: https://ubuntu.com/pro/dashboard

Here is a quick how-to:

  • Set your token via running:

    sudo snap set canonical-livepatch-server token=<Ubuntu Pro token>
    
  • Install the server admin tool:

    sudo snap install canonical-livepatch-server-admin
    
  • Set an environment variable for the admin tool to discover your snap server:

    export LIVEPATCH_URL=http://localhost:8080
    
  • Set a basic user on the server, for example sake here is one with the username admin and password admin123, note, dollar signs must be escaped and the password but be bcrypt hashed:

    sudo snap set canonical-livepatch-server \
    lp.auth.basic.users=\
    admin:\$2y\$10\$c25NVkdeIMqWdbgR4883YuE/s2CT1mCmGPm5Ma1XbUqGqM26ClTGe
    

If you'd like to generate your own,

  sudo apt-get install apache2-utils
  htpasswd -bnBC 10 <username> <password>
  • Enable basic authentication:

    sudo snap set canonical-livepatch-server lp.auth.basic.enabled=true
    
  • Login with your admin tool:

    canonical-livepatch-server-admin.livepatch-admin login -a admin:admin123
    
  • Synchronise hosted patches into your snap server:

    canonical-livepatch-server-admin.livepatch-admin sync trigger 
    

You are now ready to connect clients to your snap Livepatch instance! Currently the server is set (by default) to use file storage for the patches, you can actually see the patches here:

  ls /var/snap/canonical-livepatch-server/common/patches/

Details for canonical-livepatch-server

License
  • Proprietary

Last updated
  • 2 June 2023 - latest/stable
  • 22 February 2024 - latest/edge

Websites

Contact

Share this snap

Generate an embeddable card to be shared on external websites.


Install canonical-livepatch-server on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the installing snapd documentation.


Where people are using canonical-livepatch-server

Users by distribution (log)

Ubuntu 22.04
Ubuntu 24.04
Ubuntu 23.10
Ubuntu 20.04
Ubuntu 18.04
Ubuntu 23.04

Is there a problem with canonical-livepatch-server? Report this app