Skip to content

Commit 6d1a14f

Browse files
Add enterprise label to the page Error handling (#2721)
This PR partly copies the PR #2691
1 parent bab8d51 commit 6d1a14f

File tree

1 file changed

+9
-10
lines changed
  • modules/ROOT/pages/database-administration/standard-databases

1 file changed

+9
-10
lines changed

modules/ROOT/pages/database-administration/standard-databases/errors.adoc

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
:description: This section describes how to manage errors that you may encounter while managing databases.
22
:page-aliases: manage-databases/errors.adoc
3+
:page-role: enterprise-edition
34
[[manage-database-errors]]
45
= Error handling
56

@@ -11,8 +12,8 @@ When running the database management queries, such as `CREATE DATABASE`, it is p
1112
Because database management operations are performed asynchronously, these errors may not be returned immediately upon query execution.
1213
Instead, you must monitor the output from the `SHOW DATABASE` command; particularly the `statusMessage` and `currentStatus` columns.
1314

14-
.Fail to create a database
15-
====
15+
=== Fail to create a database
16+
1617
[source, cypher]
1718
----
1819
neo4j@system> CREATE DATABASE foo;
@@ -51,7 +52,6 @@ In a cluster:
5152
5253
3 row available after 100 ms, consumed after another 6 ms
5354
----
54-
====
5555

5656

5757
[[database-management-states]]
@@ -91,8 +91,8 @@ However, these retries are not guaranteed to succeed, and errors may persist thr
9191
If a database is in the `quarantined` state, retrying the last operation will not work.
9292
====
9393

94-
.Retry to start a database
95-
====
94+
=== Retry to start a database
95+
9696
[source, cypher]
9797
----
9898
neo4j@system> START DATABASE foo;
@@ -146,7 +146,6 @@ neo4j@system> SHOW DATABASE foo;
146146
147147
1 rows available after 4 ms, consumed after another 1 ms
148148
----
149-
====
150149

151150
If repeated retries of a command have no effect, or if a database is in a `dirty` state, you may drop and recreate the database, as detailed in xref:database-administration/standard-databases/create-databases.adoc[Create database].
152151

@@ -162,7 +161,7 @@ It produces a database dump that can be further examined and potentially repaire
162161

163162
There are two ways to get a database into a `quarantined` state:
164163

165-
* By using the xref:procedures.adoc#procedure_dbms_quarantineDatabase[`dbms.quarantineDatabase`] procedure locally to isolate a specific database.
164+
* By using the xref:procedures.adoc#procedure_dbms_quarantineDatabase[`dbms.quarantineDatabase()`] procedure locally to isolate a specific database.
166165
The procedure must be executed on the instance whose copy of the database you want to quarantine.
167166
A reason for that can be, for example, when a database is unable to start on a given instance due to a file system permissions issue with the volume where the database is located or when a recently started database begins to log errors.
168167
The quarantine state renders the database inaccessible on that instance and prevents its state from being changed, for example, with the `START DATABASE` command.
@@ -210,7 +209,7 @@ The result contains the user, the time, and the reason for the quarantine.
210209

211210
[NOTE]
212211
====
213-
The `dbms.quarantineDatabase` procedure replaces link:{neo4j-docs-base-uri}/operations-manual/4.4/reference/procedures/#procedure_dbms_cluster_quarantinedatabase[`dbms.cluster.quarantineDatabase()`], which has been deprecated in Neo4j 4.3 and will be removed with the next major version.
212+
The `dbms.quarantineDatabase()` procedure replaces link:{neo4j-docs-base-uri}/operations-manual/4.4/reference/procedures/#procedure_dbms_cluster_quarantinedatabase[`dbms.cluster.quarantineDatabase()`], which has been deprecated in Neo4j 4.3 and will be removed with the next major version.
214213
====
215214

216215
.Quarantine a database
@@ -250,8 +249,8 @@ neo4j@system> SHOW DATABASE foo;
250249
[NOTE]
251250
====
252251
A `quarantined` state is persisted for user databases.
253-
This means that if a database is quarantined, it will remain so even if that Neo4j instance is restarted.
254-
You can remove it only by running the xref:procedures.adoc#procedure_dbms_quarantineDatabase[`dbms.quarantineDatabase`] procedure on the instance where the quarantined database is located, passing `false` for the `setStatus` parameter.
252+
This means that if a database is quarantined, it will remain so even if the Neo4j process is restarted.
253+
You can remove it only by running the xref:procedures.adoc#procedure_dbms_quarantineDatabase[`dbms.quarantineDatabase()`] procedure on the instance where the quarantined database is located, passing `false` for the `setStatus` parameter.
255254
256255
The one exception to this rule is for the built-in `system` database.
257256
Any quarantine for that database is removed automatically after instance restart.

0 commit comments

Comments
 (0)