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 apigee-setup của Edge 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 thiết lập apigee sử dụng một lệnh dưới dạng:

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

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

Ví dụ: để cài đặt Edge Management Server:

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

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

Những điều cần cân nhắc khi cài đặt

Khi bạn 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 Postgres sao chép chế độ chờ chính

Theo mặc định, Edge 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 này để sử dụng tính năng sao chép chế độ chờ chính để nếu nút chính bị lỗi, nút chờ có thể tiếp tục đến lưu lượng truy cập của máy chủ.

Bạn có thể bật và định cấu hình sao chép chế độ chờ chính 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ế độ chờ chính sau khi cài đặt. Cho khác, hãy xem Thiết lập chế độ chờ chính cho Postgres.

Bật Cassandra xác thực

Theo mặc định, Cassandra cài đặt mà không bật tính năng xác thực. Tức là ai cũng có thể truy cập 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 của chúng tôi.

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

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

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

Cài đặt giao diện người dùng Edge mới

Sau khi hoàn tất bước cài đặt ban đầu, Apigee khuyên bạn cài đặt giao diện người dùng Edge mới. Đây là giao diện người dùng nâng cao dành cho nhà phát triển và quản trị viên của Apigee Edge cho Private Cloud. (Giao diện người dùng cổ điển được cài đặt theo mặc định.)

Lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt phương thức Xác thực cơ bản và sử dụng IDP như SAML hoặc Giao thức truy cập thư mục hạng nhẹ (LDAP).

Để biết thêm thông tin, hãy xem phần Cài đặt 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 chuyển vào tuỳ chọn -p của Tiện ích apigee-service để chỉ định những 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 OpenLDAP.

mt

Cài đặt Edge Management Server. Máy chủ này cũng sẽ cài đặt OpenLDAP.

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

ms

Cài đặt Edge Management Server. Máy chủ này cũng sẽ cài đặt Giao diện người dùng Edge và OpenLDAP.

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

r

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

mp

Chỉ cài đặt Trình xử lý tin nhắn Edge.

rmp

Cài đặt Bộ định tuyến cạnh và Bộ xử lý tin nhắn.

ui

Cài đặt giao diện người dùng Edge.

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ỉ dùng khi cài đặt cổng Dịch vụ dành cho nhà phát triển Apigee (hoặc đơn giản là cổng). Hãy xem phần Cài đặt cổng thông tin.

sax

Cài đặt các thành phần analytics, nghĩa là Qpid và Postgres.

Chỉ sử dụng tuỳ chọn này cho hoạt động phát triển và kiểm thử, không dành cho quá trình phát hành chính thức.

sso Cài đặt mô-đun SSO của Apigee.

mo

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

sa

Cài đặt Edge độc lập, nghĩa là Cassandra, ZooKeeper, Management Server, OpenLDAP, Giao diện người dùng Edge, Bộ định tuyến và Bộ xử lý tin nhắn. Tuỳ chọn này bỏ qua các thành phần Analytics của Edge: Qpid và Postgres.

Chỉ sử dụng tuỳ chọn này cho hoạt động phát triển và kiểm thử, không dành cho quá trình phát hành chính thức.

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 tuỳ chọn này cho hoạt động phát triển và kiểm thử, không dành cho quá trình phát hành chính thức.

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 có thể thường xuyên sử dụng cùng một tệp cấu hình để cài đặt tất cả các thành phần trong một lượt 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 nhau hoặc sửa đổi cấu hình của mình tệp, nếu:

  • Bạn đang cài đặt nhiều máy chủ OpenLDAP và cần định cấu hình sao chép như một phần của Cài đặt 13 nút. Mỗi tệp yêu cầu các giá trị khác nhau cho LDAP_SIDLDAP_PEER
  • Bạn đang tạo nhiều trung tâm dữ liệu như một phần của quá trình cài đặt 12 nút. Từng trung tâm dữ liệu yêu cầu các chế độ cài đặt khác nhau cho các thuộc tính như ZK_CLIENT_HOSTSCASS_HOSTS

Mỗi cấu trúc liên kết cài đặt được mô tả bên dưới cho thấy một tệp cấu hình mẫu cho cấu trúc liên kết đó. Cho thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem Tham chiếu tệp cấu hình cạnh.

Kiểm thử các yêu cầu về hệ thống mà không cần chạy một lượt cài đặt

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

Giờ đây, bạn có thể sử dụng "-t" gắn cờ để kiểm tra mà không phải cài đặt. Ví dụ: để kiểm tra các yêu cầu về hệ thống đối với một "aio" mà không thực sự cài đặt, hãy sử dụng sau đây:

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

Lệnh này sẽ hiển thị bất kỳ lỗi nào về yêu cầu hệ thống lên màn hình.

Hãy xem bài viết Yêu cầu về việc cài đặt để biết danh sách các yêu cầu 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 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 đang chạy tiện ích setup.sh không có quyền truy cập vào thư mục đó, hệ thống sẽ ghi nhật ký vào thư mục /tmp dưới dạng 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 không thành công.

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

Phần này mô tả cách cài đặt các thành phần Edge cho các cấu trúc liên kết khác nhau. Đơn đặt hàng của lượt cài đặt thành phần dựa trên cấu trúc liên kết bạn muốn.

Tất cả ví dụ cài đặt được hiển thị bên dưới đều giả định rằng bạn đang cài đặt:

  • Khi tính năng xác thực Cassandra đang tắt (mặc định). Xem bài viết 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ế độ chờ chính của Postgres (mặc định). Xem Thiết lập tính năng sao chép chế độ chờ chính cho Postgres để tìm hiểu thêm.
  • Trình 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 Trình xử lý thư và Các bộ định tuyến trên các nút khác nhau, 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 của Edge, bạn phải:

Lắp đặt tích hợp

  1. Dùng lệnh để cài đặt tất cả các thành phần trên một nút:
    /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 cổ điển sau khi cài đặt xong:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không áp dụng cho giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  3. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  4. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu tổ chức.

Xem video về cách cài đặt ứng dụng đa năng của Edge tại đây.

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

# 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=pass1234

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

Xem phần Xin lỗi khi cài đặt để biết danh sách các ứng dụng Edge cấu trúc liên kết và số nút.

  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 cổ điển trên nút 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không áp dụng cho giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  4. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  5. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu tổ chức.

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

# 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>"

Lắp đặt 5 nút

Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của 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ý tin nhắn trên các 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 cổ điển trên nút 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không áp dụng cho giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  6. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  7. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu tổ chức.

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

# 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>"

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

Xem phần Xin lỗi khi cài đặt để biết danh sách các ứng dụng Edge cấu trúc liên kết và số nút.

  1. Cài đặt Nút cụm Datastore 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ý tin nhắn trên các nút 4 và 5:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Cài đặt Máy chủ Qpid của Apigee Analytics 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ủ Postgres của Apigee Analytics 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 cổ điển trên nút 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không phải giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  7. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  8. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu tổ chức.

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

# 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>"

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

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

Dưới đây là thứ tự cài đặt cụm 13 nút:

  1. Cài đặt Nút cụm Datastore trên nút 1, 2 và 3:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt OpenLDAP 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ủ Postgres của Apigee Analytics 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ý tin nhắn trên các nút 10 và 11:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Cài đặt Máy chủ Qpid của Apigee Analytics 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 cổ điển trên các nút 6 và 7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không áp dụng cho giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  8. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  9. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu 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. Để tham khảo đầy đủ trên tệp cấu hình, hãy xem Tham chiếu tệp cấu hình cạnh.

# For all nodes except IP4 and IP5
# (which are the OpenLDAP 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 OpenLDAP 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>"
# For OpenLDAP 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 OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP 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 OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

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

Trước khi cài đặt Edge trên cấu trúc liên kết cụm 12 nút (hai trung tâm dữ liệu), bạn phải hiểu rõ cách đặt 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 có Đối tượng sửa đổi :observer. Các nút không có đối tượng sửa đổi :observer sẽ được gọi "voters". Bạn phải có số "người bỏ phiếu" lẻ trong cấu hình của bạn.

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

    Đối với thuộc tính ZK_CLIENT_HOSTS của mỗi trung tâm dữ liệu, hãy chỉ định địa chỉ IP hoặc tên DNS của chỉ 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 được hiển thị bên dưới, nút 9 được gắn thẻ với Đối tượng sửa đổi :observer để bạn có 5 cử tri: Các nút 1, 2, 3, 7 và 8.

  • Cassandra

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

    Đối với CASS_HOSTS đối với mỗi trung tâm dữ liệu, hãy đảm bảo rằng bạn chỉ định tất cả cá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 dữ liệu đó giữa trang trước tiên. Đối với trung tâm dữ liệu 2, trước tiên, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó. 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à tủ mạng/khu vực tình trạng còn hàng 1; và ip:2,1 = trung tâm dữ liệu 2 và tủ mạng/khu vực tình trạng còn hàng 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á đỡ/khu vực khả dụng 1 của mỗi trung tâm dữ liệu sẽ được dùng làm nguồn gốc máy chủ.

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

Xem phần Xin lỗi khi cài đặt để biết danh sách các ứng dụng Edge cấu trúc liên kết và số nút.

  1. Cài đặt Nút cụm Datastore trên 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 bằng bản sao OpenLDAP 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à Bộ xử lý tin nhắn 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 Máy chủ Qpid của Apigee Analytics 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 cổ điển trên các nút 1 và 7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Điều này áp dụng cho Giao diện người dùng cổ điển, không áp dụng cho giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

  7. Kiểm tra quá trình cài đặt theo mô tả trong phần Kiểm tra bản cài đặt.
  8. Tham gia tổ chức của bạn như mô tả trong phần Giới thiệu tổ chức.

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

  • Định cấu hình OpenLDAP có chức năng sao chép qua 2 nút OpenLDAP.
  • Chỉ định đối tượng sửa đổi :observer trên một nút ZooKeeper. Trong một dữ liệu cài đặt giữa, 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>"
# 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>"