Edge cho đám mây riêng tư phiên bản 4.18.05
Để 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.
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 bài viết 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 ở 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:
- 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
- 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
- Trên hệ điều hành Linux 6.x:
- Cách tắt vĩnh viễn SELinux hoặc đặt ở chế độ cho phép:
- Mở
/etc/sysconfig/selinux
trong trình chỉnh sửa. - Đặt
SELINUX=disabled
hoặcSELINUX=permissive
- Lưu nội dung bạn chỉnh sửa.
- Khởi động lại nút.
- 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
.
- Mở
Đ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ộ. 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 phiên bản thư viện libdb4 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 RPM libdb4
trước khi cài đặt. Edge 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 đi kèm với 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ẽ cài đặt phiên bản 4.8.
Bạn có thể sử 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 RPM libdb4
mới hơn phiên bản 4.8, hãy gỡ cài đặt.
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:
- 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 đó.
- Đă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
- Cài đặt
yum-utils
vàyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Tắt SELinux như mô tả ở trên.
- Bật kho lưu trữ EPEL như mô tả ở trên.
- Kiểm tra phiên bản
libdb4
của bạn như mô tả ở trên. - 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
- Nếu bạn đang cài đặt trên AWS, hãy chạy các lệnh
yum-configure-manager
sau:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Tải tệp Edge
bootstrap_4.18.05.sh
xuống/tmp/bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Cài đặt tiện ích dịch vụ apigee và các phần phụ thuộc của Edge:
sudo bash /tmp/bootstrap_4.18.05.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ã 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 bạn không có, thì Google Play sẽ cài đặt ứng dụng đó 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
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 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:
cat /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*'
- Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
Để 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 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 có thể truy cập vào nút đó để cài đặt.
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ộ:
- 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 đó.
- Đă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.
- Tắt SELinux như mô tả ở trên.
- Tải tệp Edge
bootstrap_4.18.05.sh
xuống/tmp/bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Cài đặt tiện ích dịch vụ apigee và các phần phụ thuộc của Edge:
sudo bash /tmp/bootstrap_4.18.05.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ã này.
- Cài đặt tiện ích
apigee-mirror
trên nút:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 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 đưa
--only-new-rpms
vào để chỉ tải các 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ã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
Giờ đây, bạ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 Edge
apigee-setup
từ kho lưu trữ cục bộ. -
(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:
- Chạy
bootstrap_4.18.05.sh
từ kho lưu trữ cục bộ để cài đặt tiện íchapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Dùng
apigee-service
để cài đặt tiện íchapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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 bài viết Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.
- Chạy
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:
- 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.18.05.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 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. - Trên nút mới, tắt SELinux như mô tả ở trên.
- Trên nút mới, bật kho lưu trữ EPEL như mô tả ở trên.
- Trên nút mới, đảm bảo rằng bạn đã tắt mọi repos trên Internet bên ngoài. Khi bạn chạy lệnh sau, tất cả các kho lưu trữ bên ngoài sẽ hiển thị là đã tắt. Tuy nhiên, bạn nên bật kho lưu trữ Apigee cục bộ và mọi kho lưu trữ nội bộ:
sudo yum repolist
- Trên nút mới, hãy cài đặt
yum-utils
vàyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Trên nút mới, kiểm tra phiên bản
libdb4
của bạn như mô tả ở trên. - 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
- Nếu bạn đang cài đặt trên AWS, hãy chạy lệnh
yum-configure-manager
sau:sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Trên nút mới, hãy huỷ lưu trữ tệp vào thư mục /tmp:
tar -xzf apigee-4.18.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.
- Cài đặt tiện ích dịch vụ apigee và các phần phụ thuộc của Edge từ
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.18.05.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.
- Dùng
apigee-service
để cài đặt tiện íchapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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 bài viết 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à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
- 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:
- Mở
/opt/apigee/customer/application/mirror.properties
trong trình chỉnh sửa. Tạo tệp nếu chưa có. - Hãy đặt các giá trị sau nếu cần:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Khởi động lại Nginx:
/opt/nginx/scripts/apigee-nginx restart
- Mở
- Theo mặc định, kho lưu trữ này yêu cầu tên người dùng:mật khẩu là
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_PASSWORD=pWord
- Trên nút mới, hãy cài đặt
yum-utils
vàyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Trên nút mới, tắt SELinux như mô tả ở trên.
- Trên nút mới, bật kho lưu trữ EPEL như mô tả ở trên.
- Trên nút mới, kiểm tra phiên bản
libdb4
của bạn như mô tả ở trên. - Trên nút từ xa, hãy tải tệp Edge bootstrap_4.18.05.sh xuống
/tmp/bootstrap_4.18.05.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
Trong đó uName:pWord là tên người dùng và mật khẩu 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ữ.
- Trên nút từ xa, hãy cài đặt phần phụ thuộc và phần phụ thuộc dịch vụ Edge:
sudo bash /tmp/bootstrap_4.18.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 của kho lưu trữ.
- Trên nút từ xa, sử dụng
apigee-service
để cài đặt tiện íchapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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 một kho lưu trữ Apigee cục bộ
Để cập nhật repo, bạn phải tải tệp bootstrap_4.18.05.sh mới nhất xuống, sau đó thực hiện một sysnc mới:
- Tải tệp Edge bootstrap_4.18.05.sh xuống
/tmp/bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Chạy tệp Edge
bootstrap_4.18.05.sh
:sudo bash/tmp/bootstrap_4.18.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 từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã này.
- Cập nhật
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Đồng bộ hoá:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- 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 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
Thêm hoặc cập nhật Edge 4.16.0x/4.17.0x trong repo 4.18.05
Nếu phải duy trì các bản cài đặt cho Edge 4.16.0x hoặc 4.17.0x trong kho lưu trữ 4.18.05, 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 Edge.
Để thêm 4.16.0x/4.17.0x vào repo 4.18.05:
- Hãy đảm bảo rằng bạn đã cài đặt phiên bản 4.18.05 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ả trong biểu mẫu bên dưới, trong đó xyz là số bản dựng:
apigee-mirror-4.18.05-0.0.xyz
- Sử dụng tiện ích
apigee-mirror
để tải Edge 4.16.0x/4.17.0x xuống kho lưu trữ của bạn. Hãy lưu ý cách bạn đặt tiền tố cho 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
Dùng chính lệnh này để cập nhật repos 4.16.0x/4.17.0x sau bằng cách chỉ định số phiên bản bắt buộc.
- 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.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.05.sh thirdparty
Hãy lưu ý cách bạn có tệp tự khởi động cho mọi phiên bản Edge. Thư mục
apigee
cũng chứa các thư mục riêng cho từng phiên bản Edge. - Để đó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 đóng 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ỉ đóng gói một phần của kho lưu trữ.
Để cài đặt Edge qua tệp repo hoặc .tar cục bộ, bạn chỉ cần nhớ chạy đúng tệp khởi động bằng cách sử dụng một trong các lệnh sau. Ví dụ sau cài đặt Edge 4.17.01:
- Nếu cài đặt qua tệp .tar, hãy chạy đúng tệp khởi động quá trình trong kho lưu trữ:
sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Để hoàn tất việc 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 bạn 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 chính xác trong 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 việc cài đặt, hãy làm theo các bước còn lại trong phần "Cài đặt từ kho lưu trữ bằng cách sử dụng máy chủ web Nginx" ở trên.