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
- Open the DBA Dash service configuration tool
- Click check for updates
- If an upgrade is available click “Upgrade”
- A powershell script will run that will perform the upgrade.
It might take a few minutes to shutdown the DBA Dash service as it waits for collections to complete. Starting the service could also take a few minutes as it upgrades the DBA Dash repository database and starts up the collections
If the application fails to start, please ensure you have .NET Framework 6 Runtime (desktop apps) 6.0.2 or later installed. See Prerequisites
Upgrading GUI clients
- The GUI will automatically prompt to upgrade on startup if the version is older than the repository database.
The client will only be prompted for upgrade if the x.y portion of the x.y.z version is different from the repository database.
- Click Help, About to check the version of the client
- 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.
- Download the latest release
- Stop the DBA Dash service (using the service configuration tool, services.msc or
net stop DBADashService
) - Close all instances of the GUI or service configuration tool that are running.
- Extract the contents of the downloaded zip to replace the existing installation files.
The ServiceConfig.json file is the only file you need to keep. This contains all the settings for the service. If you created PerformanceCountersCustom.xml you should also keep this file.
If the application fails to start, please ensure you have .NET Framework 6 Runtime (desktop apps) 6.0.2 or later installed. See Prerequisites
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