安裝 Edge apigee-setup 公用程式

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

預設安裝目錄：/opt/apigee

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

事前準備：停用 SELinux

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

  • 如要永久停用 SELinux 或設為寬鬆模式，請按照下列步驟操作：
    1. 在編輯器中開啟 /etc/sysconfig/selinux。
    2. 設定 SELINUX=disabled 或 SELINUX=permissive
    3. 儲存編輯內容。
    4. 重新啟動節點。
    5. 如有需要，請在安裝 Edge 後重新啟用 SELinux，方法是重複這項程序，將 SELINUX=enabled 設為 1。

    • 必要條件：啟用 EPEL 存放區

    您必須啟用 Extra Packages for Enterprise Linux (或 EPEL)，才能安裝或更新 Edge，或建立本機存放區。如果是 Red Hat Enterprise Linux (RHEL) 9.x、Rocky Linux 9.x 或 Oracle Linux 9.x，請執行下列指令：

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    RHEL 9/Rocky 9/Oracle 9 的必要條件

    如果要在執行 Red Hat Enterprise Linux (RHEL) 9、Rocky 9 或 Oracle 9 的伺服器上安裝 Edge，請先完成下列步驟，再執行安裝作業：

    1. 啟用 Extra Packages for Enterprise Linux (EPEL)： 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. 停用 Postgres 和 Nginx： 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    如要瞭解 PostgreSQL 和 LDAP 的預先安裝變更，請分別參閱「PostgreSQL 資料庫預先安裝需求」和「SymasLDAP 2.6.10 預先安裝變更」。

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

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

    1. 從 Apigee 取得用於存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee FTP 網站的 username:password，可以使用這些憑證。
    2. 以 root 身分登入節點，安裝 Edge RPM
    3. 停用 SELinux。
    4. 啟用 EPEL 存放區。
    5. 如要在 RHEL 9/Rocky 9/Oracle 9 上安裝，請按照「RHEL 9/Rocky 9/Oracle 9 的必要條件」一節的步驟操作。
    6. 將 Edge bootstrap_4.54.00.sh 檔案下載至 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. 安裝 Edge apigee-service 公用程式和依附元件： 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。

      Apigee Edge for Private Cloud 4.54.00 需要雙重 Java 支援，節點上必須同時安裝 Java 17 和 Java 21。執行啟動程序指令碼前，請務必安裝 Java 17 和 Java 21。安裝程式只會驗證是否已安裝這兩個 JDK 版本，不會自動安裝 Java。

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

      cat /etc/yum.repos.d/apigee.repo

      如要查看存放區內容，請使用下列指令：

      sudo yum -v repolist 'apigee*'
    8. 使用 apigee-service 安裝 apigee-setup 公用程式：
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. 使用 apigee-setup 在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

    疑難排解

    嘗試在具有外部網際網路連線的節點上安裝時，可能會遇到下列一或多項錯誤：

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

    下表列出這些錯誤的可能解決方法：

    錯誤類型 可能的解決方法
    密碼含有無效字元 請勿在 Apigee 密碼中使用特殊字元。
    連線問題

    執行下列 ncat 指令，測試網路連線：

    nc -v software.apigee.com 443

    您應該會收到類似下列內容的訊息：

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    如果未安裝 nc，可以執行下列 telnet 指令：

    telnet software.apigee.com 443

    如果指令成功，可以使用 CTRL+C 中止開啟的連線。

    如果任一指令失敗，代表網路連線受限或沒有網路連線。請洽詢網路管理員。
    憑證不正確

    確認使用者名稱和密碼正確無誤。

    舉例來說，請檢查您嘗試使用下列指令時是否會收到錯誤訊息，並提供 Apigee 使用者名稱和密碼：

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    Proxy 問題 您的本機設定使用輸出 HTTP Proxy，但您尚未將相同設定擴充至 yum 套件管理工具。檢查環境變數： 
    echo $http_proxy
echo $https_proxy

    如果是輸出 HTTP Proxy，請使用下列其中一種方式：

    • 在 /etc/yum.conf 中新增 HTTP Proxy 設定
    • 在 /etc/environment 中新增全域 HTTP Proxy 設定

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

    如果 Edge 節點位於防火牆後方，或因其他原因而無法存取網際網路，您必須建立多個存放區或鏡像，其中包含安裝期間所需的檔案。所有節點都必須能存取這些鏡像。建立節點後，即可存取這些本機鏡像，安裝 Edge。

    如要為沒有網際網路連線的節點安裝 Apigee Edge，必須存取下列本機存放區：

    建立本機 Apigee 存放區

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

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

    建立本機 Apigee 存放區：

    1. 從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。如果您已有 Apigee FTP 網站的使用者名稱和密碼，可以使用這些憑證。
    2. 以 root 身分登入節點，安裝 Edge RPM。
    3. 按照上述步驟停用 SELinux。
    4. 將 Edge bootstrap_4.54.00.sh 檔案下載至 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. 安裝 Edge apigee-service 公用程式和依附元件：
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。

    6. 在節點上安裝 apigee-mirror 公用程式： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
    7. 使用 apigee-mirror 公用程式，將 Apigee 存放區同步至 /opt/apigee/data/apigee-mirror/repos/ 目錄。

      如要盡量縮減存放區大小，請加入 --only-new-rpms，只下載最新的 RPM。

    8. (選用) 如要將本機存放區中的 Edge 安裝到託管本機存放區的節點，請先執行下列指令：
      1. 從本機存放區執行 bootstrap_4.54.00.sh，安裝 apigee-service 公用程式：
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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 檔案安裝

    如要從 .tar 檔案安裝：

    1. 在本機存放區所在的節點上，使用下列指令將本機存放區封裝成名為 /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz 的單一 .tar 檔案：
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. 將 .tar 檔案複製到要安裝 Edge 的節點。例如，將其複製到新節點上的 /tmp 目錄。
    3. 在新節點上，按照上述方式停用 SELinux。
    4. 在新節點上，請確認您可以存取本機 Yum 公用程式存放區和 EPEL 存放區。
    5. 請再次確認所有外部網際網路存放區都已停用 (您是在沒有網路連線能力的電腦上安裝，因此應該是這樣)：
      sudo yum repolist

      所有外部存放區都應停用，但本機 Apigee 存放區和內部存放區應啟用。

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

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

    如要使用 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. 確認新節點已在本機啟用 EPEL 存放區。
    5. 在新節點上，按照上述方式檢查 libdb4 版本。
    6. 在遠端節點上，安裝 Edge apigee-service 公用程式和依附元件：
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      其中 uName:pWord 是存放區的使用者名稱和密碼。

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

    更新本機 Apigee 存放區

    如要更新存放區，請下載最新的 bootstrap_4.54.00.sh 檔案，然後執行新的同步作業。

    如要更新存放區，請按照下列步驟操作：

    1. 將 Edge bootstrap_4.54.00.sh 檔案下載到 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. 執行 Edge bootstrap_4.54.00.sh 檔案： 
      sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您從 Apigee 取得的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。

    3. 更新 apigee-mirror： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
    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