###########
## Index path{color}
compass.index.url = ram://compass
#compass.index.url = file:///c:/compass
# compass.index.url = file:///home/compass
## Full default analyser
#compass.engine.analyzer.default.type = snowball
#compass.engine.analyzer.default.name = English
compass.engine.analyzer.default.type = standard
compass.engine.analyzer.default.name = English
##########
### Log
##########
#log.root.path = C:/Projets/SOA4All
##########
### Repository
##########
## A Database repository configuration. All binary files are stored as DB Blobs
repo.type = database
repo.root = null
## A Filesystem repository configuration. All binary files are stored in the filesystem
#repo.type = filesystem
#repo.root = ./test-repository
{code}
The H2 Datasource (in memory mode) is the one used by default. You also have a MySQL configuration which is disabled by default.
Let's have a look at the available parameters (these parameters values are to adapt according to the used database) :
* *jdbc.driverClassName* : this is the JDBC driver which enables the connection between the Java application and the database. A list of available JDBC drivers is available at [{color:#003f80}{+}JDBC Data Access API{+}{color}|http://developers.sun.com/product/jdbc/drivers]. *Don't forget to put your JDBC driver in the directory WEB-INF/lib.*
* *jdbc.url* : this is the URL of the database.
* *jdbc.username* : this is the username of the account used to access to the database.
* *jdbc.password* : this is the password of the account used to access to the database.
* *jdbc.dialect* : this is the Hibernate dialect allowing the translation of SQL information to the targeted database. Set the Hibernate dialect according to your database. Examples of Hibernate dialects are :
** *H2* : org.hibernate.dialect.H2Dialect
** *MySQL* : org.hibernate.dialect.MySQLDialect
** *MySQL 5 with InnoDB* : org.hibernate.dialect.MySQL5InnoDBDialect
** *MySQL with InnoDB* : org.hibernate.dialect.MySQLInnoDBDialect
** *MySQL with MyISAM* : org.hibernate.dialect.MySQLMyISAMDialect
** *HSQLDB* : org.hibernate.dialect.HSQLDialect
* *jdbc.hbm2ddl.auto* : this parameter defines if the application creates a new database from scratch (create) or only update an existing database (update). Update mode also create a database if it doesn't exist. Except for an H2 in memory mode, it is recommended to set the value at *update*.
Let's have a look at the available parameter for the indexation :
* *compass.index.url* : the index URL, "ram://_path_" for an in memory index, "file://_path_" for a file system persisted index.
* *compass.engine.analyser.default.type* : type of analyser used to tokenize indexed information. Petals master comes with core analyzers (Which are part of the lucene-core jar). They are: standard, simple, whitespace, snowball, and stop.
** *standard* : tokenize information with the following rules. Splits words at punctuation characters, removing punctuation. However, a dot that's not followed by whitespace is considered part of a token, splits words at hyphens, unless there's a number in the token, in which case the whole token is interpreted as a product number and is not split, recognizes email addresses and internet hostnames as one token.Then lowercase tokens and remove english stop words (the, a, an ...). It is the recommended and most tested analyser.
** *simple* : tokenize information by dividing text at non-letters. That's to say, it defines tokens as maximal strings of adjacent letters, as defined by java.lang.Character.isLetter() predicate. Note: this does a decent job for most European languages, but does a terrible job for some Asian languages, where words are not separated by spaces.Then lowercase tokens.
** *whitespaces* : tokenize information by dividing text at whitespace.
** *snowball* : same as standard analyser but stems words using a Snowball-generated [{color:#003f80}{+}stemmer{+}{color}.|http://en.wikipedia.org/wiki/Stemming]\\
** *stop* : same as simple analyser but remove english stop words (the, a, an ...).
* *compass.engine.analyser.default.name* : An additional setting that must be set when using the snowball analyzer.
The settings can have the following values: Danish, Dutch, English, Finnish, French, German, German2, Italian, Kp, Lovins, Norwegian, Porter, Portuguese, Russian, Spanish, and Swedish.
Other parameters (not visible in the previous screenshot) :
* *configuration.reload.delay* : this property specify the delay between 2 consecutives reload of the Petals Master configuration. *Must not be modified*.
* *root.domain* : used to generate UDDI keys. By default the root domain is "dragon.org". You could specify your own root domain. For exemple : "mycompany.com". See {color:#003f80}Chapter 9,{color} {color:#003f80}{_}Adding custom Category/Identifier systems for Organizations/Services/Endpoints{_}{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}