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

Edge for Private Cloud phiên bản 4.16.09

Để cài đặt Edge trên một nút, trước tiên, bạn cần cài đặt tiện ích thiết lập apigee 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.

Tạo đường liên kết tượng trưng từ /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 tới 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 là "apigee". Đây chính là 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, thực hiện các bước này trước khi tải tệp bootstrap_4.16.09.sh xuống. Bạn phải thực hiện tất cả các bước sau với tư cách gốc:

1. Tạo người dùng và nhóm "apigee":
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
2. Tạo một đường liên kết tượng trưng từ /opt/apigee đến thư mục gốc cài đặt mà bạn muốn:
   > ln -Ts /srv/myInstallDir /opt/apigee
   trong đó /srv/myInstallDir là vị trí mong muốn của các tệp Edge.
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 cho người dùng "apigee":
   > 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 thì mới có thể cài đặt tiện ích apigee-setup của Edge hoặc bất kỳ thành phần Edge nào. Nếu cần, bạn có thể bật lại SELinux sau khi cài đặt Edge.

• Để tạm thời đặt SELinux ở chế độ cho phép, hãy thực thi lệnh sau:
  1. Trên hệ điều hành Linux 6.x:
     echo 0 > /selinux/enforce
     
     Cách bật lại SELinux sau khi cài đặt Edge:
     echo 1 > /selinux/enforce
  2. Trên hệ điều hành Linux 7.x:
     setenforce 0
     
     Cách bật lại SELinux sau khi cài đặt Edge:
     setenforce 1
• Cách tắt vĩnh viễn SELinux hoặc đặt ở chế độ cho phép:
  1. Mở /etc/sysconfig/selinux trong trình chỉnh sửa.
  2. Đặt SELINUX=disabled hoặc SELINUX=permissionive
  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 tiện ích apigee-setup ở 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 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 Apigee ftp, bạn có thể sử dụng các thông tin đăng nhập đó.
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 Edge
   Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập thư mục gốc, nhưng bạn có thể thực hiện cấu hình Edge mà không cần quyền truy cập thư mục gốc.
3. Tắt SELinux như mô tả ở trên.
4. Tải tệp bootstrap_4.16.09.sh của Edge xuống tại /tmp/bootstrap_4.16.09.sh:
   > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
5. Cài đặt tiện ích và phần phụ thuộc dịch vụ Edge apigee:
   > sudo bash /tmp/bootstrap_4.16.09.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 từ đó.
   
   Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo rằng bạn đã cài đặt Java 1.8. Nếu bạn không có, thì Google Play sẽ cài đặt ứng dụng đó cho bạn. Hãy sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc 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
   Q = Thoát. Đối với cách 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:
   > mèo /etc/yum.repos.d/apigee.repo
   
   Để xem nội dung kho lưu trữ, hãy dùng lệnh:
   > sudo yum -v repolist 'apigee*'
6. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
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 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 bị tường lửa chặn hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet, thì bạn phải tạo một kho lưu trữ cục bộ hoặc bản sao 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 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ả các phần phụ thuộc của bên thứ ba trong kho lưu trữ công khai của chúng tôi. Bạn phải tải xuống và cài đặt các phần phụ thuộc này từ các kho lưu trữ có thể truy cập công khai.

Sau khi tạo một kho lưu trữ Edge cục bộ, có thể 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ữ cục bộ và cách cập nhật kho lưu trữ đó.

Tạo một 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 Apigee ftp, bạn có thể sử dụng các thông tin đăng nhập đó.
2. Đăng nhập vào nút RedHat hoặc CentOS của bạn với tư cách gốc để cài đặt RPM Edge.
   Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập thư mục gốc, nhưng bạn có thể thực hiện cấu hình Edge mà không cần quyền truy cập thư mục gốc.
3. Đảm bảo bạn đang dùng phiên bản mới nhất của yum-utils:
   > sudo yum update yum-utils
4. Tắt SELinux như mô tả ở trên.
5. Tải tệp bootstrap_4.16.09.sh của Edge xuống tại /tmp/bootstrap_4.16.09.sh:
   > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
6. Cài đặt tiện ích và phần phụ thuộc apigee-service của Edge:
   > sudo bash /tmp/bootstrap_4.16.09.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 từ đó.
7. Cài đặt tiện ích apigee-mirror trên nút:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror cài đặt
   
   Lưu ý: Nếu đang cập nhật repo hiện có lên 4.16.09, bạn chỉ phải cập nhật apigee-mirrage/apirgebingebingeebinge_apir-apir>
   
8. Sử dụng tiện ích apigee-mirror để đồng bộ hoá repo 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 thuộc tính --only-new-rpms để chỉ tải RPM mới nhất xuống. 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ơn, 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ạn hiện đã có 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ủa Edge từ kho lưu trữ cục bộ.
9. (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.16.09.sh qua repo cục bộ để cài đặt tiện ích apigee-service:
      > sudo bash
   2. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
   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ó 2 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 nút đó. Apigee cung cấp máy chủ web Nginx cho 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:

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 /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
   
   > /opt/apigee/apigee-service/bin/apigee-service apigee-service apigee
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, tắt SELinux như mô tả ở trên.
4. Trên nút mới, hãy giải nén tệp vào thư mục /tmp:
   > tar -xzf apigee-4.16.09.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 apigee-service và phần phụ thuộc của Edge từ /tmp/repos:
   > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   Lưu ý rằng bạn cần đưa đường dẫn đến thư mục repos vào lệnh này.
6. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
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:

1. Cài đặt máy chủ web Nginx trên nút repo:
   > 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 của admin:admin. Để thay đổi các 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_passwords=pWord
4. Trên nút mới, tắt SELinux như mô tả ở trên.
5. Trên nút điều khiển từ xa, tải tệp Edge bootstrap_4.16.09.sh vào /tmp/bootstrap_4.16.09.sh và đặt tên người dùng ở trên là /usr/bin/curl hoặc http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09 Repstrap trong đó tên người dùng của Word /bootstrap_4.16.09.t
   
   
   
6. Trên nút từ xa, hãy cài đặt phần phụ thuộc và tiện ích apigee-service và phần phụ thuộc của Edge:
   > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeProtocol=
   
   
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 cài đặt
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.

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

1. Đảm bảo rằng bạn đã cài đặt phiên bản 4.16.09 của tiện ích apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   Bạn sẽ thấy kết quả ở biểu mẫu bên dưới, trong đó xyz là số bản dựng:
   miror.xyz.0
2. Sử dụng tiện ích apigee-mirror để tải Edge 4.16.01 hoặc 4.16.05 xuống kho lưu trữ của bạn. Lưu ý cách bạn đặt tiền tố cho lệnh bằng apigeereleasever=4.16.01 hoặc apigeereleasever=4.16.05:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror6ror update.04.0.0.05.0.05.0.05.0.05.05.05.05.05.05.05.05.05.05.05.05.05.05.05.16.05:
   >
   
3. Kiểm tra thư mục /opt/apigee/data/apigee-mirror/repos để xem cấu trúc tệp:
   > 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.06_4.strap6.r lựa chọn .
   
   Thư mục apigee cũng chứa các thư mục riêng cho từng phiên bản của 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 đóng gói cả tệp 4.16.09 và 4.16.01 vào cùng tệp repos .01. Bạn không thể chỉ đóng gói một phần của kho lưu trữ.