Updates

HyperDrop Desktop

The app checks at launch and once a day and offers Install and Relaunch. Turn the check off in Settings, General, Check for updates automatically. Check by hand with Check for Updates… in the menu bar menu.

The command line

Installed from the package repository on Debian, Ubuntu, Fedora or RHEL, the command line updates with the rest of the system (sudo apt upgrade, sudo dnf upgrade). That update can arrive before the server's: a command line one minor version ahead of its server keeps working (the rule). Installed from a download, it does not update itself: install the newer build from the command line page over the old one. On a Mac, the copy inside HyperDrop Desktop updates with the app.

The server

The server never updates itself; an administrator does. The app says when: the Servers pane shows Update Server… with what the update changes, and the menu bar shows Server Update Available….

Linux: Update Server

A Linux server updates over its own API, with no SSH. Open Servers, the server, then Update Server…. It asks for the admin password and a two-factor code every time, since the update runs as root. The box swaps the new server in and puts the old one back if it does not serve; the server is away for seconds.

From a terminal, signed in as an administrator:

hyperdrop server update

On a Mac the command bundled with the app sends the server it carries. The downloaded command line has none: add --binary with the .gz from the server page, its .sig beside it. A version older than the one running is refused.

Synology NAS: Package Center

Update Server refuses on a NAS. With the package source https://gethyperdrop.com/synology/ added, each version appears under Package Center, Installed, HyperDrop, Update. Installed by hand: download the newer package from the Synology page and use Manual Install over the old one. Shares, links and settings are kept.

Until Package Center lists a new version, the app and the command line keep working with a server one minor version older or newer (Version mismatch).

Server Management

Server Management reads its release list at launch. On macOS, Windows and the Linux .zip, a banner shows the notes and Update now, which installs it and relaunches; the terminal form is hyperdrop-server-management update. A .deb or .rpm never replaces itself: once the package repository is added it updates with the rest of the system, and the banner shows the command that installs it now (sudo apt update && sudo apt install --only-upgrade hyperdrop-server-management or sudo dnf upgrade --refresh hyperdrop-server-management). Without the repository, install the next downloaded package over the old one.

Version mismatch

An app and a server work together when the first number of their versions is the same and the second is at most one apart: an app on 1.3 works with servers 1.2, 1.3 and 1.4. No version works with a server older than 1.2, the first public one. The third number never matters. A feature the server is too old for is refused by name, and everything else keeps working. Further apart, the app refuses to share and says which side is behind. Nothing is lost.

• Server older: an administrator updates it as above; a regular user is told to ask the administrator.
• Server newer: update the app with Check for Updates…, or update the command line. Installed from the package repository, it updates with the rest of the system.
• Command line too new for its server (the system updated it before the administrator updated the server): ask the administrator to update the server. To keep working until then, download the older package from the command line page and hold it. On Debian and Ubuntu: sudo apt install --allow-downgrades ./hyperdrop_<version>-<revision>_amd64.deb (ARM64: _arm64.deb), then sudo apt-mark hold hyperdrop. On Fedora: sudo dnf downgrade ./hyperdrop-<version>-<revision>.x86_64.rpm (ARM64: .aarch64.rpm), then sudo dnf versionlock add hyperdrop; on RHEL and Rocky Linux, run sudo dnf install 'dnf-command(versionlock)' first. Release the hold once the server is updated: sudo apt-mark unhold hyperdrop, or sudo dnf versionlock delete hyperdrop.

The app offers an update that still works with its server, one a minor version ahead included, and holds one further ahead; sharing keeps working. A user sees a notice in Settings, General; Update Anyway… installs it, and sharing then pauses until an administrator updates the server. An administrator is offered that update with a reminder to run Update Server right after; sharing pauses in between.