From 93ea45a57f74fb66b253ed71c662d106c6ef542a Mon Sep 17 00:00:00 2001
From: campbell-m <87438215+campbell-m@users.noreply.github.com>
Date: Wed, 8 Jan 2025 12:37:35 +0000
Subject: [PATCH] Clarified documentation for configuring the database
 settings.  See GitHub Issue #3801.

---
 INSTALL                   | 5 +++++
 web/config.inc.php-sample | 6 ++++++
 2 files changed, 11 insertions(+)

diff --git a/INSTALL b/INSTALL
index d8b8e32cf2..490f2c89c9 100644
--- a/INSTALL
+++ b/INSTALL
@@ -396,6 +396,11 @@ Then define your database connection parameters. Set the values for:
     $db_login =     The database login username
     $db_password =  The database login password for the above login username
 
+If you are using cPanel on your web server, make sure you include the prefix,
+typically 8 characters followed by an underscore, in your database name and
+database username.  For example $db_database = "abcdefgh_mrbs". (Note: this
+prefix is not the same as the table prefix below.)
+
 If the database server and web server are the same machine, use
 $db_host="localhost". Or, with PostgreSQL only, you can use $db_host="" to
 use Unix Domain Sockets to connect to the database server on the same machine.
diff --git a/web/config.inc.php-sample b/web/config.inc.php-sample
index 715c4b99e6..7fa6f38ae9 100644
--- a/web/config.inc.php-sample
+++ b/web/config.inc.php-sample
@@ -47,6 +47,12 @@ require_once 'lib/autoload.inc';
 /*******************
  * Database settings
  ******************/
+
+// If you are using cPanel on your web server, make sure you include the prefix,
+// typically 8 characters followed by an underscore, in your database name and
+// database username.  For example $db_database = "abcdefgh_mrbs". (Note: this
+// prefix is not the same as the table prefix below.)
+
 // Which database system: "pgsql"=PostgreSQL, "mysql"=MySQL
 $dbsys = "mysql";
 // Hostname of database server. For pgsql, can use "" instead of localhost