Add missing information regarding MongoDB uri. (#481)

* Add information how to write a MongoDB connection string (mongoDB
  uri property).
* Add more details about Parameters, called options bu MongoDB

Author: Anders Breid

wiki/configuration.md

@@ -1,6 +1,6 @@
 # Configuration
 
-The configuration for RabbitMQ, MongoDB etc. can be set in the [application.properties](../src/main/resources/application.properties) 
+The configuration for RabbitMQ, MongoDB etc. can be set in the [application.properties](../src/main/resources/application.properties)
 file. You can also set them as system properties using the -D flags when starting Eiffel Intelligence.
 
 ## Setting up Multiple Eiffel Intelligence Instances
@@ -14,16 +14,16 @@ to what object is configured using a set of rules.
 In this case we use the same instance of RabbitMQ and MongoDB.
 
   - **rabbitmq.queue.suffix** property should be different for each rule set.
-  Otherwise the rabbitMQ will split the events in the queue among all the 
+  Otherwise the rabbitMQ will split the events in the queue among all the
   instances listening to that queue.
   - MongoDb collection names should also be different for each rule set.
 
 <img src="images/multiple_EI_instances.png"></img>
 
 ### Set up Multiple Instances with Same Rule-set
 
-This situation may be needed when the events throughput is very high. In 
-this case the same configuration file is copied to the server where the 
+This situation may be needed when the events throughput is very high. In
+this case the same configuration file is copied to the server where the
 extra instance will be started.
 
 <img src="images/multiple_EI_instances_same_rule.png"></img>
@@ -39,7 +39,7 @@ different Eiffel protocol versions inside the war artifact file and in the
 source code repository. All default extraction rules json files can be
 found here: [extraction rules](../src/main/resources/rules)
 
-Example of setting "rules.path" property in application.properties using 
+Example of setting "rules.path" property in application.properties using
 default extraction rules json files provided in eiffel-intelligence war file:
 - rules.path: /rules/ArtifactRules-Eiffel-Agen-Version.json
 - rules.path: /rules/ArtifactRules-Eiffel-Toulouse-Version.json
@@ -60,7 +60,7 @@ If you wish to re-use the extracted value from IdentifyRules field
 somewhere else in your rule set for a particular event, it is possible
 to define a placeholder marker. Eiffel Intelligence will find and replace
 this marker in your rules with the wanted value extracted from IdentifyRules.
-This marker can be defined with the property **rules.replacement.marker**. 
+This marker can be defined with the property **rules.replacement.marker**.
 You can see example usages of it in the [example rules](../src/main/resources/rules)
 and [read more about it's usage here](rules.md#using-placeholders-in-rules).
 
@@ -161,20 +161,23 @@ used. **event.repository.url** takes a full URL to such a repository.
 
 ## MongoDB
 
-You can set up connections to multiple MongoDB instances with or without authentication.
+You can set up connections to a single MongoDB instance or a Replica set of multiple MongoDB instances with or
+without authentication and parameters.
 Here are some examples:
 
-    mongodb://localhost:27017                                       - Single MongoDB instance, no authentication
-    mongodb://username:mypasswd@localhost:27017                     - Single MongoDD instance with authentication
-    mongodb://username:mypasswd@hostname1:27017,hostname2:27017     - Multiple MongoDB instances with authentication
+    mongodb://localhost:27017                                                 - Single MongoDB instance, no authentication
+    mongodb://username:mypasswd@localhost:27017                               - Single MongoDD instance with authentication
+    mongodb://username:mypasswd@hostname1:27017,hostname2:27017               - Multiple MongoDB instances with authentication
+    mongodb://username:mypasswd@hostname1:27017,hostname2:27017/?param=value  - Multiple MongoDB instances with authentication and options
 
 If encryption of the MongoDB password is desired there is information [here](configuration.md#password-encryption).
+Options provided only once in the end but will be used for all provided hosts.
+The **spring.data.mongodb.uri** property specifies a MongoDB connection string, read more [here](https://docs.mongodb.com/manual/reference/connection-string/)
+The second property **spring.data.mongodb.database** defines a name for the database so this does not have to be provided in the uri property.
 
 * spring.data.mongodb.uri
 * spring.data.mongodb.database
 
-The second property **spring.data.mongodb.database** defines a name for the database.
-
 ## RabbitMQ
 
 You can configure the RabbitMQ settings using the rabbitmq.* properties.
@@ -281,7 +284,7 @@ Short guide about encrypting passwords:
 
 **1** Encrypt actual component password with secret encrypting password.
 Encrypting password should be a secret password and is created/generated by an
-admin user and should not be written/stored in application.properties or any 
+admin user and should not be written/stored in application.properties or any
 other config files near the application in the filesystem:
 
         ./encrypt.sh input="<the actual component password>" password=mySecretEncryptorPassword
@@ -290,12 +293,12 @@ other config files near the application in the filesystem:
 
         rv/2O+hOT4GJSPmmF/cF1w==
 
-**3** Now open application.properties file and add the new encrypted password 
+**3** Now open application.properties file and add the new encrypted password
 to the specific component password property with "ENC(myEncryptedPassword)" format:
 
          some.component.password=ENC(rv/2O+hOT4GJSPmmF/cF1w==)
 
-Do step 1 to 3 for all component passwords and properties in application.properties. 
+Do step 1 to 3 for all component passwords and properties in application.properties.
 Remember to use same secret encryptor password for all components passwords.
 
 **4** Now its time to run Eiffel-Intelligence with these encrypted passwords in application.properties.