Instalowanie narzędzia Edge apigee

Aby zainstalować Edge na węźle, musisz najpierw zainstalować narzędzie apige-setup. Jeśli pracujesz w środowisku, w którym 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. Jeśli chcesz, możesz utworzyć symboliczny link do mapy /opt/apigee, aby wskazać inną lokalizację. Więcej informacji znajdziesz w wymaganiach dotyczących instalacji.

Warunek wstępny: wyłącz SELinux

Zanim zainstalujesz narzędzie Edge apigee-setup lub jakiekolwiek komponenty Edge, musisz wyłączyć funkcję SELinux lub ustawić ją w trybie mniej rygorystycznym. W razie potrzeby po zainstalowaniu przeglądarki Edge możesz ponownie włączyć SELinux.

  • Aby trwale wyłączyć SELinux lub ustawić tryb mniej rygorystyczny:
    1. Otwórz plik /etc/sysconfig/selinux w edytorze.
    2. Ustaw wartość SELINUX=disabled lub SELINUX=permissive
    3. Zapisz zmiany.
    4. Ponownie uruchom węzeł.
    5. W razie potrzeby po zainstalowaniu przeglądarki Edge ponownie włącz SELinux, powtarzając tę procedurę, aby ustawić SELINUX=enabled.
  • Warunek wstępny: włącz repozytorium EPEL

    Aby zainstalować lub zaktualizować Edge albo utworzyć lokalny repozytorium, musisz włączyć Extra Packages for Enterprise Linux (lub EPEL). Polecenie, którego użyjesz, zależy od wersji RedHat/CentOS:

    • Red Hat/CentOS/Oracle 8.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • W przypadku Red Hat/CentOS/Oracle 9.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      sudo rpm -ivh epel-release-latest-9.noarch.rpm
    • Wymagania wstępne dotyczące RHEL 8, Rocky 8 i Oracle 8

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

      1. Włącz dodatkowe pakiety dla Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. Wyłączanie serwerów Postgres i Nginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      Wymagania wstępne dla RHEL 9, Rocky 9 i Oracle 9

      Jeśli instalujesz przeglądarkę Edge na serwerze z systemem Red Hat Enterprise Linux (RHEL) 9, Rocky 9 lub Oracle 9, przed instalacją wykonaj te czynności:

      1. Włącz pakiety dodatkowe dla Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      2. Wyłączanie serwerów Postgres i Nginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      Informacje o zmianach preinstalacyjnych dla PostgreSQL i LDAP znajdziesz odpowiednio w sekcjach Wymagania preinstalacyjnej bazy danych PostgreSQL i Zmiany związane z preinstalacją OpenLDAP 2.4.

      Instalowanie narzędzia apige-setup w Edge na węźle z zewnętrznym połączeniem z internetem

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

      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ż konto username:password w witrynie FTP Apigee, możesz użyć tych danych.
      2. Aby zainstalować pakiety RPM Edge, zaloguj się w węźle jako root.
      3. Wyłącz SELinux.
      4. Włącz repozytorium EPEL.
      5. Jeśli instalujesz na RHEL 9/Rocky 9/Oracle 9, wykonaj czynności opisane w sekcji Wymagania wstępne dla RHEL 9/Rocky 9/Oracle 9.
      6. Pobierz plik Edge bootstrap_4.53.00.sh do /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. Zainstaluj narzędzie apigee-service i jego zależności w Edge:
        sudo bash /tmp/bootstrap_4.53.00.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 podanie.

        Domyślnie instalator sprawdza, czy masz zainstalowaną wersję Java 1.8. Jeśli tego nie zrobisz, zostanie ona zainstalowana automatycznie. Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIXprzyjmuje te wartości:

        • I: zainstaluj OpenJDK 1.8 (domyślnie)
        • C: kontynuuj bez instalowania Java
        • Pytanie: Zakończ. W tym przypadku 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 polecenia:

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

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

        sudo yum -v repolist 'apigee*'
      8. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      9. Użyj polecenia 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 z internetem może wystąpić jeden lub więcej z tych błędów:

      Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.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 Nie używaj znaków specjalnych w hasłach Apigee.
      Problemy z łącznością

      Aby sprawdzić połączenie z siecią, uruchom to polecenie ncat:

      nc -v software.apigee.com 443

      Powinien pojawić się komunikat podobny do tego:

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

      Jeśli nie masz zainstalowanej aplikacji nc, możesz wykonać to polecenie telnet:

      telnet software.apigee.com 443

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

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

      Nieprawidłowe dane logowania

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

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

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

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

      • Dodaj konfigurację serwera proxy HTTP w /etc/yum.conf
      • Dodawanie globalnej konfiguracji serwera proxy HTTP w /etc/environment

      Instalowanie narzędzia apigee-setup w 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 (dużych), które zawierają pliki potrzebne podczas instalacji. Te kopie muszą być dostępne dla wszystkich węzłów. Po utworzeniu węzły będą mogły uzyskać dostęp do tych lokalnych lustrzanych kopii, aby zainstalować Edge.

      Proces instalacji Apigee Edge w przypadku 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, potrzebujesz węzła z dostępem do zewnętrznego internetu, aby móc pobrać pakiety RPM i zależności Edge. Po utworzeniu repozytorium wewnętrznego możesz je przenieść do innego węzła lub udostępnić ten węzeł do instalacji węzłów Edge.

      Po utworzeniu lokalnego repozytorium Apigee możesz później zaktualizować je za pomocą najnowszych plików wydania Edge. W następnych sekcjach dowiesz się, jak utworzyć lokalny repozytorium Apigee i jak je zaktualizować.

      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 i hasło do witryny FTP Apigee, możesz ich użyć.
      2. Aby zainstalować RPM-y Edge, zaloguj się na węźle jako użytkownik root.
      3. Wyłącz SELinux w sposób opisany powyżej.
      4. Pobierz plik bootstrap_4.53.00.sh z Edge do folderu /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. Zainstaluj narzędzie apige-service i zależne od niego komponenty:
        sudo bash /tmp/bootstrap_4.53.00.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 podanie.

      6. Zainstaluj na 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 parametr --only-new-rpms, aby pobrać tylko najnowsze RPM.

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

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

      Masz 2 opcje instalacji Edge z repozytorium lokalnego. Możesz:

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

      Instalowanie z pliku .tar

      Aby zainstalować z pliku tar:

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

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

      6. Aby zainstalować narzędzie apigee-setup, użyj aplikacji apigee-service:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. Aby zainstalować i skonfigurować komponenty Edge na węźle, użyj polecenia apigee-setup. 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 na węźle repozytorium:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
      2. Domyślnie Nginx jest skonfigurowany tak, aby używać localhost jako nazwy serwera 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 go nie ma.
        2. W razie potrzeby ustaw te wartości:
          conf_apigee_mirror_listen_port=3939
          conf_apigee_mirror_server_name=localhost
        3. Ponownie uruchom Nginx:
          /opt/nginx/scripts/apigee-nginx restart
      3. Domyślnie repozytorium wymaga podania wartości nazwa-użytkownika:hasło admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe:
        MIRROR_USERNAME=uName
        MIRROR_PASSWORD=pWord
      4. Na nowym węźle sprawdź, czy repozytorium EPEL jest włączone lokalnie.
      5. W nowym węźle sprawdź wersję instancji libdb4 w sposób opisany powyżej.
      6. Na węźle zdalnym zainstaluj narzędzie apigee-service i zależne od niego komponenty:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

      7. Na węźle zdalnym użyj apigee-service, aby zainstalować narzędzie apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      8. 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.53.00.sh, a następnie przeprowadzić nową synchronizację.

      Aby zaktualizować repozytorium:

      1. Pobierz plik bootstrap_4.53.00.sh do folderu /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Uruchom plik Edge bootstrap_4.53.00.sh:
        sudo bash/tmp/bootstrap_4.53.00.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.

      3. Aktualizacja 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 usunąć całe repozytorium:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

      Czyszczenie lokalnego repozytorium Apigee

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

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

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