Handling Exceptions

IGN-CMN-1

Operation was stopped because node is stopping.

Check that the cluster is up and running and try again.

IGN-CMN-2

Operation was stopped because the component is not started.

Wait for the node to complete the startup process and start all components.

IGN-CMN-3

Operation failed because an illegal argument or argument in a wrong format has been passed.

Check the exception message for additional information. Specific actions depend on the operation that triggered the error.

IGN-CMN-4

Operation failed because SSL could not be configured.

Check the exception message for more information and update the configuration.

IGN-CMN-5

Operation failed because a node has left the cluster.

Wait for the node to return to the cluster, or use a different node.

IGN-CMN-6

Operation failed because the cursor is already closed.

Check the exception message to find out why the cursor was closed before the operation.

IGN-CMN-7

An error occurred while closing resources.

Check the exception message to find out why the resource was closed before the operation.

IGN-CMN-8

An error occurred while marshalling or unmarshalling objects.

IGN-CMN-9

The method cannot return a null value.

IGN-CMN-65535

Internal error has occurred.

This an unexpected internal error in GridGain. In most cases, receiving it indicates a bug.

IGN-TBL-1

Table already exists.

Make sure to use the table name that does not exist on the cluster.

IGN-TBL-2

Table not found.

Check the table name and, if necessary, create it.

IGN-TBL-3

Column already exists.

Make sure to use the column name that does not exist in the table.

IGN-TBL-4

Column not found.

Check the column name and, if necessary, create it.

IGN-TBL-5

Table is currently stopping.

Wait for the table to stop before attempting more operations.

IGN-TBL-6

Table definition not correct.

Check the error message and verify the table definition.

IGN-TBL-7

Schema version mismatch.

The request uses a different schema than the table.

IGN-TBL-8

Partition type not supported.

Use a supported partition type.

IGN-CLIENT-1

Connection to client failed. This error is usually caused by incorrect address or connection timeout.

Check the exception message. If a timeout occurred, make sure the timeout values in client and server configurations allow for long-running requests.

IGN-CLIENT-2

An issue occurred with connection protocol. This error can be caused by using an incompatible client version or data corruption.

Check the exception message. If data corruption occurred, recover the data. If client versions are not compatible, use the correct client version.

IGN-CLIENT-3

Protocol version does not support a specific feature. Typically this is caused by version mismatch between client and server.

Update the client or the server to a newer version or do not use incompatible features.

IGN-CLIENT-4

Failed to find the table by ID.

Check if the table ID is correct.

IGN-CLIENT-5

An error occurred during authentication.

Check user credentials.

IGN-CLIENT-6

An error occurred during authorization.

Check the permissions of the user of the server.

IGN-CLIENT-7

An error occurred with client configuration.

Check the exception message for more information and fix the client configuration.

IGN-CLIENT-8

Cluster ID mismatch. This error can be caused by the client connecting to multiple different clusters.

Check client configuration to make sure all endpoints belong to the same cluster.

IGN-CLIENT-9

Client SSL configuration is not valid.

Check the exception message for more information. Make sure SSL configuration matches server-side configuration.

IGN-CLIENT-10

Client handshake message error. This is usually caused by the client trying to connect to a wrong endpoint (for example, REST) or a non-GridGain process is trying to connect to a GridGain endpoint.

Check the exception message for more information. If the issue is with client, check and fix client configuration. If a third-party client is trying to connect, check what it is and fix the configuration.

IGN-SQL-1

Exception is thrown when a query doesn’t intend to return any rows (for example, a DML or a DDL query).

Change the request to not expect the result from the query.

IGN-SQL-2

Exception is thrown when the specified schema cannot be found.

Make sure you use the existing schema name.

IGN-SQL-3

Statement parsing error. This error is returned when an SQL statement string is not valid according to syntax rules.

Check the exception message and correct issues in the query.

IGN-SQL-4

Statement validation error. Although statement is grammatically correct, the semantic is in question. For example, this can happen when the statement refers to relations that do not exist or describes a prohibited action.

Check the exception message and correct the query.

IGN-SQL-5

Constraint violation error such as primary key violation or NOT NULL.

Check the exception message and correct the query.

IGN-SQL-6

Statement canceled error. Statement is canceled due to timeout, admin action, etc.

Check the exception message to find out the specific reason.

IGN-SQL-7

Runtime error. Errors caused by programming errors in SQL statement itself, such errors happen during statement execution. For example, this can be caused by numeric overflow errors or type conversion errors.

Check the exception message and fix the issue.

IGN-SQL-8

SQL engine was unable to map query on current cluster topology. This may be due to a variety of reasons, but most probably because of all nodes hosting certain system view or a table partition went offline.

Check the exception message. In most scenarios, you can rerun the query when the cluster is stable.

IGN-SQL-9

Execution of transaction control statement inside an external transaction is forbidden.

Do not use transaction control statements like BEGIN TRANSACTION or COMMIT in external transactions, including JDBC with disabled autocommit mode.

IGN-IDX-1

Invalid index definition.

Check the error message. There is an issue in the way index is specified.

IGN-IDX-2

Failed to find the specified index.

Make sure the index exists.

IGN-IDX-3

Specified index already exists.

Make sure the index does not exist when creating it.

IGN-TX-1

Default error for transaction state storage.

IGN-TX-2

Transaction state storage is stopped.

IGN-TX-3

Unexpected transaction state on state change.

IGN-TX-4

Failed to acquire a lock on a key due to a conflict.

IGN-TX-5

Failed to acquire a lock on a key within the timeout.

IGN-TX-6

Failed to commit a transaction.

IGN-TX-7

Failed to roll back a transaction.

IGN-TX-8

Failed to put read-write operation into read-only transaction.

IGN-TX-9

Replica is not ready to handle a request.

IGN-TX-10

Transaction state storage rebalancing error.

IGN-TX-11

Failed to create a read-only transaction with a timestamp older than the data available in the tables.

IGN-TX-12

Failure due to an incompatible schema change.

IGN-TX-13

Failure due to primary replica expiration.

IGN-TX-14

Transaction already finished.

IGN-TX-15

Failure due to a stale operation of a completed transaction.

IGN-TX-16

Failure due to cache operations enlisted into table transaction or vice versa.

IGN-REP-1

Default error for the replication procedure.

IGN-REP-2

Replica with the same identifier already exists.

IGN-REP-3

Timeout has occurred during the replication procedure.

IGN-REP-4

The replication level tried to handle an unsupported request.

IGN-REP-5

Replica is not ready to handle the request.

IGN-REP-6

Replica is not the current primary replica.

IGN-REP-7

Failed to close cursor.

IGN-REP-8

Replica is already stopping.

IGN-REP-9

Replication safe time reordering.

IGN-STORAGE-1

A disaster has occurred, followed by an attempt to recover from the disaster. This caused inconsistent index state in the cluster metadata.

Wait until the index is rebuilt automatically.

IGN-STORAGE-2

A disaster has occurred, which led to data corruption in the persistent storage.

Restore the data from a backup or introduce a new node instead of the broken one (this may lead to data loss if the replication factor is too low).

IGN-DISTRZONES-1

Distribution zone is not found.

Check the distribution zone name used. Most likely, it is incorrect.

IGN-NETWORK-1

The node with the specified ID is not in the physical topology.

Check the error message and node ID. Update node ID if it is incorrect. If the node is offline, check why and bring it back online.

IGN-NETWORK-2

Port is already in use.

Most likely, GridGain tried to access the port occupied by a different process. Change the port or free it, and then restart the node.

IGN-NETWORK-5

Recipient node has left the physical topology.

Check the error message. The node is unavailable and need to be brought back into the cluster.

IGN-NETWORK-6

Could not resolve address. Most likely, the IP address specified in the operation is not available locally.

Change the node configuration to make the address available or use a different IP address.

IGN-NODECFG-1

Failed to read configuration.

Make sure that the node has access to the configuration file.

IGN-NODECFG-2

Failed to create a configuration file.

Check if the node has write permissions to the folder where configuration is.

IGN-NODECFG-3

Failed to write configuration.

Check if the node has write permissions to the folder where configuration is.

IGN-NODECFG-4

Failed to parse configuration.

Make sure the configuration file is correct.

IGN-CODEDEPLOY-1

Access attempt to a non-existing deployment unit.

Make sure the deployment unit is specified correctly.

IGN-CODEDEPLOY-2

Duplicate deployment unit.

Make sure deployment unit is unique. Update deployment unit name or version.

IGN-CODEDEPLOY-3

Deployment unit content read error.

Check the error message for details.

IGN-CODEDEPLOY-4

Deployment unit is unavailable for computing.

Check the error message for details.

IGN-AUTHENTICATION-1

Authentication error caused by unsupported authentication type.

Check the client configuration and use the supported configuration type.

IGN-AUTHENTICATION-2

Authentication error caused by invalid credentials.

Check and correct user credentials.

IGN-AUTHENTICATION-3

Basic authentication provider is not found.

Configure basic authentication provider.

IGN-COMPUTE-1

Classpath error.

Check the exception message for additional information and fix the classpath error.

IGN-COMPUTE-2

Class loader error.

Most likely, this is caused by an internal error in GridGain.

IGN-COMPUTE-3

Failed to initialize the job class.

Check the exception message for more information.

IGN-COMPUTE-4

Execution queue overflow.

Increase the compute.queueMaxSize configuration parameter to allow for larger queue.

IGN-COMPUTE-5

Compute job status transition error.

Retry the operation or check job status.

IGN-COMPUTE-6

Failed to cancel compute job.

Check the error message and fix the issue in it.

IGN-COMPUTE-7

Compute job result not found.

Make sure the specified job ID exists.

IGN-COMPUTE-8

Compute job state cannot be retrieved.

Make sure the specified job ID exists. If it does, check the node logs for additional information.

IGN-COMPUTE-9

Compute job failed.

Check the exception message for more information on the reason for failure.

IGN-COMPUTE-10

Failed to change job priority, because compute job was not found.

Make sure the specified job ID exists.

IGN-COMPUTE-11

Failed to change job priority, because compute job is already executing.

Wait for the job to finish before changing priority.

IGN-COMPUTE-12

Failed to resolve primary replica for colocated execution.

Check the exception message for additional information.

IGN-COMPUTE-13

Failed to change job priority.

Check the exception message for additional information.

IGN-COMPUTE-14

Specified node is not found in the cluster.

Make sure the specified node ID is correct and the node with the ID is in the cluster.

IGN-COMPUTE-15

Compute job owner cannot be retrieved.

Check the exception message for additional information and make sure that job owner is correct.

IGN-CATALOG-1

Command to the catalog has not passed the validation.

See the exception message for details. Typically, this is either caused by incorrect DDL query (same as IGN-SQL-4) or an internal GridGain error.

IGN-WORKERS-1

System worker does not update its heartbeat for a long time. Typically, this means that the node has stalled or is running slowly.

Restart the node.

IGN-WORKERS-2

System-critical operation timed out.

Restart the node.

IGN-RECOVERY-1

Partition ID is not in valid range.

Check the exception message. Most likely, the specified partition ID is not correct.

IGN-RECOVERY-2

Nodes were not found.

Check the exception message. Most likely, the specified node ID is not correct.

IGN-RECOVERY-3

Failed to recover partition states.

Retry the operation. If it fails again, check the exception message for more information.

IGN-RECOVERY-4

Cluster is under load.

Retry the operation when the cluster has less load.

IGN-MEMQUOTA-1

Disk spilling I/O error occurred.

See the exception message for details. Typically, this is caused either by disk I/O issues (not enough space, insufficient permissions etc.) or by an internal GridGain error.

IGN-MEMQUOTA-2

Disk quota used for disk spilling has been exceeded.

Disable or increase the disk quota size using the sql.offloadingDataLimit configuration option.

IGN-MEMQUOTA-3

Memory quota used for a query has been exceeded.

Rewrite the query to use less memory or increase the memory quota for the query using the sql.statementMemoryQuota` configuration option.

IGN-MEMQUOTA-4

Node memory quota exceeded.

Increase node memory quota using the sql.nodeMemoryQuota configuration option.

IGN-RBAC-1

Generic access control error.

See the exception message for details. Typically, this error is caused either by the disabled security or by an unexpected issue.

IGN-RBAC-2

User not found.

Check if username is correct and make sure that the user exists.

IGN-RBAC-3

An issue occurred while validating the user.

Check the exception message for details.

IGN-RBAC-4

User with the specified name already exists.

Check if username is correct, or use a different username.

IGN-RBAC-5

An error occurred while updating user info.

Check the exception message for details and try again.

IGN-RBAC-6

User assignment already exists.

Check the exception message for details and try again.

IGN-RBAC-7

Role with the specified name was not found

Check if role name is correct, or create a role with required name.

IGN-RBAC-8

Role with the specified name already exists.

Check if role name is correct, or use a different role name.

IGN-RBAC-9

An issue occurred while validating role information

Check the exception message for details.

IGN-RBAC-10

Failed to assign the role to the user.

Verify that both the user and the role exist.

IGN-RBAC-11

Role assignment already exists.

The role with the specified name is already assigned to the user. No action is required.

IGN-RBAC-12

Role cannot be dropped because it has privileges.

Remove privileges from the role and try again.

IGN-RBAC-13

The role already has the specified privilege.

The privilege is already added to the role. No action is required.

IGN-RBAC-14

Failed to apply a privilege, as the privilege is invalid.

Check the privilege syntax. Typically, this is caused by trying to assign invalid action.

IGN-RBAC-15

Failed to apply a privilege, as the action cannot have a selector, or the selector is not valid.

Remove a selector from the action, or correct the error in the selector.

IGN-RBAC-16

User does not have permission to change access control permissions.

Rerun the operation with an authorized user.

IGN-RBAC-17

An attempt to modify system user failed.

System user cannot be modified.

IGN-SECURITY-1

General security context error.

Check the exception message for the error details.

IGN-SECURITY-2

Security context is not set, but security is enabled.

Change your code to use secured threads.

IGN-LDAP-1

General LDAP error.

Check the exception message for information on why the error occurred.

IGN-LDAP-2

LDAP client initialization failed.

Check the exception message for information on why the initialization failed.

IGN-LDAP-3

LDAP search request failed.

Check the exception message for information on why the request failed.

IGN-LDAP-4

LDAP user not found.

Check if username is correct and make sure that the user exists.

IGN-NODEKEYMGMT-1

Node key decoding error.

Check the exception message for information on why the error occurred.

IGN-NODEKEYMGMT-2

Node key expired error.

Update the node key.

IGN-NODEKEYMGMT-3

Node key generation error.

Check the exception message for information on why the error occurred and try again.

IGN-NODEKEYMGMT-4

Node key not found.

Check the if node key is correct.

IGN-NODEKEYMGMT-5

Node key serialization or deserialization error.

Check the exception message for information on why the error occurred.

IGN-NODEKEYMGMT-6

Node key validation error.

Check the exception message for information on why the error occurred.

IGN-JWT-1

JWT validation error.

Check the exception message for information on why the error occurred.

IGN-JWT-2

JWT serialization or deserialization error.

Check the exception message for information on why the error occurred.

IGN-SNAPSHOTS-1

Generic snapshot error.

Check the exception message for information on why the error occurred.

IGN-SNAPSHOTS-2

Error indicating that a snapshot has been canceled.

Check the exception message for information on what caused the snapshot to stop.

IGN-SNAPSHOTS-3

Error indicating that an illegal or inappropriate argument was provided.

Check the command arguments and correct the command.

IGN-DCR-1

Generic DCR error.

Check the exception message for information on why the error occurred.

IGN-DCR-2

Failed to create replication.

Check the exception message for information on why the error occurred.

IGN-DCR-3

Failed to start replication.

Check the exception message for information on why the error occurred.

IGN-DCR-4

Replication cannot be removed because it is still running.

Stop the replication and try again.

IGN-DCR-5

The source and target schemas for the replicated tables are incompatible.

Make sure the local and remote clusters have the same schema.

IGN-DCR-6

Replication failed to stop.

Check the exception message for information on why the error occurred.

IGN-DCR-7

Replicated source table doesn’t exist.

Check the table name used in replication and create the table if necessary.

IGN-DCR-8

Replication failed to start second replication for the same table.

Check what replication is already using the table and stop it if needed.

IGN-DCR-9

Replication with the specified name is not found.

Check the replication name and try again.

IGN-DCR-10

Replication with the specified name already exists.

Use a different name for the new replication.

IGN-ENCRYPTION-1

Missing key provider to decrypt data from storage.

Specify the key provider.

IGN-ENCRYPTION-2

Key provider configuration is not valid.

Check the key provider configuration and update it.

IGN-ENCRYPTION-3

Failed to initialize encryption provider.

Check the exception message for information on why the error occurred.

IGN-ENCRYPTION-4

Missing data encryption key to decrypt data from storage.

Make sure the storage you are using contains the required encryption key.

IGN-LICENSE-1

Generic license error.

Check the exception message for information on why the error occurred.

IGN-LICENSE-2

A license is missing for cluster.

Make sure to add the license when initializing the cluster.

IGN-LICENSE-3

A license has been modified.

Contact GridGain support.

IGN-LICENSE-4

A license does not contain the required features.

Contact GridGain support.

IGN-LICENSE-5

Blocked licenses list has been modified.

Contact GridGain support.

IGN-CACHESTORE-1

Cache store configuration failure.

Check the exception message for information on why the error occurred.

IGN-CACHESTORE-2

Cache store access error.

Check the exception message for information on why the error occurred.

IGN-META-7

Failed to start a node because metastorage has diverged as a result of MG recovery.

Clear the node of data and add it to the cluster as a blank node.