#65 Add some MySQL documentation (#87)

* #65 Add some MySQL documentation

* #65 Add some MySQL documentation : fixing typo

README.md

@@ -43,21 +43,41 @@ Our issue tracker is available here: https://github.com/spring-petclinic/spring-
 
 ## Database configuration
 
-In its default configuration, Petclinic uses an in-memory database (HSQLDB) which
-gets populated at startup with data. A similar setup is provided for MySql in case a persistent database configuration is needed.
-Note that whenever the database type is changed, the data-access.properties file needs to be updated and the mysql-connector-java artifact from the pom.xml needs to be uncommented.
+In its default configuration, Petclinic uses an in-memory database (HSQLDB) which gets populated at startup with data.
+A similar setup is provided for MySql in case a persistent database configuration is needed.
+Dependency for Connector/J, the MySQL JDBC driver is already included in the `pom.xml` files.
+
+### Start a MySql database
 
 You may start a MySql database with docker:
 
 ```
 docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:5.7.8
 ```
+or download and install the MySQL database (e.g., MySQL Community Server 5.7 GA), which can be found here: https://dev.mysql.com/downloads/
+
+### Use the Spring 'mysql' profile
+
+To use a MySQL database, you have to start 3 microservices (`visits-service`, `customers-service` and `vets-services`)
+with the `mysql` Spring profile. Add the `--spring.profiles.active=mysql` as programm argument.
+
+By default, at startup, database schema will be created and data will be populated.
+You may also manualy create the PetClinic database and data by executing the `"db/mysql/{schema,data}.sql"` scripts of each 3 microservices. 
+In the `application.yml` of the [Configuration repository], set the `initialization-mode` to `never`.
+
+If you are running the microservices with Docker, you have to add the `mysql` profile into the (Dockerfile)[docker/Dockerfile]:
+```
+ENV SPRING_PROFILES_ACTIVE docker,mysql
+```
+In the `mysql section` of the `application.yml` from the [Configuration repository], you have to change 
+the host and port of your MySQL JDBC connection string. 
+
 
 ## Looking for something in particular?
 
 | Spring Cloud components | Resources  |
 |-------------------------|------------|
-| Configuration server    | [Config server properties](spring-petclinic-config-server/src/main/resources/application.yml) and [Configuration repository](https://github.com/spring-petclinic/spring-petclinic-microservices-config) |
+| Configuration server    | [Config server properties](spring-petclinic-config-server/src/main/resources/application.yml) and [Configuration repository] |
 | Service Discovery       | [Eureka server](spring-petclinic-discovery-server) and [Service discovery client](spring-petclinic-vets-service/src/main/java/org/springframework/samples/petclinic/vets/VetsServiceApplication.java) |
 | API Gateway             | [Zuul reverse proxy](spring-petclinic-api-gateway/src/main/java/org/springframework/samples/petclinic/api/ApiGatewayApplication.java) and [Routing configuration](https://github.com/spring-petclinic/spring-petclinic-microservices-config/blob/master/api-gateway.yml) |
 | Docker Compose          | [Spring Boot with Docker guide](https://spring.io/guides/gs/spring-boot-docker/) and [docker-compose file](docker-compose.yml) |
@@ -78,3 +98,6 @@ docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:
 The [issue tracker](https://github.com/spring-petclinic/spring-petclinic-microservices/issues) is the preferred channel for bug reports, features requests and submitting pull requests.
 
 For pull requests, editor preferences are available in the [editor config](.editorconfig) for easy use in common text editors. Read more and download plugins at <http://editorconfig.org>.
+
+
+[Configuration repository]: https://github.com/spring-petclinic/spring-petclinic-microservices-config

db_readme.txt

-================================================================================
-===        Spring PetClinic sample application - Database Configuration      ===
-================================================================================
-
-@author Costin Leau
-
---------------------------------------------------------------------------------
-
-In its default configuration, Petclinic uses an in-memory database (HSQLDB) which
-gets populated at startup with data. A similar setup is provided for Mysql in case
-a persistent database configuration is needed.
-Note that whenever the database type is changed, the data-access.properties file needs to
-be updated.

petclinic_db_setup_mysql.txt

-================================================================================
-===        Spring PetClinic sample application - MySQL Configuration         ===
-================================================================================
-
-@author Sam Brannen
-@author Costin Leau
-
---------------------------------------------------------------------------------
-
-1) Download and install the MySQL database (e.g., MySQL Community Server 5.1.x),
-   which can be found here: http://dev.mysql.com/downloads/
-
-2) Download Connector/J, the MySQL JDBC driver (e.g., Connector/J 5.1.x), which
-   can be found here: http://dev.mysql.com/downloads/connector/j/
-   Copy the Connector/J JAR file (e.g., mysql-connector-java-5.1.5-bin.jar) into
-   the db/mysql directory. Alternatively, uncomment the mysql-connector from the
-   Petclinic pom.
-
-3) Create the PetClinic database and user by executing the "db/mysql/createDB.txt"
-   script.
-
-4) Open "src/main/resources/spring/data-access.properties"; comment out all properties in the
-   "HSQL Settings" section; uncomment all properties in the "MySQL Settings"
-   section.

spring-petclinic-customers-service/src/main/resources/application.properties

 server.port=0
-petclinic.database=hsqldb
-spring.datasource.schema=classpath*:db/${petclinic.database}/schema.sql
-spring.datasource.data=classpath*:db/${petclinic.database}/data.sql
 logging.level.org.springframework=INFO

spring-petclinic-customers-service/src/main/resources/db/mysql/data.sql

@@ -29,8 +29,3 @@ INSERT IGNORE INTO pets VALUES (10, 'Mulligan', '1997-02-24', 2, 8);
 INSERT IGNORE INTO pets VALUES (11, 'Freddy', '2000-03-09', 5, 9);
 INSERT IGNORE INTO pets VALUES (12, 'Lucky', '2000-06-24', 2, 10);
 INSERT IGNORE INTO pets VALUES (13, 'Sly', '2002-06-08', 1, 10);
-
-INSERT IGNORE INTO visits VALUES (1, 7, '2010-03-04', 'rabies shot');
-INSERT IGNORE INTO visits VALUES (2, 8, '2011-03-04', 'rabies shot');
-INSERT IGNORE INTO visits VALUES (3, 8, '2009-06-04', 'neutered');
-INSERT IGNORE INTO visits VALUES (4, 7, '2008-09-04', 'spayed');

spring-petclinic-customers-service/src/test/resources/application-test.yml

 spring.jpa.hibernate.ddl-auto: none
 
+spring:
+  datasource:
+    schema: classpath*:db/hsqldb/schema.sql
+    data: classpath*:db/hsqldb/data.sql
+
 logging.level.org.springframework: INFO
 

spring-petclinic-vets-service/src/main/resources/application.properties

 server.port=0
-petclinic.database=hsqldb
-spring.datasource.schema=classpath*:db/${petclinic.database}/schema.sql
-spring.datasource.data=classpath*:db/${petclinic.database}/data.sql
-logging.level.org.springframework=INFO
 spring.profiles.active=production
-spring.cache.cache-names=vets
\ No newline at end of file
+spring.cache.cache-names=vets

spring-petclinic-vets-service/src/test/resources/application-test.yml

 spring.jpa.hibernate.ddl-auto: none
 
+spring:
+  datasource:
+    schema: classpath*:db/hsqldb/schema.sql
+    data: classpath*:db/hsqldb/data.sql
+
 vets:
   cache:
     ttl: 10

spring-petclinic-visits-service/src/main/resources/application.properties

 server.port=0
-petclinic.database=hsqldb
-spring.datasource.schema=classpath*:db/${petclinic.database}/schema.sql
-spring.datasource.data=classpath*:db/${petclinic.database}/data.sql
-logging.level.org.springframework=INFO

spring-petclinic-visits-service/src/test/resources/application-test.yml

 spring.jpa.hibernate.ddl-auto: none
 
+spring:
+  datasource:
+    schema: classpath*:db/hsqldb/schema.sql
+    data: classpath*:db/hsqldb/data.sql
+
 logging.level.org.springframework: INFO