restore the content

Author: recrwplay

modules/ROOT/pages/fabric/configuration.adoc

@@ -195,4 +195,79 @@ A Neo4j DBMS is represented by its Bolt connector address.
 Example: `xref:reference/configuration-settings.adoc#config_fabric.routing.servers["fabric.routing.servers=server1:7687,server2:7687"]`.
 |===
 
+=== Graph settings
 
+[NOTE]
+--
+The `<ID>` in the following settings is the integer associated to each Fabric graph.
+--
+
+.Fabric graph settings
+[options="header"]
+|===
+| Parameter | Description
+| `fabric.graph.<ID>.uri` | URI of the Neo4j DBMS hosting the database associated to the Fabric graph.
+Example: `neo4j://somewhere:7687`
+| `fabric.graph.<ID>.database` | Name of the database associated to the Fabric graph.
+| `fabric.graph.<ID>.name` | Name assigned to the Fabric graph.
+The name can be used in Fabric queries.
+| `fabric.graph.<ID>.driver.*` | Any specific driver setting, that means, any setting related to a connection to a specific Neo4j DBMS and database.
+This setting overrides a global driver setting.
+|===
+
+[NOTE]
+--
+When configuring access to a remote DBMS, make sure that the remote is configured to advertise its address correctly, using either xref:reference/configuration-settings.adoc#config_dbms.default_advertised_address[`dbms.default_advertised_address`] or xref:reference/configuration-settings.adoc#config_dbms.connector.bolt.advertised_address[`dbms.connector.bolt.advertised_address`].
+Fabric reads the routing table from the remote DBMS and then connects back using an appropriate entry in that table.
+--
+
+=== Drivers settings
+
+Fabric uses the Neo4j Java driver to connect to and access the data stored in Neo4j databases associated to Fabric graphs.
+This section presents the most important parameters available to configure the driver.
+
+Drivers settings are configured with parameters with names of the format:
+
+`fabric.driver.<suffix>`
+
+A setting can be global, i.e. be valid for all the drivers used in Fabric, or it can be specific for a given connection to a Neo4j database associated to a graph.
+The graph-specific setting overrides the global configuration for that graph.
+
+.Global drivers setting versus graph-specific drivers setting
+====
+A drivers setting for Fabric as the following is valid for all the connections established with the Neo4j DBMSs set in Fabric:
+
+[source, properties]
+----
+fabric.driver.api=RX
+----
+
+A graph-specific connection for the database with `ID=6` will override the `fabric.driver.api` setting for that database:
+
+[source, properties]
+----
+fabric.graph.6.driver.api=ASYNC
+----
+====
+
+[cols="1,2a", options="header"]
+.Fabric drivers setting suffixes
+|===
+| Parameter suffix
+| Explanation
+| `ssl_enabled`
+| SSL for Fabric drivers is configured using the `fabric` SSL policy.
+This setting can be used to instruct the driver not to use SSL even though the `fabric` SSL policy is configured.
+The driver will use SSL if the `fabric` SSL policy is configured, and this setting is set to `true`.
+This parameter can only be used in `fabric.graph.<graph ID>.driver.ssl_enabled` and not `fabric.driver.ssl_enabled`.
+
+| `xref:reference/configuration-settings.adoc#config_fabric.driver.api[api]`
+|Determine which driver API to be used.
+Supported values are `RX` and `ASYNC`.
+
+|===
+
+[NOTE]
+--
+Most driver options described in _Configuration_ in the link:{neo4j-docs-base-uri}[Neo4j Driver manuals] have an equivalent in Fabric configuration.
+--