安裝 Edge apigee-setup 公用程式

Private Cloud v4.18.05 專用 Edge

如要在節點上安裝 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=disabled或SELINUX=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 網站的使用者名稱:密碼，則可使用 憑證
  2. 以根權限登入節點，安裝邊緣 RPM
  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-REGION-rhel-server-optional
  9. 將 Edge bootstrap_4.18.05.sh 檔案下載至 /tmp/bootstrap_4.18.05.sh： 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. 安裝 Edge apigee-service 公用程式和依附元件： 
    sudo bash /tmp/bootstrap_4.18.05.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 元件」。

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

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

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

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

建立本機 Apigee 存放區

建立本機 Apigee 存放區：

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

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

  11. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件： 
    sudo bash /tmp/repos/bootstrap_4.18.05.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 的使用者名稱:password。如要變更 設定下列環境變數： 
    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. 在遠端節點上，下載 Edge bootstrap_4.18.05.sh 檔案， /tmp/bootstrap_4.18.05.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

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

  9. 在遠端節點上，安裝 Edge apigee-service 公用程式和依附元件： 
    sudo bash /tmp/bootstrap_4.18.05.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.18.05.sh 檔案，然後執行新的檔案 sysnc:

  1. 將 Edge bootstrap_4.18.05.sh 檔案下載至 /tmp/bootstrap_4.18.05.sh： 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. 執行 Edge bootstrap_4.18.05.sh 檔案： 
    sudo bash/tmp/bootstrap_4.18.05.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.18.05 存放區中新增或更新 Edge 4.16.0x/4.17.0x

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

如何將 4.16.0x/4.17.0x 新增到 4.18.05 存放區：

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

    結果應如下所示，其中 xyz 是版本編號：

    apigee-mirror-4.18.05-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.05.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 網路伺服器」。