Commit 8f6b741129da8e75c0a6dd55d69f83a99d1cf2ee
1 parent
32d37a0e
configure: README.md erweitert
Showing
1 changed file
with
80 additions
and
1 deletions
README.md
| 1 | -Ein Beispielprojekt für die Lehrveranstaltungen "Software Engineering 2" (SE2) und "Softwarequalität und Test" (SwQT). | |
| 1 | +# Ein Java-Beispielprojekt für die Lehrveranstaltungen "Software Engineering 2" (SE2) und "Softwarequalität und Test" (SwQT). | |
| 2 | + | |
| 3 | +## MySQL konfigurieren | |
| 4 | + | |
| 5 | +Zunächst muss das MySQL-Datenbanksystem installiert werden. Dies ist betriebssystemspezifisch. Während der Installation wird ein temporäres Root-Kennwort generiert. | |
| 6 | + | |
| 7 | +Dann kann das MySQL-Frontend gestartet werden (es wird zunächst nach dem temporären Kennwort gefragt): | |
| 8 | + | |
| 9 | +> mysql -u root -p | |
| 10 | + | |
| 11 | +Dann kann/muss das Kennwort geändert werden, beispielsweise in 'root': | |
| 12 | + | |
| 13 | +> ALTER USER 'root'@'localhost' IDENTIFIED BY ‘root‘; | |
| 14 | + | |
| 15 | +Dann muss eine projektspezifische Datenbank erstellt und mit den nötigen Rechten versehen werden: | |
| 16 | + | |
| 17 | +> create database swxercise; | |
| 18 | + | |
| 19 | +> grant all privileges on swxercise.* to 'root'@'localhost' identified by 'root'; | |
| 20 | + | |
| 21 | +## MySQL-Datenbank im WildFly einbinden | |
| 22 | + | |
| 23 | +Zunächst muss der JBoss WildFly Application Server installiert werden. Dies ist betriebssystemspezifisch. | |
| 24 | + | |
| 25 | +### Datei module.xml im Verzeichnis $JBOSS_HOME/modules/system/layers/base/com/mysql/driver/main erstellen mit folgendem Inhalt: | |
| 26 | + | |
| 27 | +``` | |
| 28 | +<module xmlns="urn:jboss:module:1.3" name="com.mysql.driver"> | |
| 29 | + <resources> | |
| 30 | + <resource-root path="mysql-connector-java-5.1.41-bin.jar" /> | |
| 31 | + </resources> | |
| 32 | + <dependencies> | |
| 33 | + <module name="javax.api"/> | |
| 34 | + <module name="javax.transaction.api"/> | |
| 35 | + </dependencies> | |
| 36 | +</module> | |
| 37 | +``` | |
| 38 | + | |
| 39 | +Und natürlich die jar-datei mit dem angegebenen MySQL-Treiber in dieses Verzeichnis hineinkopieren. Er muss von den Oracle-Internetseiten heruntergeladen werden. | |
| 40 | + | |
| 41 | +Aufgepasst bei der Version des MySQL-Konnektors in der module.xml! | |
| 42 | + | |
| 43 | +### In der standalone.xml im Verzeichnis $JBOSS_HOME/standalone/configuration folgenden Inhalt unterhalb der WildFly-Beispieldatenbank com.h2database.h2 ergänzen: | |
| 44 | + | |
| 45 | +``` | |
| 46 | +<drivers> | |
| 47 | + ... (hier befindet sich der H2-Treiber; unserer kommt darunter) | |
| 48 | + <driver name="mysql" module="com.mysql.driver"> | |
| 49 | + <driver-class>com.mysql.jdbc.Driver</driver-class> | |
| 50 | + </driver> | |
| 51 | +</drivers> | |
| 52 | +``` | |
| 53 | + | |
| 54 | +## MySQL-Datasource im WildFly definieren | |
| 55 | + | |
| 56 | +### In der standalone.xml im Verzeichnis $JBOSS_HOME/standalone/configuration folgenden Inhalt innerhalb der Datasources ergänzen: | |
| 57 | + | |
| 58 | +``` | |
| 59 | +... (hier befindet sich die H2-Datasource; unsere kommt darunter) | |
| 60 | +</datasource> | |
| 61 | +<datasource jndi-name="java:jboss/datasources/swXerciseDS" pool-name="swXerciseDS" enabled="true" use-java-context="true" jta="true"> | |
| 62 | + <connection-url>jdbc:mysql://localhost:3306/swxercise?useSSL=false</connection-url> | |
| 63 | + <driver>mysql</driver> | |
| 64 | + <!-- der Default-Eintrag "TRANSACTION_REPEATABLE_READ" kann zu Camunda-Deadlocks kommen (ThZ, 24.04.2017) --> | |
| 65 | + <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation> | |
| 66 | + <pool> | |
| 67 | + <min-pool-size>10</min-pool-size> | |
| 68 | + <max-pool-size>100</max-pool-size> | |
| 69 | + <prefill>true</prefill> | |
| 70 | + </pool> | |
| 71 | + <security> | |
| 72 | + <user-name>root</user-name> | |
| 73 | + <password>root</password> | |
| 74 | + </security> | |
| 75 | + <statement> | |
| 76 | + <prepared-statement-cache-size>32</prepared-statement-cache-size> | |
| 77 | + <share-prepared-statements>true</share-prepared-statements> | |
| 78 | + </statement> | |
| 79 | +</datasource> | |
| 80 | +``` | |
| 2 | 81 | \ No newline at end of file | ... | ... |