Help Center/ GeminiDB/ GeminiDB Cassandra API/ Best Practices/ Buying and Connecting to a GeminiDB Cassandra Instance
Updated on 2025-08-04 GMT+08:00
View PDF
Share

Buying and Connecting to a GeminiDB Cassandra Instance

This section describes how to buy a GeminiDB Cassandra instance and uses a Linux ECS as an example to describe how to connect to the instance over a private network.

Buying a GeminiDB Cassandra Instance

  1. Log in to the Huawei Cloud console.
  2. In the service list, choose Databases > GeminiDB.
  3. On the Instances page, click Buy DB Instance.
  4. Click Buy DB Instance, select a billing mode, and configure instance parameters. Then, click Next and complete subsequent operations.

    Figure 1 Basic information

    Figure 2 Setting a password

  5. View the purchased GeminiDB Cassandra instance.

    Figure 3 Available instance

Buying an ECS

  1. Log in to the Huawei Cloud console.
  2. In the service list, choose Compute > Elastic Cloud Server. On the Elastic Cloud Server console, click Buy ECS.

  3. Configure basic settings and click Next: Configure Network. Make sure that the ECS is in the same region, AZ, VPC, and security group as the GeminiDB Cassandra instance you created.

    Figure 4 Basic settings
    Figure 5 Selecting specifications
    Figure 6 Selecting an image

  4. Configure the network and click Next: Configure Advanced Settings. Make sure that the ECS is in the same VPC and security group as the GeminiDB Cassandra instance.

    • If security group rules allow access from the ECS, you can connect to the instance using the ECS.
    • If the security group rules do not allow access from the ECS, add an inbound rule to the security group.
    Figure 7 Network settings
    Figure 8 Selecting an EIP

  5. Configure a password for the ECS and click Next: Confirm.

    Figure 9 Advanced settings

  6. Confirm the configurations and click Submit.

    Figure 10 Confirming the configurations

  7. View the purchased ECS.

Connecting to the GeminiDB Cassandra Instance

  1. On the ECS console, log in to the ECS using the remote login option.

    Figure 11 Remote login

  2. Enter the username and password of the ECS.

    Figure 12 Entering the username and password

  3. Download the Cassandra installation package and upload it to the ECS.

    Method 1:

    wget https://dbs-download.obs.cn-north-1.myhuaweicloud.com/nosql/Cassandra_cqlsh_x86_64.zip

    Method 2:

    Download the Cassandra client installation package using your browser and upload it to the ECS.

  4. Decompress the client package.

    unzip Cassandra_cqlsh_x86_64.zip

  5. Make the files executable:

    chmod +x *

  6. Connect to the instance in the directory where cqlsh is located.

    ./cqlsh <DB_HOST> <DB_PORT> -u <DB_USER>

    Example:

    ./cqlsh 192.xx.xx.xx 8635 -u rwuser

    Table 1 Required description

    Parameter

    Description

    <DB_HOST>

    The private IP address of the instance to be accessed.

    To obtain this IP address, go to the Instances page, locate the instance, and click its name. The IP address can be found in the Private IP Address field under Node Information on the Basic Information page.

    If the GeminiDB Cassandra instance you purchased has multiple nodes, select the private IP address of any node.

    <DB_PORT>

    The port used to access the instance. The default port number is 8635. Set this parameter based on service requirements.

    Click the instance name to go to the Basic Information page and obtain the port number in the Network Information area.

    <DB_USER>

    Username of the instance administrator. The default value is rwuser.

  7. If information similar to the following is displayed, the connection was successful. 

    rwuser@cqlsh>

Parent Topic: Best Practices