Sau khi cài đặt tiện ích apigee-setup
Edge trên một nút, hãy 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 im lặng chứa thông tin cài đặt. Người dùng "apigee" phải truy cập hoặc đọ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ỳ vị trí 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 phần Cài đặt tiện ích apigee-setup 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 tính năng sao chép chính-dự phòng 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 này để 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 dự phòng chính 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.
Những điểm cần lưu ý về symasldap 2.6.7 trên RHEL 9.X/Rocky 9.X/Oracle 9.X
Việc cài đặt tại cơ sở yêu cầu SymasLDAP 2.6.7, được bao gồm trong kho lưu trữ apigee-thirdparty-opdk
. Để dễ dàng cài đặt, vui lòng xoá thư viện symasldap-compat
.
Đối với các bản cài đặt có 13 máy chủ và các bản cài đặt có 12 máy chủ với 2 trung tâm dữ liệu, bạn cần 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 đó 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ủ ả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ó đặ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 phần 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 để tạo điều kiện thuận lợi cho quá trình cài đặt thành công.
Cài đặt giao diện người dùng mới của Edge
Sau khi hoàn tất quá trình cài đặt ban đầu, Apigee khuyên bạn nên cài đặt giao diện người dùng Edge mới. Đây là một 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.)
Xin lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt Xác thực cơ bản và sử dụng một IDP (nhà cung cấp danh tính) như SAML hoặc 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 lựa chọn mà bạn truyền đến lựa 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ả |
---|---|
|
Chỉ cài đặt Cassandra. |
zk |
chỉ cài đặt ZooKeeper. |
|
Cài đặt ZooKeeper và Cassandra. |
|
Chỉ cài đặt SymasLDAP. |
|
Cài đặt Edge Management Server, cũng cài đặt SymasLDAP. Nếu bạn thiết lập |
|
Cài đặt Edge Management Server, đồng thời cài đặt Edge UI và SymasLDAP. Nếu bạn đặt |
|
Chỉ cài đặt Edge Router. |
|
Chỉ cài đặt Trình xử lý tin nhắn Edge. |
|
Cài đặt Edge Router và Message Processor. |
|
Cài đặt giao diện người dùng Edge. |
|
Chỉ cài đặt Máy chủ Qpid. |
|
Chỉ cài đặt Máy chủ Postgres. |
pdb |
Chỉ cài đặt cơ sở dữ liệu PostgreSQL – chỉ 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. |
|
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ử, chứ không dùng cho phiên bản chính thức. |
sso |
Cài đặt mô-đun Apigee SSO. |
|
Cài đặt tính năng kiếm tiền. |
|
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, Bộ định tuyến và Trình 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ử, chứ không dùng cho phiên bản chính thức. |
|
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ử, chứ không dùng cho phiên bản 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 thường có thể 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 quá trình 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 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 yêu cầu 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 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ả bên dưới đều cho thấy một tệp cấu hình mẫu cho cấu trúc liên kết đó. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem bài viết Thông tin 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 quy trình cài đặt
Edge cho Đám mây riêng 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ột máy 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, quy trình kiểm tra đó yêu cầu bạn thực sự phải thực hiện quá trình cài đặt.
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 phải cài đặt. Ví dụ: để kiểm tra các yêu cầu hệ thống cho một bản cài đặt "aio" mà không thực sự cài đặt, hãy dùng lệnh sau:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t
Lệnh này hiển thị mọi lỗi liên quan đến yêu cầu hệ thống trên màn hình.
Hãy xem Yêu cầu về việc cài đặt để biết danh sách các yêu cầu về hệ thống đối với tất cả các thành phần 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 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. 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 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ính năng sao chép dự phòng chính của Postgres bị tắt (mặc định). 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 để biết thêm thông tin.
- Bộ xử lý và bộ định tuyến tin nhắ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 của Edge, bạn phải:
- Kiểm tra Yêu cầu về việc cài đặt để biết các điều kiện tiên quyết và danh sách các tệp bắt buộc cần có trước khi tiến hành cài đặt. Đảm bảo rằng bạn đã xem xét các yêu cầu trước khi bắt đầu quy 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
- Cài đặt tất cả các thành phần trên một nút duy nhất bằng lệnh:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Khởi động lại thành phần Giao diện người dùng cổ điển sau khi quá trình cài đặt hoàn tất:
/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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- Tham gia tổ chức của bạn như mô tả trong phần Tham gia một tổ chức.
Xem video về cách cài đặt Edge trên một thiết bị 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. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem phần Thông tin 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.
- Cài đặt Cổng độc lập và nút 1
/opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
- Cài đặt Analytics trên nút 2:
/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
- Khởi động lại thành phần Giao diện người dùng cũ 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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- 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 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 Thông tin 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
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 Edge và số lượng nút.
- 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
- 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
- Cài đặt Bộ định tuyến và Bộ xử lý thông báo trên các nút 2 và 3:
/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
- Cài đặt Analytics trên nút 4 và 5:
/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
- Khởi động lại thành phần Giao diện người dùng cũ 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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- 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 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 Thông tin 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
Lắp đặt cụm 9 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.
- 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
- 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
- Cài đặt Bộ định tuyến và Trình 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
- Cài đặt Máy chủ Apigee Analytics Qpid trên nút 6 và 7:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- 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
- Khởi động lại thành phần Giao diện người dùng cũ 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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- 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 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 Thông tin 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 gồm 13 nút
Phần này mô tả thứ tự cài đặt cho một cụm 13 nút. Để xem danh sách các cấu trúc liên kết và số lượng 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 gồm 13 nút như sau:
- 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
- Cài đặt SymasLDAP trên nút 4 và 5:
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
- Cài đặt Apigee Management Server trên nút 6 và 7:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
- 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
- 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
- Cài đặt Máy chủ Apigee Analytics Qpid trên nút 12 và 13:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Khởi động lại thành phần Giao diện người dùng cũ 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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- 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. Để biết thông tin tham khảo đầy đủ về tệp cấu hình, hãy xem Thông tin 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 một thứ tự và đánh dấu mọi nút bằng giá trị sửa đổi:observer
. Các nút không có đối tượng sửa đổi:observer
được gọi là "voter" (người bỏ phiếu). Bạn phải có số lượng "người bỏ phiếu" là số lẻ trong cấu hình.Trong cấu trúc liên kết này, máy chủ ZooKeeper trên máy chủ 9 là máy 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 một 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 cử tri: 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
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, trước tiên, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó. Đố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 một 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ó thể truy cập 1; vàip:2,1
= trung tâm dữ liệu 2 và giá đỡ/vùng có thể truy cập 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 sẵn sàng 1 của mỗi trung tâm dữ liệu sẽ được dùng làm máy chủ ban đầu.
Trong mô hình triển khai này, chế độ thiết lập Cassandra sẽ có dạng như sau:
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.
- 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
- 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
- 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
- Cài đặt Máy chủ Apigee Analytics Qpid trên nút 4, 5, 10 và 11:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- 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
- Khởi động lại thành phần Giao diện người dùng cũ 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, chứ 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
. - Kiểm thử quy trình cài đặt như mô tả trong phần Kiểm thử quy trình cài đặt.
- 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 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.
- Đị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 |