私有雲版本 4.17.01 版本
如要在節點中安裝 Edge,請先安裝 Edge apigee-setup 公用程式。如果環境中的節點沒有外部網路連線,您也必須安裝 Apigee 存放區的本機副本。
預設安裝目錄:/opt/apigee
Edge 會安裝 /opt/apigee 目錄中的所有檔案。您無法變更這個目錄。不過,如有需要,您可以建立符號連結,將 /opt/apigee 對應至其他位置。詳情請參閱「安裝規定」。
必備條件:停用 SELinux
您必須先停用 SELinux 或將其設為寬鬆模式,才能安裝 Edge apigee-setup 公用程式或任何 Edge 元件。如有需要,您可以在安裝 Edge 後重新啟用 SELinux。
- 如要暫時將 SELinux 設為寬鬆模式,請執行下列指令:
- 在 Linux 6.x 作業系統中:
echo 0 > /selinux/enforce
如要在安裝 Edge 後重新啟用 SELinux:
echo 1 > /selinux/enforce - 在 Linux 7.x 作業系統中:
setenforce 0
如要在安裝 Edge 後重新啟用 SELinux:
setenforce 1
- 在 Linux 6.x 作業系統中:
- 如要永久停用 SELinux,或將其設為寬鬆模式:
- 在編輯器中開啟 /etc/sysconfig/selinux。
- 將 SELINUX=disabled 或 SELINUX=permissive
- 儲存編輯內容。
- 重新啟動節點。
- 如有需要,請在完成 Edge 安裝後重新啟用 SELinux,藉此重複設定 SELINUX=enabled。
必備條件:啟用 EPEL 存放區
您必須啟用「Enterprise Linux (或 EPEL)」的額外套件,才能安裝或更新 Edge。您使用的指令取決於 RedHat/CentOS 版本:
- 如果是 RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-e--觸發-latest-7.nopm.rpm; sudo rpm -ivh epel-release-latest-7.nopm.rpm - 如果是 RedHat/CentOS 6.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.nopm.rpm
在具有外部網際網路連線的節點上安裝 Edge Apigee - 設定公用程式
如要在具有外部網際網路連線的節點上安裝 Edge:
- 取得 Apigee 用來存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee ftp 網站的現有使用者名稱:密碼,您可以使用這些憑證。
- 以根層級登入節點,即可安裝 Edge RPM
注意:RPM 安裝作業需要根層級存取權,因此你可以在不使用 Root 權限的情況下執行 Edge 設定。 - 按照上述步驟停用 SELinux。
- 啟用上述的 EPEL 存放區。
- 下載 Edge bootstrap_4.17.01.sh 檔案到 /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您從 Apigee 取得的使用者名稱和密碼。如果省略 pWord,系統會提示你輸入。
根據預設,安裝程式會檢查您是否已安裝 Java 1.8。如果尚未安裝,系統會代為安裝。使用 JAVA_FIX 選項指定如何處理 Java 安裝。JAVA_FIX 採用下列值:
I = 安裝 OpenJDK 1.8 (預設)
C = 繼續,不安裝 Java
Q = 退出。如要使用這個選項,您必須自行安裝 Java。
安裝 Apigee 服務公用程式後,就會建立定義 Apigee 存放區的 /etc/yum.repos.d/apigee.repo 檔案。如要查看定義檔案,請使用下列指令:
> cat /etc/yum.repos.d/apigee.repo
如要查看存放區內容,請使用下列指令:
> sudo yum -v repolist 'apigee*' - (CentOS-6.x 和 RedHat-6.x) 在所有 Qpid 節點上,執行下列指令來下載正確的 Qpid 版本:
> yum install apigee-qpidd --disablerepo=epel - 使用 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安裝 - 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
在沒有外部網際網路連線的節點上安裝 Edge Apigee -setup 公用程式
如果 Edge 節點受防火牆保護,或是以其他方式禁止透過網際網路存取 Apigee 存放區,則必須建立 Apigee 存放區的本機存放區或鏡像。然後,所有節點皆可存取該鏡像。建立完成後,節點就可以存取本機鏡像來安裝 Edge。
如要建立內部 Apigee 存放區,您必須具備具備外部網際網路存取權的節點,才能下載邊緣千次曝光收益和依附元件。建立內部存放區後,即可將其移至其他節點,或讓該節點存取 Edge 節點進行安裝。
注意:Apigee 不會在我們的公開存放區中託管所有第三方依附元件。您必須從公開的存放區下載及安裝這些依附元件。
建立本機 Edge 存放區後,您之後可能需要使用最新的 Edge 發布檔案來更新存放區。下列各節說明如何建立本機存放區,以及如何更新存放區。
建立本機 Apigee 存放區
如要建立本機 Apigee 存放區,請按照下列指示操作:
- 取得 Apigee 用來存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee ftp 網站的現有使用者名稱:密碼,您可以使用這些憑證。
- 以根層級登入 RedHat 或 CentOS 節點,以安裝 Edge RPM。
注意:雖然 RPM 安裝作業需要 Root 存取權,但您可以在沒有 Root 權限的情況下執行 Edge 設定。 - 請確認您使用的是最新版的 yum-utils:
> sudo yum update yum-utils - 按照上述步驟停用 SELinux。
- 啟用上述的 EPEL 存放區。
- 下載 Edge bootstrap_4.17.01.sh 檔案到 /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - (CentOS-6.x 和 RedHat-6.x) 請執行下列指令,以確保您下載正確的 Qpid 版本:
> yum install apigee-qpidd --disablerepo=epel - 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您從 Apigee 取得的使用者名稱和密碼。如果省略 pWord,系統會提示你輸入。 - 在節點上安裝 apigee-調整 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 安裝
注意:如果您將現有存放區更新為 4.17.01,只需要更新 apigee-鏡像:
> /opt/apigee/apigee-service/service-service - 使用 apigee-調整 公用程式,將 Apigee 存放區同步至 /opt/apigee/data/apigee-Mirror/repos/ 目錄。
如要盡量縮減存放區的大小,請納入 --only-new-rpms,只下載最新的 RPM。下載檔案約需要 1.6 GB 的磁碟空間:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 同步處理 --only-new-rpms
如要下載整個存放區 (包括較舊的 RPM),請省略 --only-new-rpms。你需要大約 6 GB 的磁碟空間,才能下載完整:
> /opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 同步處理
現在您已取得 Apigee 存放區的本機副本。下一節將說明如何從本機存放區安裝 Edge apigee-setup 公用程式。 -
(選用) 如要從本機存放區安裝 Edge 至代管本機存放區的節點,您必須先執行下列指令:
- 從本機存放區執行 bootstrap_4.17.01.sh,以便安裝 apigee-service 公用程式:
> sudo bash /opt/apigee/data/apigee-Mirror/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-replica/repos - 透過 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安裝 - 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
- 從本機存放區執行 bootstrap_4.17.01.sh,以便安裝 apigee-service 公用程式:
從本機存放區的遠端節點安裝 apigee-setup
從本機存放區安裝 Edge 的方法有兩種。你可以採取下列其中一種做法:
- 建立存放區的 .tar 檔案,將 .tar 檔案複製到節點,然後從 .tar 檔案安裝 Edge。
- 在具有本機存放區的節點中安裝網路伺服器,以便其他節點存取。Apigee 提供 Nginx 網路伺服器,您可以自由使用,也可以使用自己的網路伺服器。
從 .tar 檔案安裝:
- 在具有本機存放區的節點中,使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-Mirror/apigee-4 .17.01.tar.gz 的單一.tar 檔案:
- 將 .tar 檔案複製到要安裝 Edge 的節點。例如,請複製至新節點上的 /tmp 目錄。
- 在新節點上,按照上述方式停用 SELinux。
- 在新節點上,將檔案解壓縮至 /tmp 目錄:
> tar -xzf apigee-4.17.01.tar.gz
這個指令會在含有 .tar 檔案的目錄中建立新的目錄 (名稱為存放區)。例如 /tmp/repos。 - 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
請注意,您在這個指令中納入存放區的路徑。 - 透過 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安裝 - 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
使用 Nginx 網路伺服器從存放區安裝:
- 在存放區節點上安裝 Nginx 網路伺服器:
> opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 nginxconfig - 根據預設,Nginx 已設為使用 localhost 做為伺服器名稱和通訊埠 3939。如何變更這些值
- 在編輯器中開啟 /opt/apigee/customer/application/Mirror.properties。如果檔案不存在,請建立檔案。
- 視需要設定下列值:
conf_apigee_Mirror_listen_port=3939
conf_apigee_Mirror_server_name=localhost - 重新啟動 Nginx:
> /opt/nginx/scripts/apigee-nginx restart
- 根據預設,存放區必須具備 admin:admin 的使用者名稱:密碼。如要變更這些憑證,請設定下列環境變數:
MIRROR_Username=uName
MIRROR_PASSWORD=pWord - 在新節點上,按照上述方式停用 SELinux。
- 在遠端節點上,將 Edge bootstrap_4.17.01.sh 檔案下載至 /tmp/bootstrap_4.17.01.sh:
> /usr/bin/curl http://uName:pWord/@<密碼>.1.<檔案>.1/.recat.17.com - 在遠端節點上,安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord username <密碼> - 在遠端節點上使用 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安裝 - 使用 apigee-setup 在遠端節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
更新本機 Apigee 存放區
如要更新存放區,您必須下載最新的 bootstrap_4.17.01.sh 檔案,然後執行新的同步作業:
- 將 Edge bootstrap_4.17.01.sh 檔案下載至 /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - 執行 Edge bootstrap_4.17.01.sh 檔案:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您在 Apigee 中設定的使用者名稱和密碼。如果您略過 pWord,系統會提示您輸入。 - 更新 apigee-調整:
> /opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 更新 - 執行同步處理:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 同步處理 --only-new-rpms - 如要下載整個存放區:
> /opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 同步處理
清理本機 Apigee 存放區
清理本機存放區會刪除 /opt/apigee/data/apigee-鏡像 和 /var/tmp/yum-apigee-*。
如要清理本機存放區,請使用:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean
在 4.17.01 存放區中新增或更新 Edge 4.16.01/4.16.05/4.16.09
如要在 4.17.01 存放區中保留 Edge 4.16.0x 的安裝項目,您可以維護包含所有版本的存放區。然後,在這個存放區中即可安裝任何版本的 Edge。
如要將 4.16.0x 新增至 4.17.01 存放區:
- 確認您已安裝 4.17.01 的 apigee-Mirror 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-鏡像 版本
您應該會看到下方顯示的結果,其中 xyz 是版本號碼:
apigee-Mirror-4.17.01-0.0。 - 使用 apigee-調整 公用程式,將 Edge 4.16.01/4.16.05/4.16.09 下載到存放區。請注意,在指令中加上 apigeereleasever=4.16.01 或 apigeereleasever=4.16.05 的前置字串:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync --only-new-rpms
使用相同指令:4. 0/1.com 的 4.1. - 檢查 /opt/apigee/data/apigee-Mirror/repos 目錄,瞭解檔案結構:
> ls /opt/apigee/data/apigee-Mirror/repos
您應該會看到下列檔案和目錄:
apigee apigee-repo-1.0.1..檔案.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.1.0.16.x.6.16.x.6.16.x.6.16.x.1.
Apigee 目錄也包含每個 Edge 版本的目錄。 - 如要將存放區封裝至 .tar 檔案,請使用下列指令:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-replica 套件,並將 4.17.01 和 4.16.0x 存放區封裝至同一個 .tar 檔案。
您無法只封裝存放區的一部分。
如要從本機存放區或 .tar 檔案安裝 Edge,請記得透過下列指令來執行正確的 Bootstrap 檔案:
- 如果是從 .tar 檔案安裝,請從存放區執行正確的 Bootstrap 檔案:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
如要完成安裝程序,請按照「 - 如果使用 Nginx 網路伺服器安裝,然後從存放區下載正確的 Bootstrap 檔案:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0 api.sh api.sh.api.sh.api.sh.api.sh.api.sh"</a>.google.c.g.g.g.