47 lines
2.3 KiB
Text
47 lines
2.3 KiB
Text
|
=== Modify the {{book.project.name}} Datasource
|
||
|
|
|
||
|
|
After declaring your JDBC driver, you have to modify the existing datasource configuration that {{book.project.name}} uses
|
||
|
|
to connect to the built-in embedded database. You'l need to change it to connect to your new external database. You'll do
|
||
|
|
this within the same configuration file and XML block that you registered your JDBC driver. Here's an example
|
||
|
|
that set's up the connection to your new database:
|
||
|
|
|
||
|
|
.Declare Your JDBC Drivers
|
||
|
|
[source,xml]
|
||
|
|
----
|
||
|
|
<subsystem xmlns="urn:jboss:domain:datasources:4.0">
|
||
|
|
<datasources>
|
||
|
|
...
|
||
|
|
<datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" enabled="true" use-java-context="true">
|
||
|
|
<connection-url>jdbc:postgresql://localhost/keycloak</connection-url>
|
||
|
|
<driver>postgresql</driver>
|
||
|
|
<pool>
|
||
|
|
<max-pool-size>20</max-pool-size>
|
||
|
|
</pool>
|
||
|
|
<security>
|
||
|
|
<user-name>William</user-name>
|
||
|
|
<password>password</password>
|
||
|
|
</security>
|
||
|
|
</datasource>
|
||
|
|
...
|
||
|
|
</datasources>
|
||
|
|
</subsystem>
|
||
|
|
----
|
||
|
|
|
||
|
|
Search for the +datasource+ definition for +KeycloakDS+. You'll first need to specify the +connection-url+. The
|
||
|
|
documentation for your vendor's JDBC implementation will tell you the connection URL you should provide there.
|
||
|
|
|
||
|
|
Next define the +driver+ you will use. This is the logical name of the JDBC driver you declared in the previous section of this
|
||
|
|
chapter.
|
||
|
|
|
||
|
|
It is expensive to open a new connection to a database ever time you want to perform a transaction. To compensate, the datasource
|
||
|
|
implementation maintains a pool of open connections. The +max-pool-size+ specifies the maximum number of connections it will pool.
|
||
|
|
You may want to change the value of this depending on the load of your system.
|
||
|
|
|
||
|
|
Finally, or PostgreSQL at least, you need to define the database username and password that is needed to connect to the database. You
|
||
|
|
may be worried that this is in clear text in the example. There are methods to obfuscate this, but this is beyond the
|
||
|
|
scope of this guide.
|
||
|
|
|
||
|
|
NOTE: For more information and details features of datasources, please see the link:{{book.appserver.datasource.link}}[the datasource configuration chapter]
|
||
|
|
of the {{book.appserver.admindoc.name}}.
|
||
|
|
|