Edge for Private Cloud phiên bản 4.16.05
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 apigee-setup sử dụng 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. Tệp cấu hình phải truy cập được hoặc đọc được bởi người dùng "apigee". Ví dụ: đặt tệp trong thư mục /tmp trên nút.
Ví dụ: để cài đặt Máy chủ quản lý cạnh:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig
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 xem xét các lựa chọn sau.
Thiết lập tính năng sao chép chính của chế độ chờ cho 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 của chế độ chờ sao cho nếu nút chính bị lỗi, nút chờ 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 bản sao chính của chế độ chờ 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. Để biết thêm thông tin, hãy xem phần Thiết lập tính năng Sao chép dự phòng chính cho Postgres.
Bật tính năng xác thực Cassandra
Theo mặc định, Cassandra cài đặt mà không bật tính năng xác thực. Điều đó có nghĩa là bất cứ 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.
Bạn có thể bật phương thức xác thực Cassandra dưới dạng thời gian 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 này sau khi cài đặt.
Để biết thêm, hãy xem phần Bật tính năng xác thực Cassandra.
Liên kết Bộ định tuyến với một cổng được bảo vệ
Nếu muốn 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 1024, 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 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.
Cách chạy Bộ định tuyến với tư cách người dùng khác:
- Ở cấp độ gốc, tạo tệp /opt/apigee/etc/edge-router.d/RUN_USER.sh.
- Thêm mục sau đây vào tệp:
RUN_USER=root
Nếu bạn không muốn chạy Bộ định tuyến ở cấp độ gốc, hãy chỉ định một người dùng có quyền truy cập vào cổng. - Lưu tệp.
- Nếu bạn đã chỉ định một người dùng không phải là người dùng gốc, hãy thay đổi chủ sở hữu tệp thành người dùng đó:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh - Khởi động lại bộ định tuyến:
> /opt/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
Chỉ định 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 đến tuỳ chọn -p của tiện ích apigee-service để chỉ định thành phần nào 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. |
ms |
Cài đặt Máy chủ quản lý Edge. Thao tác này cũng 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, thì quá trình cài đặt Open LDAP sẽ bị bỏ qua và Máy chủ quản lý sử dụng Open LDAP được cài đặt trên một nút khác. |
r |
Chỉ cài đặt Bộ định tuyến cạnh. |
mp |
Chỉ cài đặt Trình xử lý thư Edge. |
phòng tắm |
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. |
kèn sax |
Cài đặt các thành phần phân tích, nghĩa là Qpid và Postgres. Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức. |
tháng |
Cài đặt tính năng Kiếm tiền. |
sa |
Cài đặt Edge độc lập, nghĩa là Cassandra, ZooKeeper, Máy chủ quản lý, OpenLDAP, Giao diện người dùng Edge, Bộ định tuyến và Trình xử lý thư. Tuỳ chọn này bỏ qua các thành phần phân tích Edge: Qpid và Postgres. Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức. |
aio |
Cài đặt tất cả thành phần trên một nút duy nhất. Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức. |
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. Thường thì bạn 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 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ủ Open LDAP và cần định cấu hình 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.
Tệp cấu hình mẫu
Dưới đây là ví dụ về tệp cấu hình im lặng hoàn toàn để cài đặt Edge 9 nút. Chỉnh sửa tệp này nếu cần cho cấu hình của bạn. Sử dụng tuỳ chọn -f để setup.sh để thêm tệp này. Ngoài ra, bạn cũng có thể xem các tệp cấu hình mẫu cho từng cấu trúc liên kết Edge.
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra IP2=192.168.1.2 # ZooKeeper, Cassandra IP3=192.168.1.3 # ZooKeeper, Cassandra IP4=192.168.1.4 # Router, Message Processor IP5=192.168.1.5 # Router, Message Processor IP6=192.168.1.6 # Qpid IP7=192.168.1.7 # Qpid IP8=192.168.1.8 # Postgres IP9=192.168.1.9 # Postgres # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Set Edge sys admin credentials. ADMIN_EMAIL=your@email.com APIGEE_ADMINPW=yourPassword # If omitted, you are prompted for it. # Location of Edge license file. LICENSE_FILE=/tmp/license.txt # Management Server information. MSIP=$IP1 # IP or DNS name of Management Server node. # Specify the port the Management Server listens on for API calls. # APIGEE_PORT_HTTP_MS=8080 # Default is 8080. # # OpenLDAP information. # # Set to y if you are connecting to a remote LDAP server. # If n, Edge installs OpenLDAP when it installs the Management Server. USE_LDAP_REMOTE_HOST=n # If connecting to remote OpenLDAP server, specify the IP/DNS name and port. # LDAP_HOST=$IP1 # IP or DNS name of OpenLDAP node. # LDAP_PORT=10389 # Default is 10389. APIGEE_LDAPPW=yourLdapPassword # Specify OpenLDAP without replication, 1, or with replication, 2. LDAP_TYPE=1 # Set only if using replication. # LDAP_SID=1 # Unique ID for this LDAP server. # LDAP_PEER= # IP or DNS name of LDAP peer. BIND_ON_ALL_INTERFACES=y # The Message Processor and Router pod. MP_POD=gateway # The name of the region, corresponding to the data center name. REGION=dc-1 # Use dc-1 unless installing in a # multi-data center environment. # ZooKeeper information. # See table below if installing in a multi-data center environment. ZK_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. # Cassandra information. CASS_CLUSTERNAME=Apigee # Default name is Apigee. # IP addresses of the Cassandra hosts separated by spaces. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Set to enable Cassandra authentication. # CASS_AUTH=y # The default value is n. # Cassandra uname/pword required if you enabled Cassandra authentication. # CASS_USERNAME= # CASS_PASSWORD= # Use to enable Postgres master-standby replication # when you have multiple Postgres nodes. # PG_MASTER=IPorDNSofNewMaster # PG_STANDBY=IPorDNSofOldMaster # SMTP information. SKIP_SMTP=n # Skip now and configure later by specifying "y". SMTPHOST=smtp.gmail.com SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y SMTPPORT=465 # If no SSL, use a different port, such as 25.
Bảng sau đây chứa thông tin bổ sung về các thuộc tính này:
Thuộc tính |
Lưu ý |
---|---|
Tên IP/DNS |
Không sử dụng ánh xạ tên máy chủ tới 127.0.0.1 hoặc địa chỉ IP 127.0.0.1 khi chỉ định địa chỉ IP của một nút. |
QUẢN TRỊ_EMAIL |
Mật khẩu của quản trị viên hệ thống phải dài ít nhất 8 ký tự và có chứa một chữ hoa, một chữ cái viết thường, một chữ số hoặc một ký tự đặc biệt. Nếu bỏ qua mật khẩu, bạn sẽ được nhắc nhập mật khẩu đó. |
LICENSE_FILE |
Vị trí của tệp giấy phép, phải có thể truy cập được đối với người dùng "apigee". Ví dụ: lưu trữ tệp trong thư mục /tmp và chmod 777 trên tệp. Tệp này được sao chép vào thư mục cài đặt Edge. |
USE_ LDAP_REMOTE_HOST |
Nếu USE_LDAP_REMOTE_HOST là n, Edge sẽ tự động cài đặt OpenLDAP khi cài đặt Máy chủ quản lý. Đặt USE_LDAP_REMOTE_HOST thành y nếu bạn đang kết nối với máy chủ LDAP từ xa. OpenLDAP chưa được cài đặt cùng với Máy chủ quản lý. Nếu bạn đang kết nối với một máy chủ OpenLDAP từ xa, hãy sử dụng LDAP_HOST |
LDAP_TYPE |
Đặt LDAP_TYPE=1 cho Open LDAP mà không sao chép. LDAP_TYPE=2 tương ứng với OpenLDAP với tính năng sao chép. Nếu cấu trúc liên kết của Edge sử dụng một máy chủ OpenLDAP, hãy chỉ định 1. Nếu quá trình cài đặt Edge sử dụng nhiều nút OpenLDAP, chẳng hạn như trong bản cài đặt phiên bản chính thức 13 nút, hãy chỉ định 2. Nếu bạn bật tính năng nhân bản, hãy đặt các thuộc tính sau:
|
BIND_ON_ALL_INTERFACES |
Nếu bạn đặt thành "y" thì Bộ định tuyến/Bộ xử lý thư sẽ liên kết (nghe) trên mọi giao diện (IP). Nếu được đặt thành “n” thì Bộ định tuyến/Bộ xử lý thư sẽ liên kết (nghe) trên một giao diện cụ thể, IP được trả về bởi lệnh "tên máy chủ -i"). |
MP_POD |
Chỉ định tên của nhóm Bộ định tuyến và Bộ xử lý tin nhắn. Theo mặc định, tên là cổng. |
KHU VỰC |
Tên khu vực. Theo quy ước, tên thường có dạng dc-#, trong đó # tương ứng với một giá trị số nguyên. Ví dụ: dc-1, dc-2, v.v. Bạn có thể sử dụng dc-1 trừ phi cài đặt trong môi trường trung tâm đa dữ liệu. Khi cài đặt nhiều trung tâm dữ liệu, giá trị là dc-1 hoặc dc-2, v.v. tuỳ thuộc vào trung tâm dữ liệu bạn đang cài đặt. Tuy nhiên, bạn không bị hạn chế chỉ sử dụng các tên ở dạng dc-#. Bạn có thể dùng bất kỳ tên nào cho khu vực. |
ZK_HOSTS |
Địa chỉ IP hoặc tên DNS của các nút ZooKeeper. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng một thứ tự trên tất cả các nút ZooKeeper. Trong môi trường trung tâm dữ liệu, hãy liệt kê tất cả các nút ZooKeeper từ cả hai trung tâm dữ liệu. Chỉ chỉ định đối tượng sửa đổi “:observer” trên các nút ZooKeeper khi tạo nhiều trung tâm dữ liệu như mô tả trong một bản cài đặt gồm 12 máy chủ. Trong một lần cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin. |
ZK_CLIENT_HOSTS |
Địa chỉ IP hoặc tên DNS của các nút ZooKeeper mà trung tâm dữ liệu này sử dụng. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng một thứ tự trên tất cả các nút ZooKeeper. Trong một trường hợp cài đặt trung tâm dữ liệu, đây chính là các nút do ZK_HOSTS chỉ định. Trong môi trường trung tâm đa dữ liệu, chỉ liệt kê các nút ZooKeeper trong trung tâm dữ liệu này. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin. |
CASS_HOSTS |
Địa chỉ IP (không phải tên DNS) của các nút Cassandra. 2 nút đầu tiên sẽ được dùng làm máy chủ gốc. Các địa chỉ IP phải được liệt kê theo cùng một thứ tự trên tất cả các nút Cassandra. Các nút Cassandra có thể có hậu tố “:dc,ra” (không bắt buộc) chỉ định trung tâm dữ liệu và giá trị của nút Cassandra. Chỉ chỉ định đối tượng sửa đổi này khi tạo nhiều trung tâm dữ liệu như mô tả trong quy trình cài đặt gồm 12 máy chủ lưu trữ. Trong một lần cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó. Ví dụ: "192.168.124.201:1,1 = trung tâm dữ liệu 1 và vùng giá/khả năng lập chỉ mục 1, và "192.168.124.204:2,1 = trung tâm dữ liệu 2 và vùng giá/khả năng lập chỉ mục 1". Trong môi trường đa trung tâm dữ liệu, để khắc phục các vấn đề liên quan đến tường lửa, CASS_HOSTS phải được sắp xếp theo cách (như trong ví dụ trên) sao cho các nút của trung tâm dữ liệu hiện tại được đặt ở đầu. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin. |
CASS_AUTH CASS_PASSWORD |
Nếu bật tính năng xác thực Cassandra, CASS_AUTH=y, bạn có thể chuyển tên người dùng và mật khẩu Cassandra bằng cách sử dụng các thuộc tính này. |
PG_MASTER PG_STANDBY |
Thiết lập để bật tính năng sao chép chính cho thẻ chờ Postgres có dạng như sau: PG_MASTER=IPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMaster |
SKIP_SMTP |
Định cấu hình SMTP để Edge có thể gửi email về mật khẩu bị mất và các thông báo khác. Nếu không bắt buộc phải cung cấp thông tin xác thực của người dùng SMTP, hãy bỏ qua SMTPUSER và SMTP MẬT. |
Thứ tự cài đặt thành phần
Thứ tự cài đặt thành phần dựa trên cấu trúc liên kết mong muốn của bạn.
Tất cả ví dụ về cách cài đặt hiển thị bên dưới 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). 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 của chế độ chờ Postgres (mặc định). Hãy xem bài viết Thiết lập tính năng Sao chép dự phòng chính cho Postgres để biết thêm thông tin.
- Bộ xử lý thư và Bộ định tuyến trên cùng một nút. Nếu bạn cài đặt Bộ định tuyến và Bộ xử lý thông báo trên các nút khác nhau, trước tiên, hãy cài đặt tất cả Bộ xử lý thông báo rồi cài đặt tất cả Bộ định tuyến.
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 đó, thì tiện ích đó sẽ ghi nhật ký vào thư mục setup.sh dưới dạng tệp có tên là setup.sh.
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 tích hợp
- Cài đặt tất 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 - Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một 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:
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Cài đặt độc lập qua 2 máy chủ
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ố nút của Edge.
- Cài đặt Cổng vào độc lập và nút 1
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - Trên nút 1:
- Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
- Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
- Cài đặt Analytics trên nút 2:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một 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:
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Cài đặt theo cụm 5 máy chủ
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ố nút của Edge.
- 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 - Trên nút 2 và 3:
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
- Cài đặt Analytics trên nút 4 và 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một 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:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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" PG_MASTER=$IP4 PG_STANDBY=$IP5 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Cài đặt theo cụm 9 máy chủ
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ố nút của Edge.
- 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 - 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 - Trên nút 4 và 5:
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
- 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 - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một 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:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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" SKIP_SMTP=n PG_MASTER=$IP8 PG_STANDBY=$IP9 SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Cài đặt theo cụm 13 máy chủ
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ố nút của Edge.
- 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 - Cài đặt OpenLDAP trên nút 4 và 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - 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 - 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 - Trên nút 10 và 11:
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
- 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 - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một 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:
# For all components except OpenLDAP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt # First Management Server on IP6 MSIP=$IP6 USE_LDAP_REMOTE_HOST=y LDAP_HOST=$IP4 LDAP_PORT=10389 # Second Management Server on IP7 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=y # LDAP_HOST=$IP5 # LDAP_PORT=10389 # Same password for both OpenLDAPs. APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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" PG_MASTER=$IP8 PG_STANDBY=$IP9 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# For OpenLDAP on IP4 and IP5 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 # First OpenLDAP Server on IP4 MSIP=$IP6 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP5 # Second OpenLDAP Server on IP5 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=n # LDAP_TYPE=2 # LDAP_SID=2 # LDAP_PEER=$IP4 # Set same password for both OpenLDAPs. APIGEE_LDAPPW=secret |
Cài đặt theo cụm 12 máy chủ
Trước khi cài đặt Edge trên cấu trúc liên kết phân cụm máy chủ a12 (hai trung tâm dữ liệu), bạn phải tìm hiểu cách đặt 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 bất kỳ nút nào 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". Bạn phải có một số "cái phiếu" lẻ 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à đối tượng tiếp nhận dữ liệu:
Đối với thuộc tính ZK_CLIENT_HOSTS cho mỗi trung tâm dữ liệu, 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 ví dụ minh hoạ bên dưới, nút 9 được gắn thẻ bằng đối tượng 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ố 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.
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.6.24" sẽ xuất hiện trong vùng 1.168.168.12, 192.168.12, 192.168.12
Trong mô hình triển khai này, cá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ố nút của Edge.
- 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 - Cài đặt Máy chủ quản lý Apigee bằng phương pháp sao chép Open LDAP trên nút 1 và 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Trên nút 2, 3, 8 và 9:
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Khởi động lại Bộ định tuyến cạnh:
> /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
- Cài đặt Bộ định tuyến và Bộ xử lý thư:
- Cài đặt Máy chủ Qpid Analytics của Apigee 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ủ Apigee Analytics Postgres trên nút 6 và 12:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
- Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.
Hiển thị bên dưới là tệp cấu hình im lặng cho cấu trúc liên kết này. Xin lưu ý rằng tệp cấu hình này:
- Định cấu hình OpenLDAP bằng cách sao chép trên hai nút OpenLDAP.
- Chỉ định công cụ 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, hãy bỏ qua đối tượng sửa đổi đó.
# Datacenter 1 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP1 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP7 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP7 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=2 LDAP_PEER=$IP1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y 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. CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |