Primary SQL Server is inaccessible

Description

This alert is triggered when the primary SQL Server is inaccessible, indicating a potential outage or connectivity issue that would severely impact Relativity functionality.

Resolution Guidance

Impact When Active

  • Relativity becomes unavailable — users cannot log in or access any workspaces.
  • Document review, audits, and workspace configurations are inaccessible.
  • All background jobs (indexing, imaging, processing, production) fail to start or remain pending.
  • Agents and services stop functioning as they rely on SQL for task management.

How To Resolve

There can be multiple reasons why SQL Server becomes inaccessible. While there is no single guaranteed fix, you can try the following steps to investigate and resolve the issue:

  • Log into Kibana using valid credentials.
  • If access is unavailable, contact a Relativity administrator within your organization.
  • Upon successful login, Navigate to 'SQL Overview' dashboard.
  • On the dashboard, review the Windows Services Health Check section to identify the SQL Server if the services are not running.
  • Check SQL Server status- Log into the SQL Server and ensure the SQL Server (MSSQLSERVER) service is running.
  • Verify connectivity - Ensure that the SQL Server is reachable from the Relativity Web, Agent, and Worker servers (e.g., using ping or telnet on port 1433)
  • Review logs - Inspect SQL Server logs and Windows Event Viewer for any critical errors or root causes (e.g., disk space, authentication, service crashes).
  • Verify if there have been any updates to SQL Server user credentials and ensure the EDDSDBO user is correctly configured.
  • Engage a Relativity database administrator from your organization - Involve the database administration team for further investigation and resolution.

Alert Details

Alert Condition Details

NameValueDescription
Rule TypeElastic Query
Data Viewmetrics-*
Filter Queryrelsvr.sqlserver.running : 0Primary SQL Server is inaccessible
GroupCountnumber of Primary SQL Server is inaccessible documents
Threshold> 0Count greter than 0, alert triggers
Time Window90 secVerified data for last 90 sec
Frequency30 secChecks for each 30 seconds

Alert Metric Details

Metric Name: relsvr.sqlserver.running

Metric Description: Alert triggers on primary SQL Server is inaccessible for last 90 seconds.

Metric Attributes:

Attribute NameDescriptionValue
labels.nameName of DatabaseEDDS
labels.stateaccessible/inaccessible
Return to top of the page
Feedback