Updated on 2024-07-29 GMT+08:00

Connecting to Memcached on the Libmemcached (C++)

Access a DCS Memcached instance using a C++ client on an ECS in the same VPC.

Prerequisites

  • The DCS Memcached instance you want to access is in the Running state.
  • Log in to the ECS. For details on how to create ECSs, see the Elastic Cloud Server User Guide.

    An ECS can communicate with a DCS instance that belongs to the same VPC and is configured with the same security group.

    • If the ECS and DCS instance are not in the same VPC, you can establish a VPC peering connection to achieve network connectivity between the ECS and DCS instance. For details, see Does DCS Support Cross-VPC Access?
    • If different security groups have been configured for the ECS and DCS instance, you can set security group rules to achieve network connectivity between the ECS and DCS instance. For details, see Security Group Configurations.
  • GCC has been installed on the ECS. The recommended version is 4.8.4 or later.
  • You have obtained the libmemcached-x.y.z.tar.gz dependency package.

    x.y.z indicates the version of the dependency package. The latest version is recommended.

Connecting to Memcached on the Libmemcached (C++)

  1. Log in to the DCS console.
  2. Click in the upper left corner of the management console and select the region where your instance is located.
  3. In the navigation pane, choose Cache Manager.
  4. On the Cache Manager page, click the name of the DCS Memcached instance you want to access. Obtain the IP address and port number of the instance.
  5. Upload the obtained libmemcached-x.y.z.tar.gz dependency package to the created ECS.
  6. Log in to the ECS.
  7. Install related SASL dependency packages.

    For OSs of Debian series: apt install libsasl2-dev cloog.ppl

    For OSs of Red Hat series: yum install cyrus-sasl*

  8. Run the following commands to install the dependency package:

    tar -xzvf libmemcached-x.y.z.tar.gz

    cd libmemcached-x.y.z

    ./configure --enable-sasl

    make

    make install

  9. Create a file named build.sh and copy the following code to the file.

    g++ -o dcs_sample dcs_sample.cpp -lmemcached -std=c++0x -lpthread -lsasl2

    If the libmemcached.so.11 file cannot be found during compilation, run the find command to find the file and copy the file to the /usr/lib directory.

  10. Create a file named dcs_sample.cpp, copy the following C++ code to the file, and modify the code.

    • Example code for the password mode
      Change ip and port to the IP address and port number obtained in 4. Set userName and password respectively to the username and password of the Memcached instance.
      #include <iostream>
      #include <string>
      #include <libmemcached/memcached.h>
      using namespace std;
      
      #define IP  "ip"
      #define PORT  "port"
      #define USERNAME "userName"
      #define PASSWORD "password"
      memcached_return result;
      
      memcached_st * init()
      {
          memcached_st *memcached = NULL;
          memcached_server_st *cache;
          memcached = memcached_create(NULL);
          cache = memcached_server_list_append(NULL, IP, PORT, &result);
      
          sasl_client_init(NULL);
               memcached_set_sasl_auth_data(memcached, USERNAME, PASSWORD); 
               memcached_behavior_set(memcached,MEMCACHED_BEHAVIOR_BINARY_PROTOCOL,1);
               memcached_server_push(memcached,cache);
               memcached_server_list_free(cache);
                  return memcached;
      }
      
      int main(int argc, char *argv[])
      {
               memcached_st *memcached=init();
          string key = "memcached";
          string value = "hello world!";
          size_t value_length = value.length();
          int expire_time = 0;
          uint32_t flag = 0;
      
          result = memcached_set(memcached,key.c_str(),key.length(),value.c_str(),value.length(),expire_time,flag);  
          if (result != MEMCACHED_SUCCESS){
            cout <<"set data failed: " << result << endl;
            return -1;
          }
          cout << "set succeed, key: " << key << ", value: " << value << endl;
          cout << "get key:" << key << endl;
          char* result = memcached_get(memcached,key.c_str(),key.length(),&value_length,&flag,&result);
          cout << "value:" << result << endl;
                      
          memcached_free(memcached);
          return 0;
      }
    • Example code for the password-free mode

      Change ip and port to the IP address and port number obtained in 4.

      #include <iostream>
      #include <string>
      #include <libmemcached/memcached.h>
      using namespace std;
      
      #define IP  "ip"
      #define PORT  port
      memcached_return result;
      
      memcached_st * init()
      {
          memcached_st *memcached = NULL;
          memcached_server_st *cache;
          memcached = memcached_create(NULL);
          cache = memcached_server_list_append(NULL, IP, PORT, &result);
               memcached_server_push(memcached,cache);
          memcached_server_list_free(cache);
               return memcached;
      }
      
      int main(int argc, char *argv[])
      {
               memcached_st *memcached=init();
          string key = "memcached";
          string value = "hello world!";
          size_t value_length = value.length();
          int expire_time = 0;
          uint32_t flag = 0;
      
          result = memcached_set(memcached,key.c_str(),key.length(),value.c_str(),value.length(),expire_time,flag);  
          if (result != MEMCACHED_SUCCESS){
            cout <<"set data failed: " << result << endl;
            return -1;
          }
          cout << "set succeed, key: " << key << " ,value: " << value << endl;
          cout << "get key:" << key << endl;
          char* result = memcached_get(memcached,key.c_str(),key.length(),&value_length,&flag,&result);
          cout << "value:" << result << endl;
                       
          memcached_free(memcached);
          return 0;
      }

  11. Run the following commands to compile the source code:

    chmod 700 build.sh

    ./build.sh

    The dcs_sample binary file is generated.

  12. Run the following command to access the chosen DCS Memcached instance:

    ./dcs_sample
    set succeed, key: memcached ,value: hello world!
    get key:memcached
    value:hello world!