本頁面由 Cloud Translation API 翻譯而成。

安裝 Edge apigee-setup 公用程式

Private Cloud v4.18.01 專用 Edge

如要在節點上安裝 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 或 SELINUX=permissive
3. 儲存修改過的內容。
4. 重新啟動節點。
5. 如有需要，請在 Edge 安裝完成後重複這項程序，以重新啟用 SELinux，以便設定 SELINUX=enabled。

事前準備：啟用 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

必要條件：檢查 libdb4 搭載 RedHat 7.4 和 CentOS 7.4 的程式庫版本

安裝 RedHat 7.4 和 CentOS 7.4 前，請先檢查 libdb4 RPM 的版本。邊緣 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 網站的使用者名稱:密碼，則可使用憑證
以根權限登入節點，安裝邊緣 RPM
注意：雖然 RPM 安裝作業需要 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 更新 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 的情況下繼續操作
問：退出，如果採用這個選項，您必須自行安裝 Java。

安裝 apigee-service 公用程式時，系統會建立 /etc/yum.repos.d/apigee.repo 檔案定義 Apigee 存放區如要查看定義檔案，請使用下列指令：
>貓 /etc/yum.repos.d/apigee.repo

如要查看存放區內容，請使用下列指令：
>sudo yum -v 存放區清單「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 和依附元件。建立內部 IP 位址後可以將節點移至其他節點，或是讓 Edge 節點存取該節點安裝。

注意：Apigee 不會將所有第三方依附元件託管於我們的公用事業與存放區您必須透過可公開存取的依附元件下載及安裝這些依附元件與存放區

建立本機 Edge 存放區後，您之後可能需要根據邊緣版本檔案。下列各節說明如何建立本機存放區，以及如何更新檔案。

建立本機 Apigee 存放區

建立本機 Apigee 存放區：

從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。如果已有 Apigee ftp 網站的使用者名稱:密碼，則可使用憑證
以根權限登入節點，安裝邊緣 RPM。
注意：雖然 RPM 安裝作業需要 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 來僅下載最新版本的每千次觀看收益。您需要約 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 檔案複製到節點，然後從中安裝 Edge .tar 檔案。
在含有本機存放區的節點中安裝網路伺服器，以便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用，您也可以使用自己的網路伺服器

從 .tar 檔案安裝：

在含有本機存放區的節點上，使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的單一.tar 檔案：
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件
將 .tar 檔案複製到要安裝 Edge 的節點。舉例來說，請將程式碼複製到新的 /tmp 目錄節點。
在新節點上，按照上述說明停用 SELinux。
在新節點上，按照上述方式啟用 EPEL 存放區。
務必在新節點上停用所有外部網際網路存放區。執行下列指令時，所有外部存放區都會顯示為已停用。但本機 Apigee 存放區和所有內部存放區應已啟用：
>sudo yum 存放區清單
在新節點上安裝 yum-utils 和 yum-plugin-priorities：
>sudo yum 安裝 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 檔案的目錄中例如： /tmp/repos.
從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
>sudo bash /tmp/repos/bootstrap_4.18.01.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 網路伺服器：
> 選擇/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 重新啟動
存放區預設需要 admin:admin 的 username:password，如要變更這些憑證，設定下列環境變數：
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
在新節點上安裝 yum-utils 和 yum-plugin-priorities：
>sudo yum 安裝 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 檔案，然後執行新的檔案 sysnc:

下載 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 是你的使用者名稱和密碼。如果您省略 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 版本，您可以存放區中負責保留一個包含所有版本的存放區透過該存放區，您可以安裝邊緣

如何將 4.16.0x/4.17.0x 新增到 4.18.01 存放區：

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

畫面應會顯示以下表單結果，其中 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 目錄查看檔案結構：
>標準 /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 bootstrap_4.18.01.sh第三方

請注意，您如何為所有 Edge 版本建立 Bootstrap 檔案。apigee 目錄還包含單獨的專屬目錄
如要將存放區封裝為 .tar 檔案，請使用下列指令：
> Apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件

這個指令會將所有 4.17.0x 和 4.16.0x 存放區封裝到同一個 .tar 檔案。你無法只封裝部分存放區

如要從本機存放區或 .tar 檔案安裝 Edge，請務必執行正確的 Bootstrap 檔案啟動 Google Cloud 執行個體這個範例安裝 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 webserver」。