Learn how to connect to a Caching service with a Command Line Interface (CLI).
Managed Databases (also called Cloud Databases) allow you to focus on building and deploying cloud applications while OVHcloud takes care of the database infrastructure and maintenance in operational conditions.
Requirements
- access to the OVHcloud Control Panel
- a Public Cloud project in your OVHcloud account
- a Caching service running on your OVHcloud Cloud Databases (this guide can help you to meet this requirement)
- configure your Caching service to accept incoming connections
Concept
A Caching service can be managed in multiple ways.
One of the easiest, yet powerful, is to use a Command Line Interface (CLI), also known as a Console or Terminal. To interact correctly with the instance, we need to first install something called a client, to connect and control the Caching service remotely.
It's a Client-Server interaction.
Instructions
Installing redis-cli on your client
You first need to install software to interact with your instance remotely. This official software can be installed on various systems like your own computer, a VPS, or a virtual machine. The only requirements are that the system can reach public networks (Internet) and that the user has sufficient privileges to install the software.
To do so and depending on your configuration, you may need to follow the official Redis® documentation to install redis-cli, part of the Redis server package.
We are now ready to learn how to connect to our instance.
Connection
We will now follow the official Redis® documentation to perform our first connection.
In your terminal, type redis-cli -u rediss://<username>:<password>@<hostname>:<port> ping.
The result should look like this:
laptop$ redis-cli -u rediss://redisUser:3FAKExSW6Rez9Xw0admB@redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185 ping Warning: Using a password with '-a' or '-u' option on the command line interface may not be safe. PONG
It means that the instance is running and responding to your command.
To be in interactive mode, do not use any particular command:redis-cli -u rediss://<username>:<password>@<hostname>:<port>.
If you want to log in without authentication, you can try connecting without a user and then use the AUTH command, i.e. redis-cli -u rediss://<hostname>:<port>.
Don't forget you need to modify the username, password, hostname, and port.
In our example, it will look like this:
laptop$ redis-cli -u rediss://redisUser:3FAKExSW6Rez9Xw0admB@redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185 Warning: Using a password with '-a' or '-u' option on the command line interface may not be safe. redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185 PING PONG redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185 HELLO 1) "server" 2) "redis" 3) "version" 4) "6.2.3" 5) "proto" 6) (integer) 2 7) "id" 8) (integer) 20652 9) "mode" 10) "standalone" 11) "role" 12) "master" 13) "modules" 14) (empty array) redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185
redis-cli usage
You can manage your instance using the command line interface in an interactive mode or by setting parameters as redis-cli arguments.
Please follow the official Redis® redis-cli documentation.
In the event of connection or command execution issues
In case you don't use a defined user in your command line or do not have enough privileges, etc., you will get a NOAUTH or AUTH failed response like below.
redis-cli -u rediss://redis-9f6095f3-9f6095f3.database.cloud.ovh.us:20185 ping (error) NOAUTH Authentication required.
In case the user doesn't have the right privilege, you will get a NOPERM response. In this case, please review your user's roles and attached ACL. For further reading, please refer to the Official Redis® ACL documentation.
Go further
Visit the GitHub examples repository to find out how to connect to your database with several languages.
For more information and tutorials, please see our other Cloud Databases support guides or explore the guides for other OVHcloud products and services.