Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

安裝 Edge apigee-setup 公用程式

Edge for Private Cloud 4.18.01 版

如要在節點上安裝 Edge，請先安裝 Edge apigee-setup 公用程式。如果節點沒有外部網際網路連線，您也必須安裝 Apigee 存放區的本機副本。

預設安裝目錄：/opt/apigee

Edge 會將所有檔案安裝在 /opt/apigee 目錄中。您無法變更這個目錄。不過，如有需要，您可以建立符號連結，將 /opt/apigee 對應至其他位置。詳情請參閱安裝需求。

事前準備：停用 SELinux

您必須停用 SELinux，或將其設為許可模式，才能安裝 Edge apigee-setup 公用程式或任何 Edge 元件。如有需要，您可以在安裝 Edge 後重新啟用 SELinux。

如要「暫時」將 SELinux 設為寬容模式，請執行下列指令：
1. 在 Linux 6.x 作業系統上：
  sudo echo 0 > /selinux/enforce
  
  如要在安裝 Edge 後重新啟用 SELinux，請執行以下指令：
  sudo echo 1 > /selinux/enforce
2. 在 Linux 7.x 作業系統上：
  sudo setenforce 0
  
  如要在安裝 Edge 後重新啟用 SELinux：
  sudo setenforce 1
如要永久停用 SELinux 或設為寬鬆模式，請按照下列步驟操作：
1. 在編輯器中開啟 /etc/sysconfig/selinux。
2. 將 SELINUX 設為 disabled 或 permissive
3. 儲存編輯內容。
4. 重新啟動節點。
5. 如有需要，請在安裝 Edge 後重新啟用 SELinux，方法是重複這項程序，將 SELINUX=enabled。

必要條件：啟用 EPEL 存放區

您必須啟用 Extra Packages for 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 隨附較新版本。如果您有較新的版本，請將其解除安裝，Edge 安裝程式就會安裝 4.8 版。

您可以使用下列指令檢查版本：

> rpm -qa | grep libdb4

如果 libdb4 RPM 版本高於 4.8，請解除安裝。

在具備外部網際網路連線的節點上安裝 Edge apigee-setup 公用程式

如要在具備外部網際網路連線的節點上安裝 Edge，請按照下列步驟操作：

從 Apigee 取得用於存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee FTP 網站的使用者名稱和密碼，可以使用這些憑證。
以 root 身分登入節點，安裝 Edge RPM
注意：雖然 RPM 安裝需要 root 存取權，但您可以在沒有 root 存取權的情況下執行 Edge 設定。
安裝 yum-utils 和 yum-plugin-priorities：
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
按照上述步驟停用 SELinux。
按照上述步驟啟用 EPEL 存放區。
按照上述步驟檢查 libdb4 版本。
如果您是在 Oracle 7.x 上安裝，請執行下列指令：
> sudo yum-config-manager --enable ol7_optional_latest
如果是在 AWS 上安裝，請執行下列 yum-configure-manager 指令：
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
將 Edge bootstrap_4.18.01.sh 檔案下載至 /tmp/bootstrap_4.18.01.sh：
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
安裝 Edge apigee-service 公用程式和依附元件：
> sudo bash /tmp/bootstrap_4.18.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-service 公用程式時，系統會建立 /etc/yum.repos.d/apigee.repo 檔案，用於定義 Apigee 存放區。如要查看定義檔案，請使用下列指令：
> 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 存放區，您必須使用具備外部網際網路存取權的節點，才能下載 Edge RPM 和依附元件。建立內部存放區後，您可以將其移至其他節點，或讓 Edge 節點可以存取該節點以進行安裝。

注意：Apigee 不會在公開存放區中託管所有第三方依附元件。您必須從可公開存取的存放區下載並安裝這些依附元件。

建立本機 Edge 存放區後，您可能需要使用最新的 Edge 版本檔案進行更新。以下各節說明如何建立及更新本機存放區。

建立本機 Apigee 存放區

如要建立本機 Apigee 存放區，請按照下列步驟操作：

從 Apigee 取得用於存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee FTP 網站的使用者名稱和密碼，可以使用這些憑證。
以 root 身分登入節點，安裝 Edge RPM。
注意：雖然 RPM 安裝需要 root 存取權，但您可以在沒有 root 存取權的情況下執行 Edge 設定。
按照上述步驟停用 SELinux。
將 Edge bootstrap_4.18.01.sh 檔案下載至 /tmp/bootstrap_4.18.01.sh：
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
安裝 Edge apigee-service 公用程式和依附元件：
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

其中 uName:pWord 是您從 Apigee 取得的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。
在節點上安裝 apigee-mirror 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

注意：如果您要將現有存放區更新至 4.18.01，只需更新 apigee-mirror：
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
使用 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 安裝到託管本機存放區的同一個節點，請先執行下列指令：
1. 從本機存放區執行 bootstrap_4.18.01.sh，安裝 apigee-service 公用程式：
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. 使用 apigee-service 安裝 apigee-setup 公用程式：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
3. 使用 apigee-setup 在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

從本機存放區在遠端節點上安裝 apigee-setup

您可以透過兩種方式從本機存放區安裝 Edge。你可以採取下列其中一種做法：

建立存放區的 .tar 檔案，將 .tar 檔案複製到節點，然後從 .tar 檔案安裝 Edge。
在本機存放區的節點上安裝網路伺服器，讓其他節點可以存取。 Apigee 提供 Nginx 網路伺服器供您使用，您也可以使用自己的網路伺服器。

從 .tar 檔案安裝：

在本機存放區的節點上，使用下列指令將本機存放區封裝成名為 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的單一.tar 檔案：
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
將 .tar 檔案複製到要安裝 Edge 的節點。例如，將其複製到新節點上的 /tmp 目錄。
按照上述步驟，在新節點上停用 SELinux。
按照上述步驟，在新節點上啟用 EPEL 存放區。
請確認您已停用新節點上的所有外部網際網路存放區。執行下列指令時，所有外部存放區都應顯示為停用，但本機 Apigee 存放區和任何內部存放區都應啟用：
> sudo yum repolist
在新節點上安裝 yum-utils 和 yum-plugin-priorities：
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
在新節點上，按照上述方式檢查 libdb4 的版本。
如果您是在 Oracle 7.x 上安裝，請執行下列指令：
> sudo yum-config-manager --enable ol7_optional_latest
如果您是在 AWS 上安裝，請執行下列 yum-configure-manager 指令：
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
在新節點上，將檔案解壓縮至 /tmp 目錄：
> tar -xzf apigee-4.18.01.tar.gz

這個指令會在包含 .tar 檔案的目錄中，建立名為 repos 的新目錄。例如 /tmp/repos。
從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

請注意，您在這個指令中加入了 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。如要變更這些值
1. 在編輯器中開啟 /opt/apigee/customer/application/mirror.properties。如果檔案不存在，請建立檔案。
2. 視需要設定下列值：
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. 重新啟動 Nginx：
  ?> /opt/nginx/scripts/apigee-nginx restart
根據預設，存放區需要使用者名稱：密碼為 admin:admin。如要變更這些憑證，請設定下列環境變數：
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
在新節點上安裝 yum-utils 和 yum-plugin-priorities：
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
按照上述步驟，在新節點上停用 SELinux。
按照上述步驟，在新節點上啟用 EPEL 存放區。
在新節點上，按照上述方式檢查 libdb4 的版本。
在遠端節點上，將 Edge bootstrap_4.18.01.sh 檔案下載至 /tmp/bootstrap_4.18.01.sh：
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

其中 uName:pWord 是您在上方為存放區設定的使用者名稱和密碼，remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。
在遠端節點上，安裝 Edge apigee-service 公用程式和依附元件：
> sudo bash /tmp/bootstrap_4.18.01.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.18.01.sh 檔案，然後執行新的同步作業：

將 Edge bootstrap_4.18.01.sh 檔案下載至 /tmp/bootstrap_4.18.01.sh：
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
執行 Edge bootstrap_4.18.01.sh 檔案：
> sudo bash /tmp/bootstrap_4.18.01.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.18.01 存放區中新增或更新 Edge 4.16.0x/4.17.0x

如要在 4.18.01 存放區中維護 Edge 4.16.0x 或 4.17.0x 的安裝作業，可以維護包含所有版本的存放區。接著，您就可以從該存放區安裝任何版本的 Edge。

如要將 4.16.0x/4.17.0x 新增至 4.18.01 存放區：

確認您已安裝 4.18.01 版的 apigee-mirror 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

您應該會看到以下格式的結果，其中 xyz 是版本號碼：
apigee-mirror-4.18.01-0.0.xyz
使用 apigee-mirror 公用程式，將 Edge 4.16.0x/4.17.0x 下載至存放區。請注意，您必須在指令前加上所需版本：
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

稍後請使用相同指令，指定所需版本號碼，更新 4.16.0x/4.17.0x 存放區。
檢查 /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.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

請注意，所有版本的 Edge 都有一個 bootstrap 檔案。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 網路伺服器安裝，請從存放區下載並執行正確的啟動檔案：
> /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 網路伺服器從存放區安裝」中的其餘步驟操作。