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

Edge for Private Cloud phiên bản 4.16.05

Để 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.

Tạo đường liên kết tượng trưng từ /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.

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

  1. Tạo "apigee" người dùng và nhóm:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Người dùng nền tảng Apigee" API
  2. Tạo một đường liên kết tượng trưng từ /opt/apigee đến lượt cài đặt mà bạn muốn gốc:
    > Hệ số lt -T /srv/myInstallDir /opt/apigee
    trong đó /srv/myInstallDir là vị trí mong muốn của Edge tệp.
  3. Thay đổi quyền sở hữu thư mục gốc cài đặt và đường liên kết tượng trưng đến "api" ("API") người dùng:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Đ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:
      tiếng vọng 0 > /selinux/thực thi

      Cách bật lại SELinux sau khi cài đặt Edge:
      tiếng vọng 1 > /selinux/thực thi
    2. Trên hệ điều hành Linux 7.x:
      thiết lập 0

      Cách bật lại SELinux sau khi cài đặt Edge:
      thiết lập 1
  • Để 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 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.

Cài đặt Edge tiện ích thiết lập apigee trên 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ó 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
    Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập vào thư mục gốc, nhưng bạn có thể thực hiện thao tác trên Edge mà không có quyền truy cập gốc.
  3. Tắt SELinux như được mô tả ở trên.
  4. Tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
    > cuộn tròn https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.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.16.05.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 Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập từ đó.

    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ẽ 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
    Q = 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:
    > con mèo /etc/yum.repos.d/apigee.repo

    Để xem nội dung trong kho lưu trữ, hãy dùng lệnh:
    > Kho lưu trữ sudo yum -v "apigee*"
  6. 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 cài đặt
  7. 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 kho lưu trữ Apigee trên Internet, thì bạn phải tạo kho lưu trữ cục bộ hoặc phản chiếu của kho lưu trữ Apigee. Sau đó, tất cả các nút phải truy cập được vào bản sao đó. Sau khi được tạo, các nút sau đó có thể truy cập vào bản sao cục bộ đó để cài đặt Edge.

Lưu ý: Apigee không lưu trữ tất cả phần phụ thuộc của bên thứ ba ở chế độ công khai kho lưu trữ mới. Bạn phải tải và cài đặt các phần phụ thuộc này từ tệp có thể truy cập công khai kho lưu trữ mới.

Sau khi tạo kho lưu trữ cục bộ của Edge, có thể sau này bạn sẽ phải cập nhật kho lưu trữ đó bằng 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ữ cục bộ và cách hãy cập nhật ứng dụng.

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

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, 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 RedHat hoặc CentOS của bạn dưới dạng thư mục gốc để cài đặt RPM cạnh.
    Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập vào thư mục gốc, nhưng bạn có thể thực hiện thao tác trên Edge mà không có quyền truy cập gốc.
  3. Đảm bảo bạn đang dùng phiên bản yum-utils mới nhất:
    > cập nhật về sudo yum yum-utils
  4. Tắt SELinux như được mô tả ở trên.
  5. Tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
    > cuộn tròn https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  6. 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.16.05.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 Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập từ đó.
  7. Cài đặt apigee-mirror phần mềm tiện ích trên nút:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  8. Sử dụng apigee-mirror tiện ích để đồng bộ hoá kho lưu trữ Apigee với /opt/apigee/data/apigee-mirror/repos/ thư mục.

    Để 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 tệp mới nhất RPM (doanh thu mỗi nghìn lượt xem). 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-phản chiếu đồng bộ hoá

    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 của repo cục bộ.
  9. (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.16.05.sh từ repo để cài đặt tiện ích apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Sử dụng apigee-service để cài đặt trình thiết lập apigee tiện ích:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup settings
    3. Sử dụng tính năng apigee-setup để 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 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:

  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.16.05.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 /tmp trên thư mục mới nút.
  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 khôi phục tệp vào thư mục /tmp:
    > tar -xzf apigee-4.16.05.tar.gz

    Lệnh này tạo một thư mục mới, có tên repos, trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.
  5. Cài đặt tiện ích và các phần phụ thuộc Edge apigee từ /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.16.05.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.
  6. Sử dụng apigee-service để cài đặt trình thiết lập apigee tiện ích:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup settings
  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 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 từ kho lưu trữ bằng cách sử dụ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 khởi động lại
  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 các thông tin đăng nhập nà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, vô hiệu hoá SELinux như mô tả ở trên.
  5. Trên nút điều khiển từ xa, hãy tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

    trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt ở trên cho repo và remoteRepo là địa chỉ IP hoặc tên DNS của kho lưu trữ nút.
  6. Trên nút từ xa, hãy 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.16.05.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ữ.
  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 settings
  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 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.16.05.sh mới nhất, sau đó thực hiện thao tác mới đồng bộ hoá:

  1. Tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
    > cuộn tròn https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  2. Thực hiện đồng bộ hoá:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-RPMs
  3. Nếu bạn muốn tải toàn bộ kho lưu trữ xuống, hãy làm như sau:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-phản chiếu đồng bộ hoá

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.01 trong repo 4.16.05

Nếu bạn phải duy trì cài đặt cho cả Edge 4.16.05 và 4.16.01, bạn có thể duy trì một kho lưu trữ chứa cả hai phiên bản. Từ kho lưu trữ đó, sau đó bạn có thể cài đặt Edge 4.16.05 và 4.16.01.

Để thêm 4.16.01 vào repo 4.15.05:

  1. Đảm bảo rằng bạn đã cài đặt phiên bản 4.16.05 của tiện ích apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror phiên bản

    Bạn sẽ thấy kết quả trong biểu mẫu bên dưới, trong đó xyz là bản dựng số:
    apigee-mirror-4.16.05-0.0.xyz
  2. Sử dụng apigee-mirror tiện ích để tải Edge 4.16.01 xuống repo của bạn. Lưu ý cách bạn thêm tiền tố lệnh bằng apigeereleasever=4.16.01:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service đồng bộ hoá apigee-mirror --only-new-RPMs

    Sử dụng lệnh tương tự này để sau này cập nhật repo 4.16.01.
  3. Kiểm tra /opt/apigee/data/apigee-mirror/repos thư mục để xem cấu trúc tệp:
    > thiếu /opt/apigee/data/apigee-mirror/repos

    Bạn sẽ thấy các tệp và thư mục sau:
    API apigee-repo-1.0-6.x86_64.RPM bootstrap_4.16.01.sh bootstrap_4.16.05.sh bên thứ ba

    Hãy lưu ý cách bạn có tệp Tự khởi động cho cả hai phiên bản Edge. Thư mục apigee cũng chứa cho mỗi 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.16.01 /opt/apigee/apigee-service/bin/apigee-service gói apigee-mirror

    Lệnh này gói cả repos 4.16.05 và 4.16.01 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 cách sử dụng một trong các lệnh sau:

  • 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.16.0X.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.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
    > sudo bash /tmp/bootstrap_4.16.0X.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.