[CAUSEWAY-223] Additional Configuration Documentation for using SQL ObjectStore and usage for Quick Start Archetype.

• Type: Wish
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: tidy-up
• Component/s: ZZZ Mothballed: Objectstore: SQL
• Labels: Newbie
• Assignee: Unassigned
• Reporter: Jason Richardson
• Created: 01/May/12 20:46
• Updated: 11/Sep/15 14:21
• Resolved: 07/Jan/13 12:17

Description

Please Add additional documentation to the ISIS website or ISIS guides that details what POM entries and isis.properties need to be updated to use the SQL Ojbjefrom the archetype quick start documentation

I did this using the ISIS quickstart version: 0.2.0-incubating

• • This is a PostgreSQL example

• • In order to use the SQL ObjectStore the following things need to be done once the user has created their new ISIS Application.

1. comment postgresql url base example for (isis.persistor.sql.jdbc.connection): jdbc:postgresql://host:port/database

=================================
1. Add the following entry in your projectname-objstore-dflt POM file
<dependency>
<groupId>org.apache.isis.runtimes.dflt.objectstores</groupId>
<artifactId>sql-impl</artifactId>
</dependency>
=================================
2. Add the maven dependencies for your Database Drivers entry in your projectname-objstore-dflt POM file
<dependency>
<groupId>postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>9.0-801.jdbc3</version>
</dependency>
=================================
2. In the projectname-webapp project in the isis.properties file change the isis.persistor property
isis.persistor=sql

=================================
3. In the projectname-webapp project add the following properties (suitable for your Database Platform)
3a. You will need to change the connection entry and driver entry to be specific for your database platform drivers and database server location and port.
3b. -if you want ISIS to create your DB tables you will need to use an ID/Password that has table creation rights.

isis.persistor.sql.jdbc.driver=org.postgresql.Driver
isis.persistor.sql.jdbc.connection=jdbc:postgresql://127.0.0.1:5432/assignments
isis.persistor.sql.jdbc.user=postgres
isis.persistor.sql.jdbc.password=TheDatabasePassword

1. PostgreSQL ISIS specific data type overides
   isis.persistor.sql.datatypes.timestamp=TIMESTAMP
   isis.persistor.sql.datatypes.datetime=TIMESTAMP
   isis.persistor.sql.datatypes.double=DOUBLE PRECISION

=================================
4. Do a maven clean and install on your main project and run it.
4b. You should see new table(s) created in your database.