Skip to content

Commit 4999f6b

Browse files
Update descriptions of the initial. settings
1 parent 657fc5e commit 4999f6b

File tree

1 file changed

+11
-13
lines changed

1 file changed

+11
-13
lines changed

modules/ROOT/pages/configuration/configuration-settings.adoc

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -775,7 +775,7 @@ m|+++20m+++
775775
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
776776
|===
777777
|Description
778-
a|Automatically enable free servers.
778+
a|Automatically enables all `Free` servers when the DBMS starts for the first time.
779779
|Valid values
780780
a|A boolean.
781781
|Default value
@@ -791,7 +791,7 @@ m|+++false+++
791791
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
792792
|===
793793
|Description
794-
a|The initial default number of primary servers for the standard databases. If the user does not specify the number of primaries in `CREATE DATABASE`, this value will be used unless overwritten by the `dbms.setDefaultAllocationNumbers` procedure.
794+
a|The initial default number of primary servers for the standard databases. Initialized at the first DBMS startup. If the user does not specify the number of primaries in `CREATE DATABASE`, this value will be used unless overwritten by the `dbms.setDefaultAllocationNumbers` procedure.
795795
|Valid values
796796
a|An integer that is minimum `1` and is maximum `11`.
797797
|Default value
@@ -807,7 +807,7 @@ m|+++1+++
807807
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
808808
|===
809809
|Description
810-
a|The initial default number of secondary servers for standard databases. If the user does not specify the number of secondaries in `CREATE DATABASE`, this value will be used unless overwritten by the `dbms.setDefaultAllocationNumbers` procedure.
810+
a|The initial default number of secondary servers for standard databases. Initialized at the first DBMS startup. If the user does not specify the number of secondaries in `CREATE DATABASE`, this value will be used unless overwritten by the `dbms.setDefaultAllocationNumbers` procedure.
811811
|Valid values
812812
a|An integer that is minimum `0` and is maximum `20`.
813813
|Default value
@@ -823,7 +823,7 @@ m|+++0+++
823823
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
824824
|===
825825
|Description
826-
a|Names of the databases allowed on this server; all others are denied. Empty means all are allowed. This configuration can be overridden when enabling the server or altered at runtime without changing this setting. Exclusive with `server.initial_denied_databases`.
826+
a|List of database names allowed on this server; all others are denied. Empty means all are allowed. This configuration is initialized at the first DBMS startup and/or when a newly added server is enabled. The setting is used as the default input for the `ENABLE SERVER` command; can be overriden when the command is executed. Exclusive with `server.initial_denied_databases`.
827827
|Valid values
828828
a|A comma-separated set where each element is a valid database name containing only alphabetic characters, numbers, dots, and dashes with a length between 3 and 63 characters, starting with an alphabetic character or number but not with the name `system`.
829829
|Default value
@@ -839,7 +839,7 @@ m|++++++
839839
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
840840
|===
841841
|Description
842-
a|Names of the databases not allowed on this server. Empty means nothing is denied. This configuration can be overridden when enabling the server or altered at runtime without changing this setting. Exclusive with `server.initial_allowed_databases`.
842+
a|List of database names not allowed on this server. Empty means nothing is denied. This configuration is initialized at the first DBMS startup and/or when a newly added server is enabled. The setting is used as the default input for the `ENABLE SERVER` command; can be overriden when the command is executed. Exclusive with `server.initial_allowed_databases`.
843843
|Valid values
844844
a|A comma-separated set where each element is a valid database name containing only alphabetic characters, numbers, dots, and dashes with a length between 3 and 63 characters, starting with an alphabetic character or number but not with the name `system`.
845845
|Default value
@@ -855,7 +855,7 @@ m|++++++
855855
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
856856
|===
857857
|Description
858-
a|An server can restrict itself to allow databases to be hosted only as primaries or secondaries. This setting is the default input for the `ENABLE SERVER` command - the user can overwrite it when executing the command.
858+
a|Specifies whether the server can host databases as primaries, secondaries, or neither. Initialized at the first DBMS startup and/or when a newly added server is enabled. The setting is used as the default input for the `ENABLE SERVER` command; can be overriden when the command is executed.
859859
|Valid values
860860
a|One of [PRIMARY, SECONDARY, NONE].
861861
|Default value
@@ -871,7 +871,7 @@ m|+++NONE+++
871871
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
872872
|===
873873
|Description
874-
a|A list of tag names for the server used by the database allocation and when configuring load balancing and replication policies. This setting is the default input for the `ENABLE SERVER` command - the user can overwrite it when executing the command.
874+
a|A list of server tag names used by the database allocation and when configuring load balancing and replication policies. Initialized at the first DBMS startup and/or when a newly added server is enabled. The setting is used as the default input for the `ENABLE SERVER` command; can be overriden when the command is executed.
875875
|Valid values
876876
a|A comma-separated list where each element is a string identifying a server tag, which contains no duplicate items.
877877
|Default value
@@ -2297,13 +2297,11 @@ The DBMS settings must be consistent across all configuration files in a cluster
22972297
[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
22982298
|===
22992299
|Description
2300-
a|Name of the default database. +
2301-
NOTE: This setting is not the same as `dbms.default_database`, which was used to set the default database in Neo4j 4.x and earlier versions.
2302-
2303-
The `initial.dbms.default_database` setting is meant to set the default database *before* the creation of the DBMS.
2304-
Once it is created, the setting is not valid anymore.
2300+
a|Specifies the default database name *before* the first DBMS startup.
2301+
Once the initial default database is created, the setting is not valid anymore.
2302+
To change the default database, use the xref:/clustering/databases.adoc#cluster-default-database[`dbms.setDefaultDatabase()`] procedure instead.
23052303

2306-
To set the default database, use the xref:/clustering/databases.adoc#cluster-default-database[`dbms.setDefaultDatabase()`] procedure instead.
2304+
NOTE: This setting is not the same as `dbms.default_database`, which was used to set the default database in Neo4j 4.x and earlier versions.
23072305
|Valid values
23082306
a|A valid database name containing only alphabetic characters, numbers, dots, and dashes with a length between 3 and 63 characters, starting with an alphabetic character or number but not with the name system.
23092307
|Default value

0 commit comments

Comments
 (0)