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 phải cài đặt tiện ích thiết lập apigee-setup của Edge. Nếu đang ở trong một môi trường mà các nút 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 sẽ 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 đường 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 SELinux ở chế độ cho phép thì mới có thể cài đặt tiện ích apigee-setup của Edge hay bất kỳ thành phần nào của Edge. Nếu cần, sau khi cài đặt Edge, bạn có thể bật lại SELinux.

  • Cách vĩnh viễn tắt SELinux hoặc đặt SELinux thành chế độ cho phép:
    1. Mở /etc/sysconfig/selinux trong trình chỉnh sửa.
    2. Đặt SELINUX=disabled hoặc SELINUX=permissive
    3. Lưu nội dung bạn chỉnh sửa.
    4. Khởi động lại nút.
    5. Nếu cần, hãy bật lại SELinux sau khi cài đặt Edge bằng cách lặp lại quy trình này để thiết lập SELINUX=enabled.

    • Đ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ộ. Lệnh bạn sử dụng tuỳ thuộc vào phiên bản RedHat/CentOS:

    • Đối với Red Hat/CentOS/Oracle 8.x: 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • Đối với Red Hat/CentOS/Oracle 9.x: 
      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 đối với RHEL 8/Rocky 8/Oracle 8

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

      1. Bật Gói bổ sung cho Linux doanh nghiệp (EPEL): 
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. Tắt Postgres và Nginx: 
        sudo dnf module disable postgresql
sudo dnf module disable nginx

      Điều kiện tiên quyết đối với 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) (Gói bổ sung cho Enterprise Linux): 
        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 những thay đổi về cài đặt trước cho PostgreSQL và LDAP, hãy xem Yêu cầu cài đặt trước cơ sở dữ liệu PostgreSQL và Thay đổi cài đặt trước OpenLDAP 2.4, tương ứng.

      Cài đặt tiện ích thiết lập apigee Edge 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 các thông tin xác thực đó.
      2. Đăng nhập vào nút của bạn dưới dạng thư mục gốc để cài đặt RPM của 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 phần Điều kiện tiên quyết dành cho RHEL 9/Rocky 9/Oracle 9.
      6. Tải tệp Edge bootstrap_4.53.00.sh xuống /tmp/bootstrap_4.53.00.sh: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge: 
        sudo bash /tmp/bootstrap_4.53.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ỏ qua pWord, bạn sẽ được nhắc nhập giá trị này.

        Theo mặc định, trình cài đặt sẽ kiểm tra xem bạn đã cài đặt Java 1.8 hay chưa. Nếu không, ứng dụng sẽ cài đặt cho bạn. Sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc cài đặt Java. JAVA_FIX lấy các giá trị sau:

        • I: Cài đặt OpenJDK 1.8 (mặc định)
        • C: Tiếp tục mà không cài đặt Java
        • Hỏi: Thoát. Đối với tuỳ chọn này, bạn phải tự cài đặt Java.

        Việc cài đặt tiện ích apigee-service sẽ tạo tệp /etc/yum.repos.d/apigee.repo giúp 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. Hãy 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ố 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 phải 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:

      Loại lỗi Giải pháp có thể áp dụng
      Mật khẩu chứa ký tự không hợp lệ Đừng dùng ký tự đặc biệt trong mật khẩu Apigee của bạn.
      Sự cố kết nối

      Kiểm tra kết nối mạng của bạn bằng cách thực thi lệnh ncat sau:

      nc -v software.apigee.com 443

      Bạn sẽ nhận được một thông báo tương tự như sau:

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

      Nếu chưa cài đặt nc, bạn có thể thực thi lệnh telnet sau:

      telnet software.apigee.com 443

      Nếu các lệnh thành công, bạn có thể sử dụng tổ hợp phím CTRL+C để huỷ kết nối đang mở.

      Nếu một trong hai lệnh không thành công, thì tức là bạn có kết nối mạng bị hạn chế hoặc không có kết nối mạng. Hãy kiểm tra với quản trị viên mạng.
      Thông tin xác thực không chính xác

      Đảm bảo rằng tên người dùng và mật khẩu của bạn là chính xác.

      Ví dụ: hãy kiểm tra xem bạn có gặp lỗi khi cố gắng sử dụng lệnh sau với tên người dùng và mật khẩu Apigee của mình hay không:

      curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
      Vấn đề về proxy Cấu hình cục bộ của bạn sử dụng proxy HTTP đi và bạn chưa mở rộng cấu hình đó cho trình quản lý gói yum. Kiểm tra các biến môi trường: 
      echo $http_proxy
echo $https_proxy

      Đối với proxy HTTP đi ra, bạn nên sử dụng một trong các tuỳ chọn sau:

      • Thêm cấu hình proxy HTTP trong /etc/yum.conf
      • Thêm cấu hình proxy HTTP chung trong /etc/environment

      Cài đặt tiện ích thiết lập apigee-setup của Edge 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 Internet theo 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 bạn cần trong quá trình cài đặt. Sau đó, tất cả các nút phải truy cập được 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:

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

      Để tạo kho lưu trữ Apigee nội bộ, bạn phải 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 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ộ, có thể sau này bạn sẽ 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 một kho lưu trữ Apigee tại địa phương:

      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 hiện tại cho trang web ftp Apigee, bạn có thể sử dụng nhữ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 gốc để cài đặt RPM Edge.
      3. Tắt SELinux như mô tả ở trên.
      4. Tải tệp bootstrap_4.53.00.sh của Edge xuống /tmp/bootstrap_4.53.00.sh: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge: 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

      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 muốn cài đặt Edge từ kho lưu trữ cục bộ vào cùng một nút lưu trữ kho lưu trữ cục bộ, trước tiên, bạn cần chạy các lệnh sau:
        1. Chạy bootstrap_4.53.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.53.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. Hãy 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 apigee-setup trên một nút từ xa từ kho lưu trữ cục bộ

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

      • Tạo tệp .tar của kho lưu trữ, sao chép tệp .tar vào một nút, sau đó cài đặt Edge từ tệp .tar.
      • Cài đặ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ủ đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng, hoặc bạn có thể 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.53.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 này 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 và kho lưu trữ EPEL cục bộ.
      5. Kiểm tra kỹ để đảm bảo tất cả các kho lưu trữ Internet bên ngoài đã bị tắt (trường hợp này xảy ra vì bạn đang cài đặt trên máy không có kết nối Internet): 
        sudo yum repolist

        Bạn phải tắt tất cả kho lưu trữ bên ngoài, nhưng phải bật kho lưu trữ Apigee cục bộ và kho lưu trữ nội bộ.

      6. 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. Hãy 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 trình chỉnh sửa. Tạo tệp nếu chưa có.
        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 những thông tin xác thực 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 của bạn theo 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 apigee-service của Edge: 
        sudo bash /tmp/bootstrap_4.53.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. Hãy 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.53.00.sh mới nhất xuống, sau đó 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.53.00.sh xuống /tmp/bootstrap_4.53.00.sh: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Chạy tệp Edge bootstrap_4.53.00.sh: 
        sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

      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 dọn dẹp kho lưu trữ cục bộ sẽ xoá /opt/apigee/data/apigee-mirror và /var/tmp/yum-apigee-*.

      Để dọn sạch kho lưu trữ cục bộ, hãy sử dụng:

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