Yêu cầu về phần cứng
Bạn phải đáp ứng các yêu cầu tối thiểu về phần cứng sau đây để có thể sử dụng trong môi trường cấp sản xuất.
Video sau đây cung cấp cho bạn hướng dẫn cấp cao về kích thước để lắp đặt:
Đối với tất cả các trường hợp cài đặt được mô tả trong Cấu trúc liên kết khi cài đặt, các bảng sau sẽ liệt kê các yêu cầu tối thiểu về phần cứng cho cấu phần cài đặt.
Trong các bảng này, yêu cầu về ổ đĩa cứng ngoài dung lượng ổ đĩa cứng mà hệ điều hành. Tuỳ thuộc vào ứng dụng và lưu lượng truy cập mạng, quá trình cài đặt có thể cần nhiều hoặc ít tài nguyên hơn danh sách dưới đây.
Thành phần cài đặt | RAM | CPU | Ổ đĩa cứng tối thiểu |
---|---|---|---|
Cassandra | 16 GB | 8 nhân | Bộ nhớ cục bộ 250 GB với SSD hỗ trợ 2000 IOPS |
Bộ xử lý/Bộ định tuyến thư trên cùng một máy | 16 GB | 8 nhân | 100 GB |
Bộ xử lý thư (độc lập) | 16 GB | 8 nhân | 100 GB |
Bộ định tuyến (độc lập) | 16 GB | 8 nhân | 100 GB |
Analytics - Postgres/Qpid trên cùng một máy chủ | 16GB* | 8 nhân* | 500 GB – 1 TB** Bộ nhớ mạng***, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1000 IOPS trở lên* |
Analytics - Postgres chính hoặc chế độ chờ (độc lập) | 16GB* | 8 nhân* | 500 GB – 1 TB** Bộ nhớ mạng***, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1000 IOPS trở lên* |
Analytics – Qpid độc lập | 8GB | 4 nhân | Bộ nhớ cục bộ 30 GB – 50 GB có SSD
Kích thước hàng đợi Qpid mặc định là 1 GB, có thể tăng lên 2 GB. Nếu bạn cần dung lượng lớn hơn, hãy thêm các nút Qpid bổ sung. |
OpenLDAP/Giao diện người dùng/Máy chủ quản lý | 8GB | 4 nhân | 60GB |
Giao diện người dùng/Máy chủ quản lý | 4GB | 2 nhân | 60GB |
OpenLDAP (độc lập) | 4GB | 2 nhân | 60GB |
* Điều chỉnh các yêu cầu hệ thống của Postgres dựa trên thông lượng:
** Giá trị ổ đĩa cứng Postgres dựa trên số liệu phân tích có sẵn do Edge thu thập được. Nếu bạn thêm giá trị tùy chỉnh vào dữ liệu phân tích, thì các giá trị này sẽ được tăng lên cho phù hợp. Sử dụng công thức sau để ước tính dung lượng lưu trữ cần thiết:
Ví dụ:
*** Bạn nên sử dụng Bộ nhớ mạng cho cơ sở dữ liệu Postgresql vì:
|
Ngoài ra, sau đây liệt kê các yêu cầu về phần cứng nếu bạn muốn cài đặt Dịch vụ kiếm tiền (không được hỗ trợ khi cài đặt tính năng đa năng):
Thành phần có Kiếm tiền | RAM | CPU | Ổ đĩa cứng |
---|---|---|---|
Máy chủ quản lý (có Dịch vụ kiếm tiền) | 8GB | 4 nhân | 60GB |
Analytics - Postgres/Qpid trên cùng một máy chủ | 16 GB | 8 nhân | Bộ nhớ mạng từ 500 GB đến 1 TB, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1.000 IOPS hoặc cao hơn hoặc sử dụng quy tắc trong bảng trên. |
Analytics - Postgres chính hoặc chế độ chờ độc lập | 16 GB | 8 nhân | Bộ nhớ mạng từ 500 GB đến 1 TB, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1.000 IOPS hoặc cao hơn hoặc sử dụng quy tắc trong bảng trên. |
Analytics – Qpid độc lập | 8GB | 4 nhân | Bộ nhớ cục bộ 40 GB – 500 GB có SSD hoặc ổ cứng nhanh
Đối với các cài đặt lớn hơn 250 TPS, HDD có bộ nhớ cục bộ hỗ trợ 1000 IOPS được đề xuất. |
Hệ điều hành và bên thứ ba yêu cầu về phần mềm
Các hướng dẫn cài đặt này và tệp cài đặt được cung cấp đã được kiểm tra trên hệ điều hành và phần mềm bên thứ ba được liệt kê trong Các phiên bản phần mềm và phiên bản được hỗ trợ.
Java
Bạn cần cài đặt phiên bản Java 1.8 được hỗ trợ trên mỗi máy trước khi cài đặt. JDK được hỗ trợ được liệt kê trong Các phiên bản phần mềm và phiên bản được hỗ trợ.
Đảm bảo rằng biến môi trường JAVA_HOME
trỏ đến gốc của JDK cho
người dùng thực hiện cài đặt.
SELinux
Tuỳ thuộc vào chế độ cài đặt của bạn cho SELinux, Edge có thể gặp sự cố khi cài đặt và khởi động Thành phần viền. Nếu cần, bạn có thể vô hiệu hoá SELinux hoặc đặt SELinux sang chế độ cho phép trong cài đặt, sau đó bật lại ứng dụng đó sau khi cài đặt. Xem bài viết Cài đặt tiện ích thiết lập apigee của Edge để biết thêm thông tin.
Tạo "apigee" người dùng
Quy trình cài đặt này sẽ tạo một người dùng hệ thống Unix có tên 'apigee'. Thư mục cạnh và các tệp do "apigee" sở hữu, cũng như các quy trình của Edge. Điều đó có nghĩa là các thành phần Edge sẽ chạy dưới dạng "apigee" người dùng. Nếu cần, bạn có thể chạy các thành phần với tư cách là một người dùng khác.
Thư mục cài đặt
Theo mặc định, trình cài đặt ghi tất cả tệp vào thư mục /opt/apigee
. Bạn
không thể thay đổi vị trí thư mục này. Tuy không thể thay đổi thư mục này, nhưng bạn vẫn có thể tạo một
đường liên kết tượng trưng để ánh xạ /opt/apigee
đến một vị trí khác, như được mô tả trong
Tạo đường liên kết tượng trưng từ /opt/apigee.
Trong phần hướng dẫn này, thư mục cài đặt được ghi chú là
/opt/apigee
.
Tạo đường liên kết tượng trưng từ /opt/apigee
Trước khi tạo đường liên kết tượng trưng, trước tiên bạn phải tạo một người dùng và nhóm có tên "apigee". Đây là cùng một nhóm và người dùng do trình cài đặt Edge tạo.
Để tạo liên kết tượng trưng, hãy thực hiện các bước này trước khi tải tệp bootstrap_4.52.00.sh xuống. Bạn phải thực hiện tất cả các bước sau dưới dạng thư mục gốc:
- Tạo "apigee" người dùng và nhóm:
groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
- Tạo một đường liên kết tượng trưng từ
/opt/apigee
đến thư mục cài đặt gốc mà bạn muốn:ln -Ts /srv/myInstallDir /opt/apigee
Trong đó /srv/myInstallDir là vị trí mong muốn của các tệp Edge.
- Thay đổi quyền sở hữu thư mục gốc cài đặt và đường liên kết tượng trưng đến "api" ("API") người dùng:
chown -h apigee:apigee /srv/myInstallDir /opt/apigee
Cài đặt mạng
Apigee khuyên bạn nên kiểm tra chế độ cài đặt mạng trước khi cài đặt. Trình cài đặt yêu cầu rằng tất cả các máy đều có địa chỉ IP cố định. Hãy dùng các lệnh sau để xác thực cài đặt:
hostname
trả về tên của máyhostname -i
trả về địa chỉ IP cho tên máy chủ có thể được xác định địa chỉ các máy khác.
Tuỳ thuộc vào loại hệ điều hành và phiên bản hệ điều hành, bạn có thể cần phải chỉnh sửa
/etc/hosts
và /etc/sysconfig/network
nếu tên máy chủ không phải là
đặt chính xác. Hãy xem tài liệu dành cho hệ điều hành cụ thể của bạn để biết thêm thông tin.
Nếu một máy chủ có nhiều thẻ giao diện, thì "tên máy chủ -i" trả về một lệnh được phân tách bằng dấu cách danh sách địa chỉ IP. Theo mặc định, trình cài đặt Edge sử dụng địa chỉ IP đầu tiên được trả về. Địa chỉ này có thể không chính xác trong mọi trường hợp. Thay vào đó, bạn có thể đặt thuộc tính sau trong tệp cấu hình cài đặt:
ENABLE_DYNAMIC_HOSTIP=y
Khi thuộc tính đó được đặt thành "y", trình cài đặt sẽ nhắc bạn chọn địa chỉ IP để sử dụng làm của quá trình cài đặt. Giá trị mặc định là "n". Hãy xem bài viết Tham chiếu tệp cấu hình Edge để biết thêm thông tin.
Trình bao bọc TCP
Trình bao bọc TCP có thể chặn hoạt động giao tiếp của một số cổng và có thể ảnh hưởng đến OpenLDAP, Postgres và
Lắp đặt Cassandra. Trên các nút đó, hãy đánh dấu chọn /etc/hosts.allow
và
/etc/hosts.deny
để đảm bảo rằng không có hạn chế về cổng đối với yêu cầu
Các cổng OpenLDAP, Postgres và Cassandra.
iptables
Kiểm tra để đảm bảo rằng không có chính sách nào đối với iptables ngăn chặn khả năng kết nối giữa các nút trên các cổng Edge cần thiết. Nếu cần, bạn có thể dừng iptables trong quá trình cài đặt bằng cách sử dụng :
sudo/etc/init.d/iptables stop
Trên CentOS 7.x:
systemctl stop firewalld
Quyền truy cập vào thư mục
Bảng sau đây liệt kê các thư mục trên các nút Edge có yêu cầu đặc biệt từ Các quy trình cạnh tranh:
Dịch vụ | Thư mục | Mô tả |
---|---|---|
Bộ định tuyến | /etc/rc.d/init.d/functions |
Bộ định tuyến Edge sử dụng bộ định tuyến Nginx và yêu cầu quyền đọc vào
Nếu quy trình bảo mật yêu cầu bạn đặt quyền ở trạng thái bật
Bạn có thể thiết lập quyền thành 744 để cho phép truy cập đọc
|
Người giữ vườn thú | /dev/random |
Thư viện ứng dụng Zookeeper yêu cầu quyền đọc trình tạo số ngẫu nhiên
/dev/random . Nếu /dev/random bị chặn khi đọc thì
Dịch vụ người quản lý vườn thú có thể không khởi động được. |
Cassandra
Tất cả các nút Cassandra phải được kết nối với một vòng. Cassandra lưu trữ các bản sao dữ liệu trên nhiều nút để đảm bảo độ tin cậy và khả năng chịu lỗi. Chiến lược sao chép cho mỗi Không gian phím cạnh xác định các nút Cassandra nơi đặt bản sao. Để biết thêm thông tin, hãy xem Giới thiệu về Cassandra hệ số nhân bản và mức độ nhất quán.
Cassandra tự động điều chỉnh kích thước vùng nhớ khối xếp Java dựa trên bộ nhớ còn trống. Để biết thêm thông tin, hãy xem Chỉnh Tài nguyên Java trong trường hợp hiệu suất suy giảm hoặc mức tiêu thụ bộ nhớ cao.
Sau khi cài đặt Edge cho Đám mây riêng tư, bạn có thể kiểm tra để đảm bảo rằng Cassandra đã được định cấu hình
bằng cách kiểm tra /opt/apigee/apigee-cassandra/conf/cassandra.yaml
. Ví dụ: đảm bảo rằng tập lệnh cài đặt Edge cho Đám mây riêng tư đặt các giá trị sau
thuộc tính:
cluster_name
initial_token
partitioner
seeds
listen_address
rpc_address
snitch
Cơ sở dữ liệu PostgreSQL
Sau khi cài đặt Edge, bạn có thể điều chỉnh các chế độ cài đặt cơ sở dữ liệu PostgreSQL sau đây dựa trên dung lượng RAM có sẵn trên hệ thống của bạn:
conf_postgresql_shared_buffers = 35% of RAM # min 128kB conf_postgresql_effective_cache_size = 45% of RAM conf_postgresql_work_mem = 512MB # min 64kB
Cách đặt những giá trị này:
- Chỉnh sửa tệp postgresql.properties:
vi /opt/apigee/customer/application/postgresql.properties
Nếu tệp không tồn tại, hãy tạo tệp đó.
- Đặt các thuộc tính nêu trên.
- Lưu nội dung bạn chỉnh sửa.
- Khởi động lại cơ sở dữ liệu PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Giới hạn của hệ thống
Đảm bảo rằng bạn đã đặt các giới hạn hệ thống sau đây cho Cassandra và Message Processor nút:
- Trên các nút Cassandra, hãy đặt giới hạn cho memlock mềm và cứng, không có tệp và không gian địa chỉ (dưới dạng) cho
người dùng cài đặt (mặc định là "apigee") trong
/etc/security/limits.d/90-apigee-edge-limits.conf
như minh hoạ dưới đây:apigee soft memlock unlimited apigee hard memlock unlimited apigee soft nofile 32768 apigee hard nofile 65536 apigee soft as unlimited apigee hard as unlimited apigee soft nproc 32768 apigee hard nproc 65536
- Trên các nút Trình xử lý thông báo, hãy đặt số lượng chỉ số mô tả tệp mở tối đa thành 64K
trong
/etc/security/limits.d/90-apigee-edge-limits.conf
như minh hoạ dưới đây:apigee soft nofile 32768 apigee hard nofile 65536
Nếu cần, bạn có thể tăng giới hạn đó. Ví dụ: nếu bạn có một số lượng lớn tệp tạm thời sẽ mở cùng một lúc.
Nếu bạn gặp lỗi sau trong Bộ định tuyến hoặc Bộ xử lý thư
system.log
, giới hạn chỉ số mô tả tệp của bạn có thể đã được đặt quá thấp:"java.io.IOException: Too many open files"
Bạn có thể kiểm tra giới hạn người dùng bằng cách chạy:
# su - apigee $ ulimit -n 100000
Nếu bạn vẫn đạt đến giới hạn tệp đang mở sau khi đặt giới hạn của chỉ số mô tả tệp thành
100000
thân mến, hãy mở một phiếu yêu cầu hỗ trợ với dịch vụ Hỗ trợ Apigee Edge để tiếp tục khắc phục sự cố.
Dịch vụ an ninh mạng (NSS)
Dịch vụ bảo mật mạng (NSS) là một tập hợp các thư viện hỗ trợ việc phát triển các ứng dụng khách và máy chủ có hỗ trợ bảo mật. Bạn phải đảm bảo rằng mình đã cài đặt NSS phiên bản 3.19 trở lên.
Cách kiểm tra phiên bản hiện tại:
yum info nss
Cách cập nhật NSS:
yum update nss
Hãy xem bài viết này từ RedHat để biết thêm thông tin.
Tắt tính năng tra cứu DNS trên IPv6 khi sử dụng NSCD (Trình nền dịch vụ bộ nhớ đệm của dịch vụ tên)
Nếu bạn đã cài đặt và bật NSCD (Trình nền bộ nhớ đệm của dịch vụ tên), Trình xử lý thư thực hiện hai tra cứu DNS: một cho IPv4 và một cho IPv6. Bạn nên tắt tra cứu DNS trên IPv6 khi bằng NSCD.
Cách tắt tính năng tra cứu DNS trên IPv6:
- Trên mỗi nút Trình xử lý thư, hãy chỉnh sửa
/etc/nscd.conf
- Đặt thuộc tính sau:
enable-cache hosts no
Tắt IPv6 trên Google Cloud Nền tảng dành cho RedHat/CentOS 7
Nếu bạn đang cài đặt Edge trên RedHat 7 hoặc CentOS 7 trên Google Cloud Platform, thì bạn phải tắt IPv6 trên tất cả các nút Qpid.
Hãy xem tài liệu về phiên bản hệ điều hành cụ thể của bạn trên RedHat hoặc CentOS để biết hướng dẫn về tắt IPv6. Ví dụ như bạn có thể:
- Mở
/etc/hosts
trong trình chỉnh sửa. - Chèn dấu "#" trong cột một trong các dòng sau để nhận xét về nội dung đó:
#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
- Lưu tệp.
AMI AWS
Nếu bạn đang cài đặt Edge trên Hình ảnh máy Amazon (AMI) của AWS cho Red Hat Enterprise Linux 7.x, trước tiên, bạn phải chạy lệnh sau:
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Công cụ
Trình cài đặt sử dụng các công cụ UNIX sau đây trong phiên bản tiêu chuẩn do EL5 cung cấp hoặc EL6.
awk |
thử nghiệm |
libxslt |
nhịp thở/phút |
giải nén |
tên cơ sở |
grep |
lua-socket |
rpm2cpio |
thêm người dùng |
bash |
hostname |
thiếu |
sed |
wc |
bc |
id |
công cụ mạng |
sudo |
wget |
curl |
cung-thiên-bình |
perl (từ Prop) |
hắc ín |
xerces-c |
cây bách xù | libdb4 | pgrep (từ procp) | tr | ngon |
date |
libdb-cxx |
điểm |
uuid |
chkconfig |
tên dirname | động từ | pwd | uname | |
echo | librdmacm | python |
ntpdate
Apigee khuyến nghị máy chủ của bạn được đồng bộ hoá. Nếu chưa được định cấu hình,
tiện ích ntpdate
có thể phục vụ mục đích này, điều này xác minh
xem các máy chủ có được đồng bộ hoá về thời gian hay không. Bạn có thể sử dụng yum install ntp
để cài đặt
tiện ích. Điều này đặc biệt hữu ích cho việc sao chép các thiết lập OpenLDAP. Lưu ý rằng bạn thiết lập máy chủ
múi giờ theo giờ UTC.
openldap 2.4
Việc lắp đặt tại chỗ yêu cầu OpenLDAP 2.4. Nếu máy chủ của bạn có kết nối Internet,
thì tập lệnh cài đặt Edge sẽ tải xuống và cài đặt
OpenLDAP. Nếu máy chủ của bạn không có kết nối Internet, bạn phải đảm bảo rằng OpenLDAP
cài đặt trước khi chạy tập lệnh cài đặt Edge. Trên RHEL/CentOS, bạn có thể chạy
yum install openldap-clients openldap-servers
để cài đặt OpenLDAP.
Đối với các bản cài đặt 13 máy chủ và 12 máy chủ lưu trữ với 2 trung tâm dữ liệu, OpenLDAP yêu cầu sao chép vì có nhiều nút lưu trữ OpenLDAP.
Tường lửa và máy chủ ảo
Thuật ngữ virtual
thường bị quá tải trong lĩnh vực CNTT, do đó, thuật ngữ này đi kèm với
Apigee Edge để triển khai Đám mây riêng tư và máy chủ ảo. Để làm rõ, có hai
việc sử dụng cụm từ virtual
:
- Máy ảo (VM): Không bắt buộc, nhưng một số hoạt động triển khai sử dụng công nghệ VM để tạo các máy chủ riêng biệt cho các thành phần Apigee. Các máy chủ ảo (như máy chủ thực) có thể có giao diện mạng và tường lửa.
- Máy chủ ảo: Các điểm cuối trên web, tương tự như máy chủ ảo Apache.
Một bộ định tuyến trong máy ảo có thể hiển thị nhiều máy chủ ảo (miễn là các máy chủ này khác nhau trong bí danh máy chủ lưu trữ hoặc trong cổng giao diện của họ).
Tương tự như ví dụ đặt tên, một máy chủ thực A
có thể đang chạy hai máy ảo,
có tên là "VM1" và "VM2". Giả sử "VM1" hiển thị giao diện Ethernet ảo, giao diện này được đặt tên
"eth0" bên trong máy ảo và được chỉ định địa chỉ IP 111.111.111.111
bằng
máy ảo hoá hoặc máy chủ DHCP của mạng; rồi giả định VM2 hiển thị một
Giao diện Ethernet còn có tên là "eth0" và được gán một địa chỉ IP
111.111.111.222
Chúng tôi có thể có một bộ định tuyến Apigee đang chạy trên mỗi máy ảo. Bộ định tuyến hiển thị máy chủ ảo như trong ví dụ giả định này:
Bộ định tuyến Apigee trong VM1 hiển thị 3 máy chủ ảo trên giao diện eth0 (trong đó có một số
địa chỉ IP cụ thể), api.mycompany.com:80
, api.mycompany.com:443
và
test.mycompany.com:80
.
Bộ định tuyến trong VM2 hiển thị api.mycompany.com:80
(cùng tên và cổng mà
VM1).
Hệ điều hành của máy chủ thực tế có thể có tường lửa mạng; nếu có, tường lửa đó
phải được định cấu hình để truyền lưu lượng truy cập TCP bị giới hạn đối với các cổng hiển thị trên
giao diện (111.111.111.111:{80, 443}
và 111.111.111.222:80
). Trong
Ngoài ra, hệ điều hành của mỗi máy ảo có thể cung cấp tường lửa riêng trên giao diện eth0 và
cũng phải cho phép lưu lượng cổng 80 và 443 kết nối.
Đường dẫn cơ sở là thành phần thứ ba liên quan đến việc định tuyến lệnh gọi API đến các proxy API khác nhau
mà bạn có thể đã triển khai. Các gói proxy API có thể dùng chung một điểm cuối nếu chúng có các điểm cuối khác nhau
đường dẫn cơ sở. Ví dụ: một đường dẫn cơ sở có thể được định nghĩa là http://api.mycompany.com:80/
và một thuộc tính khác được xác định là http://api.mycompany.com:80/salesdemo
.
Trong trường hợp này, bạn cần một trình cân bằng tải hoặc giám đốc lưu lượng truy cập để phân chia
http://api.mycompany.com:80/ lưu lượng truy cập giữa hai địa chỉ IP
(111.111.111.111
trên VM1 và 111.111.111.222
trên VM2). Chức năng này
dành riêng cho cài đặt cụ thể của bạn và được định cấu hình bởi nhóm mạng cục bộ của bạn.
Đường dẫn cơ sở được thiết lập khi bạn triển khai API. Từ ví dụ trên, bạn có thể triển khai 2 API,
mycompany
và testmycompany
cho tổ chức
mycompany-org
với máy chủ ảo có bí danh máy chủ là
api.mycompany.com
và cổng được đặt thành 80
. Nếu bạn không khai báo
đường dẫn cơ sở trong phần triển khai thì bộ định tuyến không biết phải gửi các yêu cầu đến bằng API nào
sang.
Tuy nhiên, nếu bạn triển khai API testmycompany
với URL cơ sở là
/salesdemo
, thì người dùng truy cập vào API đó bằng
http://api.mycompany.com:80/salesdemo
. Nếu bạn triển khai mycompany API với
URL cơ sở của /
, thì người dùng sẽ truy cập API theo URL
http://api.mycompany.com:80/
Cấp phép
Mỗi lần cài đặt Edge, bạn sẽ phải có một tệp giấy phép duy nhất mà bạn nhận được từ Apigee. Bạn sẽ cần cung cấp đường dẫn đến tệp giấy phép khi cài đặt máy chủ quản lý, ví dụ: /tmp/license.txt.
Trình cài đặt sao chép tệp giấy phép vào
/opt/apigee/customer/conf/license.txt
.
Nếu tệp giấy phép hợp lệ, máy chủ quản lý sẽ xác thực ngày hết hạn và thời điểm thông báo được cho phép
Số bộ xử lý (MP). Nếu bất kỳ chế độ cài đặt giấy phép nào đã hết hạn, bạn có thể xem nhật ký trong
vị trí sau đây: /opt/apigee/var/log/edge-management-server/logs
.
Trong trường hợp này, bạn có thể liên hệ với Bộ phận hỗ trợ Apigee Edge để biết thông tin chi tiết về việc di chuyển.
Nếu bạn chưa có giấy phép, hãy liên hệ với Apigee Sales.