Thêm nút Cassandra

Edge cho đám mây riêng tư 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 thiết bị Edge hiện có để cài đặt Đám mây riêng tư.

Mặc dù có thể thêm 1 hoặc 2 nút Cassandra vào bản cài đặt Edge hiện có, nhưng Apigee khuyên bạn nên thêm 3 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 Yêu cầu về việc 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 một hệ thống phát hành chính thức đều chỉ định sử dụng 3 nút Cassandra. Ba nút này được chỉ định cho thuộc tính CASS_HOSTS trong tệp cấu hình như minh hoạ 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

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 nằm tại 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ó vẫn giữ lại chế độ cài đặt mã thông báo ban đầu của chúng, và mã thông báo ban đầu của mỗi nút mới nằm giữa 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 tệp setup.sh với cấu hình "-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 3 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 thiết lập apigee của Edge.
    2. Cài đặt Cassandra ở nút đầu tiên bằng cách 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 2 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 bằng thuộc tính REGION. Trong ví dụ này, giá trị là "dc-1":
    1. Ở 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 phương thức 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 Management-Server

  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 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ư

  1. Trên tất cả Bộ định tuyến: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  2. Trên mọi Bộ xử lý thư: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Dung lượng ổ đĩa trống 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ó sẵn để giải phóng dung lượng ổ đĩa. Lệnh này sẽ 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ó sẵn.

Để giải phóng dung lượng ổ đĩa trên các nút Cassandra có sẵn 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 phương thức xác thực JMX cho Cassandra.

Xác minh bản dựng lại

Hãy 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ẽ chỉ ra MODE: Normal khi nút tăng và chỉ mục được tạo.

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

Nên chỉ ra rằng máy chủ tiết kiệm đang chạy, cho phép Cassandra chấp nhận các yêu cầu ứng dụng mới.

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

Nên chỉ báo 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

Sẽ hiển thị 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 công cụ nút.