Yêu cầu về cài đặt

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 sau đây về phần cứng để có cơ sở hạ tầng có tính sẵn sàng cao trong môi trường cấp độ sản xuất.

Video sau đây cung cấp hướng dẫn chung về kích thước cho quá trình lắp đặt:

Đối với tất cả các trường hợp cài đặt được mô tả trong phần Cấu trúc liên kết cài đặt, các bảng sau đây liệt kê các yêu cầu tối thiểu về phần cứng cho các thành phần cài đặt.

Trong các bảng này, yêu cầu về ổ đĩa cứng là yêu cầu bổ sung cho dung lượng ổ đĩa cứng mà hệ điều hành yêu cầu. 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ủa bạn có thể cần nhiều hoặc ít tài nguyên hơn so với danh sách dưới đây.

bytes of storage needed =
  (# bytes of analytics data/request) *
  (requests/second) *
  (seconds/hour) *
  (hours of peak usage/day) *
  (days/month) *
  (months of data retention)

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) *
  (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB of storage needed

Ngoài ra, sau đây là danh sách 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ợ trong quá trình cài đặt Tất cả trong một):

Yêu cầu về băng thông mạng Cassandra

Cassandra sử dụng giao thức Gossip để trao đổi thông tin với các nút khác về cấu trúc liên kết mạng. Việc sử dụng Gossip, kết hợp với tính chất phân tán của Cassandra (bao gồm việc giao tiếp với nhiều nút cho các thao tác đọc và ghi) dẫn đến việc truyền dữ liệu đáng kể qua mạng.

Cassandra yêu cầu băng thông mạng tối thiểu là 1 Gbps cho mỗi nút. Đối với các bản cài đặt chính thức, bạn nên sử dụng băng thông cao hơn.

Độ trễ tối đa hoặc độ trễ ở phân vị thứ 99 của Cassandra phải dưới 100 mili giây.

Yêu cầu về hệ điều hành và phần mềm bên thứ ba

Những hướng dẫn cài đặt này và các tệp cài đặt được cung cấp đã được kiểm thử trên các hệ điều hành và phần mềm bên thứ ba được liệt kê trong Phần mềm được hỗ trợ và các phiên bản được hỗ trợ.

Điều kiện tiên quyết: Bật kho lưu trữ EPEL

Trước khi tiến hành cài đặt, hãy đảm bảo rằng kho lưu trữ EPEL (Gói bổ sung cho Enterprise Linux) đã được bật. Sử dụng các lệnh sau cho Red Hat, CentOS hoặc Oracle Linux 9.x:

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

sudo rpm -ivh epel-release-latest-9.noarch.rpm

Java

Bạn cần cài đặt các phiên bản Java 17 và Java 21 được hỗ trợ trên mỗi máy trước khi cài đặt. Các JDK được hỗ trợ được liệt kê trong phần Phần mềm được hỗ trợ và các phiên bản được hỗ trợ.

Đảm bảo rằng biến môi trường JAVA_HOME trỏ đến thư mục 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 vấn đề khi cài đặt và khởi động các thành phần của Edge. Nếu cần, bạn có thể tắt SELinux hoặc đặt SELinux ở chế độ cho phép trong quá trình cài đặt, sau đó bật lại sau khi cài đặt. Xem phần Cài đặt tiện ích apigee-setup của Edge để biết thêm thông tin.

Tạo người dùng "apigee"

Quy trình cài đặt sẽ tạo một người dùng hệ thống Unix có tên là "apigee". Các thư mục và tệp Edge thuộc sở hữu của "apigee", cũng như các quy trình Edge. Điều đó có nghĩa là các thành phần Edge chạy dưới dạng người dùng "apigee". Nếu cần, bạn có thể chạy các thành phần dưới dạng một người dùng khác.

Thư mục cài đặt

Theo mặc định, trình cài đặt sẽ 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. Mặc dù không thể thay đổi thư mục này, nhưng bạn có thể tạo một liên kết tượng trưng để liên kết /opt/apigee với một vị trí khác, như mô tả trong phần Tạo liên kết tượng trưng từ /opt/apigee.

Trong hướng dẫn này, thư mục cài đặt được ghi chú là /opt/apigee.

Tạo liên kết tượng trưng từ /opt/apigee

Trước khi tạo 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 là "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 sau trước khi tải tệp bootstrap_4.54.00.sh xuống. Bạn phải thực hiện tất cả các bước này dưới dạng người dùng gốc:

1. Tạo người dùng và nhóm "apigee":

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. Tạo một liên kết tượng trưng từ /opt/apigee đến thư mục gốc cài đặt 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.

3. Thay đổi quyền sở hữu thư mục gốc cài đặt và liên kết tượng trưng cho người dùng "apigee":

   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 tất cả máy đều có địa chỉ IP cố định. Sử dụng các lệnh sau để xác thực chế độ cài đặt:

• hostname trả về tên của máy
• hostname -i trả về địa chỉ IP cho tên máy chủ có thể được xử lý từ các máy khác.

Tuỳ thuộc vào loại và phiên bản hệ điều hành, bạn có thể cần chỉnh sửa /etc/hosts và /etc/sysconfig/network nếu tên máy chủ không được đặt chính xác. Hãy xem tài liệu về 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ì lệnh "hostname -i" sẽ trả về một danh sách địa chỉ IP được phân tách bằng dấu cách. 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. Ngoài ra, 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 bạn đặt thuộc tính đó thành "y", trình cài đặt sẽ nhắc bạn chọn địa chỉ IP để sử dụng trong quá trình cài đặt. Giá trị mặc định là "n". Hãy xem Tài liệu tham khảo về 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 quá trình cài đặt OpenLDAP, Postgres và Cassandra. Trên các nút đó, hãy kiểm tra /etc/hosts.allow và /etc/hosts.deny để đảm bảo rằng không có quy định hạn chế nào về cổng đối với các cổng OpenLDAP, Postgres và Cassandra bắt buộc.

iptables

Xác thực rằng không có chính sách iptables nào ngăn chặn khả năng kết nối giữa các nút trên các cổng Edge bắt buộc. Nếu cần, bạn có thể dừng iptables trong quá trình cài đặt bằng lệnh:

sudo/etc/init.d/iptables stop

Quyền truy cập vào thư mục

Bảng sau đây liệt kê các thư mục trên nút Edge có yêu cầu đặc biệt từ Quy trình Edge:

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 khoá Edge xác định các nút Cassandra nơi đặt bản sao. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về hệ số sao chép và mức độ nhất quán của Cassandra.

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 phần Điều chỉnh tài nguyên Java trong trường hợp hiệu suất bị 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 Cassandra được định cấu hình chính xác bằng cách kiểm tra tệp /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 thuộc tính sau:

• 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:

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 các giá trị này:

1. 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.

2. Đặt các thuộc tính nêu trên.
3. Lưu nội dung chỉnh sửa.
4. Khởi động lại cơ sở dữ liệu PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Cấu hình ngôn ngữ cho Rocky 9.X

Nếu bạn đang sử dụng Rocky 9.X, hãy đảm bảo hệ thống của bạn được định cấu hình bằng LANG=en_US.utf8 trong chế độ cài đặt ngôn ngữ trên toàn hệ thống. Để định cấu hình, hãy chạy các lệnh sau:

dnf -y -q install langpacks-en
localectl set-locale LANG=en_US.utf8
reboot

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 trên các nút Cassandra và Bộ xử lý thông báo:

• Trên các nút Cassandra, hãy đặt giới hạn mềm và cứng cho memlock, nofile và không gian địa chỉ (as) cho người dùng cài đặt (mặc định là "apigee") trong /etc/security/limits.d/90-apigee-edge-limits.conf như bên dưới:

  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 Bộ xử lý thông báo, hãy đặt số lượng chỉ số mô tả tệp đang 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 hạn mức đó. Ví dụ: nếu bạn có một số lượng lớn tệp tạm thời mở cùng một lúc.

• Nếu bạn thấy lỗi sau trong Bộ định tuyến hoặc Bộ xử lý thông báo system.log, thì có thể giới hạn chỉ số mô tả tệp của bạn đượ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 chỉ số mô tả tệp thành 100000, hãy mở một phiếu yêu cầu hỗ trợ với Nhóm hỗ trợ Apigee Edge để khắc phục sự cố thêm.

Dịch vụ bảo mật 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ợ phát triển các ứng dụng máy khách và máy chủ có hỗ trợ bảo mật. Bạn nên đảm bảo rằng bạn đã 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

Tắt tính năng tra cứu DNS trên IPv6 khi sử dụng NSCD (Name Service Cache Daemon)

Nếu bạn đã cài đặt và bật NSCD (Name Service Cache Daemon), Bộ xử lý thông báo sẽ thực hiện hai lần tra cứu DNS: một lần cho IPv4 và một lần cho IPv6. Bạn nên tắt tính năng tra cứu DNS trên IPv6 khi sử dụng NSCD.

Cách tắt tính năng tra cứu DNS trên IPv6:

1. Trên mỗi nút Bộ xử lý thông báo, hãy chỉnh sửa /etc/nscd.conf
2. Đặt thuộc tính sau:

   enable-cache hosts no

Tắt IPv6 trên RHEL 8 trở lên

Nếu đang cài đặt Edge trên RHEL 8 trở lên trên Google Cloud Platform, bạn phải tắt IPv6 trên tất cả các nút Qpid.

Để biết hướng dẫn về cách tắt IPv6, vui lòng tham khảo tài liệu do nhà cung cấp hệ điều hành của bạn cung cấp. Ví dụ: bạn có thể tìm thấy thông tin liên quan trong Tài liệu về Red Hat Enterprise Linux.

Điều kiện tiên quyết đối với Amazon Linux

Trước khi cài đặt mới trên Amazon Linux 2023.9/2023.10/2023.11 hoặc nâng cấp từ phiên bản 4.53.01 lên 4.54.00 (trên Amazon Linux 2023.9/2023.10/2023.11), hãy chỉnh sửa tệp /etc/yum.repos.d/amazonlinux.repo. Phần chứa [amazonlinux] phải bao gồm những nội dung sau để đảm bảo rằng các gói được tải xuống từ apigee-thirdparty chứ không phải từ Amazon:exclude=postgresql18,luajit*.

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 hoặc EL6 cung cấp.

Đồng bộ hoá thời gian

Apigee đề xuất bạn nên đồng bộ hoá thời gian của máy chủ. Nếu chưa được định cấu hình, thì tiện ích ntpdate hoặc một công cụ tương đương có thể phục vụ mục đích này bằng cách xác minh xem các máy chủ có được đồng bộ hoá thời gian hay không. Ví dụ: bạn có thể dùng yum install ntp hoặc một lệnh tương đương để cài đặt tiện ích. Điều này đặc biệt hữu ích khi sao chép các chế độ thiết lập LDAP. Xin lưu ý rằng bạn nên đặt múi giờ của máy chủ thành UTC.

Tường lửa và máy chủ ảo

Thuật ngữ virtual thường được sử dụng quá nhiều trong lĩnh vực CNTT, và điều này cũng đúng với việc triển khai Apigee Edge cho đám mây riêng tư và máy chủ ảo. Để làm rõ, có hai cách sử dụng chính cho thuật ngữ 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ệ máy ảo để tạo máy chủ tách biệt cho các thành phần Apigee. Máy chủ lưu trữ máy ảo, giống như máy chủ lưu trữ vật lý, có thể có giao diện mạng và tường lửa.
• Máy chủ ảo: Điểm cuối web, tương tự như máy chủ ảo Apache.

Bộ định tuyến trong máy ảo có thể hiển thị nhiều máy chủ ảo (miễn là chúng khác nhau về bí danh máy chủ hoặc cổng giao diện).

Ví dụ về cách đặt tên, một máy chủ vật lý A có thể đang chạy hai máy ảo, được đặt tên là "VM1" và "VM2". Giả sử "VM1" hiển thị một giao diện Ethernet ảo, được đặt tên là "eth0" bên trong máy ảo và được gán địa chỉ IP 111.111.111.111 bằng máy ảo hoá hoặc máy chủ DHCP mạng; sau đó giả sử VM2 hiển thị một giao diện Ethernet ảo cũng có tên là "eth0" và được gán địa chỉ IP 111.111.111.222.

Chúng ta có thể có một bộ định tuyến Apigee chạy trong mỗi máy ảo. Bộ định tuyến hiển thị các điểm cuối của máy chủ ảo như trong ví dụ giả định sau:

Bộ định tuyến Apigee trong VM1 hiển thị ba máy chủ ảo trên giao diện eth0 (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 như VM1).

Hệ điều hành của máy chủ vật lý 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 TCP liên kết với các cổng đang được hiển thị trên giao diện ảo hoá (111.111.111.111:{80, 443} và 111.111.111.222:80). 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ác tường lửa này cũng phải cho phép lưu lượng truy cập 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 có các đường dẫn cơ sở khác nhau. Ví dụ: bạn có thể xác định một đường dẫn cơ sở là http://api.mycompany.com:80/ và một đường dẫn cơ sở khác là http://api.mycompany.com:80/salesdemo.

Trong trường hợp này, bạn cần có một trình cân bằng tải hoặc trình điều hướng lưu lượng truy cập để phân chia lưu lượng truy cập http://api.mycompany.com:80/ 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 chế độ cài đặt cụ thể của bạn và do nhóm mạng cục bộ của bạn định cấu hình.

Đường dẫn cơ sở được đặt khi bạn triển khai một API. Từ ví dụ trên, bạn có thể triển khai hai 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 quá trình triển khai, thì bộ định tuyến sẽ không biết nên gửi yêu cầu đến API nào.

Tuy nhiên, nếu bạn triển khai API testmycompany bằng URL cơ sở của /salesdemo, thì người dùng sẽ truy cập vào API đó bằng http://api.mycompany.com:80/salesdemo. Nếu bạn triển khai API mycompany với URL cơ sở là /, thì người dùng sẽ truy cập vào API bằng URL http://api.mycompany.com:80/.

Cấp phép

Mỗi lượt cài đặt Edge đều yêu cầu một tệp giấy phép riêng biệ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 thời hạn và số lượng Bộ xử lý thông báo (MP) được phép. Nếu bất kỳ chế độ cài đặt giấy phép nào hết hạn, bạn có thể tìm thấy nhật ký ở vị trí sau: /opt/apigee/var/log/edge-management-server/logs. Trong trường hợp này, bạn có thể liên hệ với Nhóm 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 bộ phận bán hàng của Apigee.