From d7b90493b73b232474280da178049eb781834cae Mon Sep 17 00:00:00 2001 From: Martijn Dirkse Date: Fri, 22 Nov 2024 16:31:00 +0100 Subject: [PATCH] Move info about databases from dockerDevel to a better place --- .../advancedDevelopment/dockerDevel/deployingAppServer.rst | 2 +- docs/source/deploying/databaseDriver.rst | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/source/advancedDevelopment/dockerDevel/deployingAppServer.rst b/docs/source/advancedDevelopment/dockerDevel/deployingAppServer.rst index 7d968b50..0ab12ac0 100644 --- a/docs/source/advancedDevelopment/dockerDevel/deployingAppServer.rst +++ b/docs/source/advancedDevelopment/dockerDevel/deployingAppServer.rst @@ -9,7 +9,7 @@ These issues can be addressed by distributing a Docker image. Developers can cre .. WARNING:: - From release 9.0 onwards, database libraries are no longer in the standard Docker image. See :ref:`deployingDatabaseDriver` for more explanation. If you use the standard image to derive a customer-specific image, then add the library in ``/usr/local/tomcat/lib``. Keep in mind that this directory already contains other files, so do not make this directory a volume. You can also leave it to the customer to add the database driver. Make ``/opt/frank/resources`` a volume and have the library in that directory. + From release 9.0 onwards, database libraries are no longer in the standard Docker image. See :ref:`deployingDatabaseDriver` for more explanation. File ``resources.yml`` is still mapped as a volume (``/opt/frank/resources``) to allow the customer to configure external resources. This explains why it is useful not to put ``resources.yml`` in ``/opt/frank/configurations`` - doing so would make it more difficult to include configurations in a Docker image without doing so for ``resources.yml``. diff --git a/docs/source/deploying/databaseDriver.rst b/docs/source/deploying/databaseDriver.rst index 004ea033..fbe51a1f 100644 --- a/docs/source/deploying/databaseDriver.rst +++ b/docs/source/deploying/databaseDriver.rst @@ -9,6 +9,8 @@ To access a database, the Frank!Framework needs a database driver or a datasourc Until release 8.3 of the Frank!Framework, the database libraries of many databases were included in the Docker image provided by the maintainers of the Frank!Framework. This is the Docker image that holds the Frank!Framework deployed on Apache Tomcat. From the 9.0 release onwards, the database libraries will be excluded from this standard image to make it smaller. Frank developers typically derive a Docker image from this standard image to provide the Frank configurations the customer needs. They should take care now to add the database library of the chosen database. +Frank developers should carefully consider the location of the database library. If the standard image is used to derive a customer-specific image and if the database library should be in the image, then add the library in ``/usr/local/tomcat/lib``. Keep in mind that this directory already contains other files, so do not make this directory a volume. If the customer is to add the database driver, make ``/opt/frank/resources`` a volume. The customer can then supply the database library. + The following table shows for each database brand where the library can be found: .. csv-table::