Cài đặt tiện ích thiết lập api của Edge

Để cài đặt Edge trên một nút, trước tiên, bạn hãy cài đặt tiện ích Edge apigee-setup. Nếu đang ở trong một môi trường mà các nút của bạn không có kết nối Internet bên ngoài, bạn cũng phải cài đặt một bản sao cục bộ của kho lưu trữ Apigee.

Thư mục cài đặt mặc định: /opt/apigee

Edge cài đặt tất cả các tệp trong thư mục /opt/apigee. Bạn không thể thay đổi thư mục này. Tuy nhiên, nếu muốn, bạn có thể tạo một liên kết tượng trưng để ánh xạ /opt/apigee đến một vị trí khác. Hãy xem phần Yêu cầu cài đặt để biết thêm thông tin.

Điều kiện tiên quyết: Tắt SELinux

Bạn phải tắt SELinux hoặc đặt thành chế độ cho phép thì mới có thể cài đặt tiện ích Edge apigee-setup hoặc bất kỳ thành phần Edge nào. Nếu cần, sau khi cài đặt Edge, bạn có thể bật lại SELinux.

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

Bạn phải bật Extra Packages for Enterprise Linux (hoặc EPEL) để cài đặt hoặc cập nhật Edge hoặc để tạo kho lưu trữ cục bộ. Đối với Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x hoặc Oracle Linux 9.x, hãy chạy các lệnh sau:

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

Điều kiện tiên quyết cho RHEL 9/Rocky 9/Oracle 9

Nếu bạn đang cài đặt Edge trên một máy chủ chạy Red Hat Enterprise Linux (RHEL) 9, Rocky 9 hoặc Oracle 9, hãy hoàn tất các bước sau trước khi cài đặt:

1. Bật Extra Packages for Enterprise Linux (EPEL):

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. Tắt Postgres và Nginx:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

Để biết các thay đổi trước khi cài đặt cho PostgreSQL và LDAP, hãy xem các yêu cầu trước khi cài đặt cơ sở dữ liệu PostgreSQL và các thay đổi trước khi cài đặt SymasLDAP 2.6.10.

Cài đặt tiện ích Edge apigee-setup trên một nút có kết nối Internet bên ngoài

Cách cài đặt Edge trên một nút có kết nối Internet bên ngoài:

1. Lấy tên người dùng và mật khẩu từ Apigee mà bạn dùng để truy cập vào kho lưu trữ Apigee. Nếu đã có username:password cho trang web ftp Apigee, bạn có thể sử dụng thông tin đăng nhập đó.
2. Đăng nhập vào nút của bạn với tư cách là người dùng root để cài đặt các RPM Edge
   
3. Tắt SELinux.
4. Bật kho lưu trữ EPEL.
5. Nếu bạn đang cài đặt trên RHEL 9/Rocky 9/Oracle 9, hãy làm theo các bước trong Điều kiện tiên quyết cho RHEL 9/Rocky 9/Oracle 9.
6. Tải tệp Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

7. Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bạn bỏ qua pWord, bạn sẽ được nhắc nhập mật khẩu.

   Apigee Edge cho Đám mây riêng tư 4.54.00 yêu cầu hỗ trợ kép cho Java với cả Java 17 và Java 21 được cài đặt trên nút. Bạn phải cài đặt cả Java 17 và Java 21 trước khi chạy tập lệnh khởi động. Trình cài đặt chỉ xác minh rằng cả hai phiên bản JDK đều được cài đặt; trình cài đặt không tự động cài đặt Java tự động.

   Việc cài đặt tiện ích apigee-service sẽ tạo tệp /etc/yum.repos.d/apigee.repo xác định kho lưu trữ Apigee. Để xem tệp định nghĩa, hãy sử dụng lệnh:

   cat /etc/yum.repos.d/apigee.repo

   Để xem nội dung kho lưu trữ, hãy sử dụng lệnh:

   sudo yum -v repolist 'apigee*'

8. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

9. Sử dụng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút. Xem phần Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

Khắc phục sự cố

Khi cố gắng cài đặt trên một nút có kết nối Internet bên ngoài, bạn có thể gặp một hoặc nhiều lỗi sau:

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

Bảng sau đây liệt kê một số giải pháp có thể áp dụng cho các lỗi này:

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

Cài đặt tiện ích Edge apigee-setup trên một nút không có kết nối Internet bên ngoài

Nếu các nút Edge của bạn nằm sau tường lửa hoặc bị cấm truy cập vào Internet theo một cách nào đó, thì bạn phải tạo một số kho lưu trữ hoặc bản sao chứa các tệp mà bạn sẽ cần trong quá trình cài đặt. Sau đó, tất cả các nút phải có thể truy cập vào các bản sao đó. Sau khi tạo, các nút có thể truy cập vào các bản sao cục bộ này để cài đặt Edge.

Quá trình cài đặt Apigee Edge cho các nút không có kết nối Internet yêu cầu quyền truy cập vào các kho lưu trữ cục bộ sau:

• Kho lưu trữ Apigee Edge: Như mô tả trong phần Tạo kho lưu trữ Apigee cục bộ.
• Extra Packages for Enterprise Linux (hoặc EPEL): Nhóm vận hành của bạn có thể thiết lập kho lưu trữ này cho bạn.

Tạo kho lưu trữ Apigee cục bộ

Để tạo kho lưu trữ Apigee nội bộ, bạn cần có một nút có quyền truy cập Internet bên ngoài để có thể tải các RPM và phần phụ thuộc của Edge xuống. Sau khi tạo kho lưu trữ nội bộ, bạn có thể di chuyển kho lưu trữ đó sang một nút khác hoặc cho phép các nút Edge truy cập vào nút đó để cài đặt.

Sau khi tạo kho lưu trữ Apigee cục bộ, sau này bạn có thể phải cập nhật kho lưu trữ đó bằng các tệp phát hành Edge mới nhất. Các phần sau đây mô tả cách tạo kho lưu trữ Apigee cục bộ và cách cập nhật kho lưu trữ đó.

Cách tạo kho lưu trữ Apigee cục bộ:

1. Lấy tên người dùng và mật khẩu từ Apigee mà bạn dùng để truy cập vào kho lưu trữ Apigee. Nếu đã có tên người dùng:mật khẩu cho trang web ftp Apigee, bạn có thể sử dụng thông tin đăng nhập đó.
2. Đăng nhập vào nút của bạn với tư cách là người dùng root để cài đặt các RPM Edge.
   
3. Tắt SELinux như mô tả ở trên.
4. Tải tệp Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

5. Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service:
   

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bạn bỏ qua pWord, bạn sẽ được nhắc nhập mật khẩu.

6. Cài đặt tiện ích apigee-mirror trên nút:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. Sử dụng tiện ích apigee-mirror để đồng bộ hoá kho lưu trữ Apigee với thư mục /opt/apigee/data/apigee-mirror/repos/.

   Để giảm thiểu kích thước của kho lưu trữ, hãy thêm --only-new-rpms để chỉ tải các RPM mới nhất xuống.

8. (Không bắt buộc) Nếu bạn muốn cài đặt Edge từ kho lưu trữ cục bộ trên cùng một nút lưu trữ kho lưu trữ cục bộ, thì trước tiên, bạn cần chạy các lệnh sau:
   1. Chạy bootstrap_4.54.00.sh từ kho lưu trữ cục bộ để cài đặt tiện ích apigee-service:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   3. Sử dụng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút. Xem Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

Cài đặt apigee-setup trên một nút từ xa từ kho lưu trữ cục bộ

Bạn có 2 lựa chọn để cài đặt Edge từ kho lưu trữ cục bộ. Bạn có thể:

• Tạo một tệp .tar của kho lưu trữ, sao chép tệp .tar vào một nút rồi cài đặt Edge từ tệp .tar.
• Cài đặt một máy chủ web trên nút có kho lưu trữ cục bộ để các nút khác có thể truy cập vào máy chủ web đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể sử dụng máy chủ web của riêng mình.

Cài đặt từ tệp .tar

Cách cài đặt từ tệp .tar:

1. Trên nút có kho lưu trữ cục bộ, hãy sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar duy nhất có tên là /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. Sao chép tệp .tar vào nút mà bạn muốn cài đặt Edge. Ví dụ: sao chép tệp đó vào thư mục /tmp trên nút mới.
3. Trên nút mới, hãy tắt SELinux như mô tả ở trên.
4. Trên nút mới, hãy đảm bảo rằng bạn có thể truy cập vào kho lưu trữ tiện ích Yum cục bộ và kho lưu trữ EPEL repo.
5. Kiểm tra kỹ để đảm bảo rằng tất cả các kho lưu trữ Internet bên ngoài đều bị tắt (trường hợp này sẽ xảy ra vì bạn đang cài đặt trên một máy không có quyền truy cập Internet):

   sudo yum repolist

   Tất cả các kho lưu trữ bên ngoài đều phải bị tắt, nhưng kho lưu trữ Apigee cục bộ và các kho lưu trữ nội bộ của bạn phải được bật.

6. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

7. Sử dụng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút. Xem phần Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

Cài đặt từ kho lưu trữ bằng máy chủ web Nginx

Cách cài đặt từ kho lưu trữ bằng máy chủ web Nginx:

1. Cài đặt máy chủ web Nginx trên nút kho lưu trữ:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. Theo mặc định, Nginx được định cấu hình để sử dụng localhost làm tên máy chủ và cổng 3939. Cách thay đổi các giá trị này:
   1. Mở /opt/apigee/customer/application/mirror.properties trong một trình chỉnh sửa. Tạo tệp nếu tệp đó không tồn tại.
   2. Đặt các giá trị sau nếu cần:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Khởi động lại Nginx:

      /opt/nginx/scripts/apigee-nginx restart

3. Theo mặc định, kho lưu trữ yêu cầu tên người dùng:mật khẩu là admin:admin. Để thay đổi thông tin đăng nhập này, hãy đặt các biến môi trường sau:

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. Trên nút mới, hãy đảm bảo rằng kho lưu trữ EPEL được bật cục bộ.
5. Trên nút mới, hãy kiểm tra phiên bản libdb4 như mô tả ở trên.
6. Trên nút từ xa, hãy cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   Trong đó uName:pWord là tên người dùng và mật khẩu của kho lưu trữ.

7. Trên nút từ xa, hãy sử dụng apigee-service để cài đặt tiện ích apigee-setup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

8. Sử dụng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút từ xa. Xem phần Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

Cập nhật kho lưu trữ Apigee cục bộ

Để cập nhật kho lưu trữ, bạn phải tải tệp bootstrap_4.54.00.sh mới nhất xuống rồi thực hiện một lần đồng bộ hoá mới.

Cách cập nhật kho lưu trữ:

1. Tải tệp Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

2. Chạy tệp Edge bootstrap_4.54.00.sh:

   sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bạn bỏ qua pWord, bạn sẽ được nhắc nhập mật khẩu.

3. Cập nhật apigee-mirror:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. Thực hiện đồng bộ hoá:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. Nếu bạn muốn toàn bộ kho lưu trữ:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Dọn sạch kho lưu trữ Apigee cục bộ

Việc xoá kho lưu trữ cục bộ sẽ xoá /opt/apigee/data/apigee-mirror và /var/tmp/yum-apigee-*.

Để xoá kho lưu trữ cục bộ, hãy sử dụng:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean