Haruno Knowledge base

Client version

See which Windows app version customers get, and switch it.

  • Operator consoleAvailable

When a new Windows app version is released, nobody gets it until it is chosen here. Client version shows which version this environment serves and lets a super admin switch it.

This environment serves 1.3.62. A newer version, 1.3.63, is published but not chosen yet.
The Client version page: the version being served now, a note that a newer version is published, buttons to use the published or beta version, a version box and Save changes

This page is for the Windows app only. The Mac app updates from its own feed and is not controlled here.

What you see

Serving now is the version customers on this environment are offered. Under it the page says who chose it and when. Then one of these may appear:

NoteWhat it means
The published version is X. Clients here stay on Y until you choose itA newer version is released and nobody has switched to it yet
Clients here are on Y, ahead of the published XThis environment is deliberately ahead, for example on a beta. Nothing is waiting
Nobody has chosen a version here yetThe environment adopted the published version it was already serving
Nothing is published under Y any moreA red warning. The version was chosen, but its release is gone. Customers get an error instead of an update, and a new installation cannot finish. Choose a version that is still published
This server can't check right now whether Y is still publishedThe release list could not be read. It does not mean the release is gone
No version is chosenCustomers do not update at all. This does not last: as soon as the server can read the published version, it adopts it

Switch the version

  1. Press Use published X to take the released version, or Use beta candidate X to take the version being tested. Or type a Version yourself, three numbers like 1.3.62.
  2. Press Save changes. Discard drops what you typed.

A version is only accepted if a release was published under it. Customers get the change within about a minute.

If someone else saved while you were editing, the page says so and shows the current choice. Make your change again.

Customers only move up

Choosing an older version does not roll a customer back. A customer who already has the newer version simply stops getting updates until this environment serves a newer one. A computer that cannot reach the service does not update either.

Anyone who installs Haruno fresh gets the chosen version too.

How this fits a release

When a release is promoted to stable, the release process switches the live environment for you, using the release publisher account. Other environments, such as a test one, are switched here by a super admin. People on the Beta channel in the Windows app's Settings ▸ Updates read a separate beta feed and are not affected by this page.

Who can use it

Every operator can read the page. Switching the version is for super admins and for the release publisher account. A viewer sees "Only super administrators can change the client version."

What a person in support or sales can ask an operator

  • "Which Windows version are customers getting right now?" Read Serving now.
  • "A customer is on an old version and not updating." Check that a newer version is chosen here, and remember that a computer that cannot reach the service does not update.
  • "Has the new release reached everyone?" Look for the published version is X note. If it shows, it is released but not yet chosen.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,57 @@
+---
+title: Client version
+summary: See which Windows app version customers get, and switch it.
+feature: ops-client-version
+covers:
+  - web/monitoring/components/ClientVersionPage.tsx
+  - server-dotnet/src/Haruno.Server/Controllers/AdminClientVersionController.cs
+  - docs/RELEASING.md
+---
+
+When a new Windows app version is released, nobody gets it until it is chosen here. **Client version** shows which version this environment serves and lets a super admin switch it.
+
+<Shot src="/m/ac527cd34afd-ops-client-version-dark.png" alt="The Client version page: the version being served now, a note that a newer version is published, buttons to use the published or beta version, a version box and Save changes" caption="This environment serves 1.3.62. A newer version, 1.3.63, is published but not chosen yet." />
+
+This page is for the Windows app only. The Mac app updates from its own feed and is not controlled here.
+
+## What you see
+
+**Serving now** is the version customers on this environment are offered. Under it the page says who chose it and when. Then one of these may appear:
+
+| Note | What it means |
+|---|---|
+| The published version is X. Clients here stay on Y until you choose it | A newer version is released and nobody has switched to it yet |
+| Clients here are on Y, ahead of the published X | This environment is deliberately ahead, for example on a beta. Nothing is waiting |
+| Nobody has chosen a version here yet | The environment adopted the published version it was already serving |
+| Nothing is published under Y any more | A red warning. The version was chosen, but its release is gone. Customers get an error instead of an update, and a new installation cannot finish. Choose a version that is still published |
+| This server can't check right now whether Y is still published | The release list could not be read. It does not mean the release is gone |
+| No version is chosen | Customers do not update at all. This does not last: as soon as the server can read the published version, it adopts it |
+
+## Switch the version
+
+1. Press **Use published X** to take the released version, or **Use beta candidate X** to take the version being tested. Or type a **Version** yourself, three numbers like `1.3.62`.
+2. Press **Save changes**. **Discard** drops what you typed.
+
+A version is only accepted if a release was published under it. Customers get the change within about a minute.
+
+If someone else saved while you were editing, the page says so and shows the current choice. Make your change again.
+
+<Callout variant="warning" title="Customers only move up">
+Choosing an older version does not roll a customer back. A customer who already has the newer version simply stops getting updates until this environment serves a newer one. A computer that cannot reach the service does not update either.
+</Callout>
+
+Anyone who installs Haruno fresh gets the chosen version too.
+
+## How this fits a release
+
+When a release is promoted to stable, the release process switches the live environment for you, using the release publisher account. Other environments, such as a test one, are switched here by a super admin. People on the **Beta** channel in the Windows app's <Ui>Settings ▸ Updates</Ui> read a separate beta feed and are not affected by this page.
+
+## Who can use it
+
+Every operator can read the page. Switching the version is for super admins and for the release publisher account. A viewer sees "Only super administrators can change the client version."
+
+## What a person in support or sales can ask an operator
+
+- "Which Windows version are customers getting right now?" Read **Serving now**.
+- "A customer is on an old version and not updating." Check that a newer version is chosen here, and remember that a computer that cannot reach the service does not update.
+- "Has the new release reached everyone?" Look for the **published version is X** note. If it shows, it is released but not yet chosen.