Upgrades

Prerequisites

  • Consider backing up your DBA Dash repository database and ServiceConfig.json file from the installation folder.
  • .NET Framework 6 Runtime (desktop apps). Version 6.0.2 or later

    Download .NET 6 Desktop Runtime

    If the .NET 6 runtime is not installed, you will be prompted to install it when you try to run the application.

    If you have an older version of the .NET framework installed (6.0.0 or 6.0.1), the application will fail to start (no errors). This is due to a breaking change in 6.0.2. If you want to check the version of the .NET runtime you have installed you can run:

    dotnet --list-runtimes

How to upgrade

  1. Open the DBA Dash service configuration tool
  2. Click check for updates
  3. If an upgrade is available click “Upgrade”
  4. A powershell script will run that will perform the upgrade.

Upgrading GUI clients

  1. The GUI will automatically prompt to upgrade on startup if the version is older than the repository database.
  1. Click Help, About to check the version of the client
  2. Click Upgrade to upgrade.

Manual upgrade

There might be situations where you need to perform an upgrade manually. e.g. The server doesn’t have any internet connectivity.

  1. Download the latest release
  2. Stop the DBA Dash service (using the service configuration tool, services.msc or net stop DBADashService)
  3. Close all instances of the GUI or service configuration tool that are running.
  4. Extract the contents of the downloaded zip to replace the existing installation files.

Command line Upgrade 

DBADashConfig -a Update

Or (Supported on old versions of DBA Dash):

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -Uri https://raw.githubusercontent.com/trimble-oss/dba-dash/main/Scripts/UpgradeDBADash.ps1 -OutFile UpgradeDBADash.ps1
./UpgradeDBADash.ps1

For a specific version:

./UpgradeDBADash.ps1 -Tag 2.22.0
← Quick Start
CLI Installation →