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 apigee-setup của Edge. 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 đườ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 khi 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 Edge hoặc 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 tắt vĩnh viễn SELinux hoặc đặt SELinux ở chế độ cho phép:
    1. Mở /etc/sysconfig/selinux trong một trình chỉnh sửa.
    2. Đặt SELINUX=disabled hoặc SELINUX=permissive
    3. Lưu nội dung 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 để đặt 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 một 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 thực hiện các bước sau trước khi tiến hành cài đặt:

      1. Bật Extra Packages for Enterprise Linux (EPEL) (Các gói bổ sung cho Linux doanh nghiệp): 
        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 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 tiến hành 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 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.7 tương ứng.

      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 của 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 gốc để 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 phần Điều kiện tiên quyết cho RHEL 9/Rocky 9/Oracle 9.
      6. Tải tệp bootstrap_4.53.01.sh Edge xuống /tmp/bootstrap_4.53.01.sh: 
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.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.01.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 mã này.

        Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo bạn đã cài đặt Java 1.8. Nếu bạn chưa cài đặt, thì thao tác này sẽ cài đặt cho bạn. Sử dụng lựa chọn JAVA_FIX để chỉ định cách xử lý quá trình cài đặt Java. JAVA_FIX nhận 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 lựa 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 xác định kho lưu trữ Apigee. Để xem tệp định nghĩa, hãy dùng lệnh:

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

        Để xem nội dung của kho lưu trữ, hãy 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ố 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 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 những lỗi này:

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

      Kiểm thử khả năng kết nối mạng 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ể dùng tổ hợp phím CTRL+C để huỷ kết nối đang mở.

      Nếu một trong hai lệnh này không thành công, thì bạn có kết nối mạng hạn chế hoặc không có kết nối mạng. Hãy liên hệ với quản trị viên mạng của bạn.
      Thông tin đăng nhập 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 bằng 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 một proxy HTTP xuất và bạn chưa mở rộng cùng một 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 truyền dữ liệu ra, bạn nên sử dụng một trong các lựa 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 apigee-setup 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 vào 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 mà bạn sẽ 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 những bản sao này. Sau khi được 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.

      Quy 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 đây:

      Tạo một 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 một 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 một 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 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 của 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 bootstrap_4.53.01.sh Edge xuống /tmp/bootstrap_4.53.01.sh: 
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.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.01.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 mã này.

      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.01.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.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
        2. 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, 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ủ đó. 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 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.01.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.
      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ị vô hiệu hoá (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

        Bạn nên tắt tất cả các kho lưu trữ bên ngoài, nhưng nên 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 một trình chỉnh sửa. Tạo tệp nếu tệp đó chưa 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 thiết lập 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 theo cách nêu trên.
      6. Trên nút từ xa, hãy 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.01.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 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.01.sh mới nhất xuống rồi thực hiện một quy trình đồng bộ hoá mới.

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

      1. Tải tệp bootstrap_4.53.01.sh của Edge xuống /tmp/bootstrap_4.53.01.sh: 
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      2. Chạy tệp bootstrap_4.53.01.sh Edge: 
        sudo bash/tmp/bootstrap_4.53.01.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 mã này.

      3. Cập nhật apigee-mirror: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
      4. Thực hiện quá trình đồ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 dẹp kho lưu trữ Apigee cục bộ

      Thao tá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 dẹp kho lưu trữ cục bộ, hãy dùng:

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