私有雲的邊緣 4.17.09 版
如要在節點上安裝 Edge,您必須先安裝 Edge apigee-setup 公用程式。如果您的節點沒有外部網際網路連線,您也必須安裝 Apigee 存放區的本機副本。
預設安裝目錄:/opt/apigee
Edge 會安裝 /opt/apigee
目錄中的所有檔案。您無法變更這個目錄。不過,您也可以視需要建立符號連結,將 /opt/apigee
對應至其他位置。詳情請參閱「安裝規定」。
必備條件:停用 SELinux
您必須先停用 SELinux 或將其設為寬鬆模式,才能安裝 Edge apigee-setup
公用程式或任何 Edge 元件。如有需要,您可以在安裝 Edge 後重新啟用 SELinux。
- 如要「暫時」將 SELinux 設為寬鬆模式,請執行下列指令:
- 在 Linux 6.x 作業系統上:
> sudo echo 0 > /selinux/enforce
如何在安裝 Edge 後重新啟用 SELinux:
> sudo echo 1 > /selinux/enforce
- 在 Linux 7.x 作業系統上:
> sudo setenforce 0
如何在安裝 Edge 後重新啟用 SELinux:
> sudo setenforce 1
- 在 Linux 6.x 作業系統上:
- 如要「永久」停用 SELinux 或將其設為寬鬆模式:
- 在編輯器中開啟「
/etc/sysconfig/selinux
」。 - 設定
SELINUX=disabled
或SELINUX=permissive
- 儲存修改過的內容。
- 重新啟動節點。
- 如有需要,請在 Edge 安裝完成後重複這個程序來設定
SELINUX=enabled
,藉此重新啟用 SELinux。
- 在編輯器中開啟「
必備條件:啟用 EPEL 存放區
您必須啟用 Enterprise Linux (或 EPEL) 額外套件才能安裝或更新 Edge,或是建立本機存放區。您使用的指令取決於您的 RedHat/CentOS 版本:
- 如為 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
- 如為 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
必要條件:檢查 RedHat 7.4 和 CentOS 7.4 的 libdb4 程式庫版本
在 RedHat 7.4 和 CentOS 7.4 上,請先查看 libdb4
RPM 的版本,再執行安裝作業。Edge 需要 4.8 版,部分版本的 RedHat 7.4 和 CentOS 7.4 也隨附較新版本。
您可以使用下列指令查看版本:
> rpm -qa | grep libdb
如果您發現 libdb4
RPM 版本高於 4.8,請使用下列指令取代 RPM:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
如果你需要下載這些 RPM 檔案,可以透過以下來源下載:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
在具備外部網際網路連線的節點中安裝 Edge apigee-setup 公用程式
如何在有外部網際網路連線的節點上安裝 Edge:
- 從 Apigee 取得用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee ftp 網站現有的使用者名稱:password,就可以使用這些憑證。
- 以根層級登入節點來安裝 Edge RPM
- 安裝
yum-utils
和yum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 按照上述說明停用 SELinux。
- 按照上述方式啟用 EPEL 存放區。
- 如果您是在 AWS 上安裝,請執行以下
yum-configure-manager
指令:> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- 將邊緣
bootstrap_4.17.09.sh
檔案下載至/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。
根據預設,安裝程式會檢查您是否已安裝 Java 1.8。如果沒有,系統會為您安裝。使用
JAVA_FIX
選項即可指定處理 Java 安裝的方式。JAVA_FIX
採用下列值:- I = 安裝 OpenJDK 1.8 (預設)
- C = 在不安裝 Java 的情況下繼續
- 問 = 退出。如要使用這個選項,您必須自行安裝 Java。
安裝 apigee-service 公用程式,並建立定義 Apigee 存放區的 /etc/yum.repos.d/apigee.repo 檔案。如要查看定義檔,請使用下列指令:
> cat /etc/yum.repos.d/apigee.repo
如要查看存放區內容,請使用下列指令:
> sudo yum -v repolist 'apigee*'
- 使用
apigee-service
安裝apigee-setup
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup
在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
在沒有外部網際網路連線的節點中安裝 Edge apigee-setup 公用程式
如果您的 Edge 節點設有防火牆,或以其他方式禁止透過網際網路存取 Apigee 存放區,您就必須建立 Apigee 存放區的本機存放區或鏡像。接著,所有節點都必須存取該鏡像。建立完成後,節點就能存取本機鏡像來安裝 Edge。
如要建立內部 Apigee 存放區,您必須要求具備外部網際網路存取權的節點,才能下載邊緣 RPM 和依附元件。建立內部存放區後,您可以將其移至其他節點,或是開放邊緣節點存取該節點以進行安裝。
建立本機 Edge 存放區後,您之後可能需要將其更新為最新的 Edge 版本檔案。以下各節說明如何建立本機存放區及更新存放區的方式。
建立本機 Apigee 存放區
如何建立本機 Apigee 存放區:
- 從 Apigee 取得用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee ftp 網站現有的使用者名稱:password,就可以使用這些憑證。
- 以根層級登入節點即可安裝 Edge RPM。
- 安裝
yum-utils
和yum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 按照上述說明停用 SELinux。
- 按照上述方式啟用 EPEL 存放區。
- 如果您是在 AWS 上安裝,請執行以下
yum-configure-manager
指令:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- 將邊緣
bootstrap_4.17.09.sh
檔案下載至/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- 安裝 Edge
apigee-service
公用程式和依附元件:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。
- 在節點上安裝
apigee-mirror
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 使用
apigee-mirror
公用程式將 Apigee 存放區同步到/opt/apigee/data/apigee-mirror/repos/
目錄。為了盡可能減少存放區的大小,請加入
--only-new-rpms
,只下載最新的 RPM。您需要約 1.6 GB 的磁碟空間才能下載:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
如要下載整個存放區 (包含較舊的 RPM),請省略
--only-new-rpms
。 您需要約 6 GB 的磁碟空間才能完整下載:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
現在您已擁有 Apigee 存放區的本機副本。下一節將說明如何從本機存放區安裝 Edge
apigee-setup
公用程式。 -
(選用) 如要將本機存放區中的 Edge 安裝到託管本機存放區的同一節點中,請先執行下列指令:
- 從本機存放區執行
bootstrap_4.17.09.sh
,安裝apigee-service
公用程式:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- 使用
apigee-service
安裝apigee-setup
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup
在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
- 從本機存放區執行
在本機存放區的遠端節點中安裝 apigee-setup
您可以透過兩種方式從本機存放區安裝 Edge。你可以採取下列其中一種做法:
- 建立存放區的 .tar 檔案,將 .tar 檔案複製到節點,然後從 .tar 檔案安裝 Edge。
- 在含有本機存放區的節點中安裝網路伺服器,方便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用,或者您也可以使用自己的網路伺服器。
從 .tar 檔案安裝:
- 在具有本機存放區的節點上,使用下列指令將本機存放區封裝至名為
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
的單一 .tar 檔案:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 將 .tar 檔案複製到您要安裝 Edge 的節點。例如,請將其複製到新節點的
/tmp
目錄。 - 安裝
yum-utils
和yum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 按照上述說明,在新節點上停用 SELinux。
- 按照上述方式啟用 EPEL 存放區。
- 在新節點上,將檔案解壓縮至 /tmp 目錄:
> tar -xzf apigee-4.17.09.tar.gz
這個指令會在包含 .tar 檔案的目錄中建立名為「存放區」的新目錄。例如
/tmp/repos.
- 從「
/tmp/repos
」安裝 Edge apigee-service 公用程式和依附元件:> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
請注意,您會在這個指令中加入存放區目錄的路徑。
- 使用
apigee-service
安裝apigee-setup
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup
在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
使用 Nginx 網路伺服器從存放區安裝:
- 在存放區節點上安裝 Nginx 網路伺服器:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror 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
的使用者名稱:password 。如要變更這些憑證,請設定下列環境變數:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- 安裝
yum-utils
和yum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 按照上述說明,在新節點上停用 SELinux。
- 按照上述方式啟用 EPEL 存放區。
- 在遠端節點上,將 Edge bootstrap_4.17.09.sh 檔案下載至
/tmp/bootstrap_4.17.09.sh
:> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
其中 uName:pWord 是您在上方為存放區設定的使用者名稱和密碼,而 remoteRepo 是存放區節點的 IP 位址或 DNS 名稱。
- 在遠端節點上,安裝 Edge
apigee-service
公用程式和依附元件:> sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是存放區使用者名稱和密碼。
- 在遠端節點上,使用
apigee-service
安裝apigee-setup
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup
在遠端節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
更新本機 Apigee 存放區
如要更新存放區,您必須下載最新的 bootstrap_4.17.09.sh 檔案,然後執行新的同步處理:
- 將 Edge bootstrap_4.17.09.sh 檔案下載至
/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- 執行邊緣
bootstrap_4.17.09.sh
檔案:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。
- 更新
apigee-mirror
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- 執行同步處理作業:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- 如要下載整個存放區:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
清除本機 Apigee 存放區
清理本機存放區會刪除 /opt/apigee/data/apigee-mirror
和 /var/tmp/yum-apigee-*
。
如要清除本機存放區,請使用:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean
在 4.17.09 存放區中新增或更新 Edge 4.16.0x/4.17.0x
如果必須維護 4.17.09 存放區中 Edge 4.16.0x 或 4.17.01/4.17.05 的安裝作業,您可以維護包含所有版本的存放區。接著,您就可以從該存放區安裝任何版本的 Edge。
如要新增 4.16.0x/4.17.0x 至 4.17.09 存放區,請按照下列指示操作:
- 確認您已安裝 4.17.09 版的
apigee-mirror
公用程式:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
您應該會看到以下表單中的結果,其中 xyz 是版本號碼:
apigee-mirror-4.17.09-0.0.xyz
- 使用
apigee-mirror
公用程式,將 Edge 4.16.0x/4.17.01/4.17/05 下載到您的存放區。請留意指令在指令中的前置字串為何:> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
請使用相同的指令,指定所需的版本號碼,以便在稍後更新 4.16.0x/4.17.05 存放區。
- 檢查
/opt/apigee/data/apigee-mirror/repos
目錄,確認檔案結構:> ls /opt/apigee/data/apigee-mirror/repos
畫面上應該會顯示下列檔案和目錄:
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 thirdparty
請留意所有 Edge 版本都有的啟動檔案。
apigee
目錄也包含每個 Edge 版本的個別目錄。 - 如要將存放區封裝到 .tar 檔案,請使用下列指令:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
這個指令會將所有 4.17.0x 和 4.16.0x 存放區封裝到同一個 .tar 檔案中。您無法只封裝存放區的一部分。
如要從本機存放區或 .tar 檔案安裝 Edge,請務必透過下列任一指令執行正確的 Bootstrap 檔案。本範例會安裝 Edge 4.17.01:
- 如果是從 .tar 檔案安裝,請從存放區執行正確的 Bootstrap 檔案:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
如要完成安裝,請按照上方「從 .tar 檔案安裝」一節中的步驟操作。
- 如果是透過 Nginx 網路伺服器進行安裝,請從存放區下載並執行正確的 Bootstrap 檔案:
> /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://
如要完成安裝,請按照上方「使用 Nginx 網路伺服器從存放區安裝」一節中的步驟操作。