ADMIN Messages
- Last Updated: September 10, 2026
- 15 minute read
- MarkLogic Server
- Version 12.0
- Documentation
ADMIN-ALREADYREPLICA
Message Text
Forest variable1 is already a replica of forest variable2
Cause
This forest is already a replica.
Response
This forest is already a replica. You do not need to do anything.
ADMIN-ATTACHSHAREDDISKFAILOVER
Message Text
Forest variable1 is configured for shared disk fail-over and can't be attached to a database which is configured for database replication.
Cause
Tried to attach a forest to a database that is configured for database replication and the forest is already configured for shared disk failover.
Response
Either remove shared disk failover and use the forest for database replication or use a different forest for database replication.
ADMIN-BADCERTTEMPLATE
Message Text
'variable1' is not a valid certificate template id
Cause
Specified SSL certificate template is not valid.
Response
Specify a valid SSL certificate template id. You can use functions like pki:template-get-id and pki:get-template-by-name to get the correct template id.
ADMIN-BADCUSTOMFIELD
Message Text
Bad field for custom tokenization: the word field may not have tokenizer overrides
Cause
Tokenizer overrides are only allowed on named fields.
Response
Apply the override to a named field.
ADMIN-BADFIELDTYPE
Message Text
Incorrect field: The field variable1 already has a field-path.
Cause
Setting include-document-root is not allowed on path-fields.
Response
Do not set include-root on the field.
ADMIN-BADOVERRIDE
Message Text
Bad tokenizer override: override of 'variable1' to 'variable2' is invalid
Cause
The override character consists of multiple codepoints, or codepoints in the surrogate character range, or codepoints that are combining characters (Unicode Mn).
Response
Choose a different override character.
ADMIN-BADPATH
Message Text
Path expression variable1 is not indexable.
Cause
One or more of the index path expressions have incorrect XPath syntax.
Response
Make sure that only allowed XPath syntax is used in the index path expressions.
ADMIN-BADPATHFIELDTYPE
Message Text
Incorrect field: the field variable1 already has include-root.
Cause
Setting field-paths is not allowed on non-path-fields.
Response
Do not set field-paths on the field.
ADMIN-BADPATHNAMESPACE
Message Text
Undefined path namespace(s): variable1.
Cause
One or more of the namespace prefixes used in index path expression are not defined.
Response
Define all the path namespaces before using them in index path expressions.
ADMIN-BADPATHWEIGHT
Message Text
Negative path weight variable1 is not allowed.
Cause
One or more of the index paths have negative weight.
Response
Make sure that all index paths have zero or positive weights.
ADMIN-CANNOTCHANGEPORT
Message Text
Cannot change port of remote host
ADMIN-CANNOTRETIRE
Message Text
Forest variable1 is variable2.
Cause
Forests that are read-only or offline cannot be retired.
Response
Forests that are read-only or offline cannot be retired. Select a different forest.
ADMIN-CLUSTERUNIQ
Message Text
Foreign Cluster IDs have to be unique.
Cause
Tried to couple a foreign cluster which is already coupled.
Response
Decouple the foreign cluster before coupling with it again.
ADMIN-CONFIGNOTSAVED
Message Text
Configuration must be saved before variable1
Cause
Configuration is not saved.
Response
Save configuration prior to the error point.
ADMIN-CONFLICTFAILOVER
Message Text
Cannot configure both failover hosts and forest replicas on the same forest
Cause
Tried to enable local disk and shared disk failover on the same forest.
Response
MarkLogic does not support local disk failover and shared disk failover simultaneously on the same forest. You must choose only one of the two options.
ADMIN-CONFLICTINGELEMENTS
Message Text
Cannot have included and excluded elements with same QName and attribute constraints
Cause
Cannot have included and excluded elements with same QName and attribute constraints.
Response
An element with attribute constraint can be included or excluded, but not both.
ADMIN-DATABASEDUPREPLICA
Message Text
Database has duplicate foreign replica databases: variable1
Cause
Local master database might have already been attached to the foreign replica database that you are trying to attach to.
Response
Remove database replication configuration on both master and replica.
ADMIN-DATABASEFORESTATTACHED
Message Text
Forest variable1 is attached to a database
Cause
Attempted to attach to a different database a forest that is already attached to a database.
Response
Look in the Admin UI to see what database has the forest attached and take appropriate actions.
ADMIN-DATABASEFORESTNOTATTACHED
Message Text
Forest variable1 is not attached to database variable2
ADMIN-DATABASEINUSE
Message Text
variable1
Cause
Attempted to delete a database that has in-flight transactions.
Response
Wait for the in-flight transactions to finish, then retry.
ADMIN-DATABASEMASTERANDREPLICA
Message Text
Cannot configure database as both master and replica: variable1
Cause
Cannot configure database as both master and replica.
Response
Configure database as either a master or a replica.
ADMIN-DBNOTQUERYPOLICY
Message Text
Assignment policy is not a query policy, on database: variable1
Cause
The assignment policy on the database is not a query policy.
Response
Check your database configuration and make sure it uses the query policy before calling this function.
ADMIN-DBNOTRANGEPOLICY
Message Text
Assignment policy is not a range policy, on database: variable1
Cause
The assignment policy on the database is not a range policy.
Response
Check your database configuration and make sure it uses the range policy before calling this function.
ADMIN-DBREPLAGLIMIT
Message Text
Database replication lag limit must be at least 5 seconds: variable1
Cause
Tried to set the lag limit for database replication to any value less than 5.
Response
Set the lag limit on database replication to at least 5
ADMIN-DBREPQUEUESIZE
Message Text
Database replication queue size must be in the range 1:1000: variable1
Cause
Tried to set the queue size for database replication to an invalid value.
Response
Set the queue size for database replication to a value in the range 1:1000
ADMIN-DBREPSCHEMADBSAMEASDB
Message Text
Cannot setup replication for a database (variable1) whose schema database is itself.
Cause
Tried to setup database replication for a database whose schema database is itself.
Response
Do not attempt to setup database replication for a database whose schema database is itself.
ADMIN-DELETEMASTERTOO
Message Text
Cannot delete replica forest variable1 unless it is detached from its master
Cause
Cannot delete a replica forest unless it is detached from its master.
Response
Detach the replica forest from its master and try again.
ADMIN-DELETEREPLICATOO
Message Text
Cannot delete forest variable1 unless replica forest variable2 is detached or also deleted
Cause
Cannot delete forest unless its replica forest variable2 is detached or also deleted.
Response
Detach or delete replica forest.
ADMIN-DEPENDINGSCHEDULEDTASKS
Message Text
There are depend tasks on the host or the associated group. Delete those first before moving host variable1 to a new group.
Cause
Tried to move a host from one group to another without first deleting that host's existing schedule tasks.
Response
Delete the scheduled tasks on a host before you change the group on that host.
ADMIN-DUPINDEXEXCLUDEDPATH
Message Text
The index excluded path already exists variable1.
Cause
The index excluded path already exists.
Response
Set a valid index excluded path as instructed by the error text.
ADMIN-DUPLICATECONFIGITEM
Message Text
Database resource 'variable2' already contains 'variable1'
Cause
Config item already exists.
Response
Check that this was really the item you wanted to duplicate, otherwise do not duplicate it in the configuration.
ADMIN-DUPLICATEITEM
Message Text
variable1 already exists
Cause
Item already exists.
Response
Item already exists.
ADMIN-DUPLICATENAME
Message Text
variable1 already exists
Cause
Name already exists.
Response
Use a different name.
ADMIN-DUPLICATESCHEDULEDTASKIDS
Message Text
Duplicate scheduled task ids.: %s
Cause
Tried to configure a group with multiple scheduled tasks with the same ID.
Response
Do not try to add the same task more than once.
ADMIN-EMPTYEXTERNALSECURITY
Message Text
If internal security is disabled, an external security must be specified.
Cause
Both internal security and external security are not set
Response
Either enable internal security or specify an external security.
ADMIN-EMPTYNSPREFIX
Message Text
Namespace prefix must not be empty.
Cause
Namespace prefix must not be empty.
Response
Empty ns prefix is not allowed. Use a non-empty prefix.
ADMIN-EMPTYNSURI
Message Text
Namespace uri must not be empty.
Cause
Namespace uri must not be empty.
Response
Empty ns uri is not allowed. Use a legal uri.
ADMIN-EMPTYPATH
Message Text
Empty path on a field is not allowed.
Cause
One or more of the index paths are empty strings.
Response
Make sure that all index paths are valid indexable paths.
ADMIN-ENCRYPTIONDISABLED
Message Text
One or more encryption key IDs are invalid or do not exist in the Keystore Management System. variable1
Cause
Cannot validate the key encryption key provided
Response
Verify your key encryption keys and try again
ADMIN-FAILOVERANDBREP
Message Text
Forest variable1 is attached to a database which is enabled for database replication. Both can't be configured at the same time.
Cause
Tried to configure a forest for failover when the same forest is already configured for database replication.
Response
You can release the forest from database replication configuration or use a different forest for failover. You cannot use the same forest for both of these.
ADMIN-FAILOVERANDFORESTOVERRIDE
Message Text
Forest variable1 has a forest override and can not be configured for shared disk fail-over.
Cause
Tried to enable shared disk failover on a forest already configured for DB replication.
Response
MarkLogic does not support DB replication combined with shared disk failover at this time. Try using local disk failover with DB replication.
ADMIN-FIPSANDTLS
Message Text
When fips is enabled, "xdqp ssl allow tls" cannot be set to false.
ADMIN-FOREIGNCLUSTERDEPENDENCIES
Message Text
Foreign cluster variable1 can not be deleted as there are database replication dependencies. Delete replication settings for foreign replica and foreign master databases first.
Cause
There might be an existing database replication configuration with the foreign database being in the cluster you are trying to delete.
Response
Delete database replication with all the databases which are in the foreign cluster that you want to delete.
ADMIN-FOREIGNDATABASESDEPENDENCIES
Message Text
Foreign cluster variable1 can not be deleted as there are foreign database dependencies. Delete foreign databases for this cluster first.
Cause
Foreign cluster has foreign database dependencies.
Response
Delete the foreign databases dependencies for this cluster then try again.
ADMIN-FOREIGNDBEXISTS
Message Text
Foreign db already exists variable1
Cause
The foreign db is already in this database.
Response
Correct your code so that you don't re-add the foreign db.
ADMIN-FOREIGNDBITSELF
Message Text
Cannot add itself as foreign db variable1
Cause
A database tries to add itself as its foreign database.
Response
Choose a database in a different cluster to be the foreign database.
ADMIN-FOREIGNMASTERDEPENDENCIES
Message Text
Foreign master configuration can not be deleted for database variable1 as there are forest overrides. Delete foreign master forest overrides first.
Cause
Foreign master configuration can not be deleted for the database as there are forest overrides.
Response
Delete foreign master forest overrides and try again.
ADMIN-FOREIGNMASTERINVALIDCLUSTERID
Message Text
Invalid foreign cluster id variable1 specified in foreign master configuration. Cluster is unknown.
Cause
Cannot find foreign cluster by that id.
Response
Check foreign cluster id for misspelling and that the cluster was created and try again.
ADMIN-FOREIGNMASTERNODBSETTINGS
Message Text
No foreign master settings for database variable1 configured.
ADMIN-FOREIGNMASTERWRONGDATABASEID
Message Text
Invalid foreign database id. Foreign database for forest override should be variable1.
ADMIN-FOREIGNREPICAINVALID
Message Text
Can not override forest mapping. Check database replication settings on the database level. Verify foreign database id and foreign cluster id.
ADMIN-FOREIGNREPLICADEPENDENCIES
Message Text
Foreign replica configuration can not be deleted for database variable1 as there are forest overrides. Delete foreign replica forest overrides first.
Cause
When you configure database replication, you can either let the forests map by their names or hand pick the forests on the master and replica and map them. The latter method is nothing but configuring forest overrides. This error is seen when you configure database replication with forest overrides and later try to remove the database replication configuration without removing the forest mapping.
Response
Remove the forest overrides, i.e. remove mappings between master and replica forests that were hand-picked while configuring, and then try to remove database replication configuration again.
ADMIN-FOREIGNREPLICAINVALIDCLUSTERID
Message Text
At least one invalid cluster id specified in foreign replica configuration. Cluster variable1 is unknown.
Cause
The cluster id you have provided for the foreign replica database is not recognized, possibly because the local and remote clusters are not coupled yet.
Response
Check whether the foreign cluster is coupled with the local cluster and try again.
ADMIN-FORESTDISABLED
Message Text
Forest variable1 is currently disabled
ADMIN-FORESTDUPREPLICA
Message Text
Forest has duplicate foreign replica database forests: variable1
ADMIN-FORESTHASOVERRIDE
Message Text
Forest variable1 has manual forest override for database replication. First delete foreign replicas or foreign master settings for this forest.
ADMIN-FORESTMASTERANDREPLICA
Message Text
Cannot configure forest as both master and replica: variable1
ADMIN-FORESTNOTATTACHED
Message Text
Forest variable1 is not attached to a database.
ADMIN-FORESTOFFLINE
Message Text
Forest variable1 is currently offline
ADMIN-FORESTSNOTMATCH
Message Text
The number of forests doesn't match what the database currently has.
Cause
The number of forests passed in doesn't match the number of forests the database currently has.
Response
Correct your code.
ADMIN-FORESTUNMOUNTED
Message Text
Forest variable1 is currently unmounted
ADMIN-ILLEGALNSPREFIX
Message Text
Namespace prefix "xml" is reserved, Try different prefix.
Cause
Namespace prefix "xml" is reserved. It cannot be re-defined.
Response
"xml" is a reserved namespace prefix. Try different prefix.
ADMIN-INVALIDAUTHENTICATION
Message Text
If an external security is specified, authentication must be either application-level, basic, certificate or kerberos-ticket.
ADMIN-INVALIDBACKGROUNDIOLIMIT
Message Text
Invalid background IO limit: variable1
Cause
Attempted to set an invalid background IO limit for a host
Response
Choose a valid background IO limit.
ADMIN-INVALIDCONFIG
Message Text
Invalid configuration: variable1
Cause
Attempted to save a configuration with invalid structure or elements.
Response
Examine the configuration to find invalid elements. Consider using functions that create the elements you are trying to add.
ADMIN-INVALIDDBREPDELETE
Message Text
Deleting database replication configuration failed related to mismatch of foreign-replica elements.
ADMIN-INVALIDDBREPTYPE
Message Text
Invalid database-replication type.
ADMIN-INVALIDFAILOVERHOST
Message Text
The primary and failover host can not be identical for forest variable1.
Cause
Tried to use same d-node as both primary and failover host for a shared disk failover enabled forest.
Response
When you enable shared disk failover on a forest, the primary and failover hosts need to be different d-nodes in the cluster.
ADMIN-INVALIDFIELDNAME
Message Text
Field name cannot be empty
Cause
User has defined a field with an empty field name.
Response
Add a field name to the field definition.
ADMIN-INVALIDHOST
Message Text
Host id is not valid
Cause
Invalid host id.
Response
Check host id for misspellings and that it was created and try again.
ADMIN-INVALIDKEYID
Message Text
Key with ID "variable1" does not exist in the Keystore Management System or cannot be used. variable2
ADMIN-INVALIDKEYSTORECONFIG
Message Text
The Keystore configuration is incorrect
Cause
There was an error while initializing the keystore
Response
Look at the logs for details on the error
ADMIN-INVALIDPERIODNAME
Message Text
Period name cannot be empty
Cause
User has defined a period with an empty period name.
Response
Add an period name to the period definition.
ADMIN-INVALIDPORT
Message Text
Port variable1 is not valid or bindable
Cause
Port is invalid or not bindable.
Response
Check port for correct number and bindable status and try again.
ADMIN-INVALIDPROTOCOL
Message Text
Invalid Protocol: variable1. It must be either SSLv3, TLSv1, TSLv1_1 or TLSv1_2.
ADMIN-INVALIDSSLMINALLOWTLS
Message Text
Invalid min allow tls: variable1. It must be either "TLSv1.2" or "TLSv1.3".
Cause
ssl-min-allow-tls is either "TLSv1.2" or "TLSv1.3".
Response
Correct your code.
ADMIN-INVALIDTOKENDURATION
Message Text
The duration set for this token is not in the allowed range. The duration has to be a positive duration and the maximum allowed duration is variable1.
Cause
The duration set for this token is not in the allowed range.
Response
Set a valid duration as instructed by the error text.
ADMIN-JAPASSPHRASENOTALLOWED
Message Text
A backup passphrase cannot be used in combination with journal archiving
Cause
Journal archiving is set to true and passphrase is not empty
Response
Remove the passphrase or journal archiving option
ADMIN-JOURNALARCHIVEAUXDB
Message Text
Cannot specify auxiliary databases when enabling journal archiving.
Cause
Error occurs when you do a scheduled backup using admin apis, and you pass true as the value for both auxiliary databases and journal archiving.
Response
When doing a scheduled backup, select either journal archiving or auxiliary database as true, not both.
ADMIN-KERBEROSAUTHENTICATION
Message Text
If authentication is kerberos-ticket, the protocol in external security must be kerberos.
ADMIN-KERBEROSTICKET
Message Text
If authentication is kerberos-ticket, internal security must be disabled.
ADMIN-LICKEYREPL
Message Text
License key not valid for replication for host variable1
Cause
The license key you are using with the server is not valid to use for the database replication feature.
Response
Get a valid license and update the server with the new license key.
ADMIN-LOCALASFOREIGN
Message Text
Local cluster ( variable1 ) can't be a foreign cluster.
Cause
Tried to couple local cluster with itself.
Response
Check the hostname you provided while coupling the cluster. It should not be a host on the same cluster.
ADMIN-MINVERSIONREQUIRED
Message Text
variable1 cannot be used until the cluster is upgraded to effective version variable2.
Cause
The cluster has not been upgraded
Response
Complete the upgrade process
ADMIN-NOBOOTSTRAPHOSTCONFIGURED
Message Text
No bootstrap host configured on this cluster.
ADMIN-NOBOOTSTRAPHOSTONLINE
Message Text
No bootstrap host online.
Cause
No bootstrap host online.
Response
Check bootstrap host for being online, its id for misspellings, and that it was created and try again.
ADMIN-NOFOREIGNCLUSTER
Message Text
No foreign cluster with name variable1 found.
Cause
Could not find a foreign cluster with that name.
Response
Check foreign cluster for misspelling and that it was created and try again.
ADMIN-NOFOREIGNDB
Message Text
No foreign db variable1
Cause
Foreign db does not exist.
Response
Check for existence of foreign db (spelling, creation, etc.) and try again.
ADMIN-NOFOREIGNREPLICA
Message Text
No foreign replica database for database variable1 configured.
Cause
Tried to access foreign replica database attached to local master database, such as trying to delete the foreign replica.
Response
Remove stale database replication configuration (if any) and re-attach the foreign replica database.
ADMIN-NONEMPTYGROUP
Message Text
Group variable1 must have no assigned hosts before deleting
ADMIN-NOREPLCHAIN
Message Text
Replicas may not be chained: variable1
ADMIN-NOSUCHAPPSERVER
Message Text
No such appserver variable1
Cause
Appserver does not exist.
Response
Check appserver for misspellings and that it was created and try again.
ADMIN-NOSUCHDATABASE
Message Text
No such database variable1
Cause
Database does not exist.
Response
Check database for misspellings and that it was created and try again.
ADMIN-NOSUCHEXTERNALSECURITY
Message Text
No such external security variable1
Cause
External security does not exist
Response
Check external security and try again.
ADMIN-NOSUCHFIELD
Message Text
No such database field variable1
Cause
Database field does not exist.
Response
Check database field name for misspelling and that it was created in the database and try again.
ADMIN-NOSUCHFOREIGNCLUSTER
Message Text
No such foreign cluster variable1
Cause
Foreign cluster does not exist.
Response
Check foreign cluster for misspelling and that it was created and try again.
ADMIN-NOSUCHFOREST
Message Text
No such forest variable1
Cause
Forest does not exist.
Response
Check forest name for misspelling and that it was created and try again.
ADMIN-NOSUCHGROUP
Message Text
No such group variable1
Cause
Group does not exist.
Response
Check group and try again.
ADMIN-NOSUCHHOST
Message Text
No such host variable1
Cause
Host does not exist.
Response
Check host name for misspelling and that it was created and try again.
ADMIN-NOSUCHINDEXEXCLUDEDPATH
Message Text
The index excluded path does not exist variable1.
Cause
The index excluded path does not exist.
Response
Set a valid index excluded path as instructed by the error text.
ADMIN-NOSUCHITEM
Message Text
variable1 does not exist: variable2
Cause
Item does not exist.
Response
Check item for misspelling and that it was created and try again.
ADMIN-NOSUCHPERIOD
Message Text
No such database period variable1
Cause
Database period does not exist.
Response
Check database period id for misspelling and that it was created in the database and try again.
ADMIN-NOSUCHPRIVILEGE
Message Text
No such privilege variable1
Cause
Privilege does not exist.
Response
Check privilege for misspelling and that it was created and try again.
ADMIN-NOSUCHUSER
Message Text
No such user variable1
Cause
User does not exist
Response
Check user and try again.
ADMIN-NOTDYNAMICHOSTTOKEN
Message Text
This is not a dynamic host token variable1
Cause
The token provided is not a dynamic host token while trying to perform dynamic host token related operation.
Response
Make sure only supply dynamic host tokens to related operation.
ADMIN-NOTRANGEPOLICY
Message Text
The assignment policy passed in is not a range policy.
Cause
The assignment policy passed in is not a range policy.
Response
Correct your code so that you only pass in a range assignment policy to this function.
ADMIN-NOTREPLICA
Message Text
Forest variable1 is not a replica
Cause
This forest is not a replica.
Response
Retry operation on a replica forest.
ADMIN-NOTRIGGERDB
Message Text
No triggers database
ADMIN-PATHFIELDNOPATHS
Message Text
Invalid field change: Illegal to delete all paths on the field variable1.
Cause
A path field must have at least one field-path.
Response
Do not delete all the field-paths on the path field.
ADMIN-PATHNAMESPACEINUSE
Message Text
In-use database path namespaces cannot be deleted.: variable1
Cause
One or more of the path namespaces that are being deleted are in use in some index path expressions.
Response
Make sure that only those path namespaces are being deleted that are not in use by any path index.
ADMIN-PORTINUSE
Message Text
Port is currently in use
Cause
Port is currently in use.
Response
Try a different port.
ADMIN-PRIVATEFOREST
Message Text
Forest variable1 is private and cannot change hosts
Cause
Tried to change primary host of a private forest.
Response
Primary host can be changed only for public forests. You need to convert a private forest to public forest before you can change the primary host. Refer to the Failover guide for instructions on how to do this.
ADMIN-REDEFINEDNSPREFIX
Message Text
Namespace prefix must not be bound to two different uris.
Cause
Namespace prefix is already bound to another uri.
Response
Namespace prefix cannot be bound to two different uris. Use a different prefix or delete the earlier definition.
ADMIN-REDUNDANTOVERRIDE
Message Text
Redundant tokenizer override: variable1 is already in class variable2
Cause
The override character is already in the given class.
Response
Do not add the override; it is not necessary.
ADMIN-REPLICAFORESTSAMEHOST
Message Text
Replica forest may not be on the same host as its master: variable1 variable2
Cause
Replica forest may not be on the same host as its master.
Response
Move replica forest to a different host than its master.
ADMIN-SOMEFORESTSRETIRED
Message Text
Cannot reorder the forests when some of them are retired.
Cause
Some forests in the database are marked as retired.
Response
Detach those retired forests or correct your code.
ADMIN-SSLV3ORTLS
Message Text
both "xdqp ssl allow sslv3" and "xdqp ssl allow tls" cannot be set to false.
ADMIN-SWITCHTASKUSER
Message Text
Not permitted to switch task user: variable1
Cause
Tried to set task user as another user without privilege
Response
Use current user as task user or obtain privilege