ApsaraDB for MongoDB:Troubleshooting

Error message

Cause and solution

Specified parameter AccountDescription is not valid.

When you restore backup data to a new instance, ensure that the instance name meets the specified limits.

Shard total number is out of range.

When you restore data from a sharded cluster instance to a new instance, ensure that the new instance has the same number of shards as the source instance.

The downgrading dbinstance storage does not supported.

ApsaraDB for MongoDB does not support reducing the storage capacity of an instance. To reduce the storage capacity, create a new instance to replace the source one. See Other configuration change scenarios and methods.

The classic network is no longer supported. We recommend that you use a VPC.

You can no longer renew, change the instance type, or change the billing method for ApsaraDB for MongoDB instances that are in the classic network. See [Notice] EOL for ApsaraDB for MongoDB instances on the classic network.

Insufficient resources for the requested operation.

This error occurs because the zone where the instance resides has insufficient resources for the upgrade. Try changing the instance to a different specification or submit a ticket to contact technical support for assistance.

The oplog of the source database is not enabled.

This error occurs if you fail to configure a data migration task. Check the instance architecture. Standalone instances do not have an oplog and therefore do not support incremental migration with Data Transmission Service (DTS). Configure a full migration instead.

The request references an incorrect component. Contact customer support.

This error can occur during instance purchase because resource availability varies by zone. Try changing the zone or instance type, or submit a ticket to contact technical support for assistance.

The request was denied due to API rate limiting.

To manage and control API access, Alibaba Cloud limits the frequency of API calls. View your quotas and request a quota increase in the Quota Center.

Insufficient read privileges for the database.

When you use DTS to migrate data, the database accounts for the source and destination databases must have the required permissions. Here's how to grant the permissions:

• Permissions required for database accounts of standalone instances

• Permissions required for database accounts of replica set instances

• Permissions required for database accounts of sharded cluster instances

Specified restore time is not valid.

When you restore an instance by calling an API, ensure that the restore time is valid. The time must be in the yyyy-MM-ddTHH:mm:ssZ format and specified in UTC. For example, to convert the Beijing time (UTC+8) of `2024-11-08 20:00:00` to UTC, subtract 8 hours. The result is `2024-11-08T12:00:00Z`.

server returned error on SASL authentication step: BSON field 'saslContinue.mechanism' is an unknown field.

When you restore an instance across versions, authentication fails if the authentication mechanisms are different. The default authentication mechanism for MongoDB 4.0 is SCRAM-SHA-1. The default for MongoDB 5.0 and later is SCRAM-SHA-256. When you restore an instance across versions, use an earlier version of the mongorestore tool, such as version 4.0.

TypeError: db.xxx.find is not a function.

The collection name might be a reserved keyword. Use db.getCollection("xxx").find to run the query, or rename the collection.

createUser failed: Command failed with error xx (Unauthorized): 'not authorized on admin to execute command xxx.

An Alibaba Cloud account has limited permissions and cannot be granted write permissions on the admin system database. This is to prevent performance jitter that can be caused by writing data to the admin database. For more information about how to create an account with the required permissions, see Permissions of the root account specified during instance creation.

The specified network type does not match.

If a classic network security group is already added to the instance, you cannot add a VPC security group.

The instance's minor version is not supported by this API.

The minor version of the instance is too old. Upgrade the minor version of the database.

The instance is at the End of Full Support (EOFS) stage.

The instance version is in the End of Full Support (EOFS) stage and cannot be renewed. Upgrade the major version of the database.

Resource unavailable.

This error indicates that a resource issue occurred when you created, upgraded, or downgraded an instance. We recommend that you obtain the Request ID and submit a ticket to contact technical support for assistance.

Error message

Cause and solution

network error while attempting to run command 'isMaster' on host 'dds-xxxx.mongodb.rds.aliyuncs.com:3717' :exception: connect failed

• Cause 1: The instance connections have been exhausted.

  Solution:

  1. Check whether the instance connections are exhausted. For more information, see How do I query the number of connections to my instance?

  2. Optimize connection usage. For more information, see What do I do if the number of connections to my instance reaches the upper limit?

• Cause 2: Incorrect whitelist settings.

  Solution: Add the correct IP address to an IP address whitelist of the ApsaraDB for MongoDB instance.

• Timed out after 3000ms while waiting for a server that matches ReadPreferenceServerSelector{readPreference=primary}. exception=(com.mongodb.MongoSocketReadException: Prematurely reached end of stream)

• Socket recv() errno:54 Connection reset by peer x.x.x.x:27017

The number of connections to the ApsaraDB for MongoDB instance may have reached the upper limit, and no new connections can be established.

Solution:

1. Check whether the instance connections are exhausted. For more information, see How do I query the number of connections to my instance?

2. Optimize connection usage. For more information, see What do I do if the number of connections to my instance reaches the upper limit?

MongoDB.Driver.MongoWaitQueueFullException: The wait queue for acquiring a connection to server xxx is full.

The wait queue of the MongoDB driver is full, which may be caused by a small number of connections specified for a connection pool or high concurrent requests. Therefore, no available connections are provided.

Solution:

1. We recommend that you first check the connection pool settings of the program for which this error is reported. For example, make sure that a reasonable number of connections is specified for a connection pool. For more information, see How do I limit the number of connections from my client?

2. If this issue persists after you adjust the program, check whether the ApsaraDB for MongoDB instance has exhausted its connections. For more information, see the following topics:

   1. How do I query the number of connections to my instance?

   2. What do I do if the number of connections to my instance reaches the upper limit?

(TooManyLogicalSessions) Unable to add session into the cache because the number of active sessions is too high.

When an excessive number of concurrent connections are established, available sessions may be exhausted.

Solution:

1. Troubleshoot failed connection issues caused by exhausted connections. For more information, see the following topics:

   1. How do I query the number of connections to my instance?

   2. What do I do if the number of connections to my instance reaches the upper limit?

2. If no issues occur in the terms of the number of connections, check whether other instance performance items cannot meet business requirements.

   1. Use the node monitoring feature to check the usage of common resources (such as CPU utilization and memory usage) and then determine whether the instance specifications meet business requirements.

   2. If the instance specifications are excessively small but the load is high, you can change the instance configurations during off-peak hours.

• getaddrinfo failed.

• No suitable servers found (`serverSelectionTryOnce` set).

Check whether the used instance endpoint is correct. For more information about instance endpoints, see the following topics:

• Connect to a replica set instance

• Connect to a sharded cluster instance

• Failed to connect to 10.*.*.8:3717 after 5000 milliseconds, giving up.Error: couldn't connect to server 10.*.*.8:3717 (10.*.*.8), connection attempt failed

• pymongo.errors.ServerSelectionTimeoutError: dds-xxxx.mongodb.rds.aliyuncs.com:3717: [Errno 113] No route to host,dds-xxxx.mongodb.rds.aliyuncs.com:3717

• InvalidInstanceId.NotFound: The instance not in current vpc.

The ECS instance fails to connect to the ApsaraDB for MongoDB instance over a private network.

Solution:

1. Check whitelist settings. Make sure that the private IP address of the ECS instance is added to an IP address whitelist of the ApsaraDB for MongoDB instance.

2. Ensure network connectivity between the ECS instance and the ApsaraDB for MongoDB instance.

   If the ECS instance and the ApsaraDB for MongoDB instance are in the same VPC, the two instances can directly interconnect over a private network. To connect the ECS instance to the ApsaraDB for MongoDB instance across VPCs, you can use one of the following methods:

   • Migrate the two instances to the same VPC. For more information, see Connect an ECS instance to an ApsaraDB for MongoDB instance in a different region over the internal network and Connect an ECS instance to an ApsaraDB for MongoDB instance within a different Alibaba Cloud account over the internal network.

   • Make sure that the network segments to be interconnected do not conflict, and a connection is established between different VPCs. For more information, see Method 3: Establish a connection between the ECS instance and the ApsaraDB for MongoDB instance by using CEN.

org.springframework.data.mongodb.UncategorizedMongoDbException: Timeout while receiving message; nested exception is com.mongodb.MongoSocketReadTimeoutException: Timeout while receiving message

• Cause 1: Abnormal slow queries consume instance resources, which causes CPU utilization to spike or even reach its peak.

  Solution: Check whether slow queries exist and consider adding indexes for optimization. For more information, see Troubleshoot high CPU utilization issues on an instance.

• Cause 2: Incorrect connection pool settings on the application side, such as timeout settings.

  Solution: For more information, see the following topics:

  1. How do I query the number of connections to my instance?

  2. What do I do if the number of connections to my instance reaches the upper limit?

• "errmsg": "not master", "code": 10107, "codeName": "NotMaster"

• "errmsg": "not master", "code": 10107, "codeName": "NotWritablePrimary"

• Time out after 30000ms while waiting for a server that matches writableServerSelector.

• Command failed with error 10107 (NotWritablePrimary): 'not primary' on server xxx.

• Explain's child command cannot run on this node. Are you explaining a write command on a secondary?

• not master and slaveOk=false.

• MongoNotPrimaryException: Command failed with error 10107 (NotMaster): 'not master' on server xxx.

• reason: TopologyDescription { type: 'ReplicaSetNoPrimary',...}

Data is not written to the primary node in the replica set instance.

Cause: You can perform write operations only on the primary node. If you previously used the endpoint of the primary node for connection, the connected node becomes a secondary node and write operations fail after a primary/secondary switchover.

Solution:

• If your application runs in a production environment, we recommend that you use a connection string URI to connect your application to the instance. When a node fails, read/write operations on your application are not affected by a primary/secondary switchover. For more information about instance endpoints, see the following topics:

  • Connect to a replica set instance

  • Connect to a sharded cluster instance

• Manually switch the role of a node. Switch the node whose endpoint is used for connection to the new primary node.

We recommend that you ensure that your application can automatically reconnect to an ApsaraDB for MongoDB instance after it is disconnected and handle exceptions to protect business continuity.

[Unauthorized] cloud instance error, disk locked, plz check and upgrade your disk quota,

The ApsaraDB for MongoDB instance is locked due to exhausted disk space.

Solution: For more information, see What do I do if my instance is locked or data cannot be written to the instance due to exhausted disk space?

(AuthenticationFailed) Authentication failed.

• Cause 1: The password of the database account contains special characters. Special characters include ! @ # $ % ^ & * ( ) _ + =

  Solution: For more information, see How do I resolve failed connection issues due to special characters in the account name or password in a connection string?

• Cause 2: The password of the provided database account is incorrect.

  Solution: Confirm the account name and passwor, or reset the password and try again.

• Cause 3: The authentication database in the used instance endpoint is incorrect.

  Solution: Specify the correct authentication database in the instance endpoint. For more information, see How do I specify an authentication database in a connection?

• Cause 4: The client version is excessively earlier.

  Solution: The mongo shell version must be 3.0 or later. For more information about detailed installation steps, see Install MongoDB. For more information about the version requirements of clients in other languages, see MongoDB Compatibility Tables.

• !xxx@dds-xxx.mongodb.rds.aliyuncs.com: event not found

The password of the provided database account contains special characters. Special characters include ! @ # $ % ^ & * ( ) _ + =

Solution: For more information, see How do I resolve failed connection issues due to special characters in the account name or password in a connection string?

error getting cluster ID: (CommandNotFound) replSetGetConfig is forbidden by cloud provider for security reason

ApsaraDB for MongoDB does not support the replSetGetConfig command. For more information, see What commands are supported and not supported by ApsaraDB for MongoDB?