安裝 Edge apigee-setup 公用程式

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

預設安裝目錄:/opt/apigee

邊緣會安裝 /opt/apigee 目錄中的所有檔案。您無法變更這個目錄。不過,如果需要,您可以建立符號連結,將 /opt/apigee 對應至其他位置。詳情請參閱「安裝規定」。

事前準備:停用 SELinux

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

  • 如要永久停用 SELinux 或將其設為寬鬆模式,請按照下列步驟操作:
    1. 在編輯器中開啟 /etc/sysconfig/selinux
    2. 設定SELINUX=disabledSELINUX=permissive
    3. 儲存編輯內容。
    4. 重新啟動節點。
    5. 如有需要,請在 Edge 安裝完成後,重複執行這個程序來設定 SELINUX=enabled,重新啟用 SELinux。
  • 前置條件:啟用 EPEL 存放區

    您必須啟用 Extra Packages for Enterprise Linux (或 EPEL),才能安裝或更新 Edge,或建立本機存放區。您使用的指令取決於 RedHat/CentOS 版本:

    • 針對 Red Hat/CentOS/Oracle 8.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • 針對 Red Hat/CentOS/Oracle 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 8/Rocky 8/Oracle 8 的必備條件

      如果您要在執行 Red Hat Enterprise Linux (RHEL) 8 的伺服器上安裝 Edge,請先執行下列步驟,再安裝 Edge:

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

      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 資料庫預先安裝規定OpenLDAP 2.4 預先安裝變更

      在有外部網際網路連線的節點上安裝 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.53.00.sh 檔案下載至 /tmp/bootstrap_4.53.00.sh
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. 安裝 Edge apigee-service 公用程式和依附元件:
        sudo bash /tmp/bootstrap_4.53.00.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 存放區。如要查看定義檔案,請使用下列指令:

        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.53.00.sh 檔案下載至 /tmp/bootstrap_4.53.00.sh
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. 安裝 Edge apigee-service 公用程式和依附元件:
        sudo bash /tmp/bootstrap_4.53.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.53.00.sh,安裝 apigee-service 公用程式:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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.53.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.53.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.53.00.sh 檔案,然後執行新的同步處理作業。

      如何更新存放區:

      1. 將 Edge bootstrap_4.53.00.sh 檔案下載至 /tmp/bootstrap_4.53.00.sh
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. 執行 Edge bootstrap_4.53.00.sh 檔案:
        sudo bash/tmp/bootstrap_4.53.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