๐Ÿ”„Platform

Procedure to upgrade your on-premises platform.

Platform and agents can be upgraded separately.

A new platform is compatible with old and new agent versions, ensuring smooth operation both ways.

Each release comes with a minimum required version of the agent to supports the new features.

Download File

Date

Latest available platform version

2024-04-10

2024.04

Download the latest patch of the platform

The file size is approximately 250 MB.

Platform Upgrade

  • Uncompress the downloaded file

tar xvzf patch-datasentinel.tar.gz
  • 3 files are created

    • patch_datasentinel.sh

    • update-datasentinel.tar.gz

    • dump_grafana.sql

  • Run the shell script

The script must be run as Datasentinel owner

Your confirmation is needed.

The script does several actions

  • Stop backend components

  • Backup old version

  • Replace necessary files

  • Update Grafana dashboards

  • Start backend components

The script runs in a few seconds. At the end, Datasentinel should be UP and RUNNING

A log file update_datasentinel_<<VERSION>>.log is created in the current directory

If you have some โ€œDashboard not foundโ€ errors in the UI after upgrading (which should not happen), It means that new dashboards have not been registered correctly.

Follow this procedure to fix it: UI dashboard is encountering loading errors

Output example
----------------------------
Updating Datasentinel
----------------------------
Do you want to continue installing version 2021.02? (Y/[N]) : Y
Logfile created : update_datasentinel_2021.02.log
----------------------------------------
Stopping backend and dispatcher services
----------------------------------------
./patch_datasentinel.sh: line 61:  5754 Killed                  sudo systemctl stop datasentinel_dispatcher > $LOG_FILE 2>&1
----------------------------------------------------------
Uncompressing patch version 2021.02, please wait...
----------------------------------------------------------
----------------------------
Services status
----------------------------
datasentinel_backend.service                                       loaded active running   Datasentinel backend API
datasentinel_dispatcher.service                                    loaded active running   Datasentinel Agentless
datasentinel_grafana.service                                       loaded active running   Datasentinel grafana daemon
datasentinel_influxdb.service                                      loaded active running   InfluxDB service
datasentinel_postgresql.service                                    loaded active running   Datasentinel PostgreSQL instance
nginx.service                                                      loaded active running   nginx - high performance web server
-------------------------------------------
Updating grafana dashboards, please wait...
-------------------------------------------
----------------------------
Datasentinel update finished
----------------------------
{
"status": "OK",
"message": "Datasentinel Backend up and running",
"datasentinel_version": "2023.05",
"services": [
   {
      "name": "nginx",
      "description": "Nginx web server",
      "running": true
   },
   {
      "name": "datasentinel_grafana",
      "description": "Grafana frontend",
      "running": true
   },
   {
      "name": "datasentinel_postgresql",
      "description": "PostgreSQL instance",
      "running": true
   },
   {
      "name": "datasentinel_backend",
      "description": "Backend service and API",
      "running": true
   },
   {
      "name": "datasentinel_dispatcher",
      "description": "Agentless service",
      "running": true
   },
   {
      "name": "datasentinel_influxdb",
      "description": "Influxdb database",
      "running": true
   }
]
}

Last updated