Trang này được dịch bởi Cloud Translation API.

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.

Để tạm thời đặt SELinux thành 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
```
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 Enterprise Linux (RHEL) 8.0, hãy xem Điều kiện tiên quyết cho RHEL 8.

Đối với Red Hat/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 Red Hat/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 với AWS-2:

sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

Đ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 các 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ể dùng lệnh sau để kiểm tra phiên bản:

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 phiên bản đó.

Điều kiện tiên quyết đối với RHEL 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:

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
```

Tắt Postgres và Nginx:

sudo dnf module disable postgresql
sudo dnf module disable nginx

Cài đặt Python 2:
```
sudo dnf install -y python2
```

Điều kiện tiên quyết cho Amazon-Linux-2023(AL2023)

Nếu bạn đang cài đặt Edge trên một máy chủ chạy Amazon-Linux-2023(AL2023), hãy thực hiện các bước sau trước khi tiến hành cài đặt:

USE_CQLUTIL=y

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:

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 đó.
Đă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

LƯU Ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập 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 gốc.
Cài đặt yum-utils và yum-plugin-priorities.
Lưu ý: Bạn không cần cài đặt yum-plugin-priorities cho RHEL-8.X hoặc Oracle-8.X.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Tắt SELinux.
Bật kho lưu trữ EPEL.
Kiểm tra phiên bản libdb4 bạn đang dùng.
Nếu bạn đang cài đặt trên RHEL 8, hãy làm theo các bước trong phần Điều kiện tiên quyết cho RHEL 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
```

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 bootstrap_4.52.02.sh Edge xuống /tmp/bootstrap_4.52.02.sh:

curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge:
```
sudo bash /tmp/bootstrap_4.52.02.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*'
```
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.

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:// : @ software.apigee.com//apigee-repo-version.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:

Kho lưu trữ Apigee Edge: Như mô tả trong phần Tạo kho lưu trữ Apigee cục bộ.
Kho lưu trữ Yum (đối với các tiện ích như yum-utils và yum-plugin-priorities): Nhóm vận hành của bạn có thể thiết lập kho lưu trữ này cho bạn.
Extra Packages for Enterprise Linux (hoặc EPEL): Nhóm vận hành của bạn có thể thiết lập gói này cho bạn.

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ộ:

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 đó.
Đă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.

LƯU Ý: Mặc dù việc 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.
Tắt SELinux như mô tả ở trên.

Tải tệp bootstrap_4.52.02.sh Edge xuống /tmp/bootstrap_4.52.02.sh:

curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge:
```
sudo bash /tmp/bootstrap_4.52.02.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ài đặt tiện ích apigee-mirror trên nút:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
```
LƯU Ý: Nếu đang cập nhật một kho lưu trữ hiện có lên 4.52.02, bạn chỉ cần cập nhật apigee-mirror:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
```
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.

--only-new-rpms không hoạt động trên Oracle-8.X.
Lưu ý: 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 toàn bộ nội dung xuống:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
```
Giờ đây, 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 Edge 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:
1. Chạy bootstrap_4.52.02.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.52.02.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:

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.52.02.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, hãy tắt SELinux như mô tả ở trên.
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.
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ộ.
Trên nút mới, hãy cài đặt yum-utils và yum-plugin-priorities từ kho lưu trữ cục bộ.
Lưu ý: Bạn không cần cài đặt yum-plugin-priorities cho RHEL-8.X hoặc Oracle-8.X.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Nhóm vận 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.
Trên nút mới, hãy kiểm tra phiên bản libdb4 theo cách nêu 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 giải nén tệp vào thư mục /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
Lệnh này sẽ 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.
Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge từ /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
Xin lưu ý rằng bạn phải thêm đường dẫn đến thư mục repos trong lệnh này.

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 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:

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:
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
```
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
```
Trên nút mới, hãy cài đặt yum-utils và yum-plugin-priorities.
Lưu ý: Bạn không cần cài đặt yum-plugin-priorities cho RHEL-8.X hoặc Oracle-8.X.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Trên nút mới, hãy tắt SELinux như mô tả ở trên.
Trên nút mới, hãy đảm bảo rằng kho lưu trữ EPEL cục bộ đã được bật.
Trên nút mới, hãy kiểm tra phiên bản libdb4 theo cách nêu trên.
Trên nút từ xa, hãy tải tệp bootstrap_4.52.02.sh Edge xuống /tmp/bootstrap_4.52.02.sh:
```
curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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ữ, còn 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 tiện ích apigee-service và các phần phụ thuộc của Edge:
```
sudo bash /tmp/bootstrap_4.52.02.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, hãy 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 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.52.02.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ữ:

Tải tệp bootstrap_4.52.02.sh của Edge xuống /tmp/bootstrap_4.52.02.sh:

curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

Chạy tệp bootstrap_4.52.02.sh Edge:
```
sudo bash/tmp/bootstrap_4.52.02.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

Thực hiện quá trình đồng bộ hoá:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
```
Lưu ý: Lệnh apigee-service apigee-mirror sync --only-new-rpms không hoạt động trên Oracle Linux 8.X.

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

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

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.52.02, 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.

Cách thêm 4.16.0x/4.17.0x vào kho lưu trữ 4.52.02:

Đảm bảo bạn đã cài đặt phiên bản 4.52.02 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ả ở dạng bên dưới, trong đó xyz là số bản dựng:
```
apigee-mirror-4.52.02-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. Lưu ý cách bạn thêm tiền tố vào 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 một lệnh này để sau này cập nhật các kho lưu trữ 4.16.0x/4.17.0x 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.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty
```
Lưu ý cách bạn có một tệp khởi động cho tất cả các phiên bản của Edge. Thư mục apigee cũng chứa các thư mục riêng biệt cho từng phiên bản của 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 kho lưu trữ 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 từ kho lưu trữ cục bộ hoặc tệp .tar, hãy nhớ chạy tệp khởi động chính xác bằng cách sử dụ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 tệp khởi động chính xác từ 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 chính xác 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 từ kho lưu trữ bằng máy chủ web Nginx" ở trên.