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

Edge for Private Cloud phiên bản 4.19.01

Để 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 của Edge. Nếu bạn đang ở môi trường nơi 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 bản sao 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 chế độ cài đặt này thư mục. 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 Yêu cầu về việc 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 trước khi có thể cài đặt Edge Tiện ích apigee-setup hoặc bất kỳ Edge nào thành phần. Nếu cần, sau khi cài đặt Edge, bạn có thể bật lại SELinux.

  • Để tạm thời đặt SELinux thành chế độ cho phép, hãy thực thi như sau :
    1. Trên hệ điều hành Linux 6.x: 
      sudo echo 0 > /selinux/enforce

      Cách bật lại SELinux sau khi cài đặt Edge:

      sudo echo 1 > /selinux/enforce
    2. Trên hệ điều hành Linux 7.x: 
      sudo setenforce 0

      Cách bật lại SELinux sau khi cài đặt Edge:

      sudo setenforce 1
  • Để tắt vĩnh viễn SELinux hoặc đặt SELinux ở 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 để đặt SELINUX=enabled.

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

Bạn phải bật Gói bổ sung cho 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ộ. Chiến lược phát hành đĩa đơn lệnh bạn sử dụng phụ thuộc vào phiên bản RedHat/CentOS của bạn:

  • Đối với RedHat/CentOS/Oracle 7.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Đối với RedHat/CentOS/Oracle 6.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
sudo rpm -ivh epel-release-latest-6.noarch.rpm

Điều kiện tiên quyết: Kiểm tra libdb4 phiên bản thư viện trên RedHat 7.4 và CentOS 7.4

Trên RedHat 7.4 và CentOS 7.4, hãy kiểm tra phiên bản của libdb4 RPM trước khi cài đặt. Cạnh yêu cầu phiên bản 4.8 và một số phiên bản RedHat 7.4 và CentOS 7.4 có phiên bản mới hơn. Nếu bạn có phiên bản mới hơn, hãy gỡ cài đặt phiên bản đó và trình cài đặt Edge sẽ thì hãy cài đặt phiên bản 4.8.

Bạn có thể dùng lệnh sau để kiểm tra phiên bản của mình:

rpm -qa | grep libdb4

Nếu bạn thấy phiên bản libdb4 RPM mới hơn phiên bản 4.8, hãy gỡ cài đặt nó.

Cài đặt tiện ích thiết lập apigee của Edge trên một nút có Internet bên ngoài kết nố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ể dùng những thông tin xác thực.
  2. Đăng nhập vào nút của bạn làm thư mục gốc để cài đặt RPM cạnh
  3. Cài đặt yum-utils và yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Tắt SELinux như được mô tả ở trên.
  5. Bật kho lưu trữ EPEL như mô tả ở trên.
  6. Kiểm tra phiên bản libdb4 của bạn theo cách nêu trên.
  7. Nếu bạn đang cài đặt trên Oracle 7.x, hãy chạy lệnh sau: 
    sudo yum-config-manager --enable ol7_optional_latest
  8. Nếu bạn đang cài đặt trên AWS, hãy chạy lệnh sau Lệnh yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Tải tệp Edge bootstrap_4.19.01.sh xuống /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. Cài đặt tiện ích và các phần phụ thuộc dịch vụ apigee của Edge: 
    sudo bash /tmp/bootstrap_4.19.01.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 mã đó.

    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, cài đặt ứng dụng đó cho bạn. Sử dụng lựa chọn JAVA_FIX để chỉ định cách xử lý Cài đặt Java. JAVA_FIX sẽ 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 tuỳ chọn này, bạn phải tự cài đặt Java.

    Quá trình 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*'
  11. Sử dụng apigee-service để cài đặt tiện ích thiết lập apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. Sử dụng chế độ thiết lập apigee để cài đặt và định cấu hình các thành phần Edge trên nút. Xem bài viết Cài đặt các thành phần của Edge trên một nút để biết thêm thông tin.

Cài đặt Edge tiện ích thiết lập apigee 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 bị tường lửa chặn hoặc bị cấm truy cập theo một cách khác Internet, thì bạn phải tạo một vài kho lưu trữ hoặc bản sao, chứa các tệp mà bạn sẽ 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 đó. Sau khi được tạo, các nút sau đó 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 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 cần có một nút có kết nối Internet bên ngoài để có thể tải các phần phụ thuộc và RPM của Edge xuống. Sau khi tạo xong nhóm nội bộ repo, sau đó bạn có thể di chuyển nó đến một nút khác hoặc cho phép các nút Edge có thể truy cập vào 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ữ này lên phiên bản mới nhất Tệp phát hành Edge. 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 ứng dụng.

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 cho trang web ftp, thì bạn có thể sử dụng những mật khẩu đó thông tin xác thực.
  2. Đăng nhập vào nút của bạn làm thư mục gốc để cài đặt RPM cạnh.
  3. Tắt SELinux như được mô tả ở trên.
  4. Tải tệp Edge bootstrap_4.19.01.sh xuống /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  5. Cài đặt tiện ích và các phần phụ thuộc dịch vụ apigee của Edge: 
    sudo bash /tmp/bootstrap_4.19.01.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 mã đó.

  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 xuống RPM (doanh thu mỗi nghìn lượt xem) mới nhất. Bạn cần khoảng 1,6 GB dung lượng ổ đĩa để tải xuống:

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

    Nếu bạn muốn tải toàn bộ kho lưu trữ xuống, bao gồm cả các RPM cũ, hãy bỏ qua --only-new-rpms. Bạn cần khoảng 6 GB dung lượng ổ đĩa để tải xuống toàn bộ: 

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

    Bây giờ, bạn đã có một bản sao cục bộ của kho lưu trữ Apigee. Phần tiếp theo mô tả cách cài đặt Tiện ích apigee-setup cạnh từ kho lưu trữ cục bộ.

  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ộ lên 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.19.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.19.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. Dùng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút này. 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 chế độ thiết lập apigee trên một nút từ xa của kho lưu trữ cục bộ

Bạn có hai cách để cài đặt Edge qua 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 bằng repo cục bộ để các nút khác có thể truy cập vào đó. 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ủ của riêng mình máy chủ web.

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ộ, sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ vào tệp .tar đơn có tên /opt/apigee/data/apigee-mirror/apigee-4.19.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 địa chỉ đó vào Thư mục /tmp trên nút mới.
  3. Trên nút mới, vô hiệu hoá 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à EPEL cục bộ kho lưu trữ.
  5. Kiểm tra kỹ để đảm bảo tất cả các kho lưu trữ Internet bên ngoài đều bị tắt (trường hợp này xảy ra vì bạn đang cài đặt trên một máy tính không có kết nối Internet): 
    sudo yum repolist

    Bạn phải vô hiệu hoá tất cả các kho lưu trữ bên ngoài, ngoại trừ các kho lưu trữ Apigee cục bộ và các kho lưu trữ nội bộ của bạn cần được bật.

  6. Trên nút mới, cài đặt yum-utils và yum-plugin-priorities từ kho lưu trữ cục bộ của bạn: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    Nhóm điều hành hoặc nhóm khác trong tổ chức của bạn phải thiết lập một kho lưu trữ cục bộ để bạn có thể cài đặt các công cụ Yum.

  7. 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.
  8. Nếu bạn đang cài đặt trên Oracle 7.x, hãy chạy lệnh sau: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Nếu bạn đang cài đặt trên AWS, hãy chạy lệnh sau Lệnh yum-configure-manager: 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Trên nút mới, huỷ đánh dấu tệp vào thư mục /tmp: 
    tar -xzf apigee-4.19.01.tar.gz

    Lệnh này tạo một thư mục mới, có tên là repos, trong thư mục chứa tệp .tar . Ví dụ: /tmp/repos.

  11. Cài đặt tiện ích dịch vụ apigee và các phần phụ thuộc Edge từ /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Lưu ý rằng bạn bao gồm đường dẫn đến thư mục repos trong lệnh này.

  12. Dùng apigee-service để cài đặt tiện ích apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Dùng apigee-setup để cài đặt và định cấu hình các thành phần Edge trên nút này. 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 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. Người nhận 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ữ này yêu cầu tên người dùng:mật khẩu của admin:admin. Để thay đổi những 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, cài đặt yum-utils và yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Trên nút mới, vô hiệu hoá SELinux như mô tả ở trên.
  6. Trên nút mới, hãy đảm bảo rằng bạn đã bật kho lưu trữ EPEL cục bộ.
  7. 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.
  8. Trên nút điều khiển từ xa, tải tệp Edge bootstrap_4.19.01.sh xuống /tmp/bootstrap_4.19.01.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

    Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt ở trên cho kho lưu trữ và remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.

  9. 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.19.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 kho lưu trữ.

  10. Trên nút từ xa, sử dụng apigee-service để cài đặt apigee-setup phần mềm tiện ích: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. 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 bài viết Cài đặt các thành phần của 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 repo, bạn phải tải tệp bootstrap_4.19.01.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.19.01.sh xuống /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  2. Chạy tệp Edge bootstrap_4.19.01.sh: 
    sudo bash/tmp/bootstrap_4.19.01.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ạn bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.

  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 một kho lưu trữ Apigee cục bộ

Việc xoá repo cục bộ sẽ bị xoá /opt/apigee/data/apigee-mirror và /var/tmp/yum-apigee-*.

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

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

Thêm hoặc cập nhật Edge 4.16.0x/4.17.0x trong kho lưu trữ 4.19.01

Nếu bạn phải duy trì cài đặt cho Edge 4.16.0x hoặc 4.17.0x trong repo 4.19.01, bạn có thể duy trì một kho lưu trữ chứa tất cả các phiên bản. Từ kho lưu trữ đó, bạn có thể cài đặt bất kỳ phiên bản nào của Cạnh.

Cách thêm phiên bản 4.16.0x/4.17.0x vào kho lưu trữ 4.19.01:

  1. Đảm bảo bạn đã cài đặt phiên bản 4.19.01 của apigee-mirror phần mềm tiện ích: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Bạn sẽ thấy kết quả trong biểu mẫu dưới đây, trong đó xyz là số bản dựng:

    apigee-mirror-4.19.01-0.0.xyz
  2. Sử dụng apigee-mirror tiện ích để tải Edge 4.16.0x/4.17.0x xuống repo của bạn. Lưu ý cách bạn thêm tiền tố lệnh bằng phiên bản mong muốn: 
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Sử dụng cùng lệnh này để sau này cập nhật repos 4.16.0x/4.17.0x bằng cách chỉ định yêu cầu số phiên bản.

  3. Kiểm tra thư mục /opt/apigee/data/apigee-mirror/repos để xem tệp cấu trúc: 
    ls /opt/apigee/data/apigee-mirror/repos

    Bạn sẽ thấy các tệp và thư mục sau:

    apigee
apigee-repo-1.0-6.x86_64.rpm
bootstrap_4.16.01.sh
bootstrap_4.16.05.sh
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh
bootstrap_4.17.09.sh
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty

    Hãy lưu ý cách bạn có tệp Tự khởi động cho tất cả các phiên bản Edge. apigee cũng chứa các thư mục riêng cho từng phiên bản Edge.

  4. Để đóng gói kho lưu trữ vào một tệp .tar, hãy dùng lệnh sau:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Lệnh này gói tất cả các repos 4.17.0x và 4.16.0x vào cùng một tệp .tar. Bạn không thể chỉ là một phần của kho lưu trữ.

Để cài đặt Edge từ tệp repo hoặc tệp .tar cục bộ, bạn chỉ cần đảm bảo chạy đúng quy trình khởi động bằng một trong các lệnh sau. Ví dụ này cài đặt Edge 4.17.01:

  • Nếu cài đặt từ tệp .tar, hãy chạy đúng tệp tự khởi động trong kho lưu trữ:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Để hoàn tất quá trình cài đặt, hãy làm theo các bước còn lại trong phần "Cài đặt từ tệp .tar" ở trên.

  • Nếu cài đặt bằng máy chủ web Nginx, hãy tải xuống rồi chạy tệp khởi động đúng từ kho lưu trữ: 
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Để hoàn tất quá trình cài đặt, hãy làm theo các bước còn lại trong phần "Cài đặt qua kho lưu trữ bằng máy chủ web Nginx" ở trên.