Cài đặt các thành phần Edge trên một nút

Sau khi bạn cài đặt tiện ích Edge apigee-setup trên một nút, hãy sử dụng tiện ích apigee-setup để cài đặt một hoặc nhiều thành phần Edge trên nút đó.

Tiện ích apigee-setup sử dụng một lệnh có dạng:

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Trong đó, component là thành phần Edge cần cài đặt và configFile là tệp cấu hình tự động chứa thông tin cài đặt. Người dùng "apigee" phải có quyền truy cập hoặc đọc tệp cấu hình. Ví dụ: bạn có thể tạo một thư mục mới cho các tệp, đặt các tệp đó vào thư mục /usr/local hoặc /usr/local/share hoặc bất kỳ nơi nào khác trên nút mà người dùng "apigee" có thể truy cập.

Ví dụ: để cài đặt Edge Management Server, hãy làm như sau:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Để biết thông tin về cách cài đặt apigee-setup Edge, hãy xem bài viết Cài đặt tiện ích apigee-setup của Edge.

Những điều cần lưu ý khi cài đặt

Khi viết tệp cấu hình, hãy cân nhắc các lựa chọn sau.

Thiết lập tính năng sao chép chính-phụ của Postgres

Theo mặc định, Edge sẽ cài đặt tất cả các nút Postgres ở chế độ chính. Tuy nhiên, trong các hệ thống sản xuất có nhiều nút Postgres, bạn phải định cấu hình các nút đó để sử dụng tính năng sao chép chính-dự phòng để nếu nút chính gặp lỗi, nút dự phòng có thể tiếp tục phân phát lưu lượng truy cập.

Bạn có thể bật và định cấu hình tính năng sao chép chính-dự phòng tại thời điểm cài đặt bằng cách sử dụng các thuộc tính trong tệp cấu hình im lặng. Hoặc bạn có thể bật tính năng sao chép chính-dự phòng sau khi cài đặt. Để biết thêm thông tin, hãy xem bài viết Thiết lập tính năng sao chép chính-dự phòng cho Postgres.

Cài đặt SymasLDAP 2.6.10

Việc cài đặt tại cơ sở yêu cầu SymasLDAP 2.6.10, có trong kho lưu trữ apigee-thirdparty-opdk. Trước khi cài đặt, hãy xoá thư viện symasldap-compat.

Đối với các bản cài đặt 13 máy chủ và 12 máy chủ có hai trung tâm dữ liệu, bạn cần phải sao chép SymasLDAP vì có nhiều nút lưu trữ SymasLDAP.

Bật tính năng xác thực Cassandra

Theo mặc định, Cassandra sẽ cài đặt mà không bật tính năng xác thực. Điều này có nghĩa là bất kỳ ai cũng có thể truy cập vào Cassandra. Bạn có thể bật tính năng xác thực sau khi cài đặt Edge hoặc trong quá trình cài đặt.

Để biết thêm thông tin, hãy xem bài viết Bật tính năng xác thực Cassandra.

Sử dụng cổng được bảo vệ khi tạo máy chủ ảo

Nếu muốn tạo một máy chủ lưu trữ ảo liên kết Bộ định tuyến với một cổng được bảo vệ, chẳng hạn như số cổng nhỏ hơn 1000, thì bạn phải định cấu hình Bộ định tuyến để chạy dưới dạng người dùng có quyền truy cập vào các cổng đó. Theo mặc định, Bộ định tuyến chạy dưới dạng người dùng "apigee" không có quyền truy cập vào các cổng đặc quyền.

Để biết thông tin về cách định cấu hình máy chủ ảo và Bộ định tuyến để truy cập vào các cổng dưới 1000, hãy xem bài viết Thiết lập máy chủ ảo.

Các yêu cầu mới do apigee-qpidd-4.52.01-X.X.X đưa ra

Kể từ phiên bản 4.52.01, các yêu cầu mới đã được đưa ra trong quá trình cài đặt. Bạn cần phải thêm các thuộc tính QPID_MGMT_USERNAME và QPID_MGMT_PASSWORD trong quá trình cài đặt. Đảm bảo bạn thêm các thuộc tính này cùng với các giá trị thích hợp vào tệp cấu hình để quá trình cài đặt diễn ra thành công.

Định cấu hình giao diện người dùng mới của Edge

Giao diện người dùng Edge mới (các thành phần edge-management-ui và edge-management-ui-static) được cài đặt theo mặc định trong quá trình cài đặt Edge. Theo mặc định, Giao diện người dùng Edge mới sử dụng phương thức Xác thực cơ bản, và cũng có thể được định cấu hình để sử dụng tính năng Đăng nhập một lần (SSO) của Apigee hoặc một IDP bên ngoài như SAML hoặc OIDC.

Để biết thêm thông tin về cách định cấu hình Giao diện người dùng Edge mới, hãy xem phần Định cấu hình Giao diện người dùng Edge mới.

Chỉ định các thành phần cần cài đặt

Bảng sau đây liệt kê các tuỳ chọn bạn truyền đến tuỳ chọn -p của tiện ích apigee-service để chỉ định thành phần cần cài đặt trên nút:

Thành phần Mô tả

c

Chỉ cài đặt Cassandra.
zk chỉ cài đặt ZooKeeper.

ds

Cài đặt ZooKeeper và Cassandra.

ld

Chỉ cài đặt SymasLDAP.

mt

Cài đặt Edge Management Server, thao tác này cũng sẽ cài đặt SymasLDAP.

Nếu bạn đặt USE_LDAP_REMOTE_HOST=y trong tệp cấu hình, thì quá trình cài đặt SymasLDAP sẽ bị bỏ qua và Máy chủ quản lý sẽ sử dụng SymasLDAP được cài đặt trên một nút khác.

ms

Cài đặt Edge Management Server, đồng thời cài đặt Giao diện người dùng Edge mới và SymasLDAP.

Nếu bạn đặt USE_LDAP_REMOTE_HOST=y trong tệp cấu hình, thì quá trình cài đặt SymasLDAP sẽ bị bỏ qua và Máy chủ quản lý sẽ sử dụng SymasLDAP được cài đặt trên một nút khác.

r

Chỉ cài đặt Bộ định tuyến biên.

mp

Chỉ cài đặt Bộ xử lý thông báo Edge.

rmp

Cài đặt Bộ định tuyến Edge và Bộ xử lý thông báo.

ue

Cài đặt giao diện người dùng Edge mới (edge-management-ui và edge-management-ui-static).

qs

Chỉ cài đặt Máy chủ Qpid.

ps

Chỉ cài đặt Máy chủ Postgres.
pdb Chỉ cài đặt cơ sở dữ liệu Postgres – chỉ được dùng khi cài đặt cổng Apigee Developer Services (hoặc đơn giản là cổng thông tin). Xem phần Cài đặt cổng thông tin.

sax

Cài đặt các thành phần phân tích, tức là Qpid và Postgres.

Chỉ sử dụng lựa chọn này cho mục đích phát triển và kiểm thử, không dùng cho môi trường phát hành công khai.

mo

Cài đặt tính năng kiếm tiền.

sa

Cài đặt Edge độc lập, tức là Cassandra, ZooKeeper, Máy chủ quản lý, SymasLDAP, Giao diện người dùng Edge mới, Bộ định tuyến và Bộ xử lý thông báo. Lựa chọn này bỏ qua các thành phần phân tích Edge: Qpid và Postgres.

Chỉ sử dụng lựa chọn này cho mục đích phát triển và kiểm thử, không dùng cho môi trường phát hành công khai.

aio

Cài đặt tất cả các thành phần trên một nút duy nhất.

Chỉ sử dụng lựa chọn này cho mục đích phát triển và kiểm thử, không dùng cho môi trường phát hành công khai.
dp

Cài đặt cổng thông tin.

Tạo tệp cấu hình

Tệp cấu hình chứa tất cả thông tin cần thiết để cài đặt Edge. Bạn thường có thể sử dụng cùng một tệp cấu hình để cài đặt tất cả thành phần trong một bản cài đặt Edge.

Tuy nhiên, bạn sẽ phải sử dụng các tệp cấu hình khác hoặc sửa đổi tệp cấu hình nếu:

  • Bạn đang cài đặt nhiều máy chủ SymasLDAP và cần định cấu hình tính năng sao chép trong quá trình cài đặt 13 nút. Mỗi tệp cần có các giá trị khác nhau cho LDAP_SID và LDAP_PEER.
  • Bạn đang tạo nhiều trung tâm dữ liệu trong quá trình cài đặt 12 nút. Mỗi trung tâm dữ liệu đều yêu cầu các chế độ cài đặt khác nhau cho các thuộc tính như ZK_CLIENT_HOSTS và CASS_HOSTS.

Mỗi cấu trúc liên kết cài đặt được mô tả dưới đây cho thấy một tệp cấu hình mẫu cho cấu trúc liên kết đó. Để biết tài liệu tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

Kiểm tra các yêu cầu về hệ thống mà không cần chạy bản cài đặt

Edge cho Đám mây riêng tư hỗ trợ thuộc tính ENABLE_SYSTEM_CHECK=y để kiểm tra các yêu cầu về CPU và bộ nhớ trên máy trong quá trình cài đặt. Tuy nhiên, trong các bản phát hành trước của Edge, bạn phải thực sự cài đặt thì mới kiểm tra được.

Giờ đây, bạn có thể sử dụng cờ "-t" để thực hiện quy trình kiểm tra đó mà không cần cài đặt. Ví dụ: để kiểm tra các yêu cầu về hệ thống cho quá trình cài đặt "aio" mà không thực sự cài đặt, hãy sử dụng lệnh sau:

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

Lệnh này sẽ hiển thị mọi lỗi liên quan đến yêu cầu về hệ thống trên màn hình.

Hãy xem phần Yêu cầu cài đặt để biết danh sách các yêu cầu về hệ thống đối với tất cả thành phần của Edge.

Tệp nhật ký cài đặt

Theo mặc định, tiện ích setup.sh sẽ ghi thông tin nhật ký về quá trình cài đặt vào:

/opt/apigee/var/log/apigee-setup/setup.log

Nếu người dùng chạy tiện ích setup.sh không có quyền truy cập vào thư mục đó, thì tiện ích sẽ ghi nhật ký vào thư mục /tmp dưới dạng một tệp có tên setup_username.log.

Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích setup.sh sẽ không hoạt động.

Cài đặt các thành phần của Edge

Phần này mô tả cách cài đặt các thành phần Edge cho nhiều cấu trúc liên kết. Thứ tự cài đặt thành phần dựa trên cấu trúc liên kết mà bạn muốn.

Tất cả ví dụ về quy trình cài đặt được trình bày dưới đây đều giả định rằng bạn đang cài đặt:

  • Khi tắt tính năng xác thực Cassandra (mặc định). Hãy xem phần Bật tính năng xác thực Cassandra để biết thêm thông tin.
  • Khi tắt tính năng sao chép chính-phụ của Postgres (mặc định). Xem phần Thiết lập tính năng sao chép chính-phụ cho Postgres để biết thêm thông tin.
  • Bộ xử lý thông báo và Bộ định tuyến trên cùng một nút. Nếu bạn cài đặt Bộ xử lý thông báo và Bộ định tuyến trên các nút khác nhau, hãy cài đặt tất cả Bộ xử lý thông báo trước, sau đó cài đặt tất cả Bộ định tuyến.

Điều kiện tiên quyết

Trước khi có thể cài đặt các thành phần Edge, bạn phải:

  • Kiểm tra Yêu cầu cài đặt để biết các điều kiện tiên quyết và danh sách các tệp cần thiết cần có trước khi tiến hành cài đặt. Hãy đảm bảo rằng bạn đã xem xét các yêu cầu trước khi bắt đầu quá trình cài đặt.
  • Tắt SELinux hoặc đặt SELinux ở chế độ cho phép. Hãy xem phần Cài đặt tiện ích apigee-setup của Edge để biết thêm thông tin.

Cài đặt tất cả trong một

  1. Cài đặt tất cả thành phần trên một nút bằng lệnh: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Khởi động lại thành phần Giao diện người dùng Edge mới sau khi quá trình cài đặt hoàn tất: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  3. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  4. Đăng ký tổ chức của bạn như mô tả trong phần Đăng ký tổ chức.

Xem video về cách cài đặt Edge tất cả trong một tại đây.

Dưới đây là tệp cấu hình tự động cho cấu trúc liên kết này. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Cài đặt độc lập 2 nút

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết và số lượng nút của Edge.

  1. Cài đặt Cổng độc lập và nút 1 
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Cài đặt Analytics trên nút 2: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Khởi động lại thành phần Giao diện người dùng Edge mới trên nút 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  5. Đăng ký tổ chức của bạn như mô tả trong phần Đăng ký tổ chức.

Dưới đây là tệp cấu hình tự động cho cấu trúc liên kết này. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem Tài liệu tham khảo về tệp cấu hình Edge.

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Cài đặt 5 nút

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cài đặt cụm Datastore trên các nút 1, 2 và 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý trên nút 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Cài đặt Bộ định tuyến và Bộ xử lý thông báo trên nút 2 và 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Cài đặt Analytics trên nút 4 và 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Khởi động lại thành phần Giao diện người dùng Edge mới trên nút 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  6. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  7. Tham gia tổ chức của bạn như mô tả trong phần Tham gia một tổ chức.

Dưới đây là tệp cấu hình tự động cho cấu trúc liên kết này. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Cài đặt cụm 9 nút

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cài đặt Nút cụm kho dữ liệu trên nút 1, 2 và 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý Apigee trên nút 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Cài đặt Bộ định tuyến và Bộ xử lý thông báo trên các nút 4 và 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Cài đặt Apigee Analytics Qpid Server trên nút 6 và 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Cài đặt Máy chủ Apigee Analytics Postgres trên nút 8 và 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Khởi động lại thành phần giao diện người dùng New Edge trên nút 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  8. Đăng ký tổ chức của bạn như mô tả trong phần Đăng ký tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Cài đặt theo cụm 13 nút

Phần này mô tả thứ tự cài đặt cho một cụm gồm 13 nút. Để xem danh sách các cấu trúc liên kết và số nút của Edge, hãy xem phần Cấu trúc liên kết cài đặt.

Thứ tự cài đặt cho một cụm 13 nút như sau:

  1. Cài đặt Nút cụm kho dữ liệu trên nút 1, 2 và 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt SymasLDAP trên nút 4 và 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Cài đặt Máy chủ quản lý Apigee trên nút 6 và 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Cài đặt Máy chủ Apigee Analytics Postgres trên nút 8 và 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Cài đặt Bộ định tuyến và Bộ xử lý thông báo trên nút 10 và 11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Cài đặt Apigee Analytics Qpid Server trên nút 12 và 13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Khởi động lại thành phần Giao diện người dùng Edge mới trên nút 6 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  8. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  9. Tham gia tổ chức của bạn như mô tả trong phần Tham gia một tổ chức.

Dưới đây là một tệp cấu hình im lặng mẫu cho cấu trúc liên kết này. Để xem tài liệu tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

# For all nodes except IP4 and IP5
# (which are the SymasLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both SymasLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# For SymasLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the SymasLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the SymasLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both SymasLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Cài đặt cụm 12 nút

Trước khi cài đặt Edge trên một cấu trúc liên kết gồm 12 nút (2 trung tâm dữ liệu), bạn phải hiểu cách thiết lập các thuộc tính ZooKeeper và Cassandra trong tệp cấu hình im lặng.

  • ZooKeeper

    Đối với thuộc tính ZK_HOSTS cho cả hai trung tâm dữ liệu, hãy chỉ định địa chỉ IP hoặc tên DNS của tất cả các nút ZooKeeper từ cả hai trung tâm dữ liệu, theo cùng thứ tự và đánh dấu mọi nút bằng đối tượng sửa đổi :observer. Các nút không có đối tượng sửa đổi :observer được gọi là "voter" (nút bỏ phiếu). Bạn phải có số lẻ "voter" trong cấu hình của mình.

    Trong cấu trúc liên kết này, máy chủ ZooKeeper trên máy chủ 9 là trình quan sát:

    Đối với thuộc tính ZK_CLIENT_HOSTS cho mỗi trung tâm dữ liệu, chỉ chỉ định địa chỉ IP hoặc tên DNS của các nút ZooKeeper trong trung tâm dữ liệu, theo cùng thứ tự, cho tất cả các nút ZooKeeper trong trung tâm dữ liệu. Trong tệp cấu hình mẫu bên dưới, nút 9 được gắn thẻ bằng công cụ sửa đổi :observer để bạn có 5 người bỏ phiếu: Nút 1, 2, 3, 7 và 8.

  • Cassandra

    Tất cả trung tâm dữ liệu phải có cùng số lượng nút Cassandra.

    Đối với CASS_HOSTS cho mỗi trung tâm dữ liệu, hãy đảm bảo rằng bạn chỉ định tất cả địa chỉ IP Cassandra (không phải tên DNS) cho cả hai trung tâm dữ liệu. Đối với trung tâm dữ liệu 1, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó trước. Đối với trung tâm dữ liệu 2, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó trước. Liệt kê các nút Cassandra theo cùng thứ tự cho tất cả các nút Cassandra trong trung tâm dữ liệu.

    Tất cả các nút Cassandra phải có hậu tố ":d,r". Ví dụ: ip:1,1 = trung tâm dữ liệu 1 và giá đỡ/vùng có sẵn 1; và ip:2,1 = trung tâm dữ liệu 2 và giá đỡ/vùng có sẵn 1.

    Ví dụ: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"

    Nút đầu tiên trong giá đỡ/vùng có sẵn 1 của mỗi trung tâm dữ liệu sẽ được dùng làm máy chủ hạt giống.

    Trong mô hình triển khai này, chế độ thiết lập Cassandra sẽ có dạng như sau:

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cài đặt Datastore Cluster Node trên các nút 1, 2, 3, 7, 8 và 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý Apigee có tính năng sao chép SymasLDAP trên nút 1 và 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Cài đặt Bộ định tuyến và Trình xử lý thông báo trên các nút 2, 3, 8 và 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Cài đặt Apigee Analytics Qpid Server trên nút 4, 5, 10 và 11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Cài đặt Máy chủ Postgres của Apigee Analytics trên nút 6 và 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Khởi động lại thành phần Giao diện người dùng Edge mới trên nút 1 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Kiểm thử quá trình cài đặt như mô tả trong phần Kiểm thử quá trình cài đặt.
  8. Đăng ký tổ chức của bạn như mô tả trong phần Đăng ký tổ chức.

Dưới đây là tệp cấu hình tự động cho cấu trúc liên kết này. Để biết tài liệu tham khảo đầy đủ về tệp cấu hình, hãy xem phần Tài liệu tham khảo về tệp cấu hình Edge.

  • Định cấu hình SymasLDAP để sao chép trên 2 nút SymasLDAP.
  • Chỉ định đối tượng sửa đổi :observer trên một nút ZooKeeper. Trong một lần cài đặt trung tâm dữ liệu duy nhất, hãy bỏ qua đối tượng sửa đổi đó.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234