libre.sh/keycloak-scim
3
0
Fork 0
Code Issues 15 Pull requests Releases 1 Packages Activity Actions

fixed RHSSO-901

Browse source
This commit is contained in:
Jen Malloy 2017-03-27 12:49:29 -04:00
parent 2c30caffaa
commit a885e63092
1 changed files with 9 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
server_installation/topics/database/jdbc.adoc
View file

@ -1,20 +1,14 @@
=== Package the JDBC Driver
Find and download the JDBC driver JAR for your RDBMS. Before you can use this driver, you must package it up into a module
and install it into the server.
Modules define JARs that are loaded into the {{book.project.name}} classpath and the dependencies those JARs have on
other modules. They are pretty simple to set up.
Find and download the JDBC driver JAR for your RDBMS. Before you can use this driver, you must package it up into a module and install it into the server. Modules define JARs that are loaded into the {{book.project.name}} classpath and the dependencies those JARs have on other modules. They are pretty simple to set up.
Within the _.../modules/_ directory of your
{{book.project.name}} distribution, you need to create a directory structure to hold your module definition. The convention is use the Java package name
of the JDBC driver for the name of the directory structure. For PostgreSQL, create the directory _org/postgresql/main_. Copy your database
driver JAR into this directory and create an empty _module.xml_ file within it too.
Within the _.../modules/_ directory of your {{book.project.name}} distribution, you need to create a directory structure to hold your module definition. The convention is use the Java package name of the JDBC driver for the name of the directory structure. For PostgreSQL, create the directory _org/postgresql/main_. Copy your database driver JAR into this directory and create an empty _module.xml_ file within it too.
.Module Directory
image:../../{{book.images}}/db-module.png[]
After you have done this, open up the _module.xml_ file and create the following XML
After you have done this, open up the _module.xml_ file and create the following XML:
.Module XML
[source,xml]
@ -23,7 +17,7 @@ After you have done this, open up the _module.xml_ file and create the following
<module xmlns="urn:jboss:module:1.3" name="org.postgresql">
<resources>
<resource-root path="postgresql-9.4.1208.jar"/>
<resource-root path="postgresql-9.4.1212.jar"/>
</resources>
<dependencies>
@ -33,22 +27,13 @@ After you have done this, open up the _module.xml_ file and create the following
</module>
----
The module name should match the directory structure of your module. So, _org/postgresql_ maps to `org.postgresql`. The
`resource-root path` attribute should specify the JAR filename of the driver. The rest are just the normal dependencies that
any JDBC driver JAR would have.
The module name should match the directory structure of your module. So, _org/postgresql_ maps to `org.postgresql`. The `resource-root path` attribute should specify the JAR filename of the driver. The rest are just the normal dependencies that any JDBC driver JAR would have.
=== Declare and Load JDBC Driver
The next thing you have to do is declare your newly packaged JDBC driver into your deployment profile so that it loads and becomes
available when the server boots up. Where you perform this action depends on your <<fake/../../operating-mode.adoc#_operating-mode, operating mode>>. If you're
deploying in standard mode, edit _.../standalone/configuration/standalone.xml_. If you're deploying in standard clustering
mode, edit _.../standalone/configuration/standalone-ha.xml_. If you're deploying in domain mode, edit
_.../domain/configuration/domain.xml_. In domain mode, you'll need to make sure you edit the profile you are using: either
`auth-server-standalone` or `auth-server-clustered`
The next thing you have to do is declare your newly packaged JDBC driver into your deployment profile so that it loads and becomes available when the server boots up. Where you perform this action depends on your <<fake/../../operating-mode.adoc#_operating-mode, operating mode>>. If you're deploying in standard mode, edit _.../standalone/configuration/standalone.xml_. If you're deploying in standard clustering mode, edit _.../standalone/configuration/standalone-ha.xml_. If you're deploying in domain mode, edit _.../domain/configuration/domain.xml_. In domain mode, you'll need to make sure you edit the profile you are using: either `auth-server-standalone` or `auth-server-clustered`
Within the profile, search for the `drivers` XML block within the `datasources` subsystem. You should see
a pre-defined driver declared for the H2 JDBC driver. This is where you'll declare the JDBC driver for your external
database.
Within the profile, search for the `drivers` XML block within the `datasources` subsystem. You should see a pre-defined driver declared for the H2 JDBC driver. This is where you'll declare the JDBC driver for your external database.
.JDBC Drivers
[source,xml]
@ -65,11 +50,7 @@ database.
</subsystem>
----
Within the `drivers` XML block you'll need to declare an additional JDBC driver. It needs to have a `name` which
you can choose to be anything you want. You specify the `module` attribute which points to the `module` package you
created earlier for the driver JAR. Finally
you have to specify the driver's Java class. Here's an example of installing PostgreSQL driver that lives in the module
example defined earlier in this chapter.
Within the `drivers` XML block you'll need to declare an additional JDBC driver. It needs to have a `name` which you can choose to be anything you want. You specify the `module` attribute which points to the `module` package you created earlier for the driver JAR. Finally you have to specify the driver's Java class. Here's an example of installing PostgreSQL driver that lives in the module example defined earlier in this chapter.
.Declare Your JDBC Drivers
@ -89,3 +70,4 @@ example defined earlier in this chapter.
</datasources>
</subsystem>
----