Upgrade DaneOS

Overview

This procedure is intended for upgrading any supported version of the Dane Operation System. Before beginning, ensure you create a backup and export it from the cluster as a precaution for potential rollback needs. Once the upgrade is finished without issues, generate a new backup, as backups created on one version cannot be used to restore on another.

Prerequisites

Downloads

• Download the DaneOS installation package. The downloaded files are in .tgz format <FILENAME>.tgz. The run file name includes the release, version, build number, and type of installation.
• Verify the integrity of the DaneOS installation package by entering the following commands and comparing the output with the checksum information.

[<ADMIN> ~]$ sha256sum DaneOS-xxxx-final.run.tgz

Required Steps Before Starting

• Make sure you have at least 25 GB free on the primary data node in the /var/tmp directory.

Upgrade Procedure

Read and understand Prerequisites before you start.

• Log in to the primary node using SSH as user dane-admin or another user with sudo or root privileges.
• Check your current version by running the following command:

[<ADMIN> ~]$ cat /etc/daneos-release

• Check that your cluster status is healthy.

  • Run the following command on the primary node:

  [<ADMIN> ~]$ systemctl status k3s

  Example Output:

  [sudo] password for dane-admin:
  ● k3s.service - Lightweight Kubernetes
       Loaded: loaded (/etc/systemd/system/k3s.service; enabled; preset: disabled)
       Active: active (running) since Sun 2023-02-16 23:20:00 CEST; 49min ago
         Docs: https://k3s.io
      Process: 30399 ExecStartPre=/sbin/modprobe br_netfilter (code=exited, status=0/SUCCESS)
      Process: 30400 ExecStartPre=/sbin/modprobe overlay (code=exited, status=0/SUCCESS)
     Main PID: 30401 (k3s-server)
        Tasks: 231
       Memory: 2.1G

  In the output under the line k3s.service - DaneOS Kubernetes, check that two lines appear - Loaded... and Active... similar to the example above. If they appear, continue with the next step, otherwise contact Dane Support for assistance.

  • Make sure all users are logged out from the browser.
  • Run the following commands to Upgrade DaneOS :

  [<ADMIN> ~]$ cd /var/tmp
  [<ADMIN> ~]$ tar -zvxf DaneOS-xxxx-final.run.tgz
  [<ADMIN> ~]$ chmod +x DaneOS-xxxx-final.run
  [<ADMIN> ~]$ sudo sh DaneOS-xxxx-final.run
  • Verify
    • Check again the DaneOS version. Make sure that the version displayed is the one to which you intended to update.

    [<ADMIN> ~]$ cat /etc/daneos-release
    • Check again the cluster status

    [<ADMIN> ~]$ systemctl status k3s

warning

• Make sure users clear their browser cache.