Instalowanie narzędzia Edge apigee

Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli w środowisku, w którym Twoje węzły nie mają zewnętrznego połączenia internetowego, 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. Jeśli jednak chcesz, możesz utworzyć dowiązanie symboliczne, aby zmapować obiekt /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w artykule Wymagania dotyczące instalacji.

Wymaganie wstępne: wyłącz SELinux

Zanim będzie można zainstalować narzędzie Edge apigee-setup lub jakiekolwiek komponenty Edge, musisz wyłączyć SELinux lub ustawić w niej tryb mniej rygorystyczny. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

  • Aby tymczasowo ustawić SELinux tryb mniej rygorystyczny, wykonaj to polecenie:
    • W systemie operacyjnym Linux 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 trwale wyłączyć SELinux lub ustawić w nim tryb mniej rygorystyczny:
    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 włącz ponownie SELinux, wykonując te czynności, aby ustawić SELINUX=enabled.

Warunek wstępny: włącz repozytorium EPEL

Aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium, musisz włączyć Dodatkowe pakiety dla systemu Linux (lub EPEL). Wybór polecenia zależy od wersji RedHat lub CentOS:

  • W przypadku systemu Red Hat Enterprise Linux (RHEL) 8.0 zobacz wymagania wstępne dotyczące RHEL 8.

  • W przypadku systemów Red Hat/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
  • W przypadku systemów Red Hat/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
  • W przypadku AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

Warunek wstępny: sprawdź wersję biblioteki libdb4 na urządzeniach RedHat 7.4 i CentOS 7.4

W systemie RedHat 7.4 lub CentOS 7.4 sprawdź przed instalacją wersję RPM libdb4. Edge wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 są dostarczane w nowszej wersji. Jeśli masz nowszą wersję, odinstaluj ją. Instalator Edge zainstaluje następnie wersję 4.8.

Wersję możesz sprawdzić za pomocą tego polecenia:

rpm -qa | grep libdb4

Jeśli zauważysz, że RPM libdb4 jest w wersji nowszej niż 4.8, odinstaluj ją.

Wymagania wstępne dla RHEL 8

Jeśli instalujesz Edge na serwerze Red Hat Enterprise Linux (RHEL) 8, przed przeprowadzeniem instalacji wykonaj te czynności:

  1. Włącz Extra Packages for Enterprise Linux (EPEL) (Dodatkowe pakiety dla systemu Linux):
    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 i utwórz dowiązanie symboliczne:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

Zainstaluj narzędzie konfiguracji Edge Apigee w węźle z zewnętrznym połączeniem internetowym

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

  1. Uzyskaj z Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już adres username:password dotyczący witryny ftp Apigee, możesz użyć tych danych logowania.
  2. Aby zainstalować pakiety RPM Edge, zaloguj się w węźle jako użytkownik root.
  3. Zainstaluj yum-utils i yum-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ę systemu libdb4.
  7. Jeśli instalujesz urządzenia w RHEL 8, wykonaj czynności opisane w sekcji Wymagania wstępne dla RHEL 8.
  8. Jeśli instalujesz w Oracle 7.x, uruchom to polecenie:
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli wykonujesz instalację w 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.01.sh dla platformy /tmp/bootstrap_4.52.01.sh:
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
  11. Zainstaluj narzędzie i zależności usługi Edge apigee:
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

    Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli go nie masz, zainstaluje ją za Ciebie. Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

    • I: zainstaluj OpenJDK w wersji 1.8 (domyślnie)
    • C: Kontynuuj bez instalowania Javy
    • P: Zakończ. W przypadku tej opcji należy samodzielnie zainstalować język Java.

    Instalacja narzędzia apigee-service tworzy plik /etc/yum.repos.d/apigee.repo definiujący repozytorium Apigee. Aby wyświetlić plik definicji, użyj polecenia:

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

    Aby wyświetlić zawartość repozytorium, użyj 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 apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Rozwiązywanie problemów

Podczas próby instalacji w węźle z zewnętrznym połączeniem internetowym może wystąpić co najmniej jeden 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ą

Przetestuj połączenie sieciowe, 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 nc, możesz wykonać to polecenie telnet:

telnet software.apigee.com 443

Jeśli polecenie zadziała, możesz nacisnąć CTRL+C, aby przerwać otwarte połączenie.

Jeśli któreś z tych poleceń się nie powiedzie, połączenie sieciowe lub ograniczone połączenie jest ograniczone. Skontaktuj się z administratorem sieci.

Nieprawidłowe dane logowania

Upewnij się, że nazwa użytkownika i hasło są prawidłowe.

Sprawdź na przykład, czy pojawi się błąd podczas próby użycia następującego polecenia z nazwą użytkownika i hasłem Apigee:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Problemy z serwerem proxy Twoja konfiguracja lokalna korzysta z serwera proxy ruchu wychodzącego HTTP, a ta sama konfiguracja nie została rozszerzona do menedżera pakietów yum. Sprawdź zmienne środowiskowe:
echo $http_proxy
echo $https_proxy

W przypadku serwera proxy ruchu wychodzącego HTTP użyj jednej z tych opcji:

  • Dodaj konfigurację serwera proxy HTTP w pliku /etc/yum.conf
  • Dodaj konfigurację globalnego serwera proxy HTTP w elemencie /etc/environment

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

Jeśli węzły brzegowe znajdują się za zaporą sieciową lub z innego powodu nie mają dostępu do internetu, musisz utworzyć kilka repozytoriów (luster) zawierających pliki potrzebne podczas instalacji. Te kopie lustrzane muszą być wtedy dostępne dla wszystkich węzłów. Po utworzeniu węzły mogą uzyskać dostęp do tych lokalnych lustrzanych elementów, aby zainstalować Edge.

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

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć wewnętrzne repozytorium Apigee, musisz mieć węzeł z zewnętrznym dostępem do internetu, który będzie mógł pobrać RPM i zależności Edge. Po utworzeniu wewnętrznego repozytorium możesz je przenieść do innego węzła lub udostępnić go węzłom brzegowym do instalacji.

Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go do najnowszych plików wersji Edge. Poniższe sekcje zawierają informacje o tym, jak utworzyć lokalne repozytorium Apigee i jak je aktualizować.

Aby utworzyć lokalne repozytorium Apigee:

  1. Uzyskaj z 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:hasło do witryny ftp Apigee, możesz jej 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.01.sh dla platformy /tmp/bootstrap_4.52.01.sh:
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
  5. Zainstaluj narzędzie Edge apigee i zależności usługi:
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

  6. Zainstaluj w węźle narzędzie apigee-mirror:
    /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, dodaj plik --only-new-rpms, który umożliwi pobieranie tylko najnowszych pakietów RPM.

  8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z repozytorium lokalnego w tym samym węźle, w którym hostuje lokalne repozytorium, musisz najpierw uruchomić te polecenia:
    1. Aby zainstalować narzędzie apigee-service, uruchom polecenie bootstrap_4.52.01.sh z lokalnego repozytorium:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.01.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. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

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

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

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

Zainstaluj z pliku .tar

Aby zainstalować program z pliku .tar:

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

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

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

    Aby można było zainstalować narzędzia Yum, zespół operacyjny lub inna grupa w organizacji musi skonfigurować lokalne repozytorium.

  7. Na nowym węźle sprawdź wersję libdb4 w sposób opisany powyżej.
  8. Jeśli instalujesz oprogramowanie w Oracle 7.x,uruchom to polecenie:
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli instalujesz w AWS, uruchom to polecenie yum-configure-manager:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. W nowym węźle przenieś plik do katalogu /tmp:
    tar -xzf apigee-4.52.01.tar.gz

    To polecenie tworzy nowy katalog o nazwie repos (repos) w katalogu zawierającym plik .tar. Przykład: /tmp/repos.

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

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

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

Instalowanie z repozytorium przy użyciu serwera WWW Nginx

Aby zainstalować z repozytorium przy użyciu 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 serwer Nginx jest skonfigurowany tak, aby jako nazwy serwera i portu 3939 używać lokalnego hosta. Aby zmienić te wartości:
    1. Otwórz plik /opt/apigee/customer/application/mirror.properties w edytorze. Jeśli plik nie istnieje, utwórz go.
    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 ustawienia nazwa_użytkownika:hasło o wartości admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. W nowym węźle zainstaluj yum-utils i yum-plugin-priorities.
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. W nowym węźle wyłącz funkcję SELinux w sposób opisany powyżej.
  6. W nowym węźle sprawdź, czy lokalne repozytorium EPEL jest włączone.
  7. Na nowym węźle sprawdź wersję libdb4 w sposób opisany powyżej.
  8. W węźle zdalnym pobierz plik Edge bootstrap_4.52.01.sh do serwera /tmp/bootstrap_4.52.01.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

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

  9. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
    sudo bash /tmp/bootstrap_4.52.01.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 apigee-service, aby zainstalować narzędzie apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Aby zainstalować i skonfigurować komponenty Edge w węźle zdalnym, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Aktualizowanie lokalnego repozytorium Apigee

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

Aby zaktualizować repozytorium:

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

    Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz właściwość pWord, pojawi się prośba o jej podanie.

  3. Aktualizacja apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Wykonaj synchronizację:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Jeśli chcesz całe repozytorium:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Czyszczenie lokalnego repozytorium Apigee

Wyczyszczenie lokalnego repozytorium spowoduje usunięcie zapisów /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.

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

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

Dodawanie lub aktualizowanie Edge 4.16.0x/4.17.0x w repozytorium 4.52.01

Jeśli musisz zachować instalacje przeglądarki Edge 4.16.0x lub 4.17.0x w repozytorium 4.52.01, możesz utworzyć repozytorium zawierające wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję Edge.

Aby dodać rozmiar 4.16.0x/4,17.0x do repozytorium 4.52.01:

  1. Sprawdź, czy zainstalowano narzędzie apigee-mirror w wersji 4.52.01:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Wynik powinien pojawić się w formularzu poniżej, gdzie xyz to numer kompilacji:

    apigee-mirror-4.52.01-0.0.xyz
  2. Użyj narzędzia apigee-mirror, aby pobrać Edge 4.16.0x/4.17.0x do repozytorium. Zwróć uwagę, jak przed poleceniem wybierasz odpowiednią 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ź katalog /opt/apigee/data/apigee-mirror/repos, aby poznać strukturę pliku:
    ls /opt/apigee/data/apigee-mirror/repos

    Powinny być widoczne 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 dostępny jest plik wczytywania dla wszystkich wersji Edge. Katalog apigee zawiera też osobne katalogi dla każdej wersji 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 spakuje wszystkie repozytoria 4.17.0x i 4.16.0x do tego samego pliku .tar. Nie możesz umieścić w pakiecie tylko części repozytorium.

Jeśli chcesz zainstalować Edge z lokalnego repozytorium lub pliku .tar, uruchom właściwy plik wczytywania za pomocą jednego z poniższych poleceń. Ten przykład instaluje Edge 4.17.01:

  • W przypadku instalacji z pliku tar uruchom właściwy plik rozruchowy 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 „Instalowanie z pliku .tar” powyżej.

  • Jeśli instalujesz pliki za pomocą serwera WWW Nginx, pobierz z repozytorium i uruchom właściwy plik wczytywania:
    /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 kroki opisane powyżej w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx”.