Comment on page
Installation completes within minutes, ensuring that all components are operational upon completion.
The platform is available exclusively on linux systems:
A license key is required to use Datasentinel.
Obtain a Datasentinel license key:
The sizing of the machine (cpus, memory, storage) to be provisioned, will depend on the number of PostgreSQL instances to monitor as well as the data retention chosen. Default sizing recommendations with a retention of 14 days
We strongly recommend a machine with scale capabilities such as virtual machines
For enhanced memory management on a server hosting Datasentinel, it is advised to set the swappiness parameter to a value of 5.
You can confirm the current value:
Here are the firewall settings necessary for Datasentinel
- The listening port of the platform server must be accessible to connect to the GUI. The port is the https port 443 by default and can be changed.
1. Agent-based mode
- The listening port of the platform server must be accessible in both directions (PUSH and PULL) from the agents' servers.
- Each agent listens on port 8282 by default (updatable). The platform server must be able to communicate with the agent servers on this port (PUSH and PULL)
2. Agentless mode
- The platform connects directly to PostgreSQL instances. The listening port of each PostgreSQL instance must be accessible from the platform
The file size is approximately 550 MB.
// Download example with wget
During installation, you will need to be logged in as the root account. However, this is the only time this account is required. After installation, all modules and future updates will be executed using the defined application account.
dnf install -y nginx
// Uncompress the downloaded file
tar xvzf install-datasentinel-platform-rhel9-latest.tar.gz
Uncompress the downloaded file to create two files:
The application binaries and the database for storing metrics will be installed in the /datasentinel directory. You can choose to pre-create the directory as a symbolic link, file system, or directory, or it will be created during installation. Make sure the directory is empty.
// Run the shell script
The script executes in less than 2 minutes and performs multiple actions:
- 1.Requests user input for the application username (default is datasentinel). The user can be pre-created with bash as the default shell.
- 2.Requests the application listening port (default is 443)
- 3.Creates the /datasentinel directory if it doesn't already exist
- 4.Decompresses datasentinel-platform.tar.gz to install all components
- 5.Creates entries in
- 6.Deploys services for automatic restart
- 7.Starts all components.
To install Datasentinel silently, use
./init_datasentinel.sh -dDefault values will be used
At the end of the installation, the platform should be up and running.
The listening port must be opened and accessible. Also, be careful with your firewall configuration (SELinux, firewalld) if any. nginx is the entry component for Datasentinel, listening on port 443 by default for all incoming communications from other servers. It communicates locally with other components via their respective listening ports. Config file
If a 502 error appears on the graphical interface despite all components being up and running, it’s worth checking the firewall settings, such as SELinux
The on-premises platform utilizes a self-signed certificate configured with NGINX. The self-signed certificate is located in the
/etc/nginx/certsdirectory. If desired, you can replace it with your own certificate. To do so:
- 1.Generate a certificate for the platform machine.
- 2.Replace the existing files
key_datasentinel.pemwith the real certificate
- 3.Restart NGINX
Once the installation is complete, access the UI using url and username:
- URL: https://<<server_name>>
- Username: datasentinel
The password will be displayed at the end of the installation process
Datasentinel utilizes the following components:
Each component is restarted automatically with a system service located on
// Start All
systemctl start datasentinel_influxdb datasentinel_postgresql datasentinel_grafana datasentinel_backend datasentinel_dispatcher nginx
// Stop All
systemctl stop datasentinel_influxdb datasentinel_postgresql datasentinel_grafana datasentinel_backend datasentinel_dispatcher nginx
// Component status
systemctl -l | egrep -i "datasentinel_|nginx"
An alias is available when connected as datasentinel to check the availability of all components
datasentinel_backend.service loaded active running Datasentinel backend APIs
datasentinel_dispatcher.service loaded active running Datasentinel dispatcher
datasentinel_influxdb.service loaded active running InfluxDB service
datasentinel_grafana.service loaded active running Grafana daemon
datasentinel_postgresql.service loaded active running PostgreSQL 10 database server
nginx.service loaded active running The nginx HTTP and reverse proxy server
Another method to check the status of the platform is by querying its API using the following curl command
curl -k https://localhost/ds-api/
"message": "Datasentinel Backend up and running",
"description": "Nginx web server",
"description": "Grafana frontend",
"description": "PostgreSQL instance",
"description": "Backend service and API",
"description": "Agentless service",
"description": "Influxdb database",
Datasentinel generates logs, which are located in the
/datasentinel/logdirectory, except for the NGINX log file