Thêm nút Cassandra

Edge for Private Cloud phiên bản 4.19.01

Tài liệu này mô tả cách thêm 3 nút Cassandra mới vào một bản cài đặt Edge cho đám mây riêng tư hiện có.

Mặc dù bạn có thể thêm một hoặc hai nút Cassandra vào một bản cài đặt Edge hiện có, nhưng Apigee khuyên bạn nên thêm ba nút cùng một lúc.

Để biết danh sách các yêu cầu về hệ thống đối với nút Cassandra, hãy xem phần Yêu cầu cài đặt.

Cấu hình Edge hiện có

Tất cả cấu trúc liên kết Edge được hỗ trợ cho hệ thống phát hành công khai đều chỉ định sử dụng ba nút Cassandra. Ba nút được chỉ định cho thuộc tính CASS_HOSTS trong tệp cấu hình như dưới đây:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=secret
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" 
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
SMTPPASSWORD=smtppwd

Xin lưu ý rằng thuộc tính REGION chỉ định tên khu vực là "dc-1". Bạn cần thông tin đó khi thêm các nút Cassandra mới.

Sửa đổi tệp cấu hình để thêm ba nút Cassandra mới

Trong ví dụ này, 3 nút Cassandra mới có các địa chỉ IP sau:

  • 10.10.0.14
  • 10.10.0.15
  • 10.10.0.16

Trước tiên, bạn phải cập nhật tệp cấu hình Edge để thêm các nút mới:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
# Add the new node IP addresses.
IP14=10.10.0.14
IP15=10.10.0.15
IP16=10.10.0.16
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
...
# Update CASS_HOSTS to add each new node after an existing nodes. 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"

Điều này đảm bảo rằng các nút hiện có giữ lại chế độ cài đặt mã thông báo ban đầu và mã thông báo ban đầu của mỗi nút mới nằm giữa các giá trị mã thông báo của các nút hiện có.

Định cấu hình Edge

Sau khi chỉnh sửa tệp cấu hình, bạn phải:

  • Định cấu hình lại các nút Cassandra hiện có
  • Cài đặt Cassandra trên các nút mới
  • Định cấu hình lại Máy chủ quản lý

Định cấu hình lại các nút Cassandra hiện có

Trên các nút Cassandra hiện có:

  1. Chạy lại setup.sh bằng hồ sơ "-p c" và tệp cấu hình mới: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

Cài đặt Cassandra trên các nút mới

Trên mỗi nút Cassandra mới:

  1. Cài đặt Cassandra trên ba nút:
    1. Cài đặt apigee-setup trên nút đầu tiên như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
    2. Cài đặt Cassandra trên nút đầu tiên bằng cách sử dụng tệp cấu hình đã cập nhật: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. Lặp lại hai bước này cho các nút Cassandra mới còn lại.
  2. Tạo lại 3 nút Cassandra mới, chỉ định tên khu vực được đặt trong tệp cấu hình theo thuộc tính REGION. Trong ví dụ này, đó là "dc-1":
    1. Trên nút đầu tiên, hãy chạy: 
      /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1

      Trong đó, nodeIP là địa chỉ IP của nút Cassandra.

      Bạn chỉ cần truyền tên người dùng và mật khẩu nếu đã bật tính năng xác thực JMX cho Cassandra.

    2. Lặp lại bước này trên các nút Cassandra mới còn lại.

Định cấu hình lại Máy chủ quản lý

Trên nút Máy chủ quản lý

  1. Chạy lại setup.sh để cập nhật Máy chủ quản lý cho các nút Cassandra mới được thêm: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile

Khởi động lại tất cả Bộ định tuyến và Bộ xử lý thông báo

  1. Trên tất cả bộ định tuyến: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  2. Trên tất cả Bộ xử lý thông báo: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Giải phóng dung lượng ổ đĩa trên các nút Cassandra hiện có

Sau khi thêm một nút mới, bạn có thể dùng lệnh nodetool cleanup trên các nút đã có từ trước để giải phóng dung lượng ổ đĩa. Lệnh này xoá các mã thông báo cấu hình không còn thuộc sở hữu của nút Cassandra đã có từ trước.

Để giải phóng dung lượng ổ đĩa trên các nút Cassandra hiện có sau khi thêm một nút mới, hãy thực thi lệnh sau:

/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup

Bạn chỉ cần truyền tên người dùng và mật khẩu nếu đã bật tính năng xác thực JMX cho Cassandra.

Xác minh quá trình tạo lại

Sử dụng các lệnh sau để xác minh rằng quá trình tạo lại đã thành công:

nodetool [-u username -pw password] -h nodeIP netstats

Lệnh này sẽ cho biết MODE: Normal khi nút hoạt động và các chỉ mục được tạo.

nodetool [-u username -pw password] -h nodeIP statusthrift

Cho biết máy chủ Thrift đang chạy, cho phép Cassandra chấp nhận các yêu cầu mới của ứng dụng.

nodetool [-u username -pw password] -h nodeIP statusbinary

Sẽ cho biết rằng phương thức truyền tải gốc (hoặc giao thức nhị phân) đang chạy.

nodetool describecluster

Phải cho thấy các nút mới đang sử dụng cùng một phiên bản giản đồ với các nút cũ.

Để biết thêm thông tin về cách sử dụng nodetool, hãy xem tài liệu về cách sử dụng nodetool.