The best approach is to perform new manual installation and copy over the database and configuration files from your Quickstart install. As a matter of convenience, it is possible to perform a quickstart upgrade in-place. The following guide outlines your 2 options for doing so:
Quickstart Upgrade: Option 1
This method is somewhat basic, but could be complicated depending on how much customization has happened after the landscape-server-quickstart install. It is strongly recommended that you backup the database before performing an upgrade this way.
Setup
2 LXD containers for Landscape
- landscape-app-bionic (bionic) where Landscape 19.10 is running
- landscape-app-focal (focal) where Landscape 23.03 is running
1 LXD container that we are managing in Landscape, for demonstration purposes
- landscape-client (focal) is a machine enrolled in Landscape
Steps
- Install landscape-server-quickstart on landscape-app-bionic according to the quickstart install instructions
- Install landscape-client on landscape-client and register with server
- Stop all Landscape services on landscape-app-bionic with this command:
sudo lsctl stop
- Backup all landscape- database tables using
pg_dump
- Install landscape-server-quickstart on landscape-app-focal from the beta PPA
- Stop all Landscape services on landscape-app-focal with this command:
sudo lsctl stop
- Restore database data using this command:
psql -d <database> -f <file.sql>
- Run the setup command to do db schema migrations, if any:
sudo setup-landscape-server
- Start Landscape services using this command:
sudo lsctl start
- Made minor edits to
/etc/apache2/sites-available
landscape conf to correct the domain name, it should match what domain name you use for the Landscape Server - If you are using a self-signed SSL certificate, copy the new SSL cert to landscape-client. It may be prudent to copy the old SSL certificate from landscape-app-bionic to landscape-app-focal, because the Quickstart creates one based on the machine’s hostname. There is a chance this hostname could be different when you were setting it up landscape-app-focal.
- Restart the landscape-client LXD machine to ensure everything is working
Quickstart Upgrade: Option 2
This method leverages do-release-upgrade
and is not recommended, because configuration files differ from one Ubuntu LTS to the next. For those motivated to go this route, it is possible:
Setup
1 LXD container for Landscape
- landscape-app-bionic (bionic)
Steps
- Install landscape-server-quickstart on landscape-app-bionic according to the quickstart install instructions
- Backup all landscape- database tables using
pg_dump
- Perform a PPA purge with this command:
sudo ppa-purge ppa:landscape/19.10
- The postgres package blocks do-release-upgrade because it is not marked for removal through that process:
sudo apt remove postgresql-10-debversion
- Perform the release upgrade:
sudo do-release-upgrade
- Add the Landscape 23.03 PPA:
sudo add-apt-repository ppa:landscape/self-hosted-23.03
- Perform the Quickstart install
sudo apt install landscape-server-quickstart