Instalowanie narzędzia Edge apigee

Aby zainstalować Edge na węźle, najpierw zainstaluj narzędzie apigee-setup Edge. Jeśli Twoje węzły nie mają zewnętrznego połączenia z internetem, musisz też zainstalować lokalną kopię repozytorium Apigee.

Domyślny katalog instalacji: /opt/apigee

Edge instaluje wszystkie pliki w katalogu /opt/apigee. Nie możesz zmienić tego katalogu. W razie potrzeby możesz jednak utworzyć link symboliczny, aby zmapować /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w sekcji Wymagania dotyczące instalacji.

Wymaganie wstępne: wyłącz SELinux

Przed zainstalowaniem narzędzia Edge  apigee-setup lub dowolnych komponentów Edge musisz wyłączyć SELinux lub ustawić go w trybie zezwalającym. Po zainstalowaniu Edge możesz w razie potrzeby ponownie włączyć SELinux.

  • Aby tymczasowo ustawić SELinux w trybie zezwalającym, wykonaj to polecenie:
    • W systemie operacyjnym Linux w wersji 6.x:
      sudo echo 0 > /selinux/enforce

      Aby ponownie włączyć SELinux po zainstalowaniu Edge:

      sudo echo 1 > /selinux/enforce
    • W systemie operacyjnym Linux 7.x:
      sudo setenforce 0

      Aby ponownie włączyć SELinux po zainstalowaniu Edge:

      sudo setenforce 1
  • Aby na stałe wyłączyć SELinux lub ustawić go w trybie zezwalającym:
    1. Otwórz plik /etc/sysconfig/selinux w edytorze.
    2. Ustaw SELINUX=disabled lub SELINUX=permissive
    3. Zapisz zmiany.
    4. Ponownie uruchom węzeł.
    5. W razie potrzeby po instalacji Edge ponownie włącz SELinux, powtarzając tę procedurę, aby ustawić SELINUX=enabled.

Wymaganie wstępne: włącz repozytorium EPEL

Aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium, musisz włączyć Extra Packages for Enterprise Linux (EPEL). Użyte polecenie zależy od wersji RedHat/CentOS:

  • Wymagania wstępne dotyczące systemu RHEL 8.0 znajdziesz w artykule Wymagania wstępne dotyczące systemu RHEL 8.

  • W przypadku systemów Red Hat/CentOS/Oracle w wersji 7.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • W przypadku systemów Red Hat/CentOS/Oracle w wersji 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
    sudo rpm -ivh epel-release-latest-6.noarch.rpm
  • W przypadku AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

Wymagania wstępne: sprawdź wersję biblioteki libdb4 na platformach RedHat 7.4 i CentOS 7.4

W przypadku systemów RedHat 7.4 i CentOS 7.4 przed instalacją sprawdź wersję pakietów libdb4 RPM. Edge wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 są dostarczane z nowszymi wersjami. Jeśli masz nowszą wersję, odinstaluj ją, a instalator Edge zainstaluje wersję 4.8.

Aby sprawdzić wersję, możesz użyć tego polecenia:

rpm -qa | grep libdb4

Jeśli widzisz, że wersja libdb4 RPM jest nowsza niż 4.8, odinstaluj ją.

Wymagania wstępne dotyczące RHEL 8

Jeśli instalujesz Edge na serwerze z systemem Red Hat Enterprise Linux (RHEL) 8, przed rozpoczęciem instalacji wykonaj te czynności:

  1. Włącz Extra Packages for Enterprise Linux (EPEL):
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Wyłącz Postgres i Nginx:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
  3. Zainstaluj Pythona 2:
    sudo dnf install -y python2

Wymagania wstępne dotyczące Amazon Linux 2023(AL2023)

Jeśli instalujesz Edge na serwerze z systemem Amazon-Linux-2023(AL2023), przed rozpoczęciem instalacji wykonaj te czynności:

USE_CQLUTIL=y

Zainstaluj narzędzie Edge apigee-setup na węźle z zewnętrznym połączeniem internetowym.

Aby zainstalować Edge na węźle z zewnętrznym połączeniem internetowym:

  1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już username:password do witryny FTP Apigee, możesz użyć tych danych logowania.
  2. Zaloguj się na węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
  3. Zainstaluj yum-utilsyum-plugin-priorities.
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Wyłącz SELinux.
  5. Włącz repozytorium EPEL.
  6. Sprawdź wersję libdb4.
  7. Jeśli instalujesz oprogramowanie na RHEL 8, wykonaj czynności opisane w artykule Wymagania wstępne dotyczące RHEL 8.
  8. Jeśli instalujesz na platformie Oracle 7.x, uruchom to polecenie:
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli instalujesz na AWS, uruchom te polecenia: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
  10. Pobierz plik Edge bootstrap_4.52.02.sh do /tmp/bootstrap_4.52.02.sh:
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  11. Zainstaluj narzędzie apigee-service Edge i zależności:
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego wpisanie.

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIX przyjmuje te wartości:

    • I. Zainstaluj OpenJDK 1.8 (domyślnie)
    • C: Kontynuuj bez instalowania Javy
    • P: Zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.

    Instalacja narzędzia apigee-service tworzy plik /etc/yum.repos.d/apigee.repo, który definiuje repozytorium Apigee. Aby wyświetlić plik definicji, użyj tego polecenia:

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

    Aby wyświetlić zawartość repozytorium, użyj tego polecenia:

    sudo yum -v repolist 'apigee*'
  12. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Użyj narzędzia apigee-setup, aby zainstalować i skonfigurować komponenty Edge na węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Rozwiązywanie problemów

Podczas próby instalacji na węźle z zewnętrznym połączeniem internetowym może wystąpić jeden lub więcej z tych błędów:

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

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

W tabeli poniżej znajdziesz możliwe rozwiązania tych problemów:

Typ błędu Możliwe rozwiązanie
Hasło zawiera nieprawidłowe znaki W haśle Apigee nie używaj znaków specjalnych.
Problemy z łącznością

Sprawdź łączność sieciową, wykonując to polecenie:ncat

nc -v software.apigee.com 443

Wyświetli się komunikat podobny do tego:

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

Jeśli nie masz zainstalowanego narzędzia nc, możesz wykonać to polecenie telnet:

telnet software.apigee.com 443

Jeśli polecenia się powiodą, możesz przerwać otwarte połączenie, naciskając CTRL+C.

Jeśli którekolwiek z tych poleceń się nie powiedzie, oznacza to, że masz ograniczone lub żadne połączenie sieciowe. Skontaktuj się z administratorem sieci.

Nieprawidłowe dane logowania

Sprawdź, czy nazwa użytkownika i hasło są prawidłowe.

Sprawdź na przykład, czy podczas próby użycia tego polecenia z nazwą użytkownika i hasłem Apigee występuje błąd:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Problemy z serwerem proxy Konfiguracja lokalna używa wychodzącego serwera proxy HTTP, a Ty nie rozszerzyłeś tej samej konfiguracji na yum menedżera pakietów. Sprawdź zmienne środowiskowe:
echo $http_proxy
echo $https_proxy

W przypadku wychodzącego serwera proxy HTTP możesz użyć jednej z tych opcji:

  • Dodaj konfigurację serwera proxy HTTP w /etc/yum.conf
  • Dodaj globalną konfigurację serwera proxy HTTP w /etc/environment

Zainstaluj narzędzie apigee-setup Edge na węźle bez zewnętrznego połączenia z internetem.

Jeśli węzły brzegowe znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do internetu, musisz utworzyć kilka repozytoriów lub kopii, które będą zawierać pliki potrzebne podczas instalacji. Te kopie muszą być dostępne dla wszystkich węzłów. Po utworzeniu węzły mogą uzyskać dostęp do tych lokalnych kopii, aby zainstalować Edge.

Proces instalacji Apigee Edge na węzłach bez połączenia z internetem wymaga dostępu do tych lokalnych repozytoriów:

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć wewnętrzne repozytorium Apigee, potrzebujesz węzła z zewnętrznym dostępem do internetu, aby móc pobrać pakiety RPM Edge i zależności. Po utworzeniu wewnętrznego repozytorium możesz przenieść go do innego węzła lub udostępnić ten węzeł węzłom brzegowym na potrzeby instalacji.

Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go o najnowsze pliki wersji Edge. W sekcjach poniżej znajdziesz informacje o tym, jak utworzyć lokalne repozytorium Apigee i jak je zaktualizować.

Aby utworzyć lokalne repozytorium Apigee:

  1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika i hasło do witryny FTP Apigee, możesz ich użyć.
  2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
  3. Wyłącz SELinux w sposób opisany powyżej.
  4. Pobierz plik Edge bootstrap_4.52.02.sh do /tmp/bootstrap_4.52.02.sh:
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  5. Zainstaluj narzędzie apigee-service Edge i zależności:
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego wpisanie.

  6. Zainstaluj narzędzie apigee-mirror w węźle:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. Użyj narzędzia apigee-mirror, aby zsynchronizować repozytorium Apigee z katalogiem /opt/apigee/data/apigee-mirror/repos/.

    Aby zminimalizować rozmiar repozytorium, użyj opcji --only-new-rpms, aby pobrać tylko najnowsze pakiety RPM.

  8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium na tym samym węźle, w którym znajduje się to repozytorium, musisz najpierw uruchomić te polecenia:
    1. Uruchom bootstrap_4.52.02.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Instalowanie apigee-setup na zdalnym węźle z lokalnego repozytorium

Edge możesz zainstalować z lokalnego repozytorium na 2 sposoby. Możesz:

  • Utwórz plik .tar repozytorium, skopiuj go na węzeł, a następnie zainstaluj Edge z tego pliku.
  • Zainstaluj serwer WWW na węźle z lokalnym repozytorium, aby inne węzły mogły uzyskać do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też używać własnego serwera WWW.

Instalowanie z pliku .tar

Aby zainstalować z pliku .tar:

  1. Na węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Skopiuj plik .tar na węzeł, w którym chcesz zainstalować Edge. Na przykład skopiuj go do katalogu /tmp na nowym węźle.
  3. Na nowym węźle wyłącz SELinux w sposób opisany powyżej.
  4. Na nowym węźle sprawdź, czy masz dostęp do lokalnego repozytorium narzędzia Yum i repozytorium EPEL.
  5. Sprawdź, czy wszystkie zewnętrzne repozytoria internetowe są wyłączone (tak powinno być, ponieważ instalujesz oprogramowanie na komputerze bez dostępu do internetu):
    sudo yum repolist

    Wszystkie zewnętrzne repozytoria powinny być wyłączone, ale lokalne repozytorium Apigee i repozytoria wewnętrzne powinny być włączone.

  6. Na nowym węźle zainstaluj yum-utilsyum-plugin-priorities z lokalnego repozytorium.
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    Twój zespół ds. operacyjnych lub inna grupa w organizacji musi skonfigurować lokalne repozytorium, aby umożliwić Ci zainstalowanie narzędzi Yum.

  7. Na nowym węźle sprawdź wersję libdb4, tak jak to opisaliśmy powyżej.
  8. Jeśli instalujesz na platformie Oracle 7.x, uruchom to polecenie:
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli instalujesz na AWS, uruchom to polecenie:yum-configure-manager
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Na nowym węźle rozpakuj plik do katalogu /tmp:
    tar -xzf apigee-4.52.02.tar.gz

    To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. Na przykład /tmp/repos.

  11. Zainstaluj narzędzie apigee-service Edge i zależności z /tmp/repos:
    sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Zwróć uwagę, że to polecenie zawiera ścieżkę do katalogu repozytoriów.

  12. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Instalowanie z repozytorium za pomocą serwera WWW Nginx

Aby zainstalować z repozytorium za pomocą serwera WWW Nginx:

  1. Zainstaluj serwer WWW Nginx w węźle repozytorium:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Domyślnie Nginx jest skonfigurowany tak, aby używać nazwy serwera localhost i portu 3939. Aby zmienić te wartości:
    1. Otwórz plik /opt/apigee/customer/application/mirror.properties w edytorze. Utwórz plik, jeśli nie istnieje.
    2. W razie potrzeby ustaw te wartości:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Uruchom ponownie Nginx:
      /opt/nginx/scripts/apigee-nginx restart
  3. Domyślnie repozytorium wymaga podania nazwy użytkownika i hasła w formacie admin:admin. Aby zmienić te dane logowania, ustaw następujące zmienne środowiskowe:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Zainstaluj yum-utilsyum-plugin-priorities na nowym węźle.
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. Na nowym węźle wyłącz SELinux w sposób opisany powyżej.
  6. Na nowym węźle sprawdź, czy lokalne repozytorium EPEL jest włączone.
  7. Na nowym węźle sprawdź wersję libdb4, tak jak to opisaliśmy powyżej.
  8. Na węźle zdalnym pobierz plik Edge bootstrap_4.52.02.sh do katalogu /tmp/bootstrap_4.52.02.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

    gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

  9. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
    sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.

  10. Na węźle zdalnym użyj polecenia apigee-service, aby zainstalować narzędzie apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge na węźle zdalnym. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Aktualizowanie lokalnego repozytorium Apigee

Aby zaktualizować repozytorium, musisz pobrać najnowszy plik bootstrap_4.52.02.sh, a następnie przeprowadzić nową synchronizację.

Aby zaktualizować repozytorium:

  1. Pobierz plik Edge bootstrap_4.52.02.sh do /tmp/bootstrap_4.52.02.sh:
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Uruchom plik Edge bootstrap_4.52.02.sh:
    sudo bash/tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego wpisanie.

  3. Zaktualizuj apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Przeprowadź synchronizację:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Jeśli chcesz przywrócić całe repozytorium:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Czyszczenie lokalnego repozytorium Apigee

Czyszczenie lokalnego repozytorium powoduje usunięcie katalogów /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.

Aby wyczyścić lokalne repozytorium, użyj tego polecenia:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Dodawanie lub aktualizowanie Edge w wersji 4.16.0x/4.17.0x w repozytorium 4.52.02

Jeśli musisz utrzymywać instalacje Edge w wersjach 4.16.0x lub 4.17.0x w repozytorium 4.52.02, możesz utrzymywać repozytorium zawierające wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję Edge.

Aby dodać wersję 4.16.0x/4.17.0x do repozytorium 4.52.02:

  1. Sprawdź, czy masz zainstalowaną wersję 4.52.02 narzędzia apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Powinien pojawić się wynik w formie poniżej, gdzie xyz to numer kompilacji:

    apigee-mirror-4.52.02-0.0.xyz
  2. Użyj narzędzia apigee-mirror, aby pobrać Edge w wersji 4.16.0x/4.17.0x do repozytorium. Zwróć uwagę, że przed poleceniem podajesz żądaną wersję:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Użyj tego samego polecenia, aby później zaktualizować repozytoria 4.16.0x/4.17.0x, podając wymagane numery wersji.

  3. Sprawdź strukturę plików w katalogu /opt/apigee/data/apigee-mirror/repos:
    ls /opt/apigee/data/apigee-mirror/repos

    Powinny się wyświetlić te pliki i katalogi:

    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

    Zwróć uwagę, że masz plik bootstrap dla wszystkich wersji Edge. Katalog apigee zawiera też osobne katalogi dla każdej wersji przeglądarki Edge.

  4. Aby spakować repozytorium do pliku .tar, użyj tego polecenia:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    To polecenie pakuje wszystkie repozytoria w wersjach 4.17.0x i 4.16.0x do tego samego pliku .tar. Nie możesz spakować tylko części repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku .tar, uruchom odpowiedni plik bootstrap, używając jednego z tych poleceń. W tym przykładzie instalowana jest wersja Edge 4.17.01:

  • Jeśli instalujesz z pliku .tar, uruchom odpowiedni plik bootstrap z repozytorium:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Aby dokończyć instalację, wykonaj pozostałe kroki z sekcji „Instalacja z pliku .tar” powyżej.

  • Jeśli instalujesz za pomocą serwera WWW Nginx, pobierz i uruchom odpowiedni plik bootstrap z repozytorium:
    /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://

    Aby dokończyć instalację, wykonaj pozostałe czynności z sekcji „Instalowanie z repozytorium za pomocą serwera WWW Nginx” powyżej.