{panel}{toc}{panel}

h1. Pre-requisites

Before installing the Petals Master web application, be sure that you have installed the following elements:
* A [{color:#003f80}{+}JDK{+}{color} 1.6.0|http://www.mysql.com/] or later,
* A servlet container like \[{color:#003f80}{+}Apache Tomcat 5.5.26 or later,+{color}\|http://tomcat.apache.org/\]
* A Web navigator like :
* [{color:#003f80}{+}Firefox{+}{color} 2.0|http://www.mozilla-europe.org/fr/products/firefox/] or later with Javascript activated,
* [{color:#003f80}{+}Chrome{+}{color} with|http://www.firebirdsql.org/] Javascript activated,
* [{color:#003f80}{+}Internet Explorer{+}{color} 6|http://www.microsoft.com/france/windows/downloads/ie/getitnow.Mspx] or later with Javascript activated,
* [{color:#003f80}{+}Opera{+}{color} 9.6|http://www.firebirdsql.org/] or later with Javascript activated,
* [{color:#003f80}{+}Safari{+}{color} 3.1.2|http://www.apple.com/fr/safari/] or later with Javascript activated.
* Optional : A relationnal database like :
* [{color:#003f80}{+}MySQL{+}{color} 5.0|http://www.mysql.com/] or later,
* [{color:#003f80}{+}H2{+}{color} 1.1|http://www.h2database.com/html/main.html] or later,
* [{color:#003f80}{+}HSQL{+}{color} 1.8.0|http://hsqldb.org/] or later (HSQL DB is fully supported only in server mode).

\\
By default, Petals Master is configured to use a H2 database, which is embedded into Petals Master (the H2 is configured in memory mode).


h1. Configure a database and a Lucene index

The default configuration of the Petals Master application uses an H2 database, in non-persistent mode (memory mode). That means that when the servlet container is stopped, all the data are deleted (because they were not persisted).
\\
You may want to change this configuration : use H2 database but in file mode (to persist data), or change the H2 database for a MySQL database for example. We will see how to do that.
\\
Petals Master uses a Lucene index to store information about stored entities to provide advanced search capabilities. The default configuration stores the index in memory. So, if the servlet container is stopped, the index is lost. This default setting must only be used with a non persistant storage (H2 in memory mode). This configuration must be modified if you use a persistant storage like H2 in file mode or MySQL. We will see below, how to configure a file system directory for index purpose.
\\
Petals Master is packaged as a war. To change the database configuration, you have to _unzip_ _the_ _war_ archive. Go into the
_$\{petals-master-root\}_/WEB-INF/classes directory and open the _dragon.properties_ file.
\\
The default dragon.properties file is (NB : here, we have disable the MySQL configuration and enable the H2 configuration, Indexation is set in memory mode) :
{panel}
{color:#339966}\############{color}
{color:#339966}\### Datasource properties{color}
{color:#339966}\############{color}

{color:#339966}\## MySQL Datasource{color}
{color:#339966}\# jdbc.driverClassName = com.mysql.jdbc.Driver{color}
{color:#339966}\# jdbc.url = jdbc:mysql://localhost:3306/dragon{color}
{color:#339966}\# jdbc.username = anonymous{color}
{color:#339966}\# jdbc.password ={color}
{color:#339966}\# jdbc.hibernate.dialect = org.hibernate.dialect.MySQL5InnoDBDialect{color}
{color:#339966}\# jdbc.hibernate.hbm2ddl.auto = update{color}
{color:#339966}\# jdbc.hibernate.show_sql = false{color}

{color:#339966}\## In Memory H2 Datasource{color}
jdbc.driverClassName = {color:#0000ff}org.h2.Driver{color}
jdbc.url = {color:#0000ff}jdbc:h2:mem:dragon{color}
jdbc.username = {color:#0000ff}sa{color}
jdbc.password = {color:#0000ff}sa{color}
jdbc.hibernate.dialect = {color:#0000ff}org.hibernate.dialect.H2Dialect{color}
jdbc.hibernate.hbm2ddl.auto = {color:#0000ff}update{color}
jdbc.hibernate.show_sql = {color:#0000ff}false{color}

{color:#339966}\## In Memory HSQL Datasource{color}
{color:#339966}\#jdbc.driverClassName = org.hsqldb.jdbcDriver{color}
{color:#339966}\#jdbc.url = jdbc:hsqldb:mem:dragon{color}
{color:#339966}\#jdbc.username = sa{color}
{color:#339966}\#jdbc.password ={color}
{color:#339966}\#jdbc.hibernate.dialect = org.hibernate.dialect.HSQLDialect{color}
{color:#339966}\#jdbc.hibernate.hbm2ddl.auto = update{color}
{color:#339966}\#jdbc.hibernate.show_sql = false{color}
{color:#339966}\#jdbc.url =jdbc:hsqldb:{color}{color:#339966}[file:c:/hsqldb/dragon]{color}

{color:#339966}\###########{color}
{color:#339966}\### Indexation properties (Compass/Lucene){color}
{color:#339966}\###########{color}

{color:#339966}\## Index path{color}
compass.index.url = {color:#0000ff}ram://compass{color}
{color:#339966}\#compass.index.url ={color} {color:#339966}[file:///c:/compass]{color}
{color:#339966}\# compass.index.url ={color} {color:#339966}[file:///home/compass]{color}

{color:#339966}\## Full default analyser{color}
{color:#339966}\#compass.engine.analyzer.default.type = snowball{color}
{color:#339966}\#compass.engine.analyzer.default.name = English{color}
compass.engine.analyzer.default.type = {color:#0000ff}standard{color}
compass.engine.analyzer.default.name = {color:#0000ff}English{color}

{color:#339966}\##########{color}
{color:#339966}\### Log{color}
{color:#339966}\##########{color}
{color:#339966}\#log.root.path = C:/Projets/SOA4All{color}

{color:#339966}\##########{color}
{color:#339966}\### Repository{color}
{color:#339966}\##########{color}
{color:#339966}\## A Database repository configuration. All binary files are stored as DB Blobs{color}
repo.type = {color:#0000ff}database{color}
repo.root = {color:#0000ff}null{color}
{color:#339966}\## A Filesystem repository configuration. All binary files are stored in the filesystem{color}
{color:#339966}\#repo.type = filesystem{color}

h1. *Installing* *the* *application*

\\
Petals Master is packaged as a WAR archive, you just have to deploy it in your servlet container.
\\
If you have previously unwar the Petals Master archive to set your own database configuration, you have two ways :
\\
• Copy/paste your Petals Master directory directly into your serlet container,
\\
• Zip your Petals Master directory as a WAR archive, then copy/paste this new archive into your servlet container (into the WebApp directory if you use Tomcat).
\\
For instance, Tomcat users just have to copy the war to the _webapps_ directory and wait for Tomcat to deploy the application.
\\

h1. *Accessing* *the* *application*

Once deployed, Petals Master can be accessed in your web browser through the address {color:#003f80}[http://|http://+]{color}{color:#003f80}{_}{+}host{+}{_}{color}{color:#003f80}+:+{color}{color:#003f80}{_}{+}port{+}{_}{color}{color:#003f80}+/petals-master-1.x{+}{color}{color:#003f80}/petals-master{color}

If your server configuration has "localhost" as host, 8080 as port, the URL for Petals Master V1.0 is : [http://|http://+]{color:#003f80}{_}{+}localhost{+}{_}{color}{color:#003f80}+:+{color}{color:#003f80}{_}{+}8080{+}{_}{color}{color:#003f80}+/petals-master-1.x/petals-master{+}{color}.

!authentication.png|thumbnail!\\

You reach the Login page of the application. You can choose to remember your logging information for two weeks. Petals Master is setup with a default user :
An *administrator* allowed to access to all Petals Master features : Username "*master*" / Password "*master*".

Once you are successfully logged in, you can see the following screen :

!welcome.png|thumbnail!

{note}Please note that in the following screenshots, when you see *a* *field* *with* *a* *yellow* *foreground*, it means that *the* *field is required*.{note}