安裝 Edge apigee-setup 公用程式

私有雲 v4.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=已停用 或 SELINUX=permissive
    3. 儲存修改過的內容。
    4. 重新啟動節點。
    5. 如有需要，請在 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 也隨附較新版本。如果之後有版本，請解除安裝，Edge 安裝程式就會安裝 4.8 版。

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

> rpm -qa | grep libdb4

如果看到 libdb4 RPM 比 4.8 以上版本，請解除安裝。

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

如何在有外部網際網路連線的節點上安裝 Edge：

  1. 從 Apigee 取得用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee ftp 網站現有的使用者名稱:password，就可以使用這些憑證。
  2. 以根層級登入節點即可安裝 Edge RPM
    注意：雖然 RPM 安裝作業需要 Root 存取權，但您可以在沒有 Root 存取權的情況下執行 Edge 設定。
  3. 安裝 yum-utils 和 yum-plugin-priorities：
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. 按照上述說明停用 SELinux。
  5. 按照上述方式啟用 EPEL 存放區。
  6. 請按照上述方式檢查 libdb4 的版本。
  7. 如果您是在 Oracle 7.x 上安裝，請執行下列指令：
    > sudo yum-config-manager --enable ol7_optional_latest
  8. 如果您是在 AWS 進行安裝，請執行以下 yum-configure-manager 指令：
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui--rhel-server-optional
  9. 將 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
  10. 安裝 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_FIX選項指定處理 Java 安裝的方式。JAVA_FIX 會採用下列值：

    I = 安裝 OpenJDK 1.8 (預設)
    C = 在不安裝 Java 的情況下繼續操作
    Q = 結束。如要使用這個選項，您必須自行安裝 Java。

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

    如要查看存放區內容，請使用下列指令：
    > sudo yum -v repolist 'apigee*'
  11. 使用 apigee-service 安裝 apigee-setup 公用程式：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. 使用 Apigee-setup，在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

在沒有外部網際網路連線的節點中安裝 Edge apigee-setup 公用程式

如果您的 Edge 節點設有防火牆，或以其他方式禁止透過網際網路存取 Apigee 存放區，您就必須建立 Apigee 存放區的本機存放區或鏡像。接著，所有節點都必須存取該鏡像。建立完成後，節點就能存取本機鏡像來安裝 Edge。

如要建立內部 Apigee 存放區，您必須要求具備外部網際網路存取權的節點，才能下載邊緣 RPM 和依附元件。建立內部存放區後，您可以將其移至其他節點，或是開放邊緣節點存取該節點以進行安裝。

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

建立本機 Edge 存放區後，您之後可能需要將其更新為最新的 Edge 版本檔案。以下各節說明如何建立本機存放區及更新存放區的方式。

建立本機 Apigee 存放區

如何建立本機 Apigee 存放區：

  1. 從 Apigee 取得用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee ftp 網站現有的使用者名稱:password，就可以使用這些憑證。
  2. 以根層級登入節點即可安裝 Edge RPM。
    注意：雖然 RPM 安裝需要 Root 存取權，但您可以在沒有 Root 存取權的情況下執行 Edge 設定。
  3. 按照上述說明停用 SELinux。
  4. 將 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
  5. 安裝 Edge apigee-service 公用程式和依附元件：
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

    注意：如果你是將現有存放區更新至 4.18.01，則只能更新 apigee-Mirror：
    >
  7. 使用 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 公用程式。
  8. (選用) 如要將本機存放區中的 Edge 安裝到託管本機存放區的同一節點中，請先執行下列指令：
    1. 從本機存放區執行 bootstrap_4.18.01.sh 來安裝 apigee-service 公用程式：
      > sudo bash /opt/apigee/data/apigee-Mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigee 傳送到 repobase=/opt/apigee/data/apigee-repo/
    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 檔案安裝：

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

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

    請注意，你在這個指令中會包含存放區目錄的路徑。
  12. 使用 apigee-service 安裝 apigee-setup 公用程式：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. 使用 apigee-setup，在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

使用 Nginx 網路伺服器從存放區安裝：

  1. 在存放區節點上安裝 Nginx 網路伺服器：
    > opt/apigee/apigee-service/bin/apigee-service apigee-Mirror nginxconfig
  2. 根據預設，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
  3. 根據預設，存放區會需要 admin:admin 的使用者名稱:密碼。如要變更這些憑證，請設定下列環境變數：
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. 在新節點上安裝 yum-utils 和 yum-plugin-priorities：
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. 按照上述說明，在新節點上停用 SELinux。
  6. 在新節點上，按照上述方式啟用 EPEL 存放區。
  7. 在新節點上，按照上述方式檢查 libdb4 的版本。
  8. 在遠端節點上，將 <使用者名稱> 設為 <使用者名稱> 的 Bootstrap_4.18.01.sh 檔案，並設為 /tmp/bootstrap_4.18.01.sh：
    > /usr/bin/curl http://uName:pWord@remoteRepo.4.4.18.。

  9. 在遠端節點中，安裝 Edge apigee-service 公用程式和依附元件：
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeeuser=uName apigeepassword=pWordName。

  10. 在遠端節點上，使用 apigee-service 安裝 apigee-setup 公用程式：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. 使用 apigee-setup，在遠端節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

更新本機 Apigee 存放區

如要更新存放區，您必須下載最新的 bootstrap_4.18.01.sh 檔案，然後執行新的 sysnc：

  1. 將 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
  2. 執行 Edge bootstrap_4.18.01.sh 檔案：
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    其中 uName:pWord 是 Apigee 提供的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。
  3. 更新 apigee-Mirror：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 更新
  4. 執行同步處理作業：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync --only-new-rpms
  5. 如要儲存至整個存放區：
    > /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 存放區，請按照下列指示操作：

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

    你應該會看到以下形式的結果，其中 xyz 是版本號碼：
    apigee-Mirror-xyz。xyz
  2. 使用 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 存放區版本編號。
  3. 檢查 /opt/apigee/data/apigee-mirror/repos 目錄，並查看檔案結構：
    > ls /opt/apigee/data/apigee-Mirror/repos

    應該會看到下列檔案和目錄：
    /opt/apigee/data/apigee-mirror/repos353.4.454.4.4.4.3 相關的皆分。

    apigee 目錄也包含了每個 Edge 版本的個別目錄。
  4. 如要將存放區封裝為 .tar 檔案，請使用下列指令：
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件

    這個指令會將所有 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

    如要完成安裝程序，請按照上述「安裝
  • 如果使用 Nginx 網路伺服器進行安裝，請從存放區下載並執行正確的 Bootstrap 檔案。
    > /usr/bin/curl" http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/apigeestrap_4.17.01.