[Rt-commit] rt branch 4.4/dbd-oracle-version-docs created. rt-4.4.5-113-g0b0789fff1

[BPS Git Server]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "rt".

The branch, 4.4/dbd-oracle-version-docs has been created
        at  0b0789fff1a67edc60bf68e52ce7eaee12cdef0b (commit)

- Log -----------------------------------------------------------------
commit 0b0789fff1a67edc60bf68e52ce7eaee12cdef0b
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Mon Jun 13 13:56:08 2022 -0400

    Add notes on preferred DBD::Oracle versions

diff --git a/README.Oracle b/README.Oracle
index e128f70968..a0c27b2640 100644
--- a/README.Oracle
+++ b/README.Oracle
@@ -1,3 +1,6 @@
+Installation Notes
+------------------
+
 On RT 3.8.2 and later, RT deployment for Oracle databases is very
 straightforward.
 
@@ -30,6 +33,28 @@ Example:
 That should be enough to get you started on Oracle, but to complete
 installation you must follow the general instructions in the README file.
 
+Client Drivers
+--------------
+
+When installing Oracle client drivers, run the same version as
+the database you are connecting to. If you are running RT on the same
+server as the Oracle database, this should happen automatically as the
+client drivers will be installed with the Oracle database software. If
+the Oracle database runs in a separate server and you are installing
+client libraries from the Oracle Instance Client, find and install
+the version that corresponds with the database you are connecting to.
+
+You will also need to install the DBD::Oracle perl module to allow
+RT to connect to the Oracle database. Some recent versions of DBD::Oracle
+have had problems with RT and should be avoided.
+
+DBD::Oracle version 1.74 is known to work well with RT. The next
+known version to work well is version 1.90. Versions in between
+those had an issue on disconnect that would cause a segfault.
+
+Updating Statistics
+-------------------
+
 As with all databases it is important to analyze the schema and get
 current statistics after every significant dataset change.  Oracle's
 cost-based optimizer can provide particularly bad performance when the

-----------------------------------------------------------------------


hooks/post-receive
-- 
rt