安裝 Edge apigee-setup 公用程式

Private Cloud v. 4.17.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 作業系統上
      回音 0 > /selinux/enforce

      如何在安裝 Edge 後重新啟用 SELinux:
      回音 1 > /selinux/enforce
    2. 在 Linux 7.x 作業系統上
      設定 0

      如何在安裝 Edge 後重新啟用 SELinux:
      設定 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 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 6.x:
    >wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm;sudo rpm -ivh epel-release-latest-6.noarch.rpm

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

如何在具備外部網際網路連線的節點上安裝 Edge:

  1. 從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。 如果已有 Apigee ftp 網站的使用者名稱:密碼,則可使用 憑證
  2. 以根權限登入節點,安裝邊緣 RPM
    注意:雖然 RPM 安裝作業需要 Root 存取權,但你可以執行 Edge 沒有根目錄存取權的話
  3. 按照上述說明停用 SELinux。
  4. 按照上述方式啟用 EPEL 存放區。
  5. 下載 Edge bootstrap_4.17.01.sh 檔案至 /tmp/bootstrap_4.17.01.sh
    >curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  6. 安裝 Edge apigee-service 公用程式和依附元件:
    >sudo bash /tmp/bootstrap_4.17.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*」
  7. (僅限 CentOS-6.x 和 RedHat-6.x) 在所有 Qpid 節點上執行以下指令 指令,確認您已下載正確的 Qpid 版本:
    >Yum install apigee-qpidd --disablerepo=epel
  8. 使用 apigee-service 安裝 apigee-setup 公用程式:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。

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

如果您的 Edge 節點在防火牆後面,或以其他方式遭禁止存取 透過網際網路存取 Apigee 存放區,接著您必須建立本機存放區 Apigee 存放區中的一部分如此一來,所有節點都必須能存取該鏡像。建立後 然後存取本機鏡像安裝 Edge。

如要建立內部 Apigee 存放區,您需要有外部網際網路的節點 有權下載邊緣 RPM 和依附元件。建立內部 IP 位址後 可以將節點移至其他節點,或是讓 Edge 節點存取該節點 安裝。

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

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

建立本機 Apigee 存放區

建立本機 Apigee 存放區:

  1. 從 Apigee 取得您用來存取 Apigee 存放區的使用者名稱和密碼。 如果已有 Apigee ftp 網站的使用者名稱:密碼,則可使用 憑證
  2. 以根權限登入 RedHat 或 CentOS 節點,安裝邊緣 RPM。
    注意:雖然 RPM 安裝作業需要 Root 存取權,但你可以執行 Edge 沒有根目錄存取權的話
  3. 請確認您已安裝最新版的 yum-utils:
    >sudo yum 更新 yum-utils
  4. 按照上述說明停用 SELinux。
  5. 按照上述方式啟用 EPEL 存放區。
  6. 下載 Edge bootstrap_4.17.01.sh 檔案至 /tmp/bootstrap_4.17.01.sh
    >curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  7. (僅限 CentOS-6.x 和 RedHat-6.x) 請執行下列指令,確保 您下載了正確的 Qpid 版本:
    >Yum install apigee-qpidd --disablerepo=epel
  8. 安裝 Edge apigee-service 公用程式和依附元件:
    >sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    其中 uName:pWord 是原始的使用者名稱和密碼 Apigee。如果您省略 pWord,系統會提示您輸入。
  9. 安裝 apigee-mirror 以下節點的公用程式:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install

    注意:如果要將現有存放區更新為 4.17.01,只要更新檔案即可 apigee-mirror
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror update
  10. 使用 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 公用程式 本機存放區
  11. (選用) 如果您要將 Edge 從本機存放區安裝到同一個 請先執行下列指令:
    1. 從本機執行 bootstrap_4.17.01.sh 來安裝 apigee-service 公用程式:
      >sudo bash /opt/apigee/data/apigee-Mirror/repos/bootstrap_4.17.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 檔案安裝:

  1. 在含有本機存放區的節點上,使用下列指令將本機存放區封裝至 名為 /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz 的單一.tar 檔案:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件
  2. 將 .tar 檔案複製到要安裝 Edge 的節點。舉例來說,請將程式碼複製到 新的 /tmp 目錄 節點。
  3. 在新節點上,按照上述說明停用 SELinux。
  4. 在新節點上,將檔案解壓縮至 /tmp 目錄:
    >tar -xzf apigee-4.17.01.tar.gz

    這個指令會建立新的目錄 位於包含 .tar 檔案的目錄中例如: /tmp/repos.
  5. /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件:
    >sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file:// apigeerepobasepath=/tmp/repos

    請注意,您會在這個指令中加入存放區目錄的路徑。
  6. 使用 apigee-service 可以 安裝 apigee-setup 公用程式:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. 使用 apigee-setup 安裝 並在節點上設定 Edge 元件詳情請參閱「在節點上安裝 Edge 元件」。

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

  1. 在存放區節點中安裝 Nginx 網路伺服器:
    > 選擇/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 重新啟動
  3. 存放區預設需要 admin:admin 的 username:password,如要變更這些憑證, 設定下列環境變數:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. 在新節點上,按照上述說明停用 SELinux。
  5. 在遠端節點上,將 Edge bootstrap_4.17.01.sh 檔案下載至 /tmp/bootstrap_4.17.01.sh
    >/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

    其中 uName:pWord 是您在上方為 存放區,而 remoteRepo 是存放區的 IP 位址或 DNS 名稱 節點。
  6. 在遠端節點上,安裝 Edge apigee-service 公用程式和依附元件:
    >sudo bash /tmp/bootstrap_4.17.01.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.17.01.sh 檔案,然後執行新的檔案 同步處理:

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

    其中 uName:pWord 是你的使用者名稱和密碼 。如果您省略 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.17.01 存放區中新增或更新 Edge 4.16.01/4.16.05/4.16.09

如果您必須繼續在 4.17.01 存放區中安裝 Edge 4.16.0x 版本,可以 存放所有版本的存放區然後從該存放區安裝任何版本的 Edge。

如何在 4.17.01 存放區中新增 4.16.0x:

  1. 確認已安裝 4.17.01 版本的 apigee-mirror 公用程式:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror

    畫面應會顯示以下表單結果,其中 xyz 代表版本 號碼:
    apigee-mirror-4.17.01-0.0.xyz
  2. 使用 apigee-mirror 公用程式,將 Edge 4.16.01/4.16.05/4.16.09 下載至您的存放區。請注意,在 加上 apigeereleasever=4.16.01 的指令 或 apigeereleasever=4.16.05
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service Apigee-Mirror sync --only-new-rpms

    稍後請使用相同的指令來指定必要的 4.16.05/4.16.09 存放區,藉此更新 4.16.05/4.16.09 存放區 版本號碼
  3. 檢查 /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 第三方

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

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

如要從本機存放區或 .tar 檔案安裝 Edge,請務必執行正確的 Bootstrap 檔案:

  • 如果是從 .tar 檔案安裝,請從存放區執行正確的 Bootstrap 檔案:
    >sudo bash /tmp/repos/bootstrap_4.16.0X.sh Apigeeprotocol="file:// apigeerepobasepath=/tmp/repos

    如要完成安裝程序,請按照「從 .tar 檔案安裝」中的步驟操作 。
  • 如果是使用 Nginx 網路伺服器進行安裝,請下載並執行正確的 Bootstrap 檔案 從存放區複製:
    >/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
    >sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://


    如要完成安裝,請按照「使用 Nginx webserver」。