Help Center> GeminiDB> GeminiDB Redis API> Getting Started with GeminiDB Redis API> Step 2: Connect to the Instance> Connecting to a GeminiDB Redis Instance Over Private Networks> Connecting to an Instance Using a Load Balancer Address (Recommended)
Updated on 2024-05-20 GMT+08:00
View PDF

Connecting to an Instance Using a Load Balancer Address (Recommended)

This section describes how to connect to a GeminiDB Redis instance using a load balancer address on a Linux ECS. Load balancing can improve data reliability and eliminate single point of failures (SPOFs).

Precautions

  • The instances must be in the same VPC and subnet as the ECS.
  • The ECS must be in a security group that has access to the instances.

    Scenario 1: If the instance is associated with the default security group, you do not need to configure security group rules.

    Scenario 2: If the instance is not associated with the default security group, check whether the security group rules allow the ECS to connect to the instance.

    • If yes, the ECS can connect to the instance.
    • If no, add an inbound rule to the security group.

      For details about how to configure a security group, see Configuring Security Group Rules.

Prerequisites

Procedure

  1. Log in to the ECS. For details, see Logging In to an ECS in Getting Started with Elastic Cloud Server.
  2. Obtain the Redis client.

    Method 1

    Run the following command to download the Redis client.

    wget http://download.redis.io/releases/redis-6.2.0.tar.gz

    Method 2

    Download the Redis client from the address provided in Prerequisites and upload the Redis client installation package to the ECS.

  3. Decompress the client tool package.

    tar -xzf redis-6.2.0.tar.gz

  4. Connect to the DB instance in the src directory.

    cd redis-6.2.0

    make

    cd src

    ./redis-cli -h <DB_HOST> -p <DB_PORT> -a <DB_PWD>

    Example:

    ./redis-cli -h 192.xx.xx.xx -p 8635 -a <DB_PWD>

    Table 1 Parameter description

    Parameter

    Description

    <DB_HOST>

    Load balancer IP address of the instance to be connected.

    After the load balancer IP address is created, click the instance name to go to the Basic Information page and obtain the load balancer IP address in the Network Information area.

    <DB_PORT>

    Access port corresponding to the load balancer IP address of the instance.

    Click the name of the instance to go to the Basic Information page. In the Network Information area, you can find the access port in field Load Balancer IP Address.

    <DB_PWD>

    Specifies the administrator password set when you buy a GeminiDB Redis instance.

  5. Check the results. If the following information is displayed, the connection is successful.

    IP:port>