Upgrade Clients Automatically

On this page

With the automatic client upgrade, a setup program for the workstations is stored in the database. When a client connects to a database that is newer than the client and an enabled setup program is stored, it offers to install the update.

The database holds at most one setup program: loading a new one replaces the one stored before. You load it with the Database Management wizard during a database upgrade, or in the Settings App afterwards; in Alloy Navigator Cloud, the Settings App does not allow loading it. Turning the automatic upgrade off hides the stored setup program from the clients without deleting it.

In Alloy Navigator Cloud, the setup program that is distributed is the Administrative Tools package, AlloyAdminTools-<version>.exe, rather than AlloyNavigatorSetup.exe, and the prompts name that product. See Administering Alloy Navigator Cloud.

How the upgrade reaches a workstation

When you sign in, the client compares the version of the database with its own version after it opens the connection. When the database is newer and an enabled setup program is stored, the client offers Apply the Update.

  • If you accept, the client downloads the setup program to a temporary folder, runs it silently, and closes.
  • If you decline, you return to the sign-in form. The client offers the update again at the next sign-in.

The client offers nothing when the database is at the client's version or older.

In the Database Management wizard

Load the setup program during a database upgrade

The wizard shows its Automatic Upgrade page when the database is at version 7.2.0 or later and older than the wizard, on an in-place upgrade or on a production migration of an Alloy Navigator database. For the whole upgrade procedure, see Upgrade a Production Installation.

  1. On the Automatic Upgrade page, click the ellipsis button and select the setup program. The wizard accepts the file only if it is the expected setup program and the first three numbers of its version equal the version the database is upgraded to. Otherwise it reports an invalid distribution file.
  2. Once the file is accepted, the Turn on the Automatic Upgrade check box becomes available and is selected. Its state decides whether the stored setup program is enabled for the clients.

If the wizard already finds a valid setup program at its default location, it skips the page with Turn on the Automatic Upgrade selected. If you choose no file, nothing is stored. The wizard stores the setup program after the upgrade itself has run.

In the Settings App

Manage the stored setup program

After the upgrade, the automatic upgrade is managed on the node General > Upgrade and Migration. The node is gated by an administrative right of its own; see Permissions Reference. There you can:

  • Upload a setup program, or replace the stored one.
  • Download the stored setup program by clicking its file name.
  • Delete the stored setup program.
  • Turn the automatic upgrade on or off. The switch is unavailable while no setup program is stored.

In Alloy Navigator Cloud, the controls for uploading, replacing, and deleting the setup program and the on/off switch are disabled, while the download link and the current status stay available; see Administering Alloy Navigator Cloud.

In the Installer

Upgrade a workstation manually

When the source database is earlier than version 7.2, or is an Alloy Navigator Express database, the client upgrade is a manual run of the setup program on each administrator and technician workstation that has client components:

  1. Run the Alloy Navigator setup program on the workstation.
  2. On the Setup Type page, choose Client. It is the default type. It installs the client components and administrative tools, without services and server tools.

The Client type also installs the report viewer parts, with no choice. When the installation package runs its own installation of Microsoft Report Viewer and Report Viewer is still missing afterwards, the finish page shows "Microsoft Report Viewer for SQL Server 2016 was not installed."

If the workstation still has Alloy Navigator Express of version 8 or an Administrative Tools package of version 8 installed, the setup program lists those products in an error message and stops. An Alloy Navigator Express 6 or 7 client does not stop it.