安裝 Edge apigee-setup 公用程式

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

預設安裝目錄:/opt/apigee

邊緣會安裝 /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=disabledSELINUX=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:

  1. 從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee FTP 網站的 username:password,可以使用 憑證
  2. 以根權限登入節點,安裝邊緣 RPM
  3. 安裝 yum-utilsyum-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-REGION-rhel-server-optional
  9. 將 Edge bootstrap_4.19.06.sh 檔案下載至 /tmp/bootstrap_4.19.06.sh
    curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
  10. 安裝 Edge apigee-service 公用程式和依附元件:
    sudo bash /tmp/bootstrap_4.19.06.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*'
  11. 使用 apigee-service 安裝 apigee-setup 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

疑難排解

當您嘗試在具備外部網際網路連線的節點上安裝時,可能會遇到 下列一或多項錯誤:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.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 存放區,您需要有外部網際網路的節點 有權下載邊緣 RPM 和依附元件。建立內部 IP 位址後 可以將節點移至其他節點,或是讓 Edge 節點存取該節點 安裝。

建立本機 Apigee 存放區後,您之後可能需要更新至 邊緣版本檔案。下列各節說明如何建立本機 Apigee 存放區。 更新方式。

如何建立本機 Apigee 存放區:

  1. 從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。 如果已有 Apigee ftp 網站的使用者名稱:密碼,則可使用 憑證
  2. 以根權限登入節點,安裝邊緣 RPM。
  3. 按照上述說明停用 SELinux。
  4. 將 Edge bootstrap_4.19.06.sh 檔案下載至 /tmp/bootstrap_4.19.06.sh
    curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
  5. 安裝 Edge apigee-service 公用程式和依附元件:
    sudo bash /tmp/bootstrap_4.19.06.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您需要約 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.19.06.sh 以安裝 apigee-service 公用程式:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.06.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 檔案安裝

如何從 .tar 檔案安裝:

  1. 在含有本機存放區的節點上,使用下列指令將本機存放區封裝至 名為 /opt/apigee/data/apigee-mirror/apigee-4.19.06.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. 在新節點上安裝 yum-utilsyum-plugin-priorities: 在本機存放區中操作:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    您的營運團隊或機構內的其他群組必須設定本機存放區, 才能安裝 Yum 工具

  7. 在新節點上,按照上述說明檢查 libdb4 版本。
  8. 如果是在 Oracle 7.x 上安裝,請執行下列指令:
    sudo yum-config-manager --enable ol7_optional_latest
  9. 如要在 AWS 上安裝,請執行下列指令: yum-configure-manager 指令:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. 在新節點上,將檔案卸離至 /tmp 目錄:
    tar -xzf apigee-4.19.06.tar.gz

    這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos.

  11. /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件:
    sudo bash /tmp/repos/bootstrap_4.19.06.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 網路伺服器從存放區安裝

如何使用 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 的使用者名稱:password。如要變更 設定下列環境變數:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. 在新節點上安裝 yum-utilsyum-plugin-priorities
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. 在新節點上,按照上述說明停用 SELinux。
  6. 在新節點上,確認本機 EPEL 存放區已啟用。
  7. 在新節點上,按照上述說明檢查 libdb4 版本。
  8. 在遠端節點上,下載 Edge bootstrap_4.19.06.sh 檔案, /tmp/bootstrap_4.19.06.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

    其中 uName:pWord 是您為存放區設定的使用者名稱和密碼 remoteRepo 是存放區節點的 IP 位址或 DNS 名稱。

  9. 在遠端節點上,安裝 Edge apigee-service 公用程式和依附元件:
    sudo bash /tmp/bootstrap_4.19.06.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

更新本機 Apigee 存放區

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

如何更新存放區:

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

在 4.19.06 存放區中新增或更新 Edge 4.16.0x/4.17.0x

如果您必須繼續在 4.19.06 存放區中安裝 Edge 4.16.0x 或 4.17.0x 版本,您可以 存放區中負責保留一個包含所有版本的存放區透過該存放區,您可以安裝 邊緣

如何將 4.16.0x/4.17.0x 新增到 4.19.06 存放區:

  1. 確認您已安裝 4.19.06 版本的 apigee-mirror 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    結果應如下所示,其中 xyz 是版本編號:

    apigee-mirror-4.19.06-0.0.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

    畫面上應會顯示下列檔案和目錄:

    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
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

    請注意,您如何為所有 Edge 版本建立 Bootstrap 檔案。apigee 目錄也包含每個 Edge 版本的個別目錄。

  4. 如要將存放區封裝為 .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 檔案啟動 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 網路伺服器」。