Di chuyển Máy chủ Apigee

Edge for Private Cloud phiên bản 4.17.01

Các thành phần Apigee sử dụng địa chỉ IP để giao tiếp với nhau. Việc di chuyển các thành phần từ máy này sang máy khác có thể làm cho cấu hình không khớp. Để khắc phục các trường hợp cấu hình không khớp, hãy làm theo các hướng dẫn có liên quan bên dưới.

Thay đổi địa chỉ IP của nút Cassandra

Để thay đổi địa chỉ IP của nút Cassandra, hãy thực hiện các bước sau:

Đối với cấu hình có một nút Cassandra

  1. Chỉnh sửa /opt/apigee/customer/application/cassandra.properties trên hệ thống đang được sửa đổi. Hãy tạo tệp nếu chưa có.
  2. Thay đổi các thông số sau:
    • Đặt các thông số conf_cassandra_seeds và conf_cassandra_listen_address để chỉ định địa chỉ IP mới của hệ thống.
    • Thay đổi conf_cassandra_rpc_address để sử dụng địa chỉ IP mới hoặc 0.0.0.0 (cho phép Cassandra Thrift nghe trên tất cả các giao diện).
  3. Mở /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties trong trình chỉnh sửa. Bạn sẽ thấy địa chỉ IP cũ và chế độ cài đặt mặc định trong biểu mẫu:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    Lưu thông tin đó.
  4. Chỉnh sửa /opt/apigee/customer/application/cassandra.properties để thay đổi địa chỉ IP cũ được chỉ định thành địa chỉ IP mới:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Đảm bảo bạn đã tìm thấy địa chỉ IP "\n" và cài đặt mặc định ở bước 3 và giống như bước 3
  5. Khởi động lại Cassandra:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra khởi động lại
  6. Nếu cần, bạn cũng nên sửa cả ZooKeeper (xem bên dưới), nếu không, hãy khởi động lại mọi thành phần của nền tảng Apigee bắt đầu bằng Máy chủ quản lý.

Đối với cấu hình có nhiều nút Cassandra (nhẫn)

  1. Nếu nút đang được thay đổi là nút gốc, hãy chỉnh sửa tệp /opt/apigee/customer/application/cassandra.properties trên mỗi hệ thống trong vòng và thay đổi thông số conf_cassandra_seeds để bao gồm IP mới của hệ thống đã sửa đổi. Nếu tệp cassandra.properties chưa có, hãy tạo tệp đó.
  2. Chỉnh sửa /opt/apigee/customer/application/cassandra.properties trên hệ thống đang được sửa đổi và thay đổi các thông số sau:
    • Đặt conf_cassandra_listen_address để sử dụng địa chỉ IP mới.
    • Đặt conf_cassandra_rpc_address để sử dụng địa chỉ IP mới hoặc 0.0.0.0 (cho phép Cassandra Thrift nghe trên tất cả các giao diện).
  3. Mở /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties trong trình chỉnh sửa. Bạn sẽ thấy tất cả địa chỉ IP Cassandra và chế độ cài đặt mặc định ở dạng:
    192.168.56.101=dc-1:ra-1
    192.168.56.102=dc-1:ra-1
    192.168.56.103=dc-1:ra-1
    Save that
    Save that
  4. Chỉnh sửa /opt/apigee/customer/application/cassandra.properties để thay đổi địa chỉ IP cũ được chỉ định thành địa chỉ IP mới:
    /opt/apigee/customer/application/cassandra.properties

  5. Khởi động lại Cassandra trên hệ thống đã sửa đổi. Nếu hệ thống được sửa đổi là nút gốc, hãy khởi động lại từng hệ thống có dùng nút gốc đã sửa đổi.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra khởi động lại
  6. Chạy lệnh nodetool ring (vòng nút công cụ) trên nút đã sửa đổi để đảm bảo rằng vòng này đã hoàn tất. Bạn có thể tìm thấy tiện ích này tại opt/apigee/apigee-cassandra/bin.
    > buttontool -h localhost vòng
  7. Chạy quy trình sửa chữa công cụ cho nút trên nút đã sửa đổi. Xin lưu ý rằng quá trình này có thể mất chút thời gian. Vì vậy, bạn không nên làm việc này trong những giờ có lưu lượng truy cập API cao nhất.
    >nodetool -h localhost sửa chữa
  8. Nếu cần, hãy sửa chữa ZooKeeper (xem bên dưới), sau đó khởi động lại mọi thành phần của nền tảng Apigee bắt đầu bằng Máy chủ quản lý

Cập nhật gói đăng ký kho dữ liệu

  1. Tìm mã nhận dạng duy nhất (UUID) của các lượt đăng ký kho dữ liệu chỉ định địa chỉ IP cũ bằng cách dùng các lệnh bên dưới. Ghi lại các thông số "type" và "UUID":
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=engagement&region=DC" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '(type|internalip|uuid|region)'

      trong đó DC là tên trung tâm dữ liệu. Trong một lần cài đặt trung tâm dữ liệu, giá trị thường là "dc-1".
  2. Đăng ký địa chỉ IP mới bằng một trong các lệnh bên dưới. Lệnh cần dùng sẽ phụ thuộc vào loại nút được thay đổi.

    Lưu ý: Tham số REGION dưới đây đề cập đến trung tâm dữ liệu chứa cụm. Ví dụ: để có khả năng đáp ứng cao, thường thì bạn sẽ có một cụm trong dc-1 (Trung tâm ngày 1) và một cụm trong dc-2 (Trung tâm dữ liệu 2). Thông số này được xác định tại thời điểm cài đặt. Giá trị mặc định là dc-1.
    • Đối với type="application-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}&region=${REGION}&pod=engagement"
    • Đối với type="km-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=K km-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${NEWIP}&region=$way REGION-datastore:
    • Đối với type="reportcrud-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}&region=${REGION}&pod=analytics" -H 'content-type: application/x-www-form-url encrypted
  3. Xoá các lượt đăng ký cũ cho mã nhận dạng duy nhất (UUID) của hệ thống mà địa chỉ IP đã thay đổi. Đối với từng vấn đề về mã nhận dạng duy nhất (UUID) sau đây:
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

Thay đổi địa chỉ IP của nút ZooKeeper

Hãy làm theo các bước bên dưới để thay đổi địa chỉ IP của nút ZooKeeper:

Thay đổi Địa chỉ IP và khởi động lại quần thể ZooKeeper (chỉ dành cho các cấu hình tập hợp nhiều nút)

  1. Mở /opt/apigee/apigee-zookeeper/conf/zoo.cfg trong trình chỉnh sửa. Bạn sẽ thấy tất cả địa chỉ IP của ZooKeeper và chế độ cài đặt mặc định trong biểu mẫu:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168:588.803 Lưu thông tin đó    .

  2. Trên mỗi nút ZooKeeper, hãy chỉnh sửa tệp /opt/apigee/customer/application/zookeeper.properties để đặt thuộc tính conf_zoo_quorum thành địa chỉ IP chính xác. Hãy tạo tệp nếu chưa có.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n
    trong mỗi nút IP\n
  3. Tìm trưởng nhóm của ZooKeeper bằng cách sử dụng lệnh sau (thay thế <node> bằng địa chỉ IP của máy Zookeeper):
    echo srvr | nc <node> 2181

    Dòng Mode trong kết quả phải có nội dung là "leader".
  4. Khởi động lại một ZooKeeper sau lệnh khác bắt đầu bằng trưởng nhóm và kết thúc bằng nút mà địa chỉ IP đã thay đổi. Nếu nhiều nút của người quản lý vườn thú thay đổi địa chỉ IP, thì có thể bạn cần phải khởi động lại tất cả các nút.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper khởi động lại
  5. Sử dụng lệnh echo được mô tả ở trên để xác minh từng nút ZooKeeper.

Thông báo cho các nút Apigee về cấu hình đã thay đổi

  1. Trên mỗi nút Bộ định tuyến, hãy chỉnh sửa tệp /opt/apigee/customer/application/router.properties như sau. Hãy tạo tệp nếu chưa có.
    • Thay đổi tham số conf_zookeeper_connection.string để thêm địa chỉ IP mới
    • Thay đổi tham số conf_zookeeper_zk1.host để thêm địa chỉ IP mới
  2. Trên mọi nút Trình xử lý thông báo, hãy chỉnh sửa tệp /opt/apigee/customer/application/message-processor.properties như sau. Hãy tạo tệp nếu chưa có.
    • Thay đổi tham số conf_zookeeper_connection.string để thêm địa chỉ IP mới
    • Thay đổi tham số conf_zookeeper_zk1.host để thêm địa chỉ IP mới
  3. Trên nút Máy chủ quản lý, hãy chỉnh sửa tệp /opt/apigee/customer/application/management-server.properties như sau. Hãy tạo tệp nếu chưa có.
    • Thay đổi tham số conf_zookeeper_connection.string để thêm địa chỉ IP mới
    • Thay đổi tham số conf_zookeeper_zk1.host để thêm địa chỉ IP mới
  4. Khởi động lại tất cả thành phần của nền tảng Apigee bằng cách chạy lệnh sau trên mỗi nút:
    /opt/apigee/apigee-service/bin/apigee-all restart

Thay đổi địa chỉ IP của máy chủ LDAP (Open LDAP)

Để thay đổi địa chỉ IP của nút OpenLDAP, hãy làm như sau:

  1. Trên nút Máy chủ quản lý, hãy chỉnh sửa tệp /opt/apigee/customer/application/management-server.properties. Hãy tạo tệp nếu chưa có.
  2. Trong tệp management-server.properties, hãy đặt thông số conf_security_ldap.server.host thành địa chỉ IP mới.
  3. Khởi động lại Máy chủ quản lý:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-management-server khởi động lại

Thay đổi địa chỉ IP của các loại nút Apigee khác

Cách thay đổi địa chỉ IP của bất kỳ loại nút nào trong số này (Bộ định tuyến, Bộ xử lý thông báo, Máy chủ Postgres (không phải postgresql) và Máy chủ Qpid (không qpidd):

  1. Dùng lệnh cURL sau đây để đăng ký địa chỉ IP nội bộ và bên ngoài mới:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINs/EMAIL1 -X MSIPT -X MSIPT -X

Nếu không biết UUID của nút, bạn có thể sử dụng lệnh sau để hiển thị nút:

  • Bộ định tuyến: curl http://<router_IP>:8081/v1/servers/self
  • Trình xử lý thư: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self