ApsaraDB for Redis:Log on to an ApsaraDB for Redis instance by using DMS

Precautions

• DMS has limits on commands that can be run. For more information, see Syntax support for Redis.

• If the Transport Layer Security (TLS) encryption protocol is enabled for an instance of Redis, you cannot directly log on to the instance by using DMS. You must register the instance in the DMS console and enable SSL encryption in the Advanced Information section. For more information, see Register an Alibaba Cloud database instance.

Procedure

1. Log on to the ApsaraDB for Redis console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click the instance ID.

2. In the upper-right corner of the page, click Log into Database.

3. In the DMS console to which you are redirected, configure the logon method.

   Access mode	Description
   Account + password login (Recommended)	Enter the database account and password. For more information about how to create a database account, see Create and manage database accounts. Note By default, a Redis instance comes with a database account named after the instance ID, such as r-bp10noxlhcoim2****. You can use this account for logon. The account password was specified when you created the instance.
   noSecret login	If password-free access is enabled for the Redis instance, you can log on to the instance without the need to enter a password. For more information, see Enable password-free access.
   password login	Use the password that you specified when you created the Redis instance to log on to the instance. The password is created for the database account that is named after the instance ID.

   Note

   If you forget your password, reset it. For more information, see Change or reset the password.

   Use the default values for other parameters.

4. Click Login.

   If you do not add the IP address of the DMS server to a whitelist of the Redis instance, a dialog box appears and prompts you to click Configure Whitelist. The system creates a whitelist named ali_dms_group for the Redis instance and adds the IP address of the DMS server to this whitelist.

   Figure 1. Logon completion example

5. After you log on to the instance, you can run commands on the SQLConsole page. For example, you can run the DBSIZE command to query the number of keys in the current database.

   For information about the commands supported by Redis, see Overview.

FAQ

• I have previously logged on to an ApsaraDB for Redis instance by using DMS and now receive the ERR invalid password. error when I attempt to log on to the instance again. Why?

  Upon initial successful logon, DMS stores the entered username and password. If you have changed the password since the initial successful logon, this error is reported.

  Solution: In the DMS instance list, find the instance that you want to manage and choose More > Edit in the Actions column. Then, enter the new password in the Database Password field and try again.

• Why is the java.net.SocketTimeoutException: Read timed out TraceId error reported when I attempt to log on to an instance by using DMS?

  If you choose to log on to the Redis instance by using the instance ID in the DMS console, DMS uses the default virtual private cloud (VPC) endpoint and port (6379) to log on to the Redis instance. If you have changed the VPC endpoint or port of the instance, this error is reported.

  Solution: In the DMS instance list, find the instance that you want to manage and choose More > Edit in the Actions column. In the dialog box that appears, set Connection Method to Connection String Address. Then, enter the new endpoint in the Connection String Address field and try again.