edu / swXercise · Commits

Commit 8f6b741129da8e75c0a6dd55d69f83a99d1cf2ee

Authored by Thomas Ziemer
1 parent 32d37a0e
build: skipped

configure: README.md erweitert

Inline Side-by-side
Showing 1 changed file with 80 additions and 1 deletions
README.md
  View file @8f6b741
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 \ No newline at end of file 81 \ No newline at end of file