Instalowanie narzędzia Edge apigee

Aby zainstalować Edge na węźle, musisz najpierw zainstalować narzędzie Edge apigee-setup. Jeśli jesteś 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 jednak chcesz, możesz utworzyć dowiązanie symboliczne, aby zmapować /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w sekcji Wymagania dotyczące instalacji.

Wymaganie wstępne: wyłącz SELinux

Zanim zainstalujesz narzędzie Edge apigee-setup lub dowolne komponenty Edge , musisz wyłączyć SELinux lub ustawić go w trybie zezwalającym. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

  • Aby trwale wyłączyć SELinux lub ustawić go w trybie zezwalającym:
    1. Otwórz w edytorze plik /etc/sysconfig/selinux.
    2. Ustaw SELINUX=disabled lub SELINUX=permissive.
    3. Zapisz zmiany.
    4. Uruchom ponownie węzeł.
    5. W razie potrzeby po zainstalowaniu 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ć repozytorium lokalne, musisz włączyć dodatkowe pakiety dla systemu Enterprise Linux (EPEL). W przypadku systemów Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x lub Oracle Linux 9.x uruchom te polecenia:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Wymaganie wstępne w przypadku systemów RHEL 9, Rocky 9 i Oracle 9

    Jeśli instalujesz 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 dodatkowe pakiety dla systemu Enterprise Linux (EPEL): 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Wyłącz Postgres i Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Informacje o zmianach przed instalacją w przypadku PostgreSQL i LDAP znajdziesz odpowiednio w sekcjach Wymagania dotyczące instalacji PostgreSQL i Zmiany przed instalacją SymasLDAP 2.6.10.

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

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

      Apigee Edge dla chmury prywatnej 4.54.00 wymaga obsługi podwójnej Javy z zainstalowanymi na węźle Javą 17 i Javą 21. Przed uruchomieniem skryptu bootstrap musisz zainstalować Javę 17 i Javę 21. Instalator sprawdza tylko czy są zainstalowane obie wersje JDK. Nie instaluje Javy automatycznie.

      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*'
    8. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge na węźle. Więcej informacji znajdziesz w sekcji 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 błędów:

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

    Sprawdź łączność sieciową, wykonując to następujące ncat polecenie:

    nc -v software.apigee.com 443

    Powinien się pojawić komunikat podobny do tego:

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

    Jeśli nie masz zainstalowanego nc, możesz wykonać następujące telnet polecenie:

    telnet software.apigee.com 443

    Jeśli polecenia się powiodą, możesz użyć kombinacji klawiszy Ctrl+C, aby przerwać otwarte połączenie.

    Jeśli którekolwiek z poleceń się nie powiedzie, masz ograniczoną łączność sieciową lub nie masz jej wcale. 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ąpi 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 menedżera pakietów yum. 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 pliku /etc/yum.conf.
    • Dodaj globalną konfigurację serwera proxy HTTP w pliku /etc/environment.

    Instalowanie narzędzia Edge apigee-setup na węźle bez zewnętrznego połączenia z internetem

    Jeśli węzły Edge znajdują się za zaporą 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ą uzyskiwać 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 repozytoriów lokalnych:

    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 repozytorium wewnętrznego możesz przenieść je do innego węzła lub udostępnić ten węzeł węzłom Edge na potrzeby instalacji.

    Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go o najnowsze pliki wersji Edge. W sekcjach poniżej opisujemy, 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ć poświadczeń.
    2. Zaloguj się na węźle jako root, aby zainstalować pakiety RPM Edge.
    3. Wyłącz SELinux zgodnie z opisem powyżej.
    4. Pobierz plik Edge bootstrap_4.54.00.sh do katalogu /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Zainstaluj narzędzie Edge apigee-service i zależności: 
      sudo bash /tmp/bootstrap_4.54.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 wpisanie.

    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 --only-new-rpms, aby pobrać tylko najnowsze pakiety RPM.

    8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z repozytorium lokalnego na tym samym węźle, który hostuje repozytorium lokalne, musisz najpierw uruchomić te polecenia:
      1. Uruchom bootstrap_4.54.00.sh z repozytorium lokalnego, aby zainstalować narzędzie apigee-service: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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 na węźle. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge na węźle.

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

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

    • Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zainstaluj Edge z tego pliku.
    • Zainstaluj serwer WWW na węźle 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 jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.54.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. Skopiuj go na przykład do katalogu /tmp na nowym węźle.
    3. Na nowym węźle wyłącz SELinux zgodnie z opisem powyżej.
    4. Na nowym węźle upewnij się, że masz dostęp do repozytorium lokalnego narzędzia Yum i repozytorium EPEL repo.
    5. Sprawdź, czy wszystkie repozytoria zewnętrzne są wyłączone (tak powinno być, ponieważ instalujesz 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. Użyj apigee-service, aby zainstalować narzędzie apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge na węźle. Więcej informacji znajdziesz w sekcji 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 do używania localhost jako nazwy serwera i portu 3939. Aby zmienić te wartości:
      1. Otwórz w edytorze plik /opt/apigee/customer/application/mirror.properties. 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 nazwy użytkownika i hasła admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe: 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. Na nowym węźle upewnij się, że repozytorium EPEL jest włączone lokalnie.
    5. Na nowym węźle sprawdź wersję libdb4 zgodnie z opisem powyżej.
    6. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Gdzie uName:pWord to nazwa użytkownika i hasło 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 sekcji Instalowanie komponentów Edge na węźle.

    Aktualizowanie lokalnego repozytorium Apigee

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

    Aby zaktualizować repozytorium:

    1. Pobierz plik Edge bootstrap_4.54.00.sh do katalogu /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Uruchom plik Edge bootstrap_4.54.00.sh: 
      sudo bash/tmp/bootstrap_4.54.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 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 zsynchronizować 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 tego polecenia:

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