This topic describes the error messages and solutions that you may encounter when you use obshell. obshell uses descriptive strings to indicate error codes, which makes it easier for you to understand the errors.
| Error Code | Error Message | Description | Solution |
|---|---|---|---|
| Agent.AlreadyExists | Agent %s already exists | The obshell node to be added already exists in the cluster. | The obshell node is already in the cluster and cannot be added again. |
| Agent.AlreadyInitialized | Agent already initialized | The obshell node is already initialized. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Binary.NotFound | There is no available agent (version: %s, architecture: %s, distribution: %s) in OB | The OceanBase cluster does not have an available obshell binary file. | Log in to the sys tenant of the cluster and check the ocs.binary_agent_info table to confirm the existence of the obshell binary file, then retry. |
| Agent.Coordinator.IsFaulty | Faulty does not have maintainer | The coordinator of the node is unavailable. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Coordinator.NotInitialized | Coordinator is not initialized | The coordinator of the node is not initialized. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Current.UnderMaintenance | Agent is under maintenance | The current obshell node is under maintenance. | Wait for the maintenance task to complete, or complete (rollback, retry, skip) the failed maintenance task using the task command/API. |
| Agent.Daemon.StartFailed | Daemon start failed | The daemon process failed to start. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Daemon.ServeOnUnixSocketFailed | Daemon serve on socket listener failed | The daemon failed to serve on the socket listener. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Identify.NotSupportOperation | '%s' is '%s', instead of '%s', does not support this operation | The current node identity does not support this operation. | Please check the identity and retry. |
| Agent.Identify.Unknown | Unknown agent identity: %s | The identity of the obshell node is unknown. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Info.NotEqual | Agent info not equal, input is %v, meta is %v | The obshell node information does not match. | Please check the obshell node information. |
| Agent.IP.InconsistentWithOBServer | Agent ip inconsistent with observer | The IP address of the obshell node does not match the IP address of the OBServer node. | Check the IP configuration. |
| Agent.Load.OBConfigFailed | Load ob config from config file failed | Failed to load OceanBase Database configurations from the configuration file. | Check the configuration file. |
| Agent.Maintainer.NotActive | Maintainer is not active | The maintainer of the node is not active. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.MaintainerNotExist | Maintainer is not exist | The maintainer does not exist. | Check the maintainer configuration. |
| Agent.NeedToTakeOver | obshell need to be cluster. Please do takeover first. | The cluster is not managed by an obshell node. First, take over the cluster. | Follow the instructions in Take over a non-obshell cluster. |
| Agent.NoActiveServer | No agent which has active server found | No active OBServer nodes are found in the cluster. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.NoMaster | Master agent is not found | No obshell node is found with the MASTER role. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.NotExist | Server '%s' does not exist | The specified obshell node does not exist. | Check the server name and try again. |
| Agent.NotInitialized | Agent not initialized | The obshell node is not initialized. | Initialize the obshell node first. |
| Agent.OB.Version.Inconsistent | OB version is not consistent between %s(%s) and %s(%s) | The OceanBase Database versions of the two obshell nodes are inconsistent. | Ensure that the OceanBase Database versions of the obshell nodes are consistent. |
| Agent.OBVersionNotSupported | Unsupported ob version '%s', the minimum supported version is '%s' | The current OceanBase Database version is not supported. | Use a supported OceanBase Database version. |
| Agent.OceanBase.DB.NotOcs | The current database is not ocs | The current database is not OCS. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.OceanBase.NotHold | Agent is not holding OceanBase | The obshell node does not hold the connection to the OceanBase cluster. | Restart the obshell node and try again. |
| Agent.Oceanbase.Password.LoadFailed | Check password of root@sys in sqlite failed | Failed to check the password of root@sys in SQLite, and the corresponding obshell node is not a CLUSTER AGENT. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.OceanBase.Useless | The current database is useless | The current OceanBase cluster is unavailable. | Check whether the OceanBase cluster is available. |
| Agent.Package.NotFound | Package %v is not found | The corresponding installation package is not found. | Check the installation package and try again. |
| Agent.Rebuild.PortNotSame | Agent port is not the same, agent port in all_agents: %d, agent port now: %d | The ports of the obshell nodes are inconsistent. | Rebuild the obshell using the same port. |
| Agent.Rebuild.VersionNotSame | Agent version is not the same, agent version in all_agents: %s, agent version now: %s | The versions of the obshell nodes are inconsistent. | Rebuild the obshell using the same version. |
| Agent.Response.DataEmpty | Response data is empty | The response data is empty. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Response.DataFormatInvalid | Response data is not map | The response data format is invalid. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.RPC.RequestError | Request [%s]%s to %s error: %v | An error occurred when sending an internal request between nodes. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.RPC.RequestFailed | Request [%s]%s to %s failed: %s | The internal request between nodes failed. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.ServeOnTcpSocketFailed | Serve on tcp listener failed | The service failed on the TCP listener. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.ServeOnUnixSocketFailed | Serve on unix listener failed | The service failed on the Unix listener. | Check the system resources and permissions. |
| Agent.Sqlite.DB.NotInit | The sqlite db is not initialized | The SQLite database is not initialized. | Contact OceanBase Technical Support for troubleshooting. |
| Agent.Start.ObserverFailed | Start observer via flag failed | Failed to start the OBServer node | Please check the OBServer node configuration. |
| Agent.Start.WithInvalidInfo | Agent start with invalid info: %v | Invalid obshell startup information | Please check the startup parameters. |
| Agent.Synchronizer.NotInitialized | Agent synchronizer is not initialized | The synchronizer is not initialized | Please contact OceanBase Technical Support. |
| Agent.TakeOverFailed | Take over or rebuild failed | Failed to take over or rebuild | Please contact OceanBase Technical Support. |
| Agent.TakeOver.HigherVersion | Take over a higher version agent(%s) into cluster agent(%s) is not allowed | It is not allowed to take over a higher version of obshell into the cluster | Please contact OceanBase Technical Support. |
| Agent.TakeOver.NotExistInCluster | %s not in cluster | The current obshell node is not in the cluster | Please contact OceanBase Technical Support. |
| Agent.TCP.Listener.CreateFailed | Create tcp listerner failed | Failed to create the TCP listener | Please contact OceanBase Technical Support. |
| Agent.Unavailable | Agent %s is not available | There are unavailable obshell nodes in the cluster | Please contact OceanBase Technical Support. |
| Agent.UnderMaintenanceDag | %s is under maintenance by dag [%s:%s] | The current obshell node is under maintenance | Wait for the maintenance task to complete, or use the task command/API to complete (rollback, retry, skip) failed maintenance tasks. |
| Agent.UnderMaintenance | %s is under maintenance | The current obshell node is under maintenance | Wait for the maintenance task to complete, or use the task command/API to complete (rollback, retry, skip) failed maintenance tasks. |
| Agent.Unix.Socket.Listener.CreateFailed | Create unix socket listerner failed | Failed to create the Unix socket listener | Please contact OceanBase Technical Support. |
| Agent.Upgrade.KillOldServerTimeout | Wait obshell server killed timeout | The timeout occurs while waiting for the obshell server to be terminated. | Contact OceanBase Technical Support. |
| Agent.Upgrade.ToLowerVersion | Target version %s is not greater than current version %s. Please verify if the params have been filled out correctly | The target version is not higher than the current version. | Verify that the parameters are correctly filled out and provide a valid target version. |
| Agent.Version.Inconsistent | obshell version is not consistent between %s(%s) and %s(%s) | The obshell versions are inconsistent. | Use obshell of the same version. |
| Cli.FlagRequired | Required flag(s) "%s" not set | The required command option is not set. | Configure all required options. |
| Cli.NotFound | %s not found | The corresponding resource is not found. | Check whether the resource exists. |
| Cli.ObCluster.NotTakenOver | Cluster not taken over | The cluster is not taken over. | Execute the obshell cluster start -a command to take over the cluster. For more information, see Take over a non-obshell cluster. |
| Cli.OperationCancelled | Operation cancelled | The operation is cancelled. | Execute the operation again as needed. |
| Cli.StartRemoteAgentFailed | Failed to start remote agent | The remote agent fails to start. | Check the status and connection of the obshell node. |
| Cli.TakeOver.MultiServerOnSameHost | Multi-server on the same host when take over by 'cluster start' | Multiple servers are on the same host when the cluster is started. | Execute the obshell agent start command in the working directory of each node to start the node. The node will automatically take over the cluster. |
| Cli.TakeOver.WithObserverNotInConf | Server %s is not in the ob conf | The corresponding server is not in the OceanBase Database configuration. | Contact OceanBase Technical Support. |
| Cli.UnixSocket.RequestFailed | Request unix-socket [%s]%s failed: %v | The Unix socket request fails. | Contact OceanBase Technical Support. |
| Cli.Upgrade.NoValidTargetBuildVersionFound | No valid target build version in pkg_directory found by '%s' | No valid target build version is found in the specified directory. | Check the installation packages in the directory or provide a specific version number. |
| Cli.Upgrade.PackageNotFoundInPath | No valid %s package found in %s | No valid installation package is found in the specified path. | Check the installation package path. |
| Cli.UsageError | Incorrect usage: %s | The command is used incorrectly. | Please check the command syntax. You can use the -h/--help option in the corresponding command to view the help information. |
| Common.BadRequest | Bad request: %v | The request is invalid. | Please check the request parameters and retry. |
| Common.BindJsonFailed | Bind JSON failed: %v | The JSON binding failed. | Please check the JSON format and retry. |
| Common.DirNotEmpty | Dir '%s' is not empty | The directory is not empty. | Please check the directory and retry. |
| Common.FileNotExist | File '%s' does not exist | The file does not exist. | Please check the file path and retry. |
| Common.FilePermissionDenied | No read/write permission for file '%s' | You do not have the read/write permission for the file. | Please ensure that you have the read/write permission for the file and retry. |
| Common.IllegalArgument | Illegal argument | The parameter is invalid. | Please check the parameters and retry. |
| Common.InvalidAddress | '%s' is not a valid address | The address is invalid. | Please check the address and retry. |
| Common.InvalidIp | '%s' is not a valid IP address | The IP address is invalid. | Please check the IP address and retry. |
| Common.InvalidPath | Path '%s' is not valid: %s | The path format is invalid. | Please check the path format and retry. |
| Common.InvalidPort | The port '%s' is invalid, must in (1024, 65535]. | The port is invalid. | Please check the port. The port value must be in the range of (1024, 65535]. |
| Common.InvalidTimeDuration | Time duration '%s' is invalid: %s | The time duration is invalid. | Please check the time duration and retry. |
| Common.NotFound | Element not found: %v | The API request does not exist. | Please check whether the URI is correct. |
| Common.PathNotDir | '%s' is not a directory | The configured path is not a directory. | Please check the path and retry. |
| Common.PathNotExist | '%s' does not exist | The path does not exist. | Please check the path and retry. |
| Common.Unauthorized | Unauthorized | The authentication failed. | Please check the permissions and retry. |
| Common.Unexpected | Unexpected error: %s | An unexpected error occurred. | Please contact OceanBase Technical Support for troubleshooting. |
| Environment.DiskSpaceNotEnough | The remaining disk space is insufficient, the remaining disk space is %d, and the required disk space is %d | The remaining disk space is insufficient. | Please release the disk space and retry, or switch to another disk with sufficient space. |
| Environment.WithoutModule | Please check if python module '%s' is installed. | The corresponding Python module is not installed. | Please install the required Python module and retry. |
| Environment.WithoutObAdmin | Please check if ob_admin is installed. | ob_admin is not installed. | Please install ob_admin and retry. |
| Environment.WithoutPython | Please check if python is installed. | Python is not installed. | Please install Python and try again. |
| Gorm.NoRowAffected | %s: no row affected | The operation did not modify any data in OceanBase Database. | Contact OceanBase Technical Support. |
| Log.FileNameExtensionMismatched | File name '%s' extension mismatched | The file extension does not match. | Contact OceanBase Technical Support. |
| Log.FileNamePrefixMismatched | File name '%s' prefix mismatched | The file name prefix does not match. | Contact OceanBase Technical Support. |
| Log.WriteExceedMaxSize | Write length %d exceeds maximum file size %d | The write length exceeds the maximum file size. | Contact OceanBase Technical Support. |
| MySQL.Error | Occur error when execute sql | An error occurred while executing the SQL statement. | Contact OceanBase Technical Support. |
| OB.Backup.ArchiveBaseUriEmpty | archive_base_uri cannot be empty | The archive_base_uri parameter cannot be empty. |
Please set a valid log archive file path. |
| OB.Backup.ArchiveDestEmpty | Archive dest is empty, tenant: %s(%d) | The archive destination path for the tenant is empty. | Please provide a valid archive file path and try again. |
| OB.Backup.ArchiveLagTargetForS3.Invalid | archive_lag_target must be greater than %v for s3 | The archive_lag_target setting does not meet the requirements. |
Please set the archive_lag_target parameter to a value within the range specified in the error message and try again. |
| OB.Backup.ArchiveLagTarget.Invalid | archive_lag_target must be between %v and %v | The archive_lag_target setting does not meet the requirements. |
Please set the archive_lag_target parameter to a value within the range specified in the error message and try again. |
| OB.Backup.ArchiveLogStatus.Invalid | Invalid archive log status: '%s', must be '%s' or '%s' | The log archive status setting is invalid. | Currently, only the stop and doing statuses are supported. Please set the log archive status to one of the supported values. |
| OB.Backup.BaseUriEmpty | backup_base_uri cannot be empty | The backup_base_uri parameter cannot be empty. |
Please configure a valid data backup path for the backup_base_uri parameter. |
| OB.Backup.Binding.Invalid | Invalid binding mode: %s, must be %s or %s | The priority mode for archiving and business is invalid. | Currently, you can set it to optional (user business priority) or mandatory (archive priority). Please set it to one of the supported modes. |
| OB.Backup.DataBaseUriEmpty | data_base_uri cannot be empty | The data_base_uri parameter cannot be empty. |
Please configure a valid data backup file path for data_base_uri. |
| OB.Backup.DataDestEmpty | Data dest is empty, tenant: %s(%d) | The data backup path for the tenant is empty. | Please configure a valid data backup path and try again. |
| OB.Backup.DeletePolicy.Invalid | Invalid delete policy: '%s', must be '%s' | The cleanup policy is invalid. | Please set a valid delete policy. For more information, see the delete_policy parameter in the obshell API for setting backup strategies. |
| OB.Backup.HaLowThreadScore.Invalid | ha_low_thread_score must be between %d and %d | The ha_low_thread_score parameter is invalid. |
Please configure a valid value for ha_low_thread_score within the range specified in the error message and try again. |
| OB.Backup.LogArchiveConcurrency.Invalid | log_archive_concurrency must be between %d and %d | The log_archive_concurrency parameter is invalid. |
Please configure a valid value for log_archive_concurrency within the range specified in the error message and try again. |
| OB.Backup.Mode.Invalid | Invalid backup mode: %s, must be %s or %s | The backup mode is invalid. | Please use a supported data backup mode. Currently, only full (full backup) and incremental (incremental backup) are supported. |
| OB.Backup.NoUserTenants | No user tenants | No backup tenants were found. | The cluster does not have the specified backup tenant. Please check the configured tenant and try again. |
| OB.Backup.PieceSwitchInterval.Invalid | piece_switch_interval must be between %v and %v | The piece_switch_interval parameter is invalid. |
Please configure a valid value for piece_switch_interval within the range specified in the error message and try again. |
| OB.Backup.Status.Invalid | Invalid backup status: '%s', must be '%s' | The backup status is invalid. | Please use a supported backup status. Currently, only canceled is supported. |
| OB.Binary.Version.Unexpected | Unexpected observer binary version. | The OceanBase Database version is unexpected. | Contact OceanBase Technical Support for troubleshooting. |
| OB.Cluster.AlreadyInitialized | Cluster has already initialized | The cluster is already initialized. | Contact OceanBase Technical Support for troubleshooting. |
| OB.Cluster.AsyncOperationTimeout | %s timeout | The asynchronous operation times out. | Contact OceanBase Technical Support. |
| OB.Cluster.ForceStopOrTerminateRequired | Cannot stop all observer without 'force' and 'terminate' | You cannot stop all observer processes without using the force or terminate option. |
Set the stop mode to force or terminate. |
| OB.Cluster.ForceStopRequired | The current observer is not available, please stop with 'force' | The current OBServer node is unavailable. | Stop the observer process in force mode. |
| OB.Cluster.Id.Invalid | Cluster id is invalid | The cluster ID is invalid. | Retry after configuring a valid cluster ID. |
| OB.Cluster.MinorFreezeTimeout | Minor freeze timeout | Minor Freeze times out. | Contact OceanBase Technical Support. |
| OB.Cluster.MultiPaxosNotAlive | Multi paxos member is not alive | The cluster has no majority members. | Contact OceanBase Technical Support. |
| OB.Cluster.MysqlPortNotInitialized | Mysql port has not been initialized | The MySQL port is not initialized. | Contact OceanBase Technical Support. |
| OB.Cluster.Name.Empty | Cluster name is empty | The cluster name is empty. | Retry after configuring a valid cluster name. |
| OB.Cluster.NotInitialized | Cluster has not been initialized, please initialize it first | The cluster has not been initialized. | Contact OceanBase Technical Support. |
| OB.Cluster.Password.Encrypted | Please don't encrypt the 'rootPwd', and send /api/v1/obcluster/config to master agent. | The root password of the sys tenant of the cluster is encrypted. | Retry after providing the root password without encryption. |
| OB.Cluster.Password.Incorrect | The cluster root password is incorrect | The provided root password of the sys tenant of the cluster is incorrect. | Check the password and retry. |
| OB.Cluster.ScaleOutHigherVersion | Scale out a higher version agent %s(%s) into cluster agent %s(%s) is not allowed | You cannot scale out a higher version of obshell node to the cluster. | Use a compatible obshell version for scaling out. |
| OB.Cluster.ScaleOutLowerVersion | Scale out a lower version agent(%s before %s) into cluster agent(%s) is not allowed | It is not allowed to scale out an obshell node of a lower version into the cluster. | Please use the compatible obshell version specified in the error message for scaling out. |
| OB.Cluster.ScaleOutRetryCoordinateDagFailed | Retry coordinate dag %s failed | The retry of the coordination task in the scale-out task failed. | Please retry, or contact OceanBase Technical Support for troubleshooting. |
| OB.Cluster.Scope.Invalid | Scope is invalid | The specified scope is invalid. | Only SERVER, ZONE, or GLOBAL are allowed. |
| OB.Cluster.StopModeConflict | Cannot stop observer with 'force' and 'terminate' at the same time | The force and terminate modes cannot be used simultaneously to stop an OBServer node. |
Only one stop mode can be specified at a time. |
| OB.Cluster.UnderMaintenance | OceanBase cluster is under maintenance, please try again later | The cluster is under maintenance. | Wait for the maintenance task to complete, or use the task commands/API to complete (rollback, retry, skip) failed maintenance tasks. |
| OB.Cluster.UnderMaintenanceWithDag | OceanBase cluster is under maintenance by DAG: %s | The cluster is under maintenance. | Wait for the maintenance task to complete, or use the task commands/API to complete (rollback, retry, skip) failed maintenance tasks. |
| OB.Database.NotExist | Database %s of tenant %s | The specified database does not exist in the tenant. | Please configure an existing database and retry. |
| OB.Package.Corrupted | Package '%s' in OB is corrupted: %s | The installation package is corrupted. | Download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| OB.Package.MissingFile | These files are missing in package '%s': '%v' | The installation package is missing files. | Please check the installation package files, or download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| OB.Package.Name.NotSupport | Unsupported name '%s', the supported name are [%s] | The installation package name is not supported. | Download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| OB.Package.NotExist | These pkgs are missing: '%v' | The required installation packages are missing. | Download the corresponding installation packages from the OceanBase Software Download Center and upload them again. |
| OB.Parameter.RsList.Invalid | rootservice_list '%s' is invalid: %s | The rootservice_list parameter is invalid. |
Check the value of the rootservice_list parameter and try again. |
| OB.Parameter.Scope.Invalid | Parameter scope '%s' is invalid | The scope of the parameter is invalid. | The scope can only be specified as CLUSTER or TENANT. |
| OBProxy.AlreadyManaged | Agent has already managed obproxy | obshell has already managed an ODP. | obshell cannot deploy and manage another ODP if it has already managed an ODP. |
| OBProxy.HealthCheckTimeout | OBProxy health check timeout | The health check of the ODP process times out. | Check the status of the ODP process and try again. |
| OBProxy.HotRestartTimeout | Wait hot restart obproxy finish timeout | The hot restart of the ODP times out. | Check the status of the ODP process and try again. |
| OBProxy.NotBeManaged | This is not an obproxy agent | obshell has not managed an ODP. | Add an ODP to obshell. |
| OBProxy.NotRunning | OBProxy is not running | The ODP is not running. | Start the ODP and try again. |
| OBProxy.Package.Name.Invalid | Unsupported name '%s', the supported name is '%s' | The package name is not supported. | Use a supported package name. |
| OBProxy.Package.NotFound | Package %s is not found | The ODP package is not found. | Download the ODP package from the OceanBase Software Download Center and upload it again. |
| OBProxy.RsListAndConfigUrl.Conflicted | rs_list and config_url can not be specified at the same time | The rs_list and config_url parameters cannot be specified at the same time. |
Specify either the rs_list or config_url parameter. |
| OBProxy.RsListOrConfigUrl.NotSpecified | rs_list or config_url must be specified when agent is not cluster agent | The rs_list or config_url parameter is not specified. |
When the obshell node is not a CLUSTER AGENT, specify either the rs_list or config_url parameter. |
| OBProxy.StopDaemonTimeout | Kill obproxyd process timeout | The obproxyd process (ODP daemon) stops within the timeout. | Check the process and try again. |
| OBProxy.StopTimeout | Kill obproxy process timeout | The ODP process stops within the timeout. | Check the process and try again. |
| OBProxy.UpgradeToLowerVersion | Target version %s is not greater than current version %s | The target version is not greater than the current version. | Specify a target version that is higher than the current version. |
| OBProxy.Version.NotSupported | OBProxy version %s is lower than the minimum supported version %s | The ODP version is lower than the minimum supported version. | Select an ODP version that meets the requirements based on the version information in the error message. |
| OBProxy.VersionOutputUnexpected | Version not found in output: %s | The version is not found in the output. | Download the ODP installation package from the OceanBase Software Download Center and upload it again. |
| OB.Recyclebin.Tenant.NotExist | Tenant '%s' is not exist in recyclebin | The specified tenant does not exist in the recyclebin. | Check whether the tenant has been deleted or purged from the recyclebin. |
| OB.Resource.Pool.Granted | Resource pool '%s' has already been granted to a tenant | The specified resource pool has been granted to a tenant. | You cannot delete a resource pool that has been granted to a tenant. |
| OB.Resource.Pool.Name.Empty | Resource pool name is empty | The resource pool name is empty. | Provide a valid resource pool name. |
| OB.Resource.UnitConfig.Existed | Unit config '%s' is already existed | The specified resource specification name already exists. | Specify a new name for the resource specification and try again. |
| OB.Resource.UnitConfig.Name.Empty | Unit config name is empty | The resource specification name is empty. | Specify a resource specification name and try again. |
| OB.Resource.UnitConfig.NotExist | Unit config '%s' does not exist | The specified resource specification does not exist. | Specify an existing resource specification and try again. |
| OB.Restore.NotRecovering | Tenant '%s' not in restore | The tenant is not in the restore state. | You cannot cancel a restore operation for a tenant that is not in the restore state. |
| OB.Restore.Task.AlreadySucceed | Restore task was succeed, can not cancel | The restore task has been completed. | You cannot cancel a completed restore task. |
| OB.Restore.Task.NotExist | There is no restore dag: %s | The current tenant does not have a restore task. | The current tenant does not have a restore task, so you cannot cancel the restore operation. |
| OB.Restore.TimeNotValid | Restore time '%d' is not valid | The specified restore point is invalid. | You cannot restore to the specified time. Use the API (/api/v1/restore/windows) or ob_admin to obtain the restore time window. |
| OB.Server.DeleteSelf | Cannot delete the current server | You cannot delete the current obshell node. | Initiate the request from another obshell node. |
| OB.Server.HasNotBeenStarted | OBServer has not started yet, please start it normally | The OBServer node has not started. | Start the OBServer node and try again. |
| OB.Server.NotDeleting | OBServer '%s' is not deleting | The OBServer node is not in the DELETING state. |
Contact OceanBase Technical Support. |
| OB.Server.NotExist | OBServer '%s' does not exist | The specified OBServer node does not exist. | Contact OceanBase Technical Support. |
| OB.Server.Process.CheckFailed | Check observer process exist: %s | The observer process check failed. | Contact OceanBase Technical Support. |
| OB.Server.Process.NotExist | OBServer process does not exist | The observer process does not exist. | Start the observer process and try again. |
| OB.Server.StoppedInMultiZone | Cannot stop server or stop zone in multiple zones at the same time | In a multi-zone environment, you can perform operations on only one zone at a time. | You can stop only one zone at a time. |
| OB.Server.Unavailable | OBServer '%s' is not available | The OBServer node is unavailable. | Check the status of the OBServer node and try again. |
| OB.Storage.URI.Invalid | %s is invalid: %s | The storage URI is invalid. | Check the storage URI and try again. |
| OB.Tenant.Collation.Invalid | Invalid collation: '%s' | The collation is invalid. | Set a supported collation. For more information, see Collation. |
| OB.Tenant.Compaction.Status.NotIdle | Tenant '%s' is in '%s' status, operation not allowed | The tenant is not in an idle state. | Wait until the tenant is idle and then try again. |
| OB.Tenant.Existed | Tenant %s already exists | The tenant already exists. | Change the tenant name. |
| OB.Tenant.HasPoolOnZone | Tenant already has a pool located in zone '%s' | The tenant has a resource pool in the specified zone. | Delete the resource pool in the zone and try again. |
| OB.Tenant.Job.Conflict | There is already a in-progress '%s' job | An in-progress task of the specified type already exists. | Contact OceanBase Technical Support. |
| OB.Tenant.Job.Failed | Job %d failed, job status is %s | The task failed. | Contact OceanBase Technical Support. |
| OB.Tenant.Job.NotExist | There is no job of '%s' | The task does not exist. | Contact OceanBase Technical Support. |
| OB.Tenant.Job.WaitTimeout | Job %d wait timeout | The job wait timeout. | Contact OceanBase Technical Support for troubleshooting. |
| OB.Tenant.Locality.Format.Unexpected | Unexpected locality format: %s | The locality format is not as expected. | Please check the locality format and try again. |
| OB.Tenant.Locality.PrincipalNotAllowed | violate locality principal not allowed | The locality change is invalid. | Please check the locality and try again, or contact OceanBase Technical Support for troubleshooting. |
| OB.Tenant.Locked | Tenant %s is locked | The tenant is locked. | Please unlock the tenant and try again. |
| OB.Tenant.Mode.NotSupported | Invalid mode: %s, only mysql or oracle is supported | The tenant mode is invalid. | Please set the tenant mode to a supported value, which can be mysql or oracle. |
| OB.Tenant.ModifyUnitNumPartially | Could not modify unit num partially | The number of units in a tenant cannot be partially modified. | Please modify the number of units in all zones. |
| OB.Tenant.Name.Empty | Tenant name is empty. | The tenant name is empty. | Please provide a valid tenant name and try again. |
| OB.Tenant.Name.Invalid | Tenant name '%s' is invalid: %s | The tenant name is invalid. | Please provide a valid tenant name and try again. |
| OB.Tenant.NoActiveServer | Tenant '%s' has no active server | The tenant has no active OBServer node. | Please check the OBServer status and ensure that at least one OBServer node is active. |
| OB.Tenant.NoPaxosReplica | Tenant '%s' has no paxos replica, please check tenant's replica info | The tenant has no Paxos replica. | The tenant must have at least one Paxos replica (FULL). |
| OB.Tenant.NotExist | Tenant '%s' does not exist | The tenant does not exist. | Please specify a valid tenant. |
| OB.Tenant.OnlyOneReplica | Tenant '%s' only has one replica | The tenant has only one replica. | When the tenant has only one replica, the replica cannot be deleted. |
| OB.Tenant.Parameter.Empty | Tenant parameter name or value is empt | The name or value of a tenant parameter is empty. | Please check the tenant parameters and try again. |
| OB.Tenant.Parameter.Name.Empty | Tenant parameter name is empty | The name of a tenant parameter is empty. | Please provide a valid parameter name. |
| OB.Tenant.Parameter.NotExist | Tenant parameter '%s' does not exist | The tenant parameter does not exist. | Please check the parameters and try again. |
| OB.Tenant.PrimaryRegion.FullReplica.NotEnough | The region %v where the first priority of tenant zone is located needs to have at least 2 F replicas. In fact, there are only %d full replicas. | The region where the first priority of tenant zone is located needs to have at least 2 F replicas. | Please reconfigure the parameters and try again, or contact OceanBase Technical Support for troubleshooting. |
| OB.Tenant.PrimaryZone.CrossRegion | Primary zone '%s' is cross region, please check tenant's primary zone | The primary zone is cross region. | Please check the primary zone and region. |
| OB.Tenant.PrimaryZone.Invalid | Primary zone '%s' is invalid: %s | The primary zone is invalid. | Please check the primary zone based on the specific error message. |
| OB.Tenant.RebalanceDisabled | %s is not allowed when tenant 'enable_rebalance' is disabled | This operation is prohibited when enable_rebalance is set to False. |
Please set enable_rebalance to True and try again. |
| OB.Tenant.Replica.DeleteAll | Could not delete all replica | Deleting all replicas is prohibited. | Please check the replica deletion operation. |
| OB.Tenant.Replica.InvalidType | Replica type '%s' is not supported | The configured replica type is not supported. | Please set the replica type to a supported type. Currently, only FULL (full-featured replica) and READONLY (read-only replica) are supported. |
| OB.Tenant.ResourceNotEnough | Server %s %s resource not enough | The OBServer node resources are insufficient. | Please check the OBServer node resources and try again. |
| OB.Tenant.RootPasswordIncorrect | The provided password is unable to connect to the tenant. | The root user password of the tenant is incorrect. | Please check the root user password of the tenant and try again. |
| OB.Tenant.Scenario.NotSupported | Tenant scenario '%s' is invalid, only '%s' is supported | The tenant workload type is invalid. | Please use a supported tenant workload type. Set it based on the supported types indicated in the error message. |
| OB.Tenant.SetScenario.NotSupported | Current observer does not support scenario | The current tenant does not support the specified workload type. | Please check whether the OceanBase Database version supports the specified workload type. |
| OB.Tenant.StatusNotNormal | Tenant '%s' status is '%s' | The tenant status is not NORMAL. |
Please check the tenant status and try again. |
| OB.Tenant.SysOperationNotAllowed | Sys tenant is not allowed to do this operation | This operation is not allowed for the system tenant. | Please use a user tenant to perform the operation. |
| OB.Tenant.UnderMaintenance | Tenant '%s' is under maintenance, please try again later. | The tenant is under maintenance. | Please try again after the maintenance is complete. |
| OB.Tenant.UnitNum.ExceedsLimit | Unit num '%d' is bigger than server num '%d' in zone '%s' | The number of units cannot exceed the number of OBServer nodes in the zone. | Check the number of units and the number of OBServer nodes in the zone, and try again. |
| OB.Tenant.UnitNum.Inconsistent | Unit num is inconsistent, should be same in all zones. | The number of units in the tenant is inconsistent across zones. | The number of units in the tenant should be consistent across all zones. Check the number of units in the zones and the cluster. |
| OB.Tenant.UnitNum.Invalid | Unit num '%d' is invalid: %s | The number of units for the tenant is invalid. | Check the number of units and try again. |
| OB.Tenant.Variable.Empty | Tenant variable name or value is empty | The name or value of a tenant variable is empty. | Check the tenant variables and try again. |
| OB.Tenant.Variable.Invalid | Tenant variable '%s' is invalid: %s | The tenant variable is invalid. | Check the variable and try again. |
| OB.Tenant.Variable.Name.Empty | Tenant variable name is empty | The name of the tenant variable is empty. | Provide a valid variable name. |
| OB.Tenant.Variable.NotExist | Tenant variable '%s' is not found | The tenant variable does not exist. | Check whether the variable exists. |
| OB.Tenant.ZoneAlreadyHasReplica | Zone '%s' already has a replica | The specified zone already has a replica. | Add replicas to other zones. |
| OB.Tenant.ZoneList.Empty | zone_list is empty | The zone list is empty. | Check the zone list and try again. |
| OB.Tenant.Zone.Repeated | Zone '%s' is repeated | The specified zone is repeated in the zone list. | Check the zone list and try again. |
| OB.Tenant.ZoneWithoutReplica | Zone '%s' does not have a replica | The specified zone does not have a replica. | Modify the replicas in other zones. |
| OB.Upgrade.DepYamlMissing | Target pkg upgrade dep yaml is empty | The YAML file for the upgrade dependency of the target package is empty. | Contact OceanBase Technical Support for troubleshooting. |
| OB.Upgrade.Mode.NotSupported | Upgrade mode '%s' is not supported | The specified upgrade mode is not supported. | Currently, only the STOPSERVICE (stop-service upgrade) and ROLLING (rolling upgrade) modes are supported. Use one of these modes. |
| OB.Upgrade.Path.NotExist | Can not find the upgrade path from the current version %s to the target version %s, please check the upgrade dep yaml file | The upgrade path cannot be found. | Check the YAML file for the upgrade dependency. |
| OB.Upgrade.ToDeprecatedVersion | Target version %s is deprecated | The target version is deprecated. | Use a supported target version. |
| OB.Upgrade.ToLowerVersion | Target version %s is not greater than current version %s. Please verify if the params have been filled out correctly | The target version is not higher than the current version. | Please use a valid target version. |
| OB.Upgrade.UnableToRollingUpgrade | Not support rolling upgrade when zone num is lower than 3 | Rolling upgrade is not supported when the number of zones is less than 3. | Please use the STOPSERVICE (stop-and-upgrade) mode to upgrade the cluster. |
| OB.User.Name.Empty | User name is empty | The username is empty. | Please provide a valid username. |
| OB.User.Privilege.NotSupported | Unsupported privilege %s | No operation privileges are configured. | Please configure the required operation privileges for the user. |
| OB.Zone.DeleteSelf | The current agent is in '%s', please initiate the request through another agent | The zone that contains the current agent cannot be deleted. | Please initiate the request through another agent. |
| OB.Zone.Name.Empty | Zone name is empty | The zone name is empty. | Please provide a valid zone name. |
| OB.Zone.NotEmpty | The zone '%s' is not empty and cannot be deleted | The zone cannot be deleted because it is not empty. | Before you delete a zone, delete all OBServer nodes in the zone. |
| OB.Zone.NotExist | Zone '%s' does not exist | The zone does not exist. | Please check whether the zone exists. |
| Package.Compression.NotSupported | Unsupported compression '%s', the supported compression is 'xz' | The package is not in a supported compression format. | The supported compression format is xz. Please download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| Package.Format.Invalid | Unsupported payload format '%s', the supported payload format is 'cpio' | The payload format is not supported. | The supported payload format is cpio. Please download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| Package.NameMismatch | RPM package name %s not match %s | The package name does not match. | Please check the package name. |
| Package.ReleaseFormat.Invalid | Release format %s is illegal | The release format is invalid. | Please download the corresponding installation package from the OceanBase Software Download Center and upload it again. |
| Package.ReleaseInvalid | RPM package release %s not match format | The release version does not meet the format requirements. | Please check the format requirements for the installation package. |
| Request.Body.Decrypt.AES.ContentLength.Invalid | Decrypted string length is not a multiple of the block size | The length of the decrypted string is not a multiple of the block size. | Please check the encrypted body of the HTTP request (encrypted using AES). |
| Request.Body.Decrypt.AES.KeyAndIv.Invalid | AES key and iv size error | The size of the AES key and IV is incorrect. | Please provide a valid key and IV in the request header. |
| Request.Body.Decrypt.AES.NoKey | No key for aes | No AES key is provided. | Contact OceanBase Technical Support for assistance. |
| Request.Body.Decrypt.SM4.NoKey | No key for sm4 | No SM4 key is provided. | Contact OceanBase Technical Support for assistance. |
| Request.Body.ReadFailed | Failed to read request body: %s | Failed to read the HTTP request body. | Contact OceanBase Technical Support for assistance. |
| Request.File.Missing | File %s in the request is missing: %s | The requested file is missing. | Check the requested file. |
| Request.Forward.Header.NotExist | Header not found when auto forward request to master | The request header is not found when the request is automatically forwarded to the MASTER node. |
Contact OceanBase Technical Support for assistance. |
| Request.Forward.MasterAgent.NotFound | Master agent not found when auto forward request to master | The MASTER agent is not found when the request is automatically forwarded to the MASTER node. |
Contact OceanBase Technical Support for assistance. |
| Request.Header.NotFound | X-OCS-Agent-Header or X-OCS-Header not found in http request header. | The X-OCS-Agent-Header or X-OCS-Header is not found in the HTTP request header. | Set the correct X-OCS-Agent-Header or X-OCS-Header in the HTTP request header to pass the authentication. |
| Request.Header.Type.Invalid | Header type error | The type of the request header is incorrect. | The HTTP header type is invalid. Please check the HTTP request header and try again. |
| Request.Method.NotSupport | %s method not support | The method is not supported. | Contact OceanBase Technical Support for assistance. |
| Request.Path.Param.Empty | Path param %s is empty | The path parameter is empty. | Provide the path parameter and try again. |
| Request.Query.Param.Empty | Query param %s is empty | The query parameter is empty. | Provide the query parameter and try again. |
| Request.Query.Param.Illegal | Query param %s is illegal | The query parameter is invalid. | Provide a valid query parameter and try again. |
| Security.Authentication.AgentPasswordNotInitialized | Agent password is not initialized | obshell password is not initialized | Initialize the obshell password and try again. |
| Security.Authentication.Expired | Authentication expired | Authentication information has expired | Update the authentication information and try again. |
| Security.Authentication.File.Sha256Mismatch | File sha256 mismatch | The SHA256 value of the file does not match | The file in the request does not match the MD5 in the HTTP header. Please check and re-upload. |
| Security.Authentication.Header.DecryptFailed | Decrypt http header failed: %s | Failed to decrypt the HTTP request header | Check if the encryption public key is correct. |
| Security.Authentication.Header.UriMismatch | URI mismatch | The URI in the request header does not match the actual request URI | Check the request URI set in the HTTP header and try again. |
| Security.Authentication.IncorrectAgentPassword | agent_password is incorrect | The obshell password is incorrect | Check the obshell password set in X_OCS_Agent_Header and try again. |
| Security.Authentication.IncorrectOceanbasePassword | oceanbase_password is incorrect | The root password of the sys tenant of the OceanBase cluster is incorrect | Check the root password of the sys tenant set in X_OCS_Header and try again. |
| Security.Authentication.IncorrectToken | Incorrect token | The token is incorrect | Provide the correct token and try again. |
| Security.Authentication.Timestamp.Invalid | Invalid timestamp: %s, err: %s | The timestamp is invalid | Provide a valid timestamp in the HTTP header and try again. |
| Security.Authentication.Unauthorized | Authentication failed | Authentication failed | Check your request and try again. |
| Security.Authentication.UnknownPasswordType | Unknown password type | The password type is unknown | Contact OceanBase Technical Support for troubleshooting. |
| Security.Authentication.WithAgentPassword | Should use agent_password to verify: %s | The agent password should be used for verification | Set auth to the obshell node password (agent password) in X_OCS_Agent_Header in the HTTP header and try again. |
| Security.Authentication.WithOceanBasePassword | Should use oceanbase_password to verify: %s | The root password of the sys tenant of the OceanBase cluster should be used for verification | Set auth to the root password of the sys tenant in X_OCS_Agent_Header in the HTTP header and try again. |
| Security.DecryptFailed | Decrypt failed: %s | Decryption failed | Check the decryption parameters and try again. |
| Security.User.PermissionDenied | Permission denied | User does not have sufficient privileges. | Contact OceanBase Technical Support for assistance. |
| Task.AgentData.ConvertFailed | Convert %s failed: %s | The obshell task data conversion failed. | Contact OceanBase Technical Support for assistance. |
| Task.AgentData.NotSet | Agent %s data %s not set | The required obshell task data is not set. | Contact OceanBase Technical Support for assistance. |
| Task.CreateFailed | Create task '%s' failed: %s | The task creation failed. | Contact OceanBase Technical Support for assistance. |
| Task.Dag.CancelTimeout | Cancel %d timeout after %d seconds | The DAG cancellation timed out. | Contact OceanBase Technical Support for assistance. |
| Task.Dag.ExecuteTimeout | %s timeout | The DAG execution timed out. | Contact OceanBase Technical Support for assistance. |
| Task.DagFailed | Dag %s %s failed | The DAG execution failed. | Contact OceanBase Technical Support for assistance. |
| Task.Dag.Operator.CancelFinishedDag | Failed to cancel dag: dag is finished | The DAG cannot be canceled. | You can cancel only a DAG in the RUNNING state. |
| Task.Dag.Operator.CancelNotAllowed | Failed to cancel dag: node %s can not cancel | The DAG contains a node that cannot be canceled. | Contact OceanBase Technical Support for assistance. |
| Task.Dag.Operator.NotSupport | Not support operator %s | The DAG operator is not supported. | Perform a supported task operation. |
| Task.Dag.Operator.PassNotAllowed | Failed to pass dag: node %s can not pass | The DAG contains a node that cannot be skipped. | Contact OceanBase Technical Support for assistance. |
| Task.Dag.Operator.PassNotFailedDag | Failed to pass dag: dag is not failed | You can skip only a failed DAG. | You can skip only a failed DAG. |
| Task.Dag.Operator.RetryNotAllowed | Failed to set dag retry: node %s can not retry | DAG contains tasks that cannot be retried | Contact OceanBase Technical Support. |
| Task.Dag.Operator.RetryNotFailedDag | Failed to set dag retry: dag state is not failed | Retrying a non-failed DAG is not supported | Currently, only failed DAGs can be retried. |
| Task.Dag.Operator.RollbackNotAllowed | Failed to set dag rollback: node %s can not rollback | DAG contains tasks that cannot be rolled back | Contact OceanBase Technical Support. |
| Task.Dag.Operator.RollbackNotFailedDag | Failed to set dag rollback: dag state is not failed | Rolling back a non-failed DAG is not supported | Currently, only failed DAGs can be rolled back. |
| Task.Dag.PassTimeout | Pass %d timeout after %d seconds | Task skip timeout | Contact OceanBase Technical Support. |
| Task.Dag.State.Invalid | Invalid dag state '%d' | Invalid task state | Contact OceanBase Technical Support. |
| Task.Data.ConvertFailed | Convert %s failed: %s | Failed to convert task data | Contact OceanBase Technical Support. |
| Task.Data.NotSet | Data %s is not set | Required task data is not set | Contact OceanBase Technical Support. |
| Task.Engine.Unexpected | Unexpected error occurred in task engine: %s | Unexpected error occurred in the task engine | Contact OceanBase Technical Support. |
| Task.Expired | %s has already executed task %s. '%s: %s' cannot be executed. Please submit a new request. | Task has expired | Contact OceanBase Technical Support. |
| Task.GenericID.Invalid | Invalid id: %s | Invalid generic ID | Please provide a valid generic ID. |
| Task.LocalData.ConvertFailed | Convert %s failed: %s | Failed to convert local task data | Please check the local data format and try again. |
| Task.LocalData.NotSet | Task local data %s not set | Required task local data is not set | Contact OceanBase Technical Support. |
| Task.Node.Operator.NotSupport | Not support operator %s | The specified operator is not supported | Execute a supported task operation. |
| Task.Node.Operator.PassNotAllowed | Failed to pass node: node %s can not pass | The task node cannot be skipped | The task node cannot be skipped. |
| Task.Node.Operator.PassNotFailedDag | Failed to pass node: assigned dag is not failed | The task node cannot be skipped when the DAG is not failed | You can skip only failed task nodes. |
| Task.Node.Operator.PassNotFailedNode | Failed to pass node: node %s is not failed | The task node cannot be skipped when it is not failed | You can skip only failed task nodes. |
| Task.NotFound | Task not found: %v | The task is not found | Verify the task ID and try again. |
| Task.Param.ConvertFailed | Convert %s failed: %s | Failed to convert the task parameter | Contact OceanBase Technical Support. |
| Task.Param.NotSet | Param %s is not set | Required task parameter is not set | Contact OceanBase Technical Support. |
| Task.RemoteTask.Failed | Remote task %s %s failed | The remote task failed | Contact OceanBase Technical Support. |
| Task.SubDag.NotAllAdvanced | Sub dag of agents: %v not advanced, main dag failed | Some subtasks of the agents failed to be advanced | Check the blocked subtasks and resolve the issue. |
| Task.SubDag.NotAllCreated | Sub dag of agents: %v not created, main dag failed | Some subtasks of the agents failed to be created | Check the availability and connectivity of the Agent. |
| Task.SubDag.NotAllPassed | Not all sub dag passed, main dag failed | Some subtasks of the agents failed to be skipped | Check the failed subtasks and resolve the issue. |
| Task.SubDag.NotAllReady | Sub dag of agents: %v not ready, can not advance main dag | Some subtasks of the agents are not ready | Wait for all subtasks to be ready, or check for issues. |
| Task.SubDag.NotAllSucceed | Sub dag of agents: %v failed, main dag failed | Some subtasks of the agents failed | Check the failed subtasks and resolve the issue. |
| Task.Template.Empty | Task template is empty | The task template is empty | Contact OceanBase Technical Support. |