Skip to content

Commit

Permalink
Move info about databases from dockerDevel to a better place
Browse files Browse the repository at this point in the history
  • Loading branch information
Martijn Dirkse committed Nov 22, 2024
1 parent d40f883 commit d7b9049
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -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``.

Expand Down
2 changes: 2 additions & 0 deletions docs/source/deploying/databaseDriver.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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::
Expand Down

0 comments on commit d7b9049

Please sign in to comment.